๐ฟInstallation
Requirements
0bug-core (Latest Version)
ESX/QBCore/QBox Framework
Default framework multicharacter tables
Installation Steps
1. Dependencies First
ensure oxmysql
ensure qb-core/es_extended/qbx_core
ensure 0bug-core
2. Resource Installation
Download
0bug-multicharacter-v2
Place in your
[0bug]
folderAdd to your server.cfg:
ensure 0bug-core
Database Setup
Keep the same players/users table that your framework has.
4. Load Order
server.cfg load order
ensure mysql-async/oxmysql
ensure es_extended/qb-core/qbx_core
ensure 0bug-core
5. Required Discord Setup
Create a Discord Bot at Discord Developer Portal
Get your Bot Token
Enable required bot permissions
Get your Discord Server (Guild) ID
Add these to server_Config.lua
Check this tutoriel and take it as an example
6. Core Configuration
Configure 0bug-core/config.lua
WIZ_CONFIG = {
Framework = "ESX", -- QBCore, QBox, ESX
MySQL = "oxmysql",
DefaultAvatar = "https://w0.peakpx.com/wallpaper/163/205/HD-wallpaper-street-fivem-gta-gta-v-roleplay.jpg",
Lang = "en", -- en, fr, es, de, pl, sv, nl, it, pt-BR, ja, zh-CN, zh-TW, ru, cs,
}
Configure 0bug-core/scriptConfig.lua
WIZ_SCRIPT_CONFIG = {
["Houses"] = {
Name = "qb-houses" -- ps-housing, qb-houses
},
["Apartments"] = {
Name = "qb-apartments" -- ps-housing, qb-apartments
},
["Clothes"] = {
Name = "illenium-appearance" -- skinchanger,qb-clothing, tgiann-clothing, bl_appearance, codem-appearance, illenium-appearance, fivem-appearance, rcore_clothing, pa_appearance, bp-clothingv4
},
["Notification"] = {
Name = "qb-core", -- qb-core, esx-notification, mythic_notify
},
}
Configure 0bug-core/server_Config.lua
WIZ_SERVER_CONFIG = {
DISCORD = {
Discord_Token = "YOUR_DISCORD_BOT_TOKEN", -- Required
Discord_Guild_ID = "YOUR_DISCORD_SERVER_ID", -- Required
Discord_Log_Webhook = "", -- Optional
}
}
Once you are done with that but you have a different Clothing or Apartments and Housing System than the ones pre-configured by us you will have to visit these paths
0bug-core/client/Apartment_Houses
0bug-core/client/Clothes
0bug-core/server/Clothes
7. Visit Script Configuration Page.
Tebex Slot Purchase Integration
1. First enable Tebex integration in your config:
Customize = {
Tebex_Buy_Slot_Enable = true,
Tebex_Buy_Slot_Command = "buySlot", -- This is the command that will be executed
}
In your Tebex store:
Create the character slot package
Go to the package settings
Choose Game Server Commands as deliverables for this package
Under "Game Command", add:
buySlot {transaction}
The {transaction} parameter will automatically be replaced with the transaction ID


When a player purchases a slot:
They will receive an email with the transaction ID
They can enter this ID in the "Extra Slot" menu in-game
The system will verify the purchase and grant the additional slot
Important Notes
Make sure your Tebex store is properly connected to your FiveM server
The command must match exactly what you set in Tebex_Buy_Slot_Command
Keep Tebex_Buy_Slot_Enable = true to allow this functionality
Verify Installation
Start your server
Create new character
Check if all features work properly
Important for ESX and QBox Users
For ESX Go to es_extended configuration and make sure you have these 2 options set to 'true'
Config.Multichar = true
Config.Identity = true
For QBox Go to client -> config.lua and make sure you have this option set to true.
useExternalCharacters = true
DATABASE FOR QBCORE
CREATE TABLE IF NOT EXISTS `players` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`citizenid` varchar(50) NOT NULL,
`cid` int(11) DEFAULT NULL,
`license` varchar(255) NOT NULL,
`name` varchar(255) NOT NULL,
`money` text NOT NULL,
`charinfo` text,
`job` text NOT NULL,
`gang` text,
`position` text NOT NULL,
`metadata` text NOT NULL,
`inventory` longtext,
`last_updated` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`citizenid`),
KEY `id` (`id`),
KEY `last_updated` (`last_updated`),
KEY `license` (`license`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci;
COMMIT;
CREATE TABLE IF NOT EXISTS `users` (
`identifier` varchar(46) NOT NULL,
`accounts` longtext,
`group` varchar(50) DEFAULT 'user',
`inventory` longtext,
`job` varchar(20) DEFAULT 'unemployed',
`job_grade` int(11) DEFAULT '0',
`loadout` longtext,
`position` varchar(255) DEFAULT '{"x":-269.4,"y":-955.3,"z":31.2,"heading":205.8}',
`firstname` varchar(16) DEFAULT NULL,
`lastname` varchar(16) DEFAULT NULL,
`dateofbirth` varchar(10) DEFAULT NULL,
`sex` varchar(1) DEFAULT NULL,
`height` int(11) DEFAULT NULL,
`skin` longtext,
`status` longtext,
`is_dead` tinyint(1) DEFAULT '0',
`id` int(11) NOT NULL AUTO_INCREMENT,
`disabled` tinyint(1) DEFAULT '0',
`last_property` varchar(255) DEFAULT NULL,
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
`last_seen` timestamp NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP,
`phone_number` int(11) DEFAULT NULL,
`pincode` int(11) DEFAULT NULL,
PRIMARY KEY (`identifier`),
UNIQUE KEY `id` (`id`),
UNIQUE KEY `index_users_phone_number` (`phone_number`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci;
COMMIT;
Last updated