This resource provides a comprehensive status system designed to replace built-in framework statuses with more depth and flexibility. It handles a variety of player flags, a buff and debuff system, and persistent player position saving. Created to integrate with the BOII framework, however this is also adaptable for use with other frameworks.
- Statuses: Manage player-specific statuses with defaults including health, armor, hunger, thirst, stamina, oxygen, hygiene, and stress.
- Flags: Set and manage player flags. Defaults include dead, handcuffed, wanted, jailed, safezone, inside, and grouped.
- Injuries Tracking: Set and track specific body part injuries.
- Buffs & Debuffs: Comprehensive system for applying and managing temporary effects on players.
- Position Tracking: Automatically saves and stores players last known location.
oxmysql
boii_utils
- Downloading
boii_utils
:
- Download the utility library from one of our platforms;
- Edit
client/config.lua
&server/config.lua
:
- Set your framework choice under
config.framework
- Set your notifications choice under
config.notifications
Any other changes to the configs you wish to make can also be made.
- Customisation:
- Customise
client/config.lua
&server/config.lua
- Installation:
- Drag and drop
boii_statuses
into your server resources - Add
ensure boii_statuses
into yourserver.cfg
ensuring it is placed afterboii_utils
- Restart server:
- Once you have completed the above steps you are ready to restart your server and test out the script.
- Add the following export into your framework.
-
Typically you would want to add this into your player joined event if applicable or somewhere within a player object.
-
Export
exports.boii_statuses:init(player.source)
- Example usage
RegisterNetEvent('boii:player_joined', function(player)
exports.boii_statuses:init(player.source)
end)
- If this has been added correctly a status object will be created on players when they join the server.
- This resource is built to be flexible and should integrate well with other frameworks with minimal adjustments.
- Always ensure you are using the latest version of
boii_utils
to avoid compatibility issues. - You can intergrate this system with any hud of your choice, however currently this is up to you to figure out. Documentation for this will be added in time.
Contributions are welcome! If you'd like to contribute to the development of this resource, please fork the repository and submit a pull request or contact through discord.