VoidChar - Character System for Roleplay

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.

No performance impact

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!

VISIT Our Discord Server: https://discord.gg/VgmWPUnuT8

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

MYSQL CONFIGURATION

• Proceed to voidchar/lua/voidchar_mysql.lua and fill in your MySQL server credentials,

and set VoidChar.Config.MySQL.UseMySQL to true.

• YOU WILL NEED TO ADD VOIDLIB TO YOUR SERVER COLLECTION!
• The workshop content can be found here.

SERVER-SIDE HOOKS

SELECT CHARACTER

VoidChar.CharacterSelected

params: player, character object

DELETE CHARACTER

VoidChar.CharacterDeleted

params: player, character object

CREATE CHARACTER

VoidChar.CharacterCreated

params: player, character object

SERVER-SIDE FUNCTIONS

Set character var (player meta)

ply:SetCharacterVar(string key, any value)

GET CHARACTER VAR (PLAYER META)

ply:GetCharacterVar(string key)

RETURNS VALUE

GET CHARACTER ID (PLAYER META)

ply:GetCharacterID()

RETURNS NUMBER (unique character ID)

WHITELIST PLAYER

VoidChar.Ply.WhitelistPlayer(string sid, number job)

sid = SteamID64

job = Job Index (number [enum])

UNWHITELIST PLAYER

VoidChar.Ply.UnWhitelistPlayer(string sid, number job)

sid = SteamID64

job = Job Index (number [enum])

CHECK IF PLAYER IS WHITELISTED TO A JOB

VoidChar.Ply.IsPlayerWhitelisted(Player ply/string sid, number job, function callback)

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:

voidchar_savenpc

Chat Commands:

Permanently change the job of a character by chat command

!setcharjob name jobcommand

• Banners made by Eljack and Vamolox