Item Generator

Item Generator

Item Generator creates procedural items from material pools, tiers, names, stats, damage, defenses, sockets, and skills.

Files

• Settings: modules/item_generator/settings.yml

• Templates: items/common.yml

• Bundled resources on GitHub

Commands and permissions

• Alias: itemgenerator, itemgen
• Shared list, get, give, drop, and reload — divinity.admin
• Generator commands accept an optional material after the level and amount arguments.

Configuration and example

The common.yml template uses placeholders such as %BASE_NAME%, %GENERATOR_STATS%, and %GENERATOR_SOCKETS_GEM%. The generator section controls prefix/suffix chances and available materials.

Administrator notes

• Random pools can produce combinations that are individually valid but overpowered together. Test minimum, average, and maximum rolls.
• Generator IDs and referenced tier, stat, socket, skill, material, prefix, and suffix IDs must remain stable.
• Use fixed levels and an explicit material while testing, then test random generation after the deterministic cases pass.
• Generate large batches on staging to find invalid combinations and measure performance before connecting the generator to mob drops.

items/common.yml — bundled generator template

name: '%BASE_NAME% %prefix_tier% %prefix_material% %item_type% %suffix_tier%'
lore:
  - '%BASE_LORE%'
  - '&7Tier: %TIER_NAME%'
  - '&7Level: &f%ITEM_LEVEL%'
  - '%GENERATOR_STATS%'
  - '%GENERATOR_SOCKETS_GEM%'
  - '%GENERATOR_SOCKETS_ESSENCE%'
  - '%GENERATOR_SOCKETS_RUNE%'
unbreakable: true
item-flags:
  - '*'
tier: common
level:
  min: 1
  max: 50
generator:
  prefix-chance: 100.0
  suffix-chance: 100.0

See Modules and Commands and Permissions.