https://github.com/overextended/ox_inventory
Slot-based inventory with metadata.
https://github.com/overextended/ox_inventory
esx fivem inventory ox-core
Last synced: 7 months ago
JSON representation
Slot-based inventory with metadata.
- Host: GitHub
- URL: https://github.com/overextended/ox_inventory
- Owner: overextended
- License: gpl-3.0
- Created: 2021-04-08T16:36:25.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-08T11:43:00.000Z (7 months ago)
- Last Synced: 2025-03-08T12:26:04.099Z (7 months ago)
- Topics: esx, fivem, inventory, ox-core
- Language: Lua
- Homepage: https://overextended.dev/ox_inventory
- Size: 34.3 MB
- Stars: 493
- Watchers: 36
- Forks: 758
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ox_inventory
A complete inventory system for FiveM, implementing items, weapons, shops, and more without any strict framework dependency.
## 📚 Documentation
https://overextended.dev/ox_inventory
## 💾 Download
https://github.com/overextended/ox_inventory/releases/latest/download/ox_inventory.zip
## Supported frameworks
We do not guarantee compatibility or support for third-party resources.
- [ox_core](https://github.com/overextended/ox_core)
- [esx](https://github.com/esx-framework/esx_core)
- [qbox](https://github.com/Qbox-project/qbx_core)
- [nd_core](https://github.com/ND-Framework/ND_Core)
## ✨ Features
- Server-side security ensures interactions with items, shops, and stashes are all validated.
- Logging for important events, such as purchases, item movement, and item creation or removal.
- Supports player-owned vehicles, licenses, and group systems implemented by frameworks.
- Fully synchronised, allowing multiple players to [access the same inventory](https://user-images.githubusercontent.com/65407488/230926091-c0033732-d293-48c9-9d62-6f6ae0a8a488.mp4).
### Items
- Inventory items are stored per-slot, with customisable metadata to support item uniqueness.
- Overrides default weapon-system with weapons as items.
- Weapon attachments and ammo system, including special ammo types.
- Durability, allowing items to be depleted or removed overtime.
- Internal item system provides secure and easy handling for item use effects.
- Compatibility with 3rd party framework item registration.
### Shops
- Restricted access based on groups and licenses.
- Support different currency for items (black money, poker chips, etc).
### Stashes
- Personal stashes, linking a stash with a specific identifier or creating per-player instances.
- Restricted access based on groups.
- Registration of new stashes from any resource.
- Containers allow access to stashes when using an item, like a paperbag or backpack.
- Access gloveboxes and trunks for any vehicle.
- Random item generation inside dumpsters and unowned vehicles.
## Copyright
Copyright © 2024 Overextended
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see .