Core Docs

Présentation

Kairo Core est la base de tout le reste. Il charge les joueurs à la connexion, gère leurs comptes et leur argent, applique les permissions, sauvegarde les données en base et sécurise les échanges entre le client et le serveur.

Tous les modules kairo-* passent par Kairo Core pour récupérer un joueur, débiter de l'argent ou vérifier une permission. Si tu développes tes propres ressources, utilise la même API : elles fonctionneront avec tout l'écosystème sans adaptateur.

Kairo Core est volontairement léger : il ne contient ni interface, ni métier, ni inventaire. Ce sont des modules séparés, que tu installes seulement si tu en as besoin.

Installation

1. Installe MariaDB 10.6 ou plus récent (ou MySQL 8) et crée une base vide, par exemple kairo.
2. Télécharge Kairo Core depuis « Mes achats » et place le dossier kairo-core dans resources/[kairo]/.
3. Renseigne la connexion à la base dans ton server.cfg avec la variable kairo_db (voir ci-dessous).
4. Ajoute ensure kairo-core en premier, avant toutes les autres ressources Kairo.
5. Démarre le serveur : les tables sont créées automatiquement. Le premier joueur qui se connecte reçoit son compte avec l'argent de départ défini dans la configuration.

# server.cfgset kairo_db "mysql://kairo:motdepasse@localhost/kairo?charset=utf8mb4"ensure kairo-coreensure kairo-inventoryensure kairo-hud

Configuration

Toute la configuration se trouve dans config.lua. Tu n'as jamais besoin de modifier les fichiers du cœur : les mises à jour remplacent le code, jamais ta configuration.

Les comptes d'argent sont déclarés dans Config.Accounts. Tu peux en ajouter autant que tu veux (argent sale, crypto…) : ils deviennent immédiatement utilisables avec player.money.

Les groupes associent un nom à une liste de permissions. Un joueur hérite des permissions de son groupe ; tu peux ensuite tester une permission précise avec player:hasPermission().

-- config.luaConfig = {}Config.Locale = 'fr'Config.SaveInterval = 300 -- sauvegarde auto, en secondesConfig.Accounts = {    cash  = { label = 'Liquide', start = 500 },    bank  = { label = 'Banque',  start = 2500 },    black = { label = 'Argent sale', start = 0 },}Config.Groups = {    user  = {},    mod   = { 'kairo.kick', 'kairo.spectate' },    admin = { 'kairo.kick', 'kairo.spectate', 'kairo.ban', 'kairo.money' },}

API

Les exports s'appellent avec exports['kairo-core']:Nom(...). Les fonctions serveur ne sont jamais accessibles depuis le client.

local player = exports['kairo-core']:GetPlayer(source)if not player then return endprint(player.name, player.identifier)

local target = exports['kairo-core']:GetPlayerByIdentifier(owner)if target then    target:notify('Ton véhicule a été retrouvé')end

for id, player in pairs(exports['kairo-core']:GetPlayers()) do    player.money:add('bank', 100, 'bonus')end

player.money:add('bank', 500, 'paie')

if player.money:remove('cash', 250, 'achat') then    -- donner l'objetelse    player:notify('Pas assez d\'argent', 'error')end

local bank = player.money:get('bank')

if not player:hasPermission('kairo.ban') then return end

player:notify('Virement reçu', 'success')

if not player:getMeta('mon-script:bienvenue') then    player:setMeta('mon-script:bienvenue', true)end

exports['kairo-core']:RegisterCallback('bank:balance', function(source)    local player = exports['kairo-core']:GetPlayer(source)    return player.money:get('bank')end)

local balance = exports['kairo-core']:TriggerCallback('bank:balance')print('Solde : ' .. balance)

Événements

AddEventHandler('kairo:playerLoaded', function(source, player)    print(player.name .. ' est arrivé')end)

AddEventHandler('kairo:playerDropped', function(source, reason)    print('Départ : ' .. reason)end)

AddEventHandler('kairo:moneyChanged', function(source, account, amount, balance)    -- amount est négatif pour un retraitend)

AddEventHandler('kairo:client:loaded', function(data)    print('Groupe : ' .. data.group)end)

Commandes

FAQ