Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt

Use this file to discover all available pages before exploring further.

Skill Mechanics Reference

Mechanics are the actions your mobs perform. BTCMobs supports over 100 mechanics, including 100% parity with standard MythicMobs configurations and exclusive modern enhancements.

📊 Stats & Resource Mechanics

MechanicAliasesDescription
healhealpercentRestores health (can use percent=true).
sethealth-Directly sets current health.
setmaxhealth-Directly sets maximum health.
feed-Restores hunger/saturation for players.
oxygen-Modifies the target’s air supply.

🛡️ State & Status Mechanics

MechanicAliasesDescription
setname-Dynamically changes the entity’s display name.
setlevel-Changes the mob’s level for stat scaling.
glowglowingApplies/removes the spectral outline effect.
freeze-Applies the frost/slow effect (1.17+).
shield-Adds a temporary absorption shield.

🏃 Movement & Threat Mechanics

MechanicAliasesDescription
jumpleapMakes the mob jump or leap towards target.
lunge-Fast forward dash towards target.
threataddthreatAdds/Subtracts threat from the threat table.
taunt-Forces the target to attack the caster.
clearthreat-Resets the threat table.

⚔️ Combat & Projectile Mechanics

MechanicAliasesDescription
arrowvolley-Cascading rain of arrows from the sky.
shootfireball-Shoots a Ghast/Blaze fireball.
shootskull-Shoots a Wither skull.
shootshulker-Shoots a tracking Shulker bullet.
missileguidedHoming projectile with onHit/onTick skills.

🌍 World & Block Mechanics

MechanicAliasesDescription
breakblock-Mines a block and plays the breaking effect.
setblock-Changes a block at the target location.
prison-Encapsulates a target in a cage of blocks.
removeblock-Turns the target block into air.

👁️ Visual & Message Mechanics

MechanicAliasesDescription
sendtitletitleSends a large text overlay to the player.
sendtoasttoastSends a “New Challenge” toast notification.
sendactionmessageactionbarSends text above the hotbar.
messagemsgStandard chat message (MiniMessage support).
soundplaysoundPlays a Bukkit sound at the location.
raytrace-Visual line/beam between two points.

🧩 Logic & Meta Mechanics

MechanicAliasesDescription
skillsk, metaskillExecutes another skill from the config.
randomskill-Picks one skill from a list based on chance.
chain-Executes multiple skills in strict sequence.
sudo-Forces the target to execute a skill.
delaysleepPauses execution for X ticks.
cooldown-Applies a cooldown to a specific skill.
variablemathmathPerforms complex math on variables (add, sub, pow, mod).
customrandom-Calculates weighted random values for variables.
onchat-(Aura) Triggers a skill when the target speaks in chat.

🚀 Innovation Mechanics (Exclusive)

MechanicDescription
displayBlockSpawns an interpolated Block Display (Zero server lag).
displayItemSpawns an interpolated Item Display.
displayTextFloating dynamic text/damage numbers.
squadTriggers coordinated “Formation AI” behavior.

For detailed parameters of each mechanic, refer to the MythicMobs Wiki — BTCMobs supports all standard syntax!