Ce qu'il vous faut
| Élément | Obligatoire | Remarque |
|---|---|---|
| Un serveur FiveM récent (Lua 5.4) | oui | |
| La clé de votre serveur | oui | Elle commence par ock_. Vous l'obtenez sur la page Serveurs. |
| ESX, QBCore ou QBox | non | Sans framework, le jeu s'ouvre avec la commande /chi. |
| ox_inventory (ou l'inventaire de votre framework) | non | Pour l'objet « Console Chiverse ». |
| lb-phone, lb-tablet | non | L'application s'y ajoute toute seule. |
| ox_target ou qb-target | non | Pour viser un chi « à l'œil », en plus de la touche E. |
| ox_lib | non | Pour les notifications ; sinon celles du jeu sont utilisées. |
Installation en cinq étapes
Copiez le dossier omega_chi dans vos ressources. Ne le renommez pas : l'objet et les exports portent ce nom.
Ouvrez config_server.lua et renseignez l'adresse du central et votre clé :
ServerConfig = {
ApiUrl = 'https://api.chiverse.eu',
ApiKey = 'ock_votre_cle',
}Ajoutez ensure omega_chi à votre server.cfg, après votre framework, votre inventaire et votre téléphone.
Redémarrez le serveur. La console doit afficher [omega_chi] relié au serveur central.
Essayez en jeu avec /chi. Tant que Config.TestMode = true (dans config.lua), seuls les administrateurs y ont accès ; passez-le à false pour ouvrir le jeu à tous.
config_server.lua n'est lu que par le serveur : la clé n'est jamais envoyée aux joueurs. Ne la publiez pas, et retirez-la avant de transmettre le dossier à quelqu'un d'autre.
L'objet « Console Chiverse »
Le joueur utilise l'objet depuis son inventaire et la console s'ouvre, comme avec /chi. Avec ox_inventory, collez ce bloc dans ox_inventory/data/items.lua :
['chi_console'] = {
label = 'Console Chiverse',
description = 'Une console portable pour capturer, élever et faire combattre vos chi.',
weight = 300,
stack = false,
close = true,
client = {
image = 'chi_console.png',
export = 'omega_chi.useConsole',
},
},
Copiez ensuite install/chi_console.png dans ox_inventory/web/images/, puis redémarrez ox_inventory. Pour ESX sans ox_inventory et pour QBCore, les lignes à ajouter sont dans le fichier README.md de la ressource.
Config.RequireItem = true : la commande et la touche demandent alors de posséder l'objet. L'application du téléphone reste accessible sans lui.
Comment les joueurs y accèdent
| Accès | Détail |
|---|---|
| Commande | /chi ouvre la console. Une touche peut être associée dans les réglages du jeu. |
| Objet | « Console Chiverse », voir plus haut. |
| lb-phone, lb-tablet | Application ajoutée automatiquement. |
| Dans le monde | Touche E près d'un chi ou d'un lieu, ou visée « à l'œil ». |
Discret par défaut. Un joueur qui n'a jamais ouvert Chiverse ne voit rien : ni repères, ni chi, ni attaques. Le jeu s'active pour lui à sa première ouverture. Ensuite, /chiveille ou le bouton lune masque tout et le réaffiche, et Plus > Affichage en jeu règle chaque élément un par un. Pour tout afficher dès la connexion, mettez Config.StartAsleep = false.
Les lunettes
En activant le jeu, le joueur met ses lunettes : un geste, des lunettes sur le visage et un filtre léger à l'écran. C'est à travers elles qu'il voit les chi et les compagnons des autres dresseurs. En veille, il les retire.
Dans Config.Glasses : male et female donnent le modèle de lunettes des personnages « freemode ». Choisissez-les dans votre menu de vêtements ; drawable = -1 garde les lunettes du personnage. filter = '' retire le filtre de l'écran, enabled = false retire les lunettes pour tout le monde.
Ce que vous réglez
Vous vous connectez à votre espace serveur avec la clé de votre serveur.
| Vous pouvez | Détail |
|---|---|
| Masquer du contenu officiel | Décochez une zone ou un lieu : il disparaît chez vous seulement. |
| Créer vos zones | Emplacement, rayon, nombre de chi. Choisissez un modèle : la zone officielle dont la vôtre reprend les chi et les niveaux. |
| Poser des sources, des refuges et des ranchs | 20 lieux au plus. |
| Choisir le mode des zones | Automatique : zones officielles plus les vôtres. Personnalisées : uniquement les vôtres. |
| Vous retirer d'un événement | Page Événements. |
En jeu, /chipos (administrateurs) affiche vos coordonnées pour créer une zone ou un lieu. Pour que le jeu reste équitable entre les serveurs, vous ne choisissez pas les chi ni les niveaux d'une zone, et vous ne créez ni donjon ni arène.
Boutique
Les packs se vendent sur votre boutique Tebex. Votre stock de packs est prépayé : chaque livraison le décompte, et une livraison sans stock est refusée. Commande à mettre dans le paquet Tebex (exécution « quand le joueur est en ligne ») :
chi_grant {sid} sceaux_parfaits_5 {transaction}
Les objets achetés sont liés au compte du joueur : ils ne s'échangent pas. Votre boutique doit respecter les règles de la plateforme FiveM : pas de monnaie virtuelle vendue contre de l'argent réel, pas de contenu aléatoire payant.
En cas de souci
| Ce que vous voyez | Ce qu'il faut regarder |
|---|---|
aucune clé dans config_server.lua | ApiKey est vide. |
le serveur central ne répond pas (401) | La clé est fausse ou a été remplacée. |
le serveur central ne répond pas (0) | L'adresse ApiUrl est fausse, ou le central est injoignable depuis votre machine. |
/chi répond « pas disponible » | Config.TestMode est à true et vous n'êtes pas administrateur. |
| Un joueur ne voit ni repères ni chi | Il n'a jamais ouvert le jeu, ou il est en veille (/chiveille). |
| Les chi apparaissent la tête en bas | Config.WorldSprites.flipV = true. |
| Baisse de performance près des zones | Baissez Config.WorldSprites.max, ou passez enabled à false. |
| Les lunettes ne vont pas avec vos tenues | Changez Config.Glasses.male / female, ou mettez drawable = -1. |
| L'objet n'ouvre rien | Vérifiez le nom chi_console et la ligne export = 'omega_chi.useConsole'. |
Mises à jour
Les nouveaux chi, lieux, quêtes, événements et réglages arrivent par le central : vous n'avez rien à faire. Seule une nouvelle version de la ressource demande de remplacer le dossier ; gardez alors votre config.lua et votre config_server.lua. Les nouvelles versions sont annoncées sur la page Nouveautés.