Utility Mechanics
These mechanics are the glue that holds your skills together, managing execution flow and providing feedback to players.Communication
message / msg
Sends a message to the target.
- Attributes:
message(string): The text to send. Supports placeholders.
sendtitle
Displays a large title on the target’s screen.
- Attributes:
title(string): The title text.subtitle(string): The subtitle text.
sendtoast
Sends a toast notification (achievement-style) to the target.
- Attributes:
text(string): The notification text.icon(string): The icon material.
randommessage
Selects and sends a random message from a provided list.
- Attributes:
messages(string): Semicolon-separated list of messages.
resourcepack
Prompts the target player to download a resource pack.
- Attributes:
url(string): Download link.hash(string): SHA-1 hash for verification.
Meta Mechanics (Control Flow)
skill / metaskill
Executes another skill by name.
- Attributes:
s(string): The name of the skill to execute.
delay / wait
Pauses execution for a specified duration.
- Attributes:
ticks(number): The delay in ticks.
repeat
Repeats the execution of a sub-mechanic.
- Attributes:
times(number): Number of repetitions.interval(ticks): Delay between repetitions.
Variable System
BTCMobs includes a powerful variable system for storing and manipulating data across skills.| Mechanic | Description | Example Use |
|---|---|---|
setvariable | Stores a value in a variable. | Tracking kill counts, phases. |
variableadd | Adds a value to a variable. | Incrementing stacks, timers. |
variablesubtract | Decreases a variable value. | Skill cooldowns, mana costs. |
customrandom | Picks a weighted random value. | Random rewards, path branching. |
Logic & Branching
switch
Executes different skills based on a condition or variable value.
foreach
Iterates through a list of targets or values and executes a skill for each.
cancelevent
Cancels the event that triggered the skill (e.g., onAttack).
Item & Inventory
giveitem / pickupitem
Gives an item to the target or forces them to pick up a nearby item.
takeitem
Removes a specific item from the target’s inventory.
smelt
Smelts the item currently held in the target’s hand.
takeexp
Removes experience points from the target player.
System & Navigation
pin
Pins the entity to their current location, preventing movement.
tracklocation
Updates a variable with the target’s current coordinates for future use in location-based skills.
opencustommenu
Opens a custom Typewriter-designed GUI menu for the player.
- Attributes:
id(string): The menu identifier from your configuration.