Configurer tlr_core
tlr_core se règle à trois niveaux, du plus général au plus fin :
- server.cfg : clés, base de données, console web (convars, voir Installation).
- Le dossier
config/: les valeurs de départ, lisibles et modifiables (ce sont les seuls fichiers Lua non chiffrés aveclocales/, la liblib/et les données deshared/listées plus bas). - Le panel en jeu (
/tlr) et la console web : presque tout se change en direct, sans redémarrer.
La règle d'or : fichier, puis panel
- La plupart des valeurs de
config/sont des valeurs de départ : elles sont copiées en base au premier démarrage (tables vides), puis le panel fait foi. Modifier le fichier ensuite ne change plus rien pour ces éléments (banques, boutiques, coffres, maisons, salons, armes...) : changez les en jeu. - Les paramètres (
TLRConfig.Settings) et les réglages relus à chaque démarrage (métiers, activités, savoirs natifs, ranch, télégraphe, dresseur, marché noir) suivent cet ordre : valeur du cœur < fichier < modification en jeu. Dans le panel, le bouton « Revenir à la valeur du fichier » efface la modification en jeu. - Une valeur invalide n'est pas appliquée : elle est signalée dans la fenêtre du serveur, le tableau de bord du panel et
tlr_diag, et la valeur par défaut s'applique. - Après une modification d'un fichier de
config/, redémarrez la ressource (restart tlr_core) ou le serveur. - Montants toujours en centimes (
150= $1.50), poids d'objets en grammes sauf mention, coordonnées en{ x, y, z }relevées en jeu.
Gardez une copie de votre dossier config/ : une mise à jour peut livrer de nouveaux fichiers d'exemple (voir Mise à jour).
Les fichiers de config/
config/config.lua : le fichier principal
| Bloc | Rôle |
|---|---|
TLRConfig.Settings | Valeurs de départ des paramètres : nom du serveur, année de jeu, âges, nombre de personnages, profil économique (tight, medium, easy). La liste complète est dans le panel, section Paramètres. |
TLRConfig.DefaultSpawn, SpawnPoints, SpawnChecks, RespawnPoint | Point d'apparition des nouveaux personnages, lieux proposés, contrôles, réapparition après la mort. |
TLRConfig.TrainArrival | Arrivée en train des nouveaux personnages : convois, place assise, contrôleur, gares proposées. S'active ou se coupe dans le panel. |
TLRConfig.DefaultGroups | Groupes créés au premier démarrage (admin 80, moderator 40) et leurs permissions. Ensuite, gérez les dans le panel, section Permissions. |
TLRConfig.SaveInterval | Sauvegarde automatique des personnages, en minutes. |
TLRConfig.RateLimit | Limite de requêtes de l'interface par joueur (anti spam). |
TLRConfig.PlacementCatalog, PlacementStreamDistance | Modèles autorisés pour l'outil de placement (vide = tous) et distance d'affichage. |
TLRConfig.Items, StarterItems | Objets déclarés par fichier (taille en cases, poids, péremption) et objets remis à la création d'un personnage. |
TLRConfig.Jobs, JobActivities, JobServices | Modifier ou créer des métiers (grades, salaires en centimes, liste blanche, service), ajuster les activités, réglages des métiers de services (valeurs par défaut). Les 135 métiers du catalogue sont listés dans shared/jobs_catalog.lua. |
TLRConfig.Weapons, Ammo | Catalogue des armes et munitions de départ (panel, section Armes, ensuite). |
TLRConfig.Stables, HorseShop, WagonShop | Écuries, chevaux et charrettes en vente au premier démarrage. Le catalogue complet des races et robes est dans shared/horse_catalog_data.lua. |
TLRConfig.Wild | Chevaux sauvages : zones d'apparition et points de vente ou de garde. |
TLRConfig.Banks | Agences bancaires semées au premier démarrage. |
TLRConfig.Law | Ordre public : droits par métier et grade, barème des amendes, prisons. |
TLRConfig.Shops | Boutiques simples : position, horaires, objets, prix de base, rachat, stock. |
TLRConfig.Storage | Coffres posés dans le monde et maisons de départ (prix, loyer, accès). |
TLRConfig.Appearance, ClothingShops | Options de l'éditeur de personnage, prix des vêtements, magasins de vêtements. |
TLRConfig.Blackmarket (facultatif) | Surcharge des fichiers du marché noir, fusion par clé. |
Les autres fichiers
| Fichier | Rôle | Relu à chaque démarrage |
|---|---|---|
config/barber.lua | Salons de coiffure et bains publics : fauteuils, caméras, PNJ, prix. | Non (semé une fois, puis panel) |
config/blackmarket.lua | Marché noir itinérant : marchand, trajets, horaires, boutique, contrats, blips, sécurité. | Oui |
config/blackmarket_drugs.lua | Trafic de drogue : récolte, laboratoire, culture, vente aux passants, effets. | Oui |
config/blackmarket_cards.lua | Cartes de collection (144 cartes, 12 séries). | Oui |
config/blackmarket_crimes.lua | Crimes : vol à la tire, braquages, diligences, commerces, maisons, banques, fausse monnaie, avis de recherche. | Oui |
config/craftworld.lua | Décor de récolte, ferme, montures du craftworld. | Oui (certaines valeurs aussi au panel) |
config/gouvcomp_config.lua | Compagne du gouverneur (PNJ qui l'accompagne) : métier et grade requis, modèle, santé, arme, ordres, siège, lieux, blip, diagnostic (Config.Debug, Config.Logs). | Oui |
config/gouvcomp_domestics.lua | Personnel de maison du gouverneur : majordome, cuisinière, garde manger. | Oui |
config/native.lua | Savoirs natifs (amulettes, couvertures, sacs) : ajustements objet par objet de shared/native.lua. | Oui |
config/radial.lua | Roue du joueur (touche F6) : catégories, sous roues, interactions par métier, animations d'habillage. Fichier client : fonctions permises. | Oui (côté client) |
config/ranch.lua | Ranchs : espèces, besoins, prix, ranchs fixes ; ajuste shared/ranch_data.lua. | Oui |
config/saloon.lua | Saloons (recettes, comptoirs) et magasins à marchand. | Semences une fois, puis panel |
config/telegram.lua | Bureaux du télégraphe et leurs blips. | Oui |
config/trainer.lua | Parcours et lieux d'entraînement du dresseur. | Oui |
Données lisibles de shared/
Ces fichiers ne contiennent que des données (catalogues, textes, réglages) : ils sont livrés en clair pour que vous puissiez les consulter, et les ajuster si besoin. Préférez toujours config/ ou le panel quand ils couvrent le réglage : un fichier de shared/ modifié est remplacé à chaque mise à jour.
shared/*_data.lua: catalogues (apparence, animations, consommables, artisanat, pêche, chasse, herboristerie, armurerie, honneur, livre des lois, chefs d'accusation, maladies, chevaux et robes, équipement, charrettes, ranch, sièges...).shared/*_text.lua,shared/ecosystem_locale_*.lua,shared/gouvcomp_locale.lua: textes affichés.shared/ecosystem_cfg_*.lua: réglages de l'écosystème animal (espèces, zones, saisons, météo, pièges, permis de chasse...).shared/jobs_catalog.lua,shared/mining_seed.lua,shared/gouvcomp_defaults.lua,shared/native.lua.
Textes et langue : locales/
locales/fr.lua contient les messages d'erreur et textes communs. Modifiez les libellés à votre goût (gardez les clés et les %s). Une autre langue : copiez le fichier, traduisez, et remplacez la ligne locales/fr.lua dans fxmanifest.lua.
Interface : web/
Toute l'interface (HTML, CSS, JS) est lisible. Fichiers prévus pour vous :
web/loading/config.js: écran de chargement (nom, message, astuces, thème) ; images dansweb/loading/img/.web/img/items/: images des objets (aussi envoyables depuis le panel, section Objets).- Thèmes : 7 thèmes choisis dans le panel ; les couleurs sont dans
web/css/themes.css.
Après une modification de web/, redémarrez la ressource et videz le cache de RedM si l'ancienne version reste affichée.
Ce qui se règle seulement en jeu
Paramètres, permissions et groupes, métiers activés, objets, boutiques, banques, portes, zones, blips, placements, VIP, réglages des systèmes (section Réglages : chaque système a ses curseurs), carte par régions, événements. Voir le guide du panel.
Source : tlr_core/docs/CONFIGURATION.md