[RELEASE] B2_Dogtags System

[RELEASE] B2_Dogtags System for FiveM

Introduction

We are excited to release the Dogtag System for FiveM servers! This resource enhances role-playing experiences by adding immersive dogtags for players. Compatible with QBCore and QBox frameworks, it supports both qb-inventory and ox-inventory systems.

Features

• Player’s Name on Label: Displays the player’s name prominently on each dogtag.
• Gang Rank in Description: Includes the player’s gang rank in the dogtag description.
• Gang-Specific Dog Tags: Drops the correct gang-specific tag upon a player’s death.
• Drop Mechanism on Death: Dogtags drop at the player’s death location.
• Pick-Up Availability: Dogtags are available for other players to pick up after the deceased player respawns.
• Inventory Compatibility: Supports both qb-inventory and ox-inventory systems.
• Optional Police and Civilian Dogtags: Configurable options for police and civilian dogtags.

Item in Bag Inventory only available for Ox. QB-Inventory does not seem to support custom drops like this. QB-Inventory works by pressing E on the bag, and it gives you the item.

Installation

1. Purchase, Download and Extract the Resource

   Purchase & download the dogtag system resource and extract it into your resources directory. Ensure the folder is named b2_dogtags.

2. Add the Resource to Your Server

   Open your server.cfg and add the following line to ensure the resource starts with your server:

   ensure b2_dogtags
   

3. Configure the Resource

   Open the config.lua file in the b2_dogtags directory and configure it according to your server’s needs.

4. Configure Item Images

   Place custom item images in the appropriate inventory’s images directory.

   • For ox_inventory, place images in ox_inventory/web/images.
   • For qb-inventory, place images in qb-inventory/html/images.

5. Add Items to Inventory

   Ensure dogtag items are defined in your inventory script.

   • For ox_inventory, add item definitions to data/items.lua.
   • For qb-inventory, add item definitions to shared/items.lua.

6. Database Configuration

   Ensure your database is configured correctly with the players table structure.

7. Testing

   • Restart your server.
   • Ensure the resource starts correctly without errors.
   • Test the dogtag drop and pick-up functionalities in-game.

8. Troubleshooting

   • Check server and client console logs for errors.
   • Ensure configurations and item definitions are correctly set up.
   • Enable debugging in config.lua for detailed logs.

For detailed installation steps, refer to the Installation Guide or the GitBook Docs

Configuration

Configure the script by editing the config.lua file:

Config = {}

Config.Framework = 'qb' -- 'qb' or 'qbx'
Config.Inventory = 'qb-inventory' -- 'qb-inventory' or 'ox_inventory'
Config.NotifyScript = 'b2_notify' -- 'b2_notify' or 'ox' or 'qb_notify' or 'qbx_notify'

Config.GangTags = {
    ['gang1'] = 'tag_gang1',
    ['gang2'] = 'tag_gang2',
    -- Add more gangs and their corresponding tags - these should be the same as in the gangs.lua file
}

Config.DropOnDeath = true -- Enable or disable the drop mechanism on death
Config.PickUpAvailability = true -- Enable or disable the pick-up availability
Config.Debugging = true -- Enable or disable debugging

Config.CivPlayersDropTags = false  -- Enable or disable the drop of tags when a civilian player dies - false means only gang members will drop tags
Config.PoliceDropTags = true -- Enable or disable the drop of tags when a police officer dies - done via Job
Config.PoliceJob = 'police' -- Define the police job name

Usage

Once installed and configured, the Dogtag System works as follows:

1. Player Death: When a player dies, their dogtag drops at the death location.
2. Dogtag Pick-Up: Another player can pick up the dogtag by pressing E when near it.
3. Inventory Management: The dogtag is added to the player’s inventory with metadata showing the deceased player’s name and gang rank.

Extending the Dogtag System

Adding New Gangs

To add new gangs to the Dogtag System, update the Config.GangTags table in the config.lua file:

Config.GangTags = {
    ['gang1'] = 'tag_gang1',
    ['gang2'] = 'tag_gang2',
    ['newgang'] = 'tag_newgang', -- Add your new gang here
    -- Add more gangs and their corresponding tags
}

Customizing Notifications

To customize the notification system, set the Config.NotifyScript variable in the config.lua file:

Config.NotifyScript = 'b2_notify' -- 'b2_notify' or 'ox' or 'qb_notify' or 'qbx_notify'

Ensure the chosen notification script is installed and configured on your server.

Support

For installation help and support, refer to the included documentation or reach out to us directly.

Availability

The Dogtag System is available on Tebex in both asset protected and open source formats. Choose the option that best suits your needs!

Tebex Store: B2 Scripts

Upgrade your FiveM server with our immersive Dogtag System and make every player’s death a memorable one!