Item Vault Inventory Plugin for Godot 4

Build item data, drops, pickups, inventory, shops, and saves around one stable item identity.

ItemVault is a commercially licensed GDScript plugin for Godot 4.4+. Define an item once, use it in drop tables and world pickups, store it in inventory, and persist it by stable ID. Use the complete pipeline or integrate only the modules your project needs.

ItemVault 1.0.0 • Godot 4.4+ • GDScript • 2D and 3D • No required autoloads • Source included

Core Systems

• Shared item data: ItemDefinition, ItemStack, and ItemDatabase give drops, pickups, inventory, and save data the same stable identity.
• Item-aware drops and pickups: build weighted drop tables, assign preplaced pickup contents in the inspector, spawn world items in 2D or 3D, and collect them through matching event-driven collectors.
• Inventory building blocks: free-list and slot-based containers, stacking, overflow handling, weight and capacity rules, wallet currencies, typed queries, transfers, and atomic transactions with rollback.
• Versioned persistence: JSON saves use stable item IDs instead of resource paths, with a save-version guard and documented handling for removed IDs.
• Scene-owned integration: add ItemVaultRuntime where the item pipeline belongs, enable automatic collector wiring when useful, or compose the underlying services yourself. No global autoload is forced.
• Backend-neutral contract: typed commands, result codes, snapshots, and reservations support projects that need a replaceable inventory backend.

Current 1.0 Scope

2D: point spawning, shape-edge spawning, launch force, move-on-spawn, pickup collection, and pickup-to-inventory routing.

3D: point spawning, move-on-spawn, pickup collection, and pickup-to-inventory routing.

Not included in 1.0: 3D shape-edge and launch-force convenience spawners. Hotbar and equipment UI remain game-owned rather than being imposed as plugin APIs.

Included Demos and Guides

Seven scene-first demos cover:

1. JSON inventory save/load round-trip
2. Drop table and chest drops
3. Inventory transfer between containers
4. Shop buy, sell, and buyback transactions
5. 2D pickup-to-inventory routing
6. 2D point, shape-edge, and launch-force spawning
7. 3D chest drops and pickup-to-inventory routing

Each demo authors its UI hierarchy in .tscn, so you can inspect the scene before pressing Play. Eight focused guides cover item data, drop tables, runtime wiring, saves, dimension-neutral handling, and common integration questions.

Getting Started

1. Copy addons/item_vault/ to res://addons/item_vault/.
2. Enable ItemVault under Project Settings → Plugins.
3. Create ItemDefinition resources with stable IDs and optional world scenes.
4. Add ItemVaultRuntime to the scene that owns the item pipeline, then enable only the pickup and inventory routing your project needs.

Compatibility and Validation

• Godot: 4.4 or later; the compatibility matrix covers 4.4 and 4.7.1.
• Language: GDScript. No C#, Rust toolchain, or GDExtension is required to use the Godot plugin.
• Reference backend: an optional Rust reference implementation is included for teams evaluating the backend-neutral contract.
• Release evidence: 331 automated tests across 44 test files, seven interactive demos, and zero storefront-domain validation findings in the 1.0 review snapshot.

License and Support

Use and modify the covered plugin source in commercial or non-commercial games, applications, interactive media, and internal projects. Credit is not required. Redistribution, resale, or publication of the source as a standalone plugin, library, template, or competing product is not permitted. Third-party demo assets retain their own licenses.

ItemVault for Godot 4 — source included — no royalties.