Skip to main content

​
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
ParameterDefaultDescription
typeBLOCKBLOCK, ITEM, TEXT
material/mSTONEBlock or Item material
textTextText content (for TEXT type)
duration/d20Duration in ticks
scale1,1,1Scale vector (x,y,z)
rotation0,0,0Rotation in degrees
translation/offset0,0,0Offset from target
interpolation0Animation duration in ticks
billboardFIXEDFIXED, CENTER, VERTICAL, HORIZONTAL
view_range1.0Visibility range multiplier
Examples: 
- 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
ParameterDefaultDescription
width/w1.0Hitbox width
height/h1.0Hitbox height
onHit/skill-Skill to execute on hit
synctrueFollows the caster
durationInfinityLifetime
offset0,0,0Spawn 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
ParameterDefaultDescription
id-Squad identifier
actionSETSET, AGGRO, SKILL
radius30Communication 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
ParameterDefaultDescription
typePLAINSBiome type
duration200Duration in ticks
- biome{type=CRIMSON_FOREST} @selflocation ~onSpawn

​
BioState Mechanic

Control entity-specific states (sitting, dashing, etc.). Mechanic: biostate
Aliases: entitystate
ParameterDefaultDescription
modeSITTINGState mode
statetrueEnable/disable
Modes: 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
ParameterDefaultDescription
intensity1.0Shake intensity

​
Launch Block

Spawns falling blocks with velocity. Mechanic: launchblock
Aliases: fallingblock
ParameterDefaultDescription
materialANVILBlock type
velocity0,1,0Launch direction
- launchblock{material=ANVIL;velocity=0,2,0} @target

​
Grapple

Pull the caster toward the target. Mechanic: grapple
ParameterDefaultDescription
force1.0Pull strength
- grapple{force=1.5} @target

​
Utility Mechanics

​
Loop Sound

Play sounds at intervals. Mechanic: loopsound
ParameterDefaultDescription
soundambient.caveSound to play
interval20Interval in ticks

​
Item Cooldown

Apply cooldown to an item type. Mechanic: itemcooldown
Aliases: cooldown
ParameterDefaultDescription
materialENDER_PEARLItem type
ticks100Cooldown duration
- itemcooldown{material=ENDER_PEARL;ticks=200} @target

​
Damage Item

Damage the held item. Mechanic: damageitem
Aliases: itemdamage
ParameterDefaultDescription
amount10Damage amount

​
Temporal Mechanics

​
Delay

Execute a skill after a delay. Mechanic: delay
ParameterDefaultDescription
skill/s-Skill to execute
ticks/delay20Delay in ticks
seconds-Delay in seconds
- delay{skill=Explode;ticks=60} @self

​
Repeat

Execute a skill multiple times. Mechanic: repeat
ParameterDefaultDescription
skill/s-Skill to repeat
interval20Interval in ticks
count/times1Repetitions
delay/start0Initial 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
ParameterDefaultDescription
frequency1Vibration frequency

​
🌪️ 1.21+ Mechanics

​
Wind Charge

Fire a Breeze Wind Charge projectile. Mechanic: windcharge
ParameterDefaultDescription
velocity1.0Speed of the charge
- windcharge{velocity=1.5} @target

​
Mace Attack

Perform a Mace smash attack with knockback. Mechanic: maceattack Aliases: smash
ParameterDefaultDescription
damage10Damage amount
knockback2.0Knockback strength
- maceattack{damage=20;knockback=3.0} @target