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.
Innovation Features
[!NOTE]
These features are exclusive to BTCMobs and leverage modern Minecraft (Paper 1.21+) capabilities.
Display Mechanic (VFX)
Uses 1.21+ BlockDisplay, ItemDisplay, and TextDisplay entities for high-performance visual effects.
Mechanic: display
Aliases: vfx, blockdisplay, itemdisplay, textdisplay
| Parameter | Default | Description |
|---|
type | BLOCK | BLOCK, ITEM, TEXT |
material/m | STONE | Block or Item material |
text | Text | Text content (for TEXT type) |
duration/d | 20 | Duration in ticks |
scale | 1,1,1 | Scale vector (x,y,z) |
rotation | 0,0,0 | Rotation in degrees |
translation/offset | 0,0,0 | Offset from target |
interpolation | 0 | Animation duration in ticks |
billboard | FIXED | FIXED, CENTER, VERTICAL, HORIZONTAL |
view_range | 1.0 | Visibility range multiplier |
- display{type=BLOCK;m=LAVA;scale=1.5,1.5,1.5;d=100} @self
- display{type=TEXT;text="&c-100 HP";billboard=CENTER;d=40} @target
- display{type=ITEM;i=DIAMOND_SWORD;scale=1,1,1;d=200} @self
Interaction Hitboxes
Creates invisible, clickable interaction entities for weak points on bosses.
Mechanic: interaction
Aliases: hitbox
| Parameter | Default | Description |
|---|
width/w | 1.0 | Hitbox width |
height/h | 1.0 | Hitbox height |
onHit/skill | - | Skill to execute on hit |
sync | true | Follows the caster |
duration | Infinity | Lifetime |
offset | 0,0,0 | Spawn offset |
- interaction{w=2;h=2;onHit=CriticalDamage;offset=0,3,0} @self
Smart Squad AI
Enables mobs to share combat state and communicate within a Squad.
Mechanic: squad
| Parameter | Default | Description |
|---|
id | - | Squad identifier |
action | SET | SET, AGGRO, SKILL |
radius | 30 | Communication range |
skill | - | Skill for SKILL action |
- squad{id=RoyalGuard;action=SET} @self ~onSpawn
- squad{id=RoyalGuard;action=AGGRO} @self ~onDamaged
- squad{id=RoyalGuard;action=SKILL;skill=RaiseShields} @self
Biome Mechanic
Change biome at target locations.
Mechanic: biome
Aliases: setbiome
| Parameter | Default | Description |
|---|
type | PLAINS | Biome type |
duration | 200 | Duration in ticks |
- biome{type=CRIMSON_FOREST} @selflocation ~onSpawn
BioState Mechanic
Control entity-specific states (sitting, dashing, etc.).
Mechanic: biostate
Aliases: entitystate
| Parameter | Default | Description |
|---|
mode | SITTING | State mode |
state | true | Enable/disable |
SITTING (Cat/Wolf), DASHING (Camel), CROAKING (Frog)
- biostate{mode=SITTING;state=true} @self
- biostate{mode=DASHING;state=true} @self
Physics Mechanics
Shake / Screen Shake
Simulates camera shake effect for players.
Mechanic: shake
Aliases: screenshake
| Parameter | Default | Description |
|---|
intensity | 1.0 | Shake intensity |
Launch Block
Spawns falling blocks with velocity.
Mechanic: launchblock
Aliases: fallingblock
| Parameter | Default | Description |
|---|
material | ANVIL | Block type |
velocity | 0,1,0 | Launch direction |
- launchblock{material=ANVIL;velocity=0,2,0} @target
Grapple
Pull the caster toward the target.
Mechanic: grapple
| Parameter | Default | Description |
|---|
force | 1.0 | Pull strength |
- grapple{force=1.5} @target
Utility Mechanics
Loop Sound
Play sounds at intervals.
Mechanic: loopsound
| Parameter | Default | Description |
|---|
sound | ambient.cave | Sound to play |
interval | 20 | Interval in ticks |
Item Cooldown
Apply cooldown to an item type.
Mechanic: itemcooldown
Aliases: cooldown
| Parameter | Default | Description |
|---|
material | ENDER_PEARL | Item type |
ticks | 100 | Cooldown duration |
- itemcooldown{material=ENDER_PEARL;ticks=200} @target
Damage Item
Damage the held item.
Mechanic: damageitem
Aliases: itemdamage
| Parameter | Default | Description |
|---|
amount | 10 | Damage amount |
Temporal Mechanics
Delay
Execute a skill after a delay.
Mechanic: delay
| Parameter | Default | Description |
|---|
skill/s | - | Skill to execute |
ticks/delay | 20 | Delay in ticks |
seconds | - | Delay in seconds |
- delay{skill=Explode;ticks=60} @self
Repeat
Execute a skill multiple times.
Mechanic: repeat
| Parameter | Default | Description |
|---|
skill/s | - | Skill to repeat |
interval | 20 | Interval in ticks |
count/times | 1 | Repetitions |
delay/start | 0 | Initial delay |
- repeat{skill=Pulse;interval=10;count=5} @self
Combat Mechanics
Missile
Homing projectile mechanic.
Mechanic: missile
Aliases: guidedprojectile, homingmissile
Aura
Create an aura effect around the caster.
Mechanic: aura
Aliases: effect:aura
Vibration
Send a vibration signal (for Warden detection).
Mechanic: vibration
| Parameter | Default | Description |
|---|
frequency | 1 | Vibration frequency |
🌪️ 1.21+ Mechanics
Wind Charge
Fire a Breeze Wind Charge projectile.
Mechanic: windcharge
| Parameter | Default | Description |
|---|
velocity | 1.0 | Speed of the charge |
- windcharge{velocity=1.5} @target
Mace Attack
Perform a Mace smash attack with knockback.
Mechanic: maceattack
Aliases: smash
| Parameter | Default | Description |
|---|
damage | 10 | Damage amount |
knockback | 2.0 | Knockback strength |
- maceattack{damage=20;knockback=3.0} @target