Skip to main content

Visual Mechanics

BTCMobs provides a rich set of visual mechanics to make your mobs feel alive and impactful.

Particle Systems

BTCMobs includes several optimized particle shapes for cinematic effects.

particle

Spawns a basic particle at the target location.
  • Attributes:
    • particle (string): The particle ID (e.g., FLAME, SMOKE).
    • amount (number): Number of particles.
    • hs / vs (number): Horizontal and vertical spread.
- particle{p=FLAME;amount=20;hs=0.5;vs=1.0} @self ~onTimer:20

Advanced Shapes

MechanicDescriptionExample Use
particlelineDraws a line of particles between caster and target.Laser beams, grappling hooks.
particleringCreates a ring of particles around the target.Buff zones, aura indicators.
particlesphereGenerates a sphere of particles.Explosions, magical barriers.
particlehelixCreates a spiraling helix of particles.Teleportation, ascending energy.

Beams & Trails

beam / enderbeam

Creates a solid beam between two points.
  • Attributes:
    • particle (string): Particle used for the beam.
    • radius (number): Thickness of the beam.
- beam{p=REDSTONE;r=0.5} @target ~onAttack

guardianbeam

Spawns a vanilla Guardian laser beam.
  • Attributes:
    • duration (ticks): How long the beam persists.

Screen & Feedback Effects

These effects impact the player’s perception and are perfect for “boss” mechanics.

screentint

Applies a color tint to the player’s screen (requires Client-Side Support).
  • Attributes:
    • color (hex): The tint color (e.g., #FF0000 for red).
    • fade (ticks): Fade in/out duration.

shakescreen

Shakes the player’s camera to simulate impact or earthquakes.
  • Attributes:
    • intensity (number): Strength of the shaking.
    • duration (ticks): How long to shake.

Model Animations (BetterModel)

If you are using the BetterModel extension, these mechanics control your custom models.

model

Sets or updates the model of the mob.
  • Attributes:
    • mid (string): The Model ID from your models folder.

state

Plays a specific animation state on the model.
  • Attributes:
    • animation (string): The animation state to play (e.g., attack, walk).
    • loop (boolean): Whether the animation should repeat.