Personnalisation
Presque tout se trouve dans un seul fichier, config.lua. Les deux fichiers de bridge et les locales sont également ouverts.
Quel fichier gère quoi
Section intitulée « Quel fichier gère quoi »| Fichier | Ce qu’il gère | Ouvert ? |
|---|---|---|
config.lua | Langue, devise, interaction, limite de placement, et chaque borne fixe avec son prix | Oui |
locales/*.lua | Les invites, notifications et libellés de target | Oui |
bridge/client_bridge.lua | Détection du framework, lecture de l’argent, notifications, texte d’aide et zones ox-target / qb-target / drawtext | Oui |
bridge/server_bridge.lua | Prélèvement et versement d’argent ou de jetons, noms et identifiants de personnages, notifications et items de borne utilisables | Oui |
items/ | Définitions d’items pour ox, qb et ESX, et icônes dans items/images/ | Oui |
ui/ | Le menu de borne et les sept jeux, un dossier par jeu dans ui/games/ | Non escrowed |
client/data.lua | Position de la caméra et de l’écran pour chaque modèle de borne | Escrowed |
mic_arcade_props/ | Les modèles de bornes et le moteur de rendu d’écran | Assets seuls |
Général — config.lua
Section intitulée « Général — config.lua »| Option | Ce qu’elle fait | Par défaut |
|---|---|---|
Config.Locale | Quel fichier de locales/ est utilisé | 'en' |
Config.PaymentType | Ce que coûte une partie : cash, bank, both ou item | 'item' |
Config.PaymentItem | L’item utilisé comme monnaie quand PaymentType est item | 'arcade_coin' |
Config.Interaction | ox-target (avec un tiret), qb-target ou drawtext | 'ox-target' |
Config.MaxArcadesPerPlayer | Combien de bornes posées un personnage peut avoir en même temps | 3 |
Types de paiement
Section intitulée « Types de paiement »| Valeur | Ce qui se passe |
|---|---|
cash | Payé en liquide (sur ESX, le compte money) |
bank | Payé depuis le compte bancaire |
both | Cash d’abord ; s’il n’y en a pas assez, le reste vient de la banque |
item | Payé en Config.PaymentItem, un item par unité de prix |
La même devise est utilisée pour les mises et les gains de DuoFight.
Bornes et prix — Config.Arcades
Section intitulée « Bornes et prix — Config.Arcades »Une entrée par modèle de borne. Chaque entrée a un Price et, facultativement, plusieurs positions fixes (vec4 avec x, y, z et cap/heading) — une borne apparaît à chacune d’elles.
| Borne | Modèle | Jeu | Prix | Fixe par défaut |
|---|---|---|---|---|
| DuoFight | mic_arcade_duofight | Combat à deux joueurs, ou contre l’ordinateur | 0 | Non (commenté) |
| Alien | mic_arcade_alien | Alien | 100 | Non (commenté) |
| Breakout | mic_arcade_brick | Breakout | 100 | Non (commenté) |
| Pixel | mic_arcade_pixel | Pixel | 100 | Oui |
| Race | mic_arcade_race | Race | 100 | Oui |
| Tower | mic_arcade_tower | Tower | 100 | Oui |
| Road | mic_arcade_road | Road | 100 | Oui |
- Pour ajouter une borne fixe, ajoutez une position à la liste sous ce modèle. Placez-vous à l’endroit désiré, relevez vos coordonnées et votre cap, et inscrivez-les.
- Pour en retirer une, supprimez ou commentez sa position. Le
Prices’applique toujours aux bornes posées de ce modèle. - Un prix de
0rend la borne gratuite. - L’origine de la borne Breakout est plus basse que les autres — la position Breakout fournie est environ 0.7 plus basse sur l’axe z que ses voisines. Faites de même lorsque vous en ajoutez une.
Le Price correspond également au tarif prélevé par une borne posée de ce modèle.
Bornes posées par les joueurs
Section intitulée « Bornes posées par les joueurs »Un item de borne (arcade_alien, arcade_race…) lance le placement :
| Touche | Ce qu’elle fait |
|---|---|
| Regarder autour | Déplace la prévisualisation selon la vue |
| Molette de la souris | Fait pivoter la borne |
| E | Place la borne et consomme l’item |
| ESC / Retour | Annule ; vous conservez l’item |
Le propriétaire — et uniquement le propriétaire — a accès à l’option Pick Up Arcade dessus (avec drawtext, la deuxième touche indiquée dans l’invite). Ramasser la borne redonne l’item. Une machine en cours d’utilisation ne peut pas être ramassée.
Config.MaxArcadesPerPlayer compte les bornes qu’un personnage a actuellement déployées.
Mises DuoFight
Section intitulée « Mises DuoFight »Sélectionner deux joueurs sur DuoFight demande une mise : 1, 5, 25, 50 ou 100, dans votre devise. L’hôte la paie et attend devant la machine ; le joueur suivant qui utilise la machine se voit proposer le match et paie la même mise pour le rejoindre.
| Résultat | Ce qui se passe |
|---|---|
| Victoire | Le vainqueur reçoit les deux mises |
| Égalité | Chaque joueur récupère sa mise |
| Un joueur part en plein match | Il déclare forfait : l’autre joueur gagne les deux mises |
| L’hôte s’en va avant qu’un joueur rejoigne | Le match est annulé ; la mise de l’hôte n’est pas remboursée |
| Un joueur se déconnecte | Le match est annulé, sans versement |
Classements
Section intitulée « Classements »Chaque jeu sauf DuoFight enregistre le meilleur score de chaque personnage dans mic_arcade_leaderboard et affiche le top dix sur la borne. Les noms correspondent au nom de personnage de votre framework. Pour réinitialiser un classement, videz cette table (ou les lignes correspondant à un jeu) pendant que le serveur est arrêté.
Dix langues sont fournies dans locales/ : en, es, fr, de, it, pt, nl, ja, ru, zh. Réglez Config.Locale sur le code désiré.
Pour en ajouter une, copiez locales/en.lua vers un nouveau fichier nommé selon votre code, remplacez Locales['en'] par votre code, traduisez la partie droite de chaque ligne et définissez Config.Locale. Une clé manquante s’affichera sous la forme Translation [xx][key] does not exist — il n’y a pas de bascule automatique vers l’anglais.
Les fichiers de locale couvrent ce qui s’affiche dans l’univers du jeu : libellés de target, invites d’aide et notifications. Les textes à l’intérieur des jeux font partie de ui/games/.
Le bridge
Section intitulée « Le bridge »| Fichier | Ce qu’il couvre |
|---|---|
bridge/client_bridge.lua | Détection du framework, affichage de l’argent ou des jetons au joueur, Bridge.Notify, texte d’aide, et zone d’interaction sur chaque borne pour ox-target, qb-target ou drawtext |
bridge/server_bridge.lua | Détection du framework, prélèvement et versement d’argent ou d’items (Bridge.RemoveMoney, Bridge.AddMoney), items de borne, nom et id du personnage, notifications serveur et liste des items utilisables |
Une ressource de notifications différente : modifiez Bridge.Notify dans le fichier client et Bridge.ServerNotify dans le fichier serveur. Les messages d’argent insuffisant sont envoyés depuis Bridge.RemoveMoney.
Une ressource de target différente : Bridge.RegisterArcadeInteraction et Bridge.RemoveArcadeInteraction dans le fichier client sont les seuls endroits où le target est manipulé.
Un autre inventaire : les jetons et les items de bornes sont vérifiés et retirés via les fonctions joueur natives du framework dans server_bridge.lua. Pointez Bridge.RemoveMoney, Bridge.AddMoney, Bridge.RemoveSpecificItem, Bridge.AddSpecificItem et Bridge.GetMoney vers votre inventaire s’il ne répond pas à celles-ci.
Un nouvel item utilisable pour une borne : la table UsableArcades en bas de server_bridge.lua associe chaque item à son modèle de borne.