Inventory & Trading Engine
Server-authoritative inventory and peer-to-peer trading for Roblox
Server-authoritative inventory and peer-to-peer trading for Roblox
Overview
A production-ready inventory and trading system built for Roblox. Handles item storage with DataStore persistence, stackable items, atomic peer-to-peer trades with full rollback, and anti-exploit protection out of the box. Drop it in, register your items, and ship.
Features
- Item Registry — Define items with id, name, rarity, stacking rules, and custom metadata
- Five Rarity Tiers — Common, Uncommon, Rare, Epic, Legendary
- Stackable Inventory — Configurable max stack per item, auto-filling, 200 slots per player
- Peer-to-Peer Trading — Request, offer, confirm flow with atomic swaps
- Server-Authoritative — All logic runs server-side, clients only send RemoteEvent requests
- DataStore Persistence — Autosave, shutdown-safe saves, retry with exponential backoff
- Anti-Exploit — Ownership validation, duplicate guards, trade logging, cooldowns, timeouts
- Admin Tools — Grant, revoke, inspect, and wipe inventories with role-based access
- Studio Helpers — Command-bar tools for inventory dumps and trade log audits
- Interactive Demo — Full demo place (.rbxl) with UI panel for testing everything
API Example
What's Included
- Complete source code (5 core modules + entry script)
- Configurable settings file with reference template
- Runnable demo .rbxl place file
- Demo server and client UI scripts
- Studio command-bar helper tools
- Four example scripts (basic setup, trading flow, admin, economy integration)
- Full documentation (installation, configuration, API reference, migration, FAQ)
- Structured changelog and release notes
Requirements
- Roblox Studio (latest stable version)
- Place must be published to enable DataStore persistence (falls back to in-memory in unpublished places)
- Basic knowledge of Scripts, LocalScripts, and ModuleScripts
Integration
Works standalone, or pairs with Easy Economy System for a complete shop system. Example integration script included — deducts currency on purchase, grants items atomically, rolls back on failure.
Support
- All future updates included at no additional cost
License
- Modification permitted for internal use
- Redistribution and resale prohibited
Copyright (c) 2026 LuaSystems. All rights reserved.
