🎒 ED5 Carry Weight System v1.0.0
Add realistic weight and encumbrance mechanics to your RPG Maker MZ/MV game!
This plugin introduces a fully customizable carry-weight and encumbrance mechanic where items, weapons, and armor contribute to total weight. As players carry more, their movement speed slows—forcing strategy and immersion.
✨ Key Features
📊 Dynamic Weight System
• Assign weight to items, weapons, and armor
• Customizable default weights
• Support for decimals and large values
🏃 Movement Penalties
• Gradual Mode – Smooth slowdown based on weight%
• Threshold Mode – Step-based speed reductions
• Fully tweakable values
📈 Visual Feedback UI
• Sleek bar that auto-hides
• Smooth fade-in & fade-out
• Color-coded warnings
• Zero screen clutter
⚙️ Fully Customizable
• Powerful note tags for items, actors, classes, states
• Carry bonuses & weight modifiers
• Optional over-encumber behavior
🎯 Smart Display
• Only appears when weight changes
• Ideal for clean UIs
🔧 Developer Friendly
• Script calls
• Plugin commands (MZ)
• Event condition support
🎮 How It Works
Two Weight Modes
Gradual Mode (Realistic)
Speed = Base × (1 - Weight%)
Great for: survival systems, realism-focused RPGs.
Threshold Mode (Classic)
0–25% → 100% speed
25–50% → 85% speed
50–75% → 70% speed
75–100% → 50% speed
100%+ → 25% speed
(All thresholds editable!)
📝 Note Tags
Items / Weapons / Armor
<weight:5> <weight:0.5> <weight:25>
Actors / Classes / Armor / States
<carryBonus:50> <carryBonus:-20>
States Only
<weightMod:1.5> <weightMod:0.8>
💡 Usage Examples
1. Heavy Armor with Strength Bonus
<weight:15> <carryBonus:10>
Result: Net weight = 5 units
2. Cursed State (Burden)
<weightMod:2.0>
Effect: All items weigh double
3. Strong Class (Warrior)
<carryBonus:100>
4. Event Check Example
if ($gameParty.getWeightPercentage() > 75) { $gameMessage.add("You're carrying too much!"); }
🎨 UI System
Smart Auto-Hide
• Shows on weight change
• 0.25s fade-in
• Stays for 3 seconds (editable)
• Smooth fade-out
Bar Visualization
• 10 levels (0–100%+)
• Green = safe
• Orange = warning
• Red = overencumbered
🛠️ Script Calls
$gameParty.getCurrentWeight() $gameParty.getMaxCarryWeight() $gameParty.getWeightPercentage() $gameParty.isOverencumbered() $gamePlayer.getWeightSpeedMultiplier()
🎯 Plugin Commands (MZ)
• Show Weight Window
• Hide Weight Window
(Auto-shows on weight change)
⚙️ Plugin Parameters
• Base Carry Weight
• Gradual/Threshold mode
• Display duration
• Allow Over-Encumber
• Default weights
• Gold weight
🎲 Game Design Ideas
• Survival RPGs – Harsh penalties & realism
• Class identity – Warriors carry more
• Treasure runs – Heavy loot slows movement
• Cursed dungeons – Weight modifiers
• Pack mules – Temporary carriers
• Weight puzzles – Be heavy or light
📦 Included
✔ ED5_CarryWeight.js
✔ Full documentation
✔ Example note tags
✔ MV & MZ compatible
🔧 Installation
Download plugin
Place in js/plugins/
Activate in Plugin Manager
Adjust parameters
Add note tags
Play!
🤝 Compatibility
✔ MZ & MV
✔ Works with most inventory plugins
⚠ Some movement plugins may require load order adjustments
📞 Support & Updates
Created by ED5 (Chigoox)
🌐 Website: chigoox.itch.io
❤️ Patreon: patreon.com/chigoox
Bug reports → Itch.io comments
Feedback always welcome!
📜 License
✔ Free for commercial & non-commercial
✔ Modifiable for your game
❌ Do not resell the plugin
🔮 Planned Updates
• Weight reduction for stackable items
• Bag/Container system
• Mount/vehicle bonuses
• Weight breakdown UI
• More UI customization
🎉 Thank You!
Your support helps ED5 create more powerful RPG Maker tools.
If you enjoy this plugin, please rate, comment, and share!