Skip to content

Items & World

The Item & World module (itemworld) is uxmEssentials' toolbox of item, block, entity and environment utilities — roughly the entire EssentialsX "everything else" surface, around 65 commands, in one module. It is the largest module in the plugin.

Because it is so broad, it is built to be carved up: seven independent sub-feature groups you can enable or disable individually, per-command switches inside each group, and per-type permission opt-outs on the sharpest verbs.

The Seven Sub-Feature Groups

Every command belongs to one of seven groups. A disabled group takes all of its commands offline at once.

Group What it covers Representative commands
item-utils Give / edit / inspect held items /give, /item, /itemname, /itemlore, /enchant, /repair, /hat, /skull, /itemdb
workstations Portable crafting / utility blocks /anvil, /workbench, /enderchest, /grindstone, /loom, /smithingtable, /furnace
cleanup Tidy inventories and drops /disposal, /condense, /enderclear
powertool Bind commands to a held item /powertool, /powertoollist, /powertooltoggle
mob-entity Spawn / count / purge entities /spawnmob, /spawner, /kill, /butcher, /killall, /remove, /entitycount
time-weather Change time and weather /time, /weather, /day, /night, /sun, /rain, /thunder
admin-fun The joke / spectacle verbs /lightning, /fireball, /kittycannon, /nuke, /tree, /beezooka

Grouping follows the module's own group names

The seven group ids above (item-utils, workstations, cleanup, powertool, mob-entity, time-weather, admin-fun) are the switches in itemworld.conf. The per-command split between them mirrors those names.

What's Useful For What

Building & item work

I want to… Use
Give myself or a player an item /give, /giveall, /item, /more
Rename / re-lore / re-flag a held item /itemname, /itemlore, /itemflag
Enchant, repair or make unbreakable /enchant, /disenchant, /repair, /repairall, /unbreakable
Wear an item as a hat /hat
Look up an item, its recipe, or its id /itemdb, /iteminfo, /recipe, /showitem

Portable stations & cleanup

I want to… Use
Craft / repair / smith on the go /workbench, /anvil, /smithingtable, /grindstone
Open an ender chest or furnace /enderchest, /furnace
Throw away or compact items /disposal, /condense

Entities & environment

I want to… Use
Spawn mobs or a spawner /spawnmob, /spawner
Clear mobs from an area /butcher, /killall, /remove
Count nearby entities /entitycount
Set time or weather /time, /weather, /day, /night, /sun, /rain

Power tools

Bind a command to whatever you're holding: /powertool <command> makes the held item run that command when you use it. /powertoollist shows your bindings and /powertooltoggle switches them on and off.

Enabling & Disabling

Everything is controlled from modules/itemworld/config.conf. Disable a whole group, or leave a group on and switch off individual commands within it.

# modules/itemworld/config.conf
enabled = true

groups {
  item-utils   { enabled = true }
  workstations { enabled = true }
  cleanup      { enabled = true }
  powertool    { enabled = true }
  mob-entity   { enabled = true }
  time-weather { enabled = true }
  admin-fun    { enabled = false }   # e.g. keep the joke verbs off a serious server
}

# safety caps
give-cap = 64
more-cap = 64
max-enchant-level = 255
spawnmob-cap = 50
purge-max-radius = 200
give-audit-threshold = 64   # audit-log any /give above this amount

audit {
  # per-verb audit switches, e.g.
  # nuke = true
}

Two layers of gating

A command is available only if its group is enabled and its own per-command switch is on. On top of that, the command's permission node must be granted. A disabled group registers none of its commands at all.

Per-Type Opt-Out Nodes

Three commands accept a type, and each type is individually permissible. The parent wildcards default to true (everything allowed), so you deny by granting the specific node false:

Node pattern Restricts
uxmessentials.itemworld.give.<material> Which materials /give may hand out
uxmessentials.itemworld.enchant.<enchant> Which enchantments /enchant may apply
uxmessentials.itemworld.spawnmob.<mob> Which mobs /spawnmob may spawn

For example, set uxmessentials.itemworld.give.bedrock = false on a helper rank to let them give most items but never hand out bedrock.

Audit Logging

The abusable, destructive and admin-fun verbs are recorded to the audit log. That covers area purges (/killall, /remove, /butcher), spectacle verbs (/nuke, /lightning, /fireball, …), and large /give amounts once they cross give-audit-threshold. The audit { } block lets you turn individual verbs' logging on or off. Caps like purge-max-radius and spawnmob-cap bound how much damage a single command can do.

Permissions

Each command has its own node under uxmessentials.itemworld.* (see the command reference for the full list). Most are staff-default (op); the read-only inspection verbs (/itemdb, /iteminfo, /recipe) are self-service. Workstations add a .workstation.others node to open a station for someone else. The module's reload tier is uxmessentials.module.itemworld.

Tips & Gotchas

Whole-world purges and Folia

/killall and /remove at world scope, and /gc's entity count, do a whole-world entity scan. This is a known residual limitation under Folia and is best used with a radius rather than server-wide on very large worlds.

  • Turn admin-fun off on survival/economy servers — those verbs (/nuke, /kittycannon, /antioch) are spectacle tools, not gameplay.
  • Per-type opt-outs are the clean way to hand /give to junior staff without the risk of spawn eggs, bedrock, or command blocks.
  • The time-weather group also ships short aliases (/day, /night, /sun, /rain) gated by .time.alias / .weather.alias.

Next Steps