DUXPLIMA Documentation

End rules

The rules that decide what kind of fight happens in the event world, and the block and item blacklists.

While an event runs, the plugin changes how the event world behaves. Each rule is independent, and together they decide what kind of event you are running.

end-rules:
  disablePvP: true
  disableDamage: true
  disableCrystalDamage: true
  keepInventory: true
  announceAdvancements: false
  showDeathMessages: false
  generateStructures: false
  disableDragonEgg: true
  disablePickups: false
  disableBlockBreak: false
  disableItemDrop: false
  disableBrokenBlockDrops: false
  disableBlockPlace: false
  disableBreathPickup: false
  disablePotions: false
  disableElytra: false
  disableDragonDestroy: false
  disableCrystalDestroy: false
  disableEndermanGrief: false

What the defaults mean

The shipped settings make a co-operative fight with no risk: nobody can hurt anybody, nobody takes damage, and nobody loses items. Everyone is there to damage the dragon and climb the leaderboard.

That removes every reason for the event to turn into an argument. A fight where players can kill each other for the last hit is a different event, and one to turn on deliberately.

The rules

RuleWhen true
disablePvPPlayers cannot hurt each other, arrows and other projectiles included
disableDamagePlayers in the event world take no damage at all, from the dragon or anything else
disableCrystalDamageEnd crystal explosions do not hurt players
keepInventoryPlayers keep their items when they die in the event
announceAdvancementsAdvancements are announced in chat. false hides them
showDeathMessagesDeath messages are shown. false hides them
generateStructuresEnd cities generate in a generated event world. false keeps them out
disableDragonEggNo dragon egg appears when the dragon dies
disablePickupsPlayers cannot pick items up
disableItemDropPlayers cannot drop items
disableBlockBreakPlayers cannot break blocks
disableBrokenBlockDropsBlocks players break drop nothing
disableBlockPlacePlayers cannot place blocks or empty buckets
disableBreathPickupPlayers cannot use glass bottles, so dragon's breath cannot be collected
disablePotionsPlayers cannot drink or throw potions
disableElytraPlayers cannot glide with an elytra
disableDragonDestroyThe dragon does not break the blocks it flies through
disableCrystalDestroyEnd crystal explosions do not break blocks
disableEndermanGriefEndermen do not pick up or place blocks

announceAdvancements, showDeathMessages and generateStructures read the other way round from the disable rules: they are on when true. These three, and keepInventory, are applied when the plugin generates or copies the event world; a type: VANILLA world keeps its own game rules. See Worlds.

The rules about items, blocks, potions and gliding apply to players in the event. Staff in the event world without joining are not held to them.

Rules worth thinking about

disableDragonEgg: true. Three events a day would put three eggs a day into the economy, and the egg stops being a trophy within a week. Give it as a first-place reward in rewards.yml instead, as the default rewards do.

disableDamage: true. With this on, the dragon's damage-modifier does nothing. Turn it off before tuning damage, and keep keepInventory: true if dying should not cost players their gear.

Dying leaves the event. A player who dies is out of the event and comes back through the entrance, paying again if price-required-for-every-join is on. With damage on, a death costs more than the items.

disableBlockPlace. Left off, players build up to reach the dragon, which is part of the vanilla fight. If you only want to stop certain blocks, use block-blacklist instead.

disableElytra: false gives anyone with an elytra the flight that is otherwise a permission. Set it to true unless your arena allows for that.

disableDragonDestroy: false lets the dragon carve up the arena. Harmless in a world that is rebuilt before every event; not harmless in a type: VANILLA world, which is kept.

Block and item blacklists

block-blacklist:
  - "*_BED"
  - "TNT"

item-blacklist:
  - "MACE"
ListEffect on players in the event
block-blacklistThese blocks cannot be placed, even with disableBlockPlace: false. LAVA and WATER also stop the buckets
item-blacklistThese items cannot be used, and hitting with one in the main hand does nothing

Write material names in capitals. A * at the start or the end matches the rest of the name: *_BED covers every bed colour, NETHERITE_* every netherite item.

Beds and TNT are blocked by default because both explode in the end. The mace is blocked because its damage grows with the distance fallen, and in a dragon fight that distance has no limit.

Blacklisting what breaks the fight is better than turning building off entirely: the list stays short, and the parts of the fight that work stay as they are.