SHOWCASE VIDEO
About VoidChar
Ever wanted to play multiple characters on your roleplay server? Then VoidCharacter is just right for you!
DARKRP BASED GAMEMODES SUPPORT
- bWhitelist compatibility
- ItemStore compatibility
- Vrondakis leveling system compatibility
- xAdmin compability
INTEGRATED WHITELIST SYSTEM
NEW INTEGRATED FACTION SYSTEM (UP TO 4 FACTIONS!)
- Create up to 4 factions and set available jobs for them
- Set an icon for each faction through direct img URL
- Configurable limited faction player count (so factions are balanced)
- Importing factions from bWhitelist
A MODERN AND EASY ACCESSIBLE UI
Multiple character slots
- Each character has a separate wallet, level, xp, itemstore inventory
- NEW Characters can choose bodygroups
- Checkbox for Clone ID (Auto-generated 4-digit ID, e. g. for StarWarsRP, can be as a suffix or a prefix - before name or after name)
NPCs for changing Identity
- NEW Configurable multiple NPCs (or props) for different jobs (for example a police job NPC and a crime job NPC)
- Configurable name rules (first name and last name, minimum and maximum name length, restricted words/names, etc..)
- Gives user an ability to change characters after creating
Ingame admin panel
- Edit existing character values; such as name, money, job or playermodel, of any player
- Edit whitelist for each player
Rich configuration
- Custom language support
- Adjustable character slots. You may restrict them to donators, admins, etc..
- Background music is playing via URL, so players don't need to download music
- Configurable player sequences (poses) in selection menu
- Disable Clone ID or enforce it so no need to be ticked anymore.
Non-exploitable back-end
MySQL support (MySQLOO)
More to come! The addon will be frequently updated
Need support for a specific addon? Let us know and we will be happy to add it!
Just drag and drop the voidchar folder into your addons directory.
For Example: /garrysmod/addons/voidchar
- IMPORTANT: ADD VOIDLIB TO YOUR SERVER COLLECTION FIRST!
- Main Configuration is located in voidchar/lua/voidchar_config.lua
- Configure fonts in voidchar/lua/voidchar/vgui/_fonts.lua
- Configure languages in voidchar/lua/voidchar/languages
- Configure MySQL in voidchar/lua/voidchar_mysql.lua
- Proceed to voidchar/lua/voidchar_mysql.lua and fill in your MySQL server credentials,
API Reference
DELETE CHARACTER
CREATE CHARACTER
GET CHARACTER VAR (PLAYER META)
RETURNS VALUE
GET CHARACTER ID (PLAYER META)
RETURNS NUMBER (unique character ID)
WHITELIST PLAYER
job = Job Index (number [enum])
UNWHITELIST PLAYER
job = Job Index (number [enum])
CHECK IF PLAYER IS WHITELISTED TO A JOB
job = Job Index (number [enum])
callback = Function to call after getting the result
SAVE ALL VOIDCHAR NPCS:
Chat Commands:
Permanently change the job of a character by chat command
SERVER-SIDE HOOKS
SELECT CHARACTERparams: player, character object
DELETE CHARACTER
params: player, character object
CREATE CHARACTER
params: player, character object
SERVER-SIDE FUNCTIONS
SET CHARACTER VAR (PLAYER META)GET CHARACTER VAR (PLAYER META)
RETURNS VALUE
GET CHARACTER ID (PLAYER META)
RETURNS NUMBER (unique character ID)
WHITELIST PLAYER
sid = SteamID64
job = Job Index (number [enum])
UNWHITELIST PLAYER
sid = SteamID64
job = Job Index (number [enum])
CHECK IF PLAYER IS WHITELISTED TO A JOB
ply = Player/sid = steamid string (steamid will return false if using bWhitelist)
job = Job Index (number [enum])
callback = Function to call after getting the result
RETURNS BOOLEAN
Console Commands:SAVE ALL VOIDCHAR NPCS:
Chat Commands:
Permanently change the job of a character by chat command
