DUXPLIMA Documentation

Grindstone, types and targets

What a grindstone takes off, how a type draws and caps an enchantment, targets and slots, and every trigger.

The grindstone

grindstone.enabled decides whether ours come off at all. Which of ours come off is the type's grindstone-removable, so a curse stays on because its type says so. The item comes out with our data consistent with what a player then reads on it.

Types

types {
  normal { name = "@content.types.types.normal.name", order = 1, format = "<value><name> <roman>", limit-per-item = -1, grindstone-removable = true }
  curse  { name = "@content.types.types.curse.name",  order = 2, format = "<bad><name> <roman>",   limit-per-item = 2,  grindstone-removable = false }
}
KeyMeaning
nameWhat a player reads for the type: Enchantment, Curse
orderWhere it sorts in a lore block and a window; lowest first
formatThe line an enchantment of this type is drawn as: <name>, <roman>, <number>
limit-per-itemHow many of this type one item may carry; -1 for no limit
grindstone-removableWhether a grindstone takes it off

Do not write <level> in a format: that is a colour role of theme.conf and the palette would eat it. Colours are roles, never hex codes. A second kind of curse, or removable curses, is an edit to this file.

Targets and slots

A target is a list of items and the slot those items are used from.

SlotFires while the item is
mainhand, offhandIn that hand
handsIn either hand
helmet, chestplate, leggings, bootsWorn there
armorWorn in any armour slot
anyAnywhere it is equipped

The shipped targets: sword (with the mace), axe, pickaxe, shovel from the main hand; bow (bow and crossbow) from either hand; helmet (with the turtle shell), chestplate (with the elytra), leggings, boots from their slot; armor from any armour slot. The item lists are yours, which is why a bow enchantment reaches a crossbow without a second enchantment. See targets.conf.

Triggers

TriggerFires when
attackThe wearer hits an entity
defendAn entity hits the wearer
killThe wearer kills an entity
deathThe wearer dies
block-breakThe wearer breaks a block
block-placeThe wearer places a block
shoot-bowThe wearer fires a bow or a crossbow
projectile-hitA projectile the wearer fired hits something
interactThe wearer right clicks
fishThe wearer catches something with a rod
moveThe wearer moves from one block to another; a turn of the head does not count

The file format also accepts periodic, a timer for an enchantment that acts while worn, but this build never fires it.

Related: Enchantment files, types.conf