Personnalisation

Chaque décision réside dans l’un de deux emplacements, et le choix dépend d’une seule question : y aurait-il un risque si un joueur le lisait ?

Emplacement	Ce qu’il contient	Qui peut le voir
shared/config.lua et shared/config/*.lua	Tout ce qui concerne le comportement du téléphone	Envoyé aux clients
shared/server_config.lua	Clés, tokens, webhooks, certificats	Serveur uniquement, jamais envoyé

Cette séparation n’est pas qu’une question de propreté. Une configuration partagée est téléchargée par chaque joueur qui se connecte, donc un token de téléversement ou un webhook Discord qui s’y trouverait deviendrait un token et un webhook accessibles à tout le monde.

---

Les fichiers, et ce que chacun décide

shared/config.lua          the item, the key, the prop, the animations, the folding
shared/config/
  apps.lua                 which apps exist, which arrive installed, which cost money
  battery.lua              whether the phone goes flat, and how fast
  boss.lua                 who counts as a boss, and what each rung may do
  calls.lua                voice, video, speakerphone, the numbers that ring a whole job
  camera.lua               photos and video, where they are uploaded, the keys
  cases.lua (in config.lua) the fourteen colours, and whether they are items
  cityid.lua               which licences this city issues
  crypto.lua               the coins, how fast they move, what the house takes
  device.lua               phones as items: backups, and what belongs to a device
  garage.lua               where vehicles come from
  mail.lua                 the domain, and who may write to everybody
  messages.lua             attachments
  music.lua                streaming, speakers, imports
  nearby.lua               how far AirDrop reaches
  properties.lua           housing
  pulse.lua                jobs, events and news, and who may post
  radio.lua                channels, and which of them a job may not have
  restrict.lua             when the phone cannot come out
  services.lua             the businesses in the directory
  social.lua               the four social apps and their limits
  wallet.lua               transfers, invoices, bills
  weather.lua              where the weather comes from
  web.lua                  the phone on a real browser

Il n’est pas nécessaire de modifier quoi que ce soit pour que le téléphone fonctionne. Chaque fichier est fourni avec des valeurs par défaut opérationnelles.

---

Les quelques choix à trancher avant que quiconque ne se connecte

Le téléphone est-il un objet que l’on peut perdre ?

Config.Device dans shared/config/device.lua. Désactivé, un téléphone appartient à un personnage et le suit indéfiniment. Activé, le téléphone est l’item : un nouvel item est un nouveau téléphone avec un nouveau numéro, et un téléphone qui change de propriétaire emporte tout son contenu avec lui.

Cela modifie la signification d’un identifiant partout ailleurs, c’est donc une décision à prendre au départ plutôt qu’une option à basculer sur une ville déjà en activité.

Quelles applications existent

Config.AppList dans shared/config/apps.lua. Trois possibilités par application :

phone     = { How = 'installed' },              -- always there
instapic  = { How = 'store', Price = 0 },       -- downloaded from the App Store
darknet   = { How = 'off' },                    -- gone: not on the phone, not in the store

Jobs et NotJobs restreignent une application à un métier ; Boss = true la réserve uniquement à la personne qui dirige une entreprise.

Quand le téléphone ne peut pas être sorti

shared/config/restrict.lua. Mort, menotté, en train de nager, en feu, en chute libre, sur une échelle — chacun avec son propre interrupteur, et chacun avec Close qui définit si un téléphone ouvert est rangé ou simplement refusé.

Deux chiffres méritent d’être connus car ils garantissent la cohérence de la règle :

Falling  = { Enabled = true, Close = true, Height = 8.0 },   -- metres of air before a fall counts
Climbing = { Enabled = true, Close = true, After  = 1.0 },   -- seconds before a climb counts

Sans eux, le téléphone se rangerait à chaque fois que quelqu’un descend d’un trottoir, car le jeu considère cela comme une chute, et traite le fait de descendre d’un muret comme une escalade.

Tombe-t-il à plat de batterie ?

shared/config/battery.lua, désactivé par défaut. Activé, la barre d’état affiche un niveau significatif, un item chargeur existe, et un téléphone déchargé ne s’ouvre pas.

Argent

shared/config/wallet.lua pour les virements et factures, shared/config/crypto.lua pour le marché. Les deux prennent le nom de compte utilisé par votre framework — bank, money, ou tout autre nom que vous lui avez donné.

---

Le fichier réservé au serveur

shared/server_config.lua — copiez shared/server_config.example.lua par-dessus et complétez ce que vous utilisez.

• Téléversements — Fivemanage ou un webhook Discord, pour les photos et notes vocales.
• Webhooks — où le téléphone signale ce qu’il souhaite transmettre.
• HTTPS — le certificat pour la partie navigateur. Voir le certificat.

Il se trouve dans server_scripts à dessein. Un client ne le reçoit jamais.

Attention

Tout ce qui se trouve dans ce fichier est une vraie clé. Avant de partager les fichiers de votre serveur avec qui que ce soit — un développeur, un hébergeur, une sauvegarde sur un espace public —, videz-le, ou transmettez le fichier .example à la place.