Equipment System - Drag-Drop Gear for Godot 4

Try it free first. Equipment Lite is a free 4-slot gear manager — test the equip/unequip loop before you buy. The full version adds drag-drop paper-doll UI, stat modifiers, set bonuses, and save/inventory integration.

Bundle and save. Equipment is in the Inventory Cluster ($14.99, 4 systems) and the RPG Toolkit ($29.99, all 8) — both cheaper than the singles. Building more than gear? The bundle pays for itself on system #2. 

---------------------------------------

Paper-doll UI, stat modifier aggregation, two-handed conflicts, drag-drop from inventory. Free Lite tier available.

Inspector-first equipment slots + stat modifiers for Godot 4.3+. Paper-doll UI, two-handed conflicts, drag-drop from Inventory, save-ready. Plugs into the RPG Toolkit - runs standalone too.

Equipment in most engines is a tangle: a custom Resource here, a paper-doll over there, a stats panel that almost agrees with the modifiers your gear lists. This addon is the simple version, done well.

**Author slots in the Inspector.** Make an `EquipmentLayout`. Add an `EquipmentSlotConfig` per slot: head, chest, weapon_main, weapon_off, rings, neck - whatever your game has. Per-slot allowed categories, paper-doll grid positions, silhouette icons. No code required.

**Author items in the Inspector.** Use the shared `ItemResource` (bundled, or the Inventory addon's). Add two keys to its `metadata`: `equip_slot` and `stat_modifiers`. The stat modifier list is just Dictionaries - `{stat, op, amount}` - so you can author hundreds without rebuilding anything.

**Paper-doll UI with drag-drop.** Drop an `EquipmentUI` Control. Drag from the Inventory addon's slots, drop on the paper-doll, equip. Right-click to unequip — items return to the bound inventory automatically. Slot-to-slot drag-swap works between two equipment views (great for transmog or loadout switchers).

**Two-handed weapons handled.** Mark an item `metadata.two_handed = true`. Mark the main-hand slot's `conflicts_with` with the off-hand slot id. The addon does the rest: auto-ejects the off-hand and blocks it until the two-hander comes off.

**Stat-modifier aggregation.** The addon collects all `stat_modifiers` from equipped items and exposes them via `get_modifier_sum(stat)`, `apply_modifiers(stat, base)`, and `all_modifiers()`. Pipe these straight into your stats panel — no Stats system required for v1. When the Stats addon ships, it subscribes to the same modifier-changed bus signal.

**Save-ready.** When the Save / Load addon is installed, equipment persists automatically. Slot mapping → item path. Loads restore by `resource_path`.

### What you get

- `EquipmentSlotConfig`, `EquipmentLayout` Resources

- `EquipmentComponent` data layer (equip / unequip / try_equip / conflicts / modifiers / clear)

- Paper-doll `EquipmentUI` + `EquipmentPaperSlot` with drag-drop and slot-to-slot swap

- Stat modifier helpers (`flat`, `percent_add`, `percent_mult`) with `apply_modifiers(stat, base)` one-liner

- Auto-equip-on-use bus hook (toggleable)

- Save-contract auto-join when Save addon is installed

- Demo: bag + paper-doll + live stats panel, 9 items including a two-handed axe and an off-hand shield

- 6 docs: quick start, slot config reference, modifiers, two-handed, integration, troubleshooting

### Requirements

Godot 4.3 or newer. Pure GDScript - no GDExtension.

### License

MIT.