> ## Documentation Index
> Fetch the complete documentation index at: https://entities.lodemc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# World & Blocks

> Summoning, explosions and lightning, blocks, visual effects, screen effects, scoreboards and spawners.

Changing the world around the mob: what spawns, what blows up, which blocks are where, and what players see.

```yaml theme={null}
- summon{type=crypt_minion;amount=3;radius=4} +onHurt <50%
- explosion{yield=2} +onDeath @selfLocation
- effect:explosion @selfLocation                      # the look and sound, no damage
- blockmask{material=magma_block;radius=4;duration=5s} @selfLocation
- spawner{id=crypt;action=disable} +onDeath           # the boss dies, the dungeon stops
```

Most of these act on a **location**, so they work with location targeters like `@selfLocation`, `@forward{f=5}` or `@ring{r=6;p=8}` as well as with entities (which give their position). See [Targeters](https://entities.lodemc.net/targeters.md).

| Mechanic | Usage | What it does |
| :- | :- | :- |
| `activatespawner` <sub>also as</sub> | `activateSpawner{spawners=<id>,<id>}` | Runs one spawn cycle on the listed spawners. |
| `blackscreen` <sub>also effect:blackscreen, e:blackscreen</sub> | `blackScreen{duration=<ticks>}` | Blacks out a player's screen for a while. |
| `blockdestabilize` <sub>also destabilizeblock, destabilizeblocks</sub> | `blockDestabilize` | Turns the block at the target into a falling block. |
| `blockmask` <sub>also effect:blockmask, e:blockmask</sub> | `blockMask{material=<block>;radius=0;duration=0}` | Shows blocks as a different block to players for a while, without changing the world. |
| `blockphysics` <sub>also bphysics</sub> | `blockPhysics` | Forces a block update at the target. |
| `blockunmask` <sub>also effect:blockunmask, e:blockunmask</sub> | `blockUnmask{radius=0}` | Removes block masks near the target. |
| `blockwave` <sub>also effect:blockwave, e:blockwave</sub> | `blockWave{radius=2;velocity=0.2;duration=15}` | Throws a wave of blocks up from the ground at the target. |
| `bloodyscreen` <sub>also effect:bloodyscreen, redscreen</sub> | `bloodyScreen{duration=<ticks>}` | Covers a player's screen in the red border effect for a while. |
| `bonemeal` | `bonemeal{blockFace=UP}` | Applies bone meal to the block at the target. |
| `bossborder` <sub>also effect:bossborder, e:bossborder</sub> | `bossBorder{radius=<n>}` | Draws a world border around the caster to box players into an arena. |
| `breakblock` <sub>also blockbreak</sub> | `breakBlock{doDrops=true;doEffect=true}` | Breaks the block at the target. |
| `breakblockandgiveitem` <sub>also blockbreakandgiveitem</sub> | `breakBlockAndGiveItem{items=<item>}` | Breaks the block at the target and gives its drops to the caster. |
| `effect:ender` <sub>also ender, e:ender</sub> | `effect:ender` | Plays the ender effect at the target. |
| `effect:enderbeam` <sub>also enderbeam</sub> | `effect:enderbeam{duration=60;yoffset=0}` | Draws an end-crystal beam at the target. |
| `effect:explosion` <sub>also e:explosion, effect:explode, fakeexplosion, fakeexplode</sub> | `effect:explosion` | Plays an explosion with no damage. |
| `effect:flames` <sub>also flames, e:flames</sub> | `effect:flames` | Plays the flames effect at the target. |
| `effect:geyser` <sub>also geyser, e:geyser</sub> | `effect:geyser{type=water;height=3;interval=10}` | Makes a geyser of water or lava at the target. |
| `effect:guardianbeam` <sub>also guardianbeam, effect:beam, e:beam</sub> | `effect:guardianbeam{duration=400;interval=1}` | Draws a guardian beam from the caster to the target. |
| `effect:lightning` <sub>also e:lightning, fakelightning</sub> | `effect:lightning{localized=false}` | Plays a lightning strike with no damage. |
| `effect:skybox` <sub>also skybox, e:skybox</sub> | `effect:skybox{skybox=<type>}` | Changes a player's sky. Approximated with the player's own weather. |
| `effect:smoke` <sub>also smoke, e:smoke</sub> | `effect:smoke{direction=0}` | Plays a puff of smoke at the target. |
| `effect:smokeswirl` <sub>also smokeswirl, e:smokeswirl</sub> | `effect:smokeswirl{duration=20;interval=2}` | Plays swirling smoke at the target for a while. |
| `effect:thunderlevel` <sub>also thunderlevel, e:thunderlevel</sub> | `effect:thunderlevel{level=<0..1>}` | Darkens a player's sky. Approximated with the player's own weather. |
| `effect:totemresurrection` <sub>also totemresurrection, totemofundying, totemeffect</sub> | `effect:totemresurrection` | Plays the totem-of-undying effect. |
| `explosion` <sub>also explode</sub> | `explosion{yield=2;fire=false;blockdamage=false}` | Makes an explosion at the target. |
| `fakelightningstrike` | `fakeLightning` | Lightning that does no damage or fire. |
| `firework` <sub>also fireworks, effect:firework, e:firework</sub> | `firework{type=BALL;power=1;colors=#FFFFFF}` | Launches a firework at the target. |
| `hologram` <sub>also summonhologram, holo</sub> | `hologram{text=<text>;stay=100}` | Shows floating text at the target for a while. |
| `modifyglobalscore` <sub>also mgs</sub> | `modifyGlobalScore{objective=<o>;action=ADD;value=1}` | Changes a server-wide scoreboard score. |
| `modifymobscore` <sub>also mms</sub> | `modifyMobScore{objective=<o>;action=ADD;value=1}` | Changes the caster's scoreboard score. |
| `modifyscore` <sub>also setscore</sub> | `modifyScore{objective=<o>;entry=<e>;action=SET;value=0}` | Changes a scoreboard score for an entry. |
| `modifytargetscore` <sub>also mts</sub> | `modifyTargetScore{objective=<o>;action=ADD;value=1}` | Changes the target's scoreboard score. |
| `movepin` | `movePin{pin=<name>}` | Moves a named pin to the target location. |
| `pasteschematic` <sub>also schematicpaste, fawepaste, wepaste</sub> | `pasteSchematic{schematic=<name>;pasteair=false}` | Pastes a schematic at the target. Needs WorldEdit or FAWE. |
| `prison` | `prison{material=ICE;duration=100}` | Encases the target in blocks for a while. |
| `pushblock` | `pushBlock{direction=NORTH}` | Pushes the block at the target like a piston would. |
| `pushbutton` <sub>also buttonpush</sub> | `pushButton` | Presses the button at the target. |
| `recoil` <sub>also effect:recoil, e:recoil</sub> | `recoil{recoil=<deg>;pitch=-10to10;yaw=-0.25to0.25}` | Kicks a player's view up and sideways. |
| `setblockopen` <sub>also setdoor</sub> | `setBlockOpen{open=true}` | Opens or closes a door, trapdoor or gate at the target. |
| `setblocktype` <sub>also setblock</sub> | `setBlockType{type=<block>;physics=false}` | Places a block at the target. |
| `setglobalscore` <sub>also sgs</sub> | `setGlobalScore{objective=<o>;value=<n>}` | Sets a server-wide scoreboard score. |
| `setmobscore` <sub>also sms</sub> | `setMobScore{objective=<o>;value=<n>}` | Sets the caster's scoreboard score. |
| `settargetscore` <sub>also sts</sub> | `setTargetScore{objective=<o>;value=<n>}` | Sets the target's scoreboard score. |
| `spawner` | `spawner{id=<spawner\|group\|all>;action=trigger\|enable\|disable\|reset\|clear}` | Drives a [spawner](https://entities.lodemc.net/spawners.md), group or `all`: `trigger`, `enable`, `disable`, `reset` (keep the mobs) or `clear` (remove them too). |
| `spring` <sub>also water</sub> | `spring{type=water;duration=60}` | Makes a temporary water or lava spring at the target. |
| `summon` <sub>also spawnmob, spawnmobs, piratesummon</sub> | `summon{type=<mob>;amount=1;radius=0;level=<n>}` | Spawns mobs at the target: a LodeEntities mob id or a vanilla entity type. |
| `summonareaeffectcloud` <sub>also summoncloud</sub> | `summonAreaEffectCloud{type=<potion>;radius=3;duration=200}` | Spawns a lingering potion cloud. |
| `summonfallingblock` | `summonFallingBlock{type=<block>}` | Spawns a falling block. |
| `togglelever` <sub>also lever</sub> | `toggleLever{duration=0}` | Flips the lever at the target, optionally back again after a while. |
| `togglepiston` <sub>also piston</sub> | `togglePiston` | Extends or retracts the piston at the target. |
| `undopaste` <sub>also undoschematic, undoschem</sub> | `undoPaste{id=<paste id>}` | Undoes an earlier paste. |
| `worldeditreplace` <sub>also wereplace</sub> | `worldEditReplace{from=AIR;to=AIR}` | Replaces blocks in a region. Needs WorldEdit. |

## Summoning

`summon` places LodeEntities mobs (with their model, stats and effects) or plain vanilla entities. A summoned mob records the caster as its **parent**, which `@parent`, `@children`, `@siblings` and the `ischild` condition read. It takes MythicMobs' full option set: owner and parent links, inherited threat and faction, `level`, spread and more.

```yaml theme={null}
- summon{type=skeletal_minion;amount=2to4;radius=5} @selfLocation
- summon{type=zombie;amount=1} @ring{r=6;p=6}             # one zombie on each of six points
```

The world's time and weather are under [Entity State](https://entities.lodemc.net/mechanics-entity-state.md). Schematics need WorldEdit or FAWE; without them these lines do nothing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.