⚔️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

60	2	∞	1
Built-in Modifiers	Engine Support	Item Combinations	Single File

---

📋 Table of Contents

1. 🌟 Introduction
2. ✨ Features
3. 💾 Installation
4. 🚀 Quick Start
5. 📖 Usage Guide
6. 🗃️ Modifier Database
7. ⚙️ Configuration
8. 🔄 MZ & MV Compatibility
9. 📚 API Reference
10. 💡 Examples
11. 🔧 Troubleshooting
12. 📝 Changelog
13. 💬 Support

---

🌟 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

Type	Category	Count	Examples
Prefixes	🏅 Quality	10	Sturdy, Fine, Superior, Masterwork, Flawless, Legendary
	⚒️ Material	10	Iron, Steel, Mithril, Adamantine, Crystal
	⚡ Modifier	10	Strong, Mighty, Swift, Deadly, Arcane, Blessed
Suffixes	🔥 Elemental	10	of Flames, of Frost, of Lightning, of the Storm
	🐺 Bestial	10	of the Bear, of the Wolf, of the Dragon, of the Phoenix
	👑 Legendary	10	of Power, of the Gods, of Eternity, of Devastation

🎨 Rarity System

Rarity	Color	Hex Code	Probability	Description
Common	🟢 Green	#a1e065	50%	Basic improvements
Uncommon	🔵 Blue	#0070dd	30%	Moderate bonuses
Rare	🟣 Purple	#a335ee	15%	Significant enhancements
Legendary	🟠 Orange	#ff8000	5%	Game-changing powers

🎯 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

---

💾 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

Parameter	Default	Description
Prefixes	30 defaults	Quality, Material, Modifier categories
Suffixes	30 defaults	Elemental, Bestial, Legendary categories
Global Chance	0.1 (10%)	Master probability for modifiers
Max Prefixes	3	Maximum prefixes per item (1-5)
Max Suffixes	1	Maximum suffixes per item (0-3)
Enable Debug Log	false	Show console logs for debugging
Prefix Order	quality,material,modifier	Category ordering in item names

🎲 Rarity Probabilities

Rarity	Default	Adjustable Range
Common (1)	50%	0% - 100%
Uncommon (2)	30%	0% - 100%
Rare (3)	15%	0% - 100%
Legendary (4)	5%	0% - 100%

---

🔄 MZ & MV Compatibility

✅ Feature Compatibility Matrix

Feature	RPG Maker MZ	RPG Maker MV
Plugin Loads	✅ Yes	✅ Yes
60 Built-in Modifiers	✅ Yes	✅ Yes
Plugin Commands	✅ GUI Interface	✅ Text Commands
Script Calls	✅ Yes	✅ Yes
Parameter Editing	✅ Easy GUI	⚠️ Manual JSON
Item Generation	✅ Perfect	✅ Perfect
Save/Load Persistence	✅ Yes	✅ Yes

✅ 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

🎉 [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

ID	Element	ID	Element
1	⚫ Physical	6	🟤 Earth
2	🔴 Fire	7	💨 Wind
3	🔵 Ice	8	⚪ Light
4	⚡ Thunder	9	⚫ Darkness
5	💧 Water

📊 Parameter Index

Index	Parameter	Index	Parameter
0	❤️ HP	4	🔮 MAT
1	💙 MP	5	🛡️ MDF
2	⚔️ ATK	6	⚡ AGI
3	🛡️ DEF	7	🍀 LUK

---