⚔️ED5 Procedural Item Generator⚔️
⚔️ED5 Procedural Item Generator⚔️
⚔️ED5 Procedural Item Generator⚔️
Complete Documentation
📦 Version 2.1 🎮 RPG Maker MZ & MV 💰 Paid License 📅 October 3, 2025
By ED5 (AKA CHIGOOX)
📊 Quick Stats
602∞1Built-in ModifiersEngine SupportItem CombinationsSingle File
📋 Table of Contents
🌟 Introduction
✨ Features
💾 Installation
🚀 Quick Start
📖 Usage Guide
🗃️ Modifier Database
⚙️ Configuration
🔄 MZ & MV Compatibility
📚 API Reference
💡 Examples
🔧 Troubleshooting
📝 Changelog
💬 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
TypeCategoryCountExamplesPrefixes🏅 Quality10Sturdy, Fine, Superior, Masterwork, Flawless, Legendary⚒️ Material10Iron, Steel, Mithril, Adamantine, Crystal⚡ Modifier10Strong, Mighty, Swift, Deadly, Arcane, BlessedSuffixes🔥 Elemental10of Flames, of Frost, of Lightning, of the Storm🐺 Bestial10of the Bear, of the Wolf, of the Dragon, of the Phoenix👑 Legendary10of Power, of the Gods, of Eternity, of Devastation
🎨 Rarity System
RarityColorHex CodeProbabilityDescriptionCommon🟢 Green#a1e06550%Basic improvementsUncommon🔵 Blue#0070dd30%Moderate bonusesRare🟣 Purple#a335ee15%Significant enhancementsLegendary🟠 Orange#ff80005%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
Download the ED5_RandomizeItemStats.js file
Copy to your project's js/plugins/ folder
Open your project in RPG Maker MZ
Launch Plugin Manager (F10 or Tools → Plugin Manager)
Add the plugin to your plugin list
Enable the plugin (check the box)
Save your project
✅ Done! The plugin is ready with 60 built-in modifiers.
🎮 For RPG Maker MV
Download the ED5_RandomizeItemStats.js file
Copy to your project's js/plugins/ folder
Open your project in RPG Maker MV
Launch Plugin Manager (Tools → Plugin Manager)
Add the plugin to your plugin list
Enable the plugin (check Status: ON)
Save your project
✅ Done! All 60 modifiers are pre-configured.
🧪 Verification
Create a new event
Add a plugin command or script call
Generate a test item
Check your inventory
🚀 Quick Start
5-Minute Tutorial
Step 1: Create an Event ⏱️ 30 seconds
Open the map editor
Double-click to create a new event
Name it "Treasure Chest"
Step 2: Add Generation Command ⏱️ 1 minute
For RPG Maker MZ:
Add command: Plugin Command...
Select: ED5_RandomizeItemStats
Choose: Generate Random Weapon
Set Base Weapon ID: 1
Leave categories empty for random
For RPG Maker MV:
Add command: Plugin Command...
Type: GenerateWeapon 1
For Both (Alternative - Script Call):
ED5_ProcGen.createWeapon(1, [], []);
Step 3: Test ⏱️ 1 minute
Save the event
Playtest your game (Ctrl+R)
Interact with the event
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
ParameterDefaultDescriptionPrefixes30 defaultsQuality, Material, Modifier categoriesSuffixes30 defaultsElemental, Bestial, Legendary categoriesGlobal Chance0.1 (10%)Master probability for modifiersMax Prefixes3Maximum prefixes per item (1-5)Max Suffixes1Maximum suffixes per item (0-3)Enable Debug LogfalseShow console logs for debuggingPrefix Orderquality,material,modifierCategory ordering in item names
🎲 Rarity Probabilities
RarityDefaultAdjustable RangeCommon (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
FeatureRPG Maker MZRPG Maker MVPlugin Loads✅ Yes✅ Yes60 Built-in Modifiers✅ Yes✅ YesPlugin Commands✅ GUI Interface✅ Text CommandsScript Calls✅ Yes✅ YesParameter Editing✅ Easy GUI⚠️ Manual JSONItem Generation✅ Perfect✅ PerfectSave/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:
Check Console (F8) for error messages
Enable Debug Logging in parameters
Verify Base ID exists in database
Check Global Chance isn't too low
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
IDElementIDElement1⚫ Physical6🟤 Earth2🔴 Fire7💨 Wind3🔵 Ice8⚪ Light4⚡ Thunder9⚫ Darkness5💧 Water
📊 Parameter Index
IndexParameterIndexParameter0❤️ HP4🔮 MAT1💙 MP5🛡️ MDF2⚔️ ATK6⚡ AGI3🛡️ DEF7🍀 LUK
🎉 Thank you for using ED5 Procedural Item Generator! 🎉
May your loot be legendary! ⚔️🛡️✨
Version 2.1 | Released October 3, 2025
Created by ED5 (AKA CHIGOOX)
Made with ❤️ for the RPG Maker community
