🎒 ED5 Carry Weight System v1.0.0

Name: ED5 Carry Weight Plugin
Availability: InStock

Add realistic weight and encumbrance mechanics to your RPG Maker MZ/MV game!

This plugin creates an immersive inventory management system where items, weapons, and armor have weight. As players carry more items, their movement speed decreases, forcing strategic decisions about what to carry.

✨ Key Features

📊 Dynamic Weight System - Individual weight values for items, weapons, and armor with customizable defaults
🏃 Movement Penalties - Two modes: Gradual slowdown or threshold-based speed reduction
📈 Visual Feedback - Sleek auto-hiding bar UI with smooth fade animations and color-coded warnings
⚙️ Fully Customizable - Extensive note tags for items, equipment, actors, classes, and states
🎯 Smart Display - Only shows when weight changes, fades in/out smoothly, minimal on-screen clutter
🔧 Developer Friendly - Script calls, plugin commands (MZ), and conditional event support

🎮 How It Works

Weight Modes

Mode	Description	Best For
Gradual	Movement speed decreases smoothly as weight increases `Speed = Base × (1 - Weight%)`	Realistic simulations, survival games
Threshold	Speed reduces in steps at specific weight percentages	Classic RPGs, more forgiving gameplay

Default Threshold Settings

0-25% weight: 100% speed (no penalty)
25-50% weight: 85% speed (slight slowdown)
50-75% weight: 70% speed (noticeable slowdown)
75-100% weight: 50% speed (heavy burden)
100%+ weight: 25% speed (overencumbered!)

💡 Tip: All thresholds are fully customizable in the plugin parameters!

📝 Note Tags Reference

Items, Weapons, & Armor

<weight:5>          Item weighs 5 units
<weight:0.5>        Light item (half a unit)
<weight:25>         Heavy item (25 units)

Actors, Classes, Armor, & States

<carryBonus:50>     Increases max carry weight by 50
<carryBonus:-20>    Decreases max carry weight by 20

States Only

<weightMod:1.5>     Everything weighs 50% more (cursed/exhausted)
<weightMod:0.8>     Everything weighs 20% less (blessed/energized)

💡 Usage Examples

Example 1: Heavy Armor with Strength Bonus

Plate Armor Notes:
<weight:15>
<carryBonus:10>
Result: Weighs 15 units but increases carry capacity by 10
Net burden: Only 5 units!

Example 2: Cursed State

Curse of Burden State Notes:
<weightMod:2.0>
Result: All items weigh twice as much while cursed
Strategy: Remove curse or drop items!

Example 3: Strong Character Class

Warrior Class Notes:
<carryBonus:100>
Result: Can carry 100 more units than base weight
Perfect for tank/carry builds!

Example 4: Conditional Event (Overencumbered Check)

◆Script: if ($gameParty.getWeightPercentage() > 75) {
◆  Show Text: You're carrying too much!
◆  Common Event: Remove Heavy Items
◆Script: }

🎨 Visual UI System

Smart Auto-Hide Display

Shows only when weight changes - No constant clutter
Smooth fade-in animation - Appears elegantly in 0.25 seconds
3-second display duration - Customizable in parameters
Smooth fade-out animation - Disappears seamlessly

Bar Visualization

0-9% weight: Shows empty bar outline + percentage
10-19% weight: 1 green bar + percentage
20-29% weight: 2 green bars + percentage
30-39% weight: 3 green bars + percentage
...continues up to 10 bars (100%+)

Color Coding

Green: 0-74% (safe)
Orange: 75-99% (warning)
Red: 100%+ (overencumbered)

🛠️ Script Calls

Script Call	Returns	Example Use
`$gameParty.getCurrentWeight()`	Number	Current total weight (e.g., 45.5)
`$gameParty.getMaxCarryWeight()`	Number	Max capacity (e.g., 100)
`$gameParty.getWeightPercentage()`	Number	Weight as percentage (e.g., 45.5)
`$gameParty.isOverencumbered()`	Boolean	true if over 100% capacity
`$gamePlayer.getWeightSpeedMultiplier()`	Number	Current speed multiplier (e.g., 0.85)

🎯 Plugin Commands (RPG Maker MZ)

Show Weight Window: Manually display weight UI
Hide Weight Window: Manually hide weight UI

Note: The window auto-shows when weight changes, so manual commands are optional!

⚙️ Plugin Parameters

Parameter	Default	Description
Base Carry Weight	100	Starting max weight for all actors
Weight Mode	Threshold	Gradual or Threshold speed penalties
Display Duration	180 frames	How long UI stays visible (60 = 1 sec)
Allow Over-Encumber	Yes	Can carry beyond 100% (with penalty)
Default Item Weight	1	Weight for items without <weight> tag
Gold Weight	0.01	Weight per gold piece (0 = weightless)

🎲 Game Design Ideas

Survival Mode - Use gradual mode with harsh penalties. Players must decide: bring healing items or valuable loot?
Class-Based Systems - Give warriors high carry
Bonus, mages low carryBonus. Creates unique playstyles!
Treasure Hunting - Heavy treasure chests slow players. Do they take it all or make multiple trips?
Cursed Dungeons - States that increase weightMod. Players feel the burden of corruption!
Pack Mules - Add temporary party members with huge carryBonus as support characters
Weight-Based Puzzles - Create challenges where being light (fast) or heavy (strong) matters

📦 What's Included

✅ ED5_CarryWeight.js - Main plugin file
✅ Full documentation - Extensive help section
✅ Examples - Ready-to-use note tag templates
✅ Support - Compatible with MZ & MV

🔧 Installation

Download ED5_CarryWeight.js
Place in your project's js/plugins/ folder
Open Plugin Manager in RPG Maker
Activate the plugin
Configure parameters (or use defaults)
Add note tags to your items/equipment
Play and enjoy realistic weight mechanics!

🤝 Compatibility

✅ RPG Maker MZ: Fully supported with plugin commands
✅ RPG Maker MV: Fully supported
✅ Most plugins: Compatible with standard inventory systems
⚠️ Custom movement plugins: May need load order adjustment

📞 Support & Updates

Created by ED5 (Chigoox)

🌐 Website: chigoox.itch.io | https://www.patreon.com/c/chigoox
📧 Report bugs or request features through itch.io comments
💬 Feedback welcome - let me know how you use this plugin!

📜 License & Usage

✅ Free for commercial and non-commercial projects
✅ Modify to fit your game's needs
✅ Credit ED5!
❌ Do not redistribute as your own plugin

🔮 Future Updates (Planned)

🎒 Item stacking weight reduction
📦 Container/bag system integration
🐴 Mount/vehicle carry bonus
📊 Detailed weight breakdown menu
🎨 More UI customization options

Thank you for your support! 🎉

If you enjoy this plugin, please rate it and share your feedback. Your reviews help other developers discover quality tools!

ED5 Carry Weight Plugin