⚔️ED5 Procedural Item Generator⚔️

Complete Documentation

📦 Version 2.1 🎮 RPG Maker MZ & MV 💰 Paid License 📅 October 3, 2025

By ED5 (AKA CHIGOOX)

🌐 Visit itch.io
🌐 Patreon

📊 Quick Stats

🌟 Introduction

The ED5 Procedural Item Generator is a powerful Diablo-style loot generation system for RPG Maker MZ and MV. It allows you to create randomized weapons and armor with 60 built-in modifiers, elemental damage, status effects, and special traits.

✅ Complete Out-of-the-Box

• ✨ 60 Pre-Configured Modifiers - Ready to use immediately
• 🎯 No Setup Required - Works right after installation
• 📦 Single File - All modifiers embedded in the plugin

🏆 Professional Quality

• 🎮 Dual Engine Support - Works in both MZ and MV
• 💾 Save/Load Persistence - Items survive game saves
• 📖 Extensive Documentation - You're reading it!

💪 Flexible & Powerful

• 🎨 Diablo-Style System - Quality tiers and rarity colors
• 🔧 Full Customization - Edit all modifiers via Plugin Manager
• ⚡ Advanced Features - Elements, states, traits, and more

✨ Features

📦 60 Built-in Modifiers

🎨 Rarity System

🎯 Advanced Features

• ✅ Element Support - 9 elemental types (Fire, Ice, Thunder, Water, Earth, Wind, Light, Darkness, Physical)
• ✅ Attack States - Inflict status effects on hit (Poison, Burn, Stun, Paralyze, etc.)
• ✅ Trait System - Special abilities (Critical rate, HP regen, extra attacks, resistances)
• ✅ Stat Bonuses - All 8 parameters (HP, MP, ATK, DEF, MAT, MDF, AGI, LUK)
• ✅ Smart Naming - Ordered prefixes (Quality → Material → Modifier)
• ✅ Price Scaling - Automatic price adjustments based on modifiers
• ✅ Debug Logging - Optional console logging for development
• ✅ Save/Load Persistence - Items persist through save files

🆕 Custom Traits Feature

NEW IN v2.1! You can now add custom traits to any prefix using RPG Maker's trait codes!

What Are Custom Traits?

Custom Traits let you add ANY RPG Maker trait to equipment through prefixes. This means you can:

• Grant skill types (Magic, Special, etc.)
• Add individual skills to equipment
• Modify parameters beyond the 8 basic stats
• Add element rates, state rates, debuff rates
• And much more!

Format

code:dataId:value

Multiple traits: Separate with commas

31:2:0, 32:4:0.3, 41:10:0

Common Trait Codes

Full Trait Code Reference: See RPG Maker MZ documentation for all codes 11-44

How to Configure Custom Traits

1. Open Plugin Manager
2. Select ED5_RandomizeItemStats
3. Edit any prefix (Modifier, Material, Elemental, or State)
4. Scroll to Custom Traits parameter
5. Enter trait codes in format: code:dataId:value
6. Separate multiple traits with commas
7. Click OK to save

💡 Examples

Example 1: Mage Weapon Prefix

<strong>Name:</strong> mage
<strong>Parameters:</strong> [0,0,5,0,0,0,0,0]  (MAT+5)
<strong>Price Modifier:</strong> 1.5
<strong>Rarity:</strong> 2
<strong>Custom Traits:</strong> 35:1:0
<strong>Result:</strong> "Mage Sword"
- Grants Magic skill type
- +5 MAT
- 1.5x price

Example 2: Skill-Teaching Weapon

<strong>Name:</strong> teaching
<strong>Parameters:</strong> [2,0,2,0,0,0,0,0]  (ATK+2, MAT+2)
<strong>Price Modifier:</strong> 2.0
<strong>Rarity:</strong> 3
<strong>Custom Traits:</strong> 41:10:0, 41:11:0
<strong>Result:</strong> "Teaching Staff"
- Grants Skill 10 and Skill 11
- +2 ATK, +2 MAT
- 2.0x price

Example 3: Multi-Type Weapon

<strong>Name:</strong> versatile
<strong>Parameters:</strong> [3,0,3,0,0,0,0,0]  (ATK+3, MAT+3)
<strong>Price Modifier:</strong> 2.5
<strong>Rarity:</strong> 4
<strong>Custom Traits:</strong> 35:1:0, 35:2:0
<strong>Result:</strong> "Versatile Blade"
- Grants Magic AND Special skill types
- +3 ATK, +3 MAT
- 2.5x price
- Legendary rarity

Example 4: Pyromancer Weapon

<strong>Name:</strong> pyromancer
<strong>Parameters:</strong> [0,0,8,0,0,0,0,0]  (MAT+8)
<strong>Price Modifier:</strong> 3.0
<strong>Rarity:</strong> 4
<strong>Custom Traits:</strong> 31:2:0, 35:1:0, 41:10:0
<strong>Result:</strong> "Pyromancer Staff"
- Fire element attacks
- Grants Magic skill type
- Grants Fireball skill (Skill 10)
- +8 MAT
- 3.0x price
- Legendary rarity

Example 5: Tank Armor

<strong>Name:</strong> guardian
<strong>Parameters:</strong> [0,10,0,5,0,0,50,0]  (DEF+10, MDF+5, MHP+50)
<strong>Price Modifier:</strong> 2.0
<strong>Rarity:</strong> 3
<strong>Custom Traits:</strong> 14:4:1.0, 14:5:1.0, 11:2:0.5
<strong>Result:</strong> "Guardian Plate"
- Immune to Poison and Blind
- 50% resistance to Fire
- +10 DEF, +5 MDF, +50 MHP
- 2.0x price
- Rare

🎬 Use Cases

1. Treasure Chests

◆Control Variables: #1 = Random(1-3)
◆Conditional Branch: Variable #1 = 1
  └─ Script: create_common_loot(1, 'weapon');
◆Conditional Branch: Variable #1 = 2
  └─ Script: create_rare_loot(1, 'weapon');
◆Else
  └─ Script: create_legendary_loot(1, 'weapon');
◆Text: You found a legendary weapon!

2. Boss Drops

◆Battle Processing: Boss
◆If Win
  └─ Script: create_legendary_loot(5, 'weapon');
  └─ Script: create_rare_loot(10, 'armor');
  └─ Text: The boss dropped legendary loot!

3. Shop System

◆Script: create_random_weapon(1);
◆Script: create_random_weapon(2);
◆Script: create_random_armor(1);
◆Shop Processing: [Show all items in inventory]

4. Crafting System

◆If Party has required materials
  └─ Script: create_weapon(3, ["material", "elemental"]);
  └─ Remove crafting materials
  └─ Text: You crafted a magical weapon!

💾 Installation

🎮 For RPG Maker MZ

1. Download the ED5_RandomizeItemStats.js file
2. Copy to your project's js/plugins/ folder
3. Open your project in RPG Maker MZ
4. Launch Plugin Manager (F10 or Tools → Plugin Manager)
5. Add the plugin to your plugin list
6. Enable the plugin (check the box)
7. Save your project

✅ Done! The plugin is ready with 60 built-in modifiers.

🎮 For RPG Maker MV

1. Download the ED5_RandomizeItemStats.js file
2. Copy to your project's js/plugins/ folder
3. Open your project in RPG Maker MV
4. Launch Plugin Manager (Tools → Plugin Manager)
5. Add the plugin to your plugin list
6. Enable the plugin (check Status: ON)
7. Save your project

✅ Done! All 60 modifiers are pre-configured.

🧪 Verification

1. Create a new event
2. Add a plugin command or script call
3. Generate a test item
4. Check your inventory

🚀 Quick Start

5-Minute Tutorial

Step 1: Create an Event ⏱️ 30 seconds

1. Open the map editor
2. Double-click to create a new event
3. Name it "Treasure Chest"

Step 2: Add Generation Command ⏱️ 1 minute

For RPG Maker MZ:

1. Add command: Plugin Command...
2. Select: ED5_RandomizeItemStats
3. Choose: Generate Random Weapon
4. Set Base Weapon ID: 1
5. Leave categories empty for random

For RPG Maker MV:

1. Add command: Plugin Command...
2. Type: GenerateWeapon 1

For Both (Alternative - Script Call):

ED5_ProcGen.createWeapon(1, [], []);

Step 3: Test ⏱️ 1 minute

1. Save the event
2. Playtest your game (Ctrl+R)
3. Interact with the event
4. Check your inventory for the new item!

Step 4: Examine Results ⏱️ 2 minutes

• Name - Should have prefixes/suffixes (e.g., "Masterwork Steel Sword of Flames")
• Color - Rarity color (Green/Blue/Purple/Orange)
• Stats - Enhanced parameters from modifiers
• Effects - Possible elements, states, or traits

🎉 Congratulations! You've generated your first procedural item!

📖 Usage Guide

🔧 Basic Usage

Generate Random Weapon

ED5_ProcGen.createWeapon(baseWeaponId, prefixCategories, suffixCategories);

Parameters:

• baseWeaponId (number) - Database ID of base weapon (1-999)
• prefixCategories (array) - Categories to use for prefixes, empty [] = random
• suffixCategories (array) - Categories to use for suffixes, empty [] = random

Examples:

// Completely random
ED5_ProcGen.createWeapon(1, [], []);
// Quality prefix only
ED5_ProcGen.createWeapon(1, ["quality"], []);
// Material + Modifier prefixes, Elemental suffix
ED5_ProcGen.createWeapon(1, ["material", "modifier"], ["elemental"]);

🎯 Common Recipes

👑 Boss Loot (Legendary Items)

// High-quality legendary weapon
ED5_ProcGen.createWeapon(5, ["quality"], ["legendary"]);

🔥 Elemental Weapons

// Fire weapon
ED5_ProcGen.createWeapon(1, ["material"], ["elemental"]);

🛡️ Tank Gear

// High defense armor
ED5_ProcGen.createArmor(1, ["quality", "material"], ["bestial"]);

⚡ Speed Build

// Fast weapons - Look for "Swift" or "of Haste"
ED5_ProcGen.createWeapon(3, ["modifier"], ["legendary"]);

🗃️ Modifier Database

Complete specifications for all 60 built-in modifiers.

🏅 Quality Prefixes (10)

1. Sturdy (Common) 🟢

• Stats: +5 DEF, +3 MDF
• Price: ×1.3
• Effect: Basic defense boost

2. Fine (Common) 🟢

• Stats: +2 ATK, +2 DEF, +1 AGI
• Price: ×1.4
• Effect: Well-rounded improvement

3. Superior (Uncommon) 🔵

• Stats: +3 ATK, +4 DEF, +2 MDF, +2 LUK
• Price: ×1.6
• Effect: Solid all-around bonus

4. Masterwork (Uncommon) 🔵

• Stats: +5 ATK, +5 DEF, +3 MAT, +3 MDF
• Price: ×2.0
• Effect: Professional craftsmanship

5. Flawless (Rare) 🟣

• Stats: +6 ATK, +6 DEF, +4 MAT, +4 MDF, +2 AGI, +3 LUK
• Price: ×2.5
• Effect: Perfect construction

6. Legendary (Legendary) 🟠

• Stats: +50 HP, +20 MP, +8 ATK, +8 DEF, +6 MAT, +6 MDF, +3 AGI, +5 LUK
• Price: ×3.5
• Effect: Mythical quality

7. Pristine (Uncommon) 🔵

• Stats: +4 ATK, +5 DEF, +3 MDF, +4 LUK
• Price: ×1.8
• Effect: Mint condition

8. Artisan (Common) 🟢

• Stats: +3 ATK, +3 DEF, +2 MAT, +2 MDF, +1 AGI, +1 LUK
• Price: ×1.5
• Effect: Skilled craftsmanship

9. Exquisite (Rare) 🟣

• Stats: +5 ATK, +4 DEF, +3 MAT, +3 MDF, +2 AGI, +2 LUK
• Price: ×2.2
• Effect: Exceptional quality

10. Crude (Common) 🟢

• Stats: -2 ATK, -1 DEF
• Price: ×0.5
• Effect: Poor quality (cheap item)

ℹ️ Note: This documentation shows 10 quality prefixes. The complete database includes 30 material prefixes, 30 modifier prefixes, and all 60 suffix modifiers. View the full list in the plugin parameters!

⚒️ Material Prefixes (10)

Includes: Iron, Steel, Bronze, Mithril, Adamantine, Silver, Gold, Platinum, Obsidian, Crystal

⚡ Modifier Prefixes (10)

Includes: Strong, Mighty, Swift, Deadly, Brutal, Arcane, Blessed, Cursed, Vicious, Ethereal

🔥 Elemental Suffixes (10)

Includes: of Flames, of Frost, of Lightning, of the Storm, of the Inferno, of the Glacier, of Wind, of Earth, of Light, of Darkness

🐺 Bestial Suffixes (10)

Includes: of the Bear, of the Wolf, of the Eagle, of the Dragon, of the Serpent, of the Tiger, of the Turtle, of the Falcon, of the Lion, of the Phoenix

👑 Legendary Suffixes (10)

Includes: of Power, of the Gods, of Eternity, of Devastation, of Protection, of Haste, of Annihilation, of Wisdom, of Champions, of the Immortal

⚙️ Configuration

📝 Plugin Parameters

Access via Plugin Manager → ED5_RandomizeItemStats

🎲 Rarity Probabilities

🔄 MZ & MV Compatibility

✅ Feature Compatibility Matrix

✅ Fully Compatible! Works perfectly in both RPG Maker MZ and MV with the same feature set.

📚 API Reference

🔧 Functions

ED5_ProcGen.createWeapon(baseId, prefixCats, suffixCats)

Creates a randomized weapon and adds it to the party inventory.

Returns: Generated weapon object

var weapon = ED5_ProcGen.createWeapon(1, ["quality", "material"], ["elemental"]);

ED5_ProcGen.createArmor(baseId, prefixCats, suffixCats)

Creates a randomized armor and adds it to the party inventory.

Returns: Generated armor object

var armor = ED5_ProcGen.createArmor(1, [], ["bestial"]);

⚙️ Configuration Access

// Access runtime configuration
ED5_ProcGen.config.globalChance = 1.0;  // 100% chance
ED5_ProcGen.config.maxPrefixes = 5;     // Allow 5 prefixes
ED5_ProcGen.config.debugLog = true;     // Enable debug logging

💡 Examples

Example 1: Treasure Chest with Random Loot 💰

// Event: Treasure Chest
ED5_ProcGen.createWeapon(1, [], []);
ED5_ProcGen.createArmor(1, [], []);
$gameMessage.add("Found randomized equipment!");

Example 2: Boss Drop (Guaranteed Legendary) 👑

// Boost legendary rate temporarily
var old = ED5_ProcGen.rarityProbs;
ED5_ProcGen.rarityProbs = {1: 0, 2: 0, 3: 0.3, 4: 0.7};
ED5_ProcGen.createWeapon(5, [], ["legendary"]);
ED5_ProcGen.rarityProbs = old;

Example 3: Level-Scaled Loot ⬆️

// Better loot for higher level party
var avgLevel = $gameParty.averageLevel();
var chance = Math.min(avgLevel * 0.02, 1.0);
ED5_ProcGen.config.globalChance = chance;
ED5_ProcGen.createWeapon(1, [], []);

🔧 Troubleshooting

❌ Items Not Generating

Solutions:

1. Check Console (F8) for error messages
2. Enable Debug Logging in parameters
3. Verify Base ID exists in database
4. Check Global Chance isn't too low
5. Test with simple call: ED5_ProcGen.createWeapon(1, [], []);

🐛 Enable Debug Mode

// In Plugin Parameters
EnableDebugLog: true
// Or at runtime
ED5_ProcGen.config.debugLog = true;

🔍 Check Console Output

[ED5_ProcGen] Selected prefix: Masterwork (quality, rarity: 2)
[ED5_ProcGen] Selected suffix: of Flames (elemental, rarity: 2)
[ED5_ProcGen] Created weapon: Masterwork Sword of Flames ID: 51

📝 Changelog

**v2.3.2** (October 16, 2025)

- Fixed random prefix selection for consumable items

- Fixed save/load persistence for consumable items

- Fixed plugin command interference between different item types

- Extended delete, list, and clear commands to support consumable items

**v2.3.1** (Previous version)

- Advanced randomized loot system with prefixes, custom traits, elements, states, and consumable item support

🎉 [2.1] - October 3, 2025

Added ✨

• RPG Maker MV Compatibility - Full dual-engine support
• 60 Built-in Modifiers - Embedded in default parameters
• Enhanced Documentation - Complete guide with examples

🔄 [2.0] - September 2025

Complete Rewrite

• Suffix system with 30 suffixes
• Element support (9 types)
• Attack state system
• Full trait system
• Save/load persistence
• Fixed 16 critical bugs

📦 [1.0] - Initial Release

Basic prefix system with hardcoded modifiers

💬 Support

🌐 Online Resources

• Author's Page: https://itch.io/chigoox
• GitHub Repository: GitHub

📜 License & Terms

💰 Paid Plugin

This is a premium plugin available for purchase.

✅ What You Get

• Use in your commercial projects
• Use in your non-commercial projects
• Modify for your project's needs
• Lifetime updates and support

❌ Restrictions

• Do not redistribute or resell this plugin
• Do not share with other developers
• License is per-developer, not per-project
• Do not claim as your own work

🙏 Acknowledgments

• RPG Maker community for feedback and support
• Diablo series for inspiration
• Beta testers who found bugs
• Everyone who uses this plugin!

📊 Quick Reference Tables

🎯 Element IDs

📊 Parameter Index