module item_generator - magemonkeystudio/divinity GitHub Wiki
The Item Generator module enables procedural item creation using flexible templates. Rather than defining individual items, you create rules, filters, and probabilities that allow the system to generate thousands of possible item variants dynamically.
This is ideal for:
- Loot tables
- Dungeon rewards
- Mob drops
- Progression-based item scaling
- Randomized crafting systems
Divinity provides a full-featured in-game GUI for editing item generator templates.
-
/itemgenerator create <id>
โ Creates a new generator with the given ID. -
/itemgenerator edit <id>
โ Opens the in-game editor for an existing generator.
Changes are saved instantly and do not require manual reloading.
Each item generator has the following editable properties:
- Editor: Name Format
- Editor: Materials
- Editor: Lore Format
- Editor: Custom Model Data
- Editor: Color
- Editor: Durability
- Editor: Unbreakable
- Editor: Prefix Chance
- Editor: Suffix Chance
- Editor: Armor Trimmings
- Editor: Item Flags
- Editor: Enchanted
- Editor: Skull Hash
- Editor: Stat Bonuses
- Editor: Minimum Level
- Editor: Maximum Level
- Editor: Tier
- Editor: Ammo Types
- Editor: Hand Types
- Editor: Damage Types
- Editor: Defense Types
- Editor: Item Stats
- Editor: Fabled Attributes
- Editor: Sockets
- Editor: Requirements
- Editor: Enchantments
- Editor: Skills
- Editor: Uses by Level
-
/itemgenerator help
โ Show help page. -
/itemgenerator create <id>
โ Create a new generator. -
/itemgenerator edit <id>
โ Open the in-game editor. -
/itemgenerator get <id> [level] [amount]
โ Get a generated item. -
/itemgenerator give <player> <id> [level] [amount]
โ Give an item to a player. -
/itemgenerator drop <world> <x> <y> <z> <id> [level] [amount]
โ Drop an item in the world. -
/itemgenerator list [page]
โ List all generator IDs. -
/itemgenerator reload
โ Reload the module.
Permission Node | Description |
---|---|
divinity.itemgenerator.edit |
Allows use of /itemgenerator edit
|
divinity.itemgenerator.create |
Allows use of /itemgenerator create
|
divinity.itemgenerator.get |
Allows use of /itemgenerator get
|
divinity.itemgenerator.give |
Allows use of /itemgenerator give
|
divinity.itemgenerator.drop |
Allows use of /itemgenerator drop
|
divinity.itemgenerator.list |
Allows use of /itemgenerator list
|
divinity.itemgenerator.reload |
Allows use of /itemgenerator reload
|
divinity.itemgenerator.preview |
Allows use of /itemgenerator preview
|
Return to: Home