DUXPLIMA Documentation

Actions

Every action a rule can name, what in the game each one covers, and how the tree works.

Contents: How the tree works · Building · Using blocks · Entities · Damage · Items · Vehicles, hangings, trampling · Movement · Nature

How the tree works

An action is a dotted name such as use.door. The part before a dot is its parent, so use is the parent of use.door, use.container and every other use.* action. A rule on a parent covers every child that has no rule of its own:

use everyone deny
use.door everyone allow

Here doors open and nothing else does. /guard actions prints the top level and /guard actions use every action under use. Other plugins can add their own branch through the developer API, and their actions are then written in rules like these.

A block, item or entity that no table below names is never let through by accident: a right click on an unlisted block is use.other, on an unlisted entity interact.other, and so on.

Player actions are decided for the player who does them. Actions under world.* have no player behind them: only everyone rules count for them, plus the border test. A nature action a player starts (lighting a fire, priming TNT, emptying a lava bucket) is checked both ways.

Building

ActionCovers
breakBreaking a block, and a block taken by an entity a player controls
placePlacing a block, and tools that reshape one: axes stripping logs, shovels making paths, hoes tilling, honeycomb waxing, brushes, glass bottles, shears

Using blocks

ActionCovers
useParent of every right click on a block
use.doorDoors
use.trapdoorTrapdoors
use.gateFence gates
use.buttonButtons
use.leverLevers
use.pressure-plateStepping on pressure plates. Quiet: a player standing on one is not told every tick
use.containerChests, barrels, shulker boxes, furnaces, hoppers, droppers, dispensers, brewing stands, chiseled bookshelves, decorated pots
use.workstationCrafting table, crafter, anvils, enchanting table, smithing table, loom, grindstone, stonecutter, cartography and fletching tables
use.bedBeds
use.respawn-anchorRespawn anchors
use.redstoneRepeaters, comparators, daylight detectors
use.signEditing signs
use.lecternLecterns
use.cakeCakes and candle cakes
use.beaconBeacons
use.jukeboxJukeboxes and note blocks
use.composterComposters
use.cauldronCauldrons
use.bellBells
use.otherAny other block with a right click, the ender chest included

Entities

ActionCovers
interactParent of every right click on an entity
interact.villagerVillagers and wandering traders (trading)
interact.animalAnimals, fish and bats (feeding, breeding, shearing, leashing, milking)
interact.armor-standTaking from or putting on an armor stand
interact.item-framePutting in, taking out or turning an item in a frame
interact.vehicleGetting into boats and minecarts, riding
interact.otherAny other entity

Damage

ActionCovers
damageParent of every hit by a player, their arrows and potions included
damage.playerHurting another player
damage.animalHurting animals, fish and bats
damage.monsterHurting monsters
damage.villagerHurting villagers and wandering traders
damage.armor-standHitting armor stands
damage.hangingHitting item frames and paintings
damage.vehicleHitting boats and minecarts
damage.otherHurting any other entity

Items

ActionCovers
itemParent of every item action
item.dropDropping an item
item.pickupPicking an item up. A refused pickup is quiet: no message, no alert
item.useParent of using an item in hand
item.use.ender-pearlThrowing ender pearls
item.use.chorus-fruitTeleporting by chorus fruit
item.use.fireworkLaunching fireworks
item.use.potionThrowing splash and lingering potions
item.use.wind-chargeThrowing wind charges
item.use.bucketFilling or emptying any bucket
item.use.spawn-eggSpawn eggs
item.use.bone-mealBone meal
item.use.lighterFlint and steel, fire charges
item.use.otherThrowing anything else: snowballs, eggs, tridents

Vehicles, hangings, trampling

ActionCovers
vehicle.placePlacing boats and minecarts
vehicle.destroyBreaking boats and minecarts
hanging.placeHanging item frames and paintings
hanging.breakTaking down item frames and paintings
trample.cropTrampling farmland, by a player (quiet, like a pickup) or by a mob (checked as nature)
trample.turtle-eggStepping on turtle and sniffer eggs. Quiet
trample.dripleafTipping big dripleaf. Quiet

vehicle, hanging and trample are parents too, so trample everyone deny covers all three kinds.

Movement

ActionCovers
move.enterWalking, riding, flying or teleporting into the region
move.exitLeaving it the same ways
move.teleport-inArriving by teleport only: commands, plugins, ender pearls, chorus fruit, portals
move.teleport-outLeaving by teleport only

A refused walk pushes the player back to where they last stood outside (set enter.push-back = false to only stop them). Every teleport, from /home, /warp and /tpa to any other plugin, is checked against both move.enter and move.teleport-in.

Nature

Only everyone rules count here. Leave these unset and they cost nothing.

ActionCovers
world.explosion.creeperCreeper explosions
world.explosion.tntTNT and TNT minecarts
world.explosion.witherThe wither and its skulls
world.explosion.ghastGhast fireballs and other fireballs
world.explosion.bedBeds and respawn anchors exploding outside their dimension
world.explosion.crystalEnd crystals
world.explosion.breezeWind charges bursting
world.explosion.otherAny other explosion
world.fire.spreadFire spreading
world.fire.burnFire burning blocks away, and fire going out
world.fire.lavaLava setting blocks alight
world.fire.lightningLightning setting blocks alight
world.liquid.waterWater flowing
world.liquid.lavaLava flowing
world.pistonPistons pushing and pulling
world.dispenserDispensers firing
world.hopperHoppers moving items
world.grow.treeSaplings and fungi growing
world.grow.cropCrops growing
world.grow.vineVines, cave vines, weeping and twisting vines, glow lichen spreading
world.grow.sculkSculk spreading
world.grow.amethystAmethyst buds growing
world.grow.otherBamboo, chorus, kelp, sugar cane and cactus growing
world.spreadAnything else spreading: grass, mycelium, moss, mushrooms
world.decayLeaves decaying
world.formBlocks forming on their own: snow, ice, frosted ice, concrete powder hardening, lava turning to stone, cobblestone or obsidian
world.meltSnow, snow blocks, ice and frosted ice melting
world.fadeOther blocks fading on their own, such as coral dying, and farmland drying out
world.mob.endermanEndermen taking or placing blocks
world.mob.ravagerRavagers breaking crops and leaves
world.mob.witherThe wither breaking blocks as it moves
world.mob.silverfishSilverfish entering blocks
world.mob.zombie-doorZombies breaking doors
world.mob.snow-golemSnow golem trails
world.mob.otherAny other mob changing a block (sheep eating grass, foxes taking berries) and mobs breaking item frames and paintings
world.portalPortals forming
world.dragon-eggThe dragon egg teleporting
world.lightningLightning striking

High-frequency events (liquids, fire spread, growth, decay, forming, melting) can be skipped for a whole world with worlds.<world>.high-frequency = false in the config, for a world where those rules do not matter.