Constructeur d'arènes

Le constructeur (« builder ») permet de créer et d'éditer des arènes directement en jeu, sans modifier la configuration. Chaque arène est sauvegardée et apparaît immédiatement.

Ouvrir le builder

En jeu, saisir la commande :

/arena_builder

L'accès est réservé aux administrateurs. Sur VORP, il s'agit des groupes listés dans Config.Builder.adminGroups ; sur RSG, de la permission ace josk_arena.builder (voir Installation). La tablette du builder s'ouvre alors et liste les arènes existantes.

Créer une arène

1. Dans la tablette, choisir créer une nouvelle arène et lui attribuer un nom.
2. Placer les différents points de l'arène (voir le tableau ci-dessous). Pour chaque point, la tablette se masque et l'élément se place à la souris dans le monde.
3. Revenir dans la tablette et enregistrer. L'arène apparaît aussitôt sur la carte, avec son blip et son PNJ d'accueil.

Points à placer

Point	Rôle
Coins du polygone	Délimitent la zone de l'arène. Au moins 3 sont requis.
Spawn coin rouge / bleu	Points d'apparition des deux combattants.
Preview ped rouge / bleu	Emplacement « vitrine » où les combattants s'affichent avant le combat.
Caméra de combat	Vue utilisée pendant le combat.
Caméra spectateur	Vue proposée aux spectateurs.
Position du bookmaker	Emplacement d'apparition du PNJ des paris.
Point d'expulsion des intrus	Destination des joueurs qui s'introduisent dans un combat.
Position du blip / PNJ d'accueil	Entrée de l'arène : blip sur la carte et PNJ décoratif.

Commandes de placement

Pendant le placement d'un point :

Action	Touche / souris
Poser un coin du polygone	Clic (ou la touche affichée)
Retirer le dernier coin	Clic droit (ou la touche affichée)
Poser et orienter un point	Maintenir Espace / clic maintenu, puis viser avec la souris
Valider	Entrée
Annuler	Échap

Les caméras capturent automatiquement la pose de la vue libre (position + angle) au moment de la validation : orienter la caméra comme souhaité, puis valider.

Paramètres par arène

Depuis la tablette, chaque arène dispose de réglages qui surchargent la configuration globale lorsqu'ils sont renseignés (et retombent sur les valeurs par défaut sinon) :

• Combattants (roster solo / PNJ propre à l'arène)
• Récompenses
• Récompenses activées — case « Verser les récompenses ». Désactivée, l'arène fonctionne sans rémunération côté gain (combat « gratuit »). Couplée à « Verser les récompenses en accès libre » (cf. Accès libre) pour décider si les modes ouverts au public paient aussi.
• Paris (activation, mises minimum/maximum, rake, modes autorisés)
• Pari du gestionnaire — case à cocher « Autoriser le gestionnaire à parier sur sa propre arène ». Désactivé par défaut (un manager influence le résultat, donc pas de double casquette). À activer uniquement pour des contextes RP spécifiques (combats truqués, enquêtes des forces de l'ordre). Le PNJ bookmaker joue alors une mise en scène visible quand le manager pose un pari — cf. betting.md.
• Métier requis
• Gestionnaires assignés — liste de joueurs (sélectionnés par leur identifiant de personnage) autorisés à piloter cette arène en plus du métier requis. Utile pour laisser un PNJ d'écurie gérer son ring sans accorder le métier à tout le monde, ou pour partager le contrôle d'une arène entre plusieurs joueurs RP. L'un d'eux peut être marqué président de l'arène : c'est lui qui encaisse la commission des paris (cf. paris) ; à défaut, le 1er de la liste.
• Accès libre par mode — pour chaque mode (Joueur vs PNJ, PNJ vs PNJ, Royal Rumble, Duel, Tournoi), une case « Accès libre ». Activée, le mode est accessible sans passer par un gestionnaire — n'importe quel joueur peut lancer le combat depuis l'entrée. Désactivée (par défaut), seuls les gestionnaires peuvent ouvrir le mode.
• Récompenses en accès libre — case dédiée. Quand un mode est en accès libre, cette case décide si les combats gratuits versent aussi des récompenses ou non.
• Modèle du PNJ bookmaker
• Nom et sprite du blip
• Vérification du sol — case « Vérifier le sol au spawn ». Activée, les combattants sont raccrochés au sol avant de spawner (corrige les arènes avec un sol non plat). À désactiver pour les arènes YMAP qui définissent leur propre hauteur de sol.
• YMAP (sans navmesh) — case dédiée. À cocher si l'arène est un YMAP sans navmesh (les peds ne savent pas s'y déplacer normalement). Le script s'adapte : les PNJ vs PNJ démarrent au corps à corps au centre du ring (pas de scène de marche vers les coins), et les Royal Rumble restent groupés au centre avec un filet de sécurité qui rapproche le 2e finaliste s'il s'éloigne. À laisser décoché pour les arènes MLO standard. ⚠️ Cocher cette case change le comportement de combat des PNJ sur l'arène — détails et limites dans Combats.
• Activation de l'arène

Activer / désactiver

Une arène désactivée n'affiche ni blip ni PNJ et refuse l'entrée. Le bouton d'activation de la tablette permet de l'ouvrir ou de la fermer sans la supprimer.

Supprimer une arène

Le bouton Supprimer ouvre une modale de confirmation qui détaille tout ce qui va disparaître avec l'arène : tournois en cours et terminés, paris ouverts (avec leur cagnotte), historique des combats, écuries liées… Il faut recopier le nom exact de l'arène pour activer le bouton de suppression définitive. Garde-fou contre les clics distraits.

Effet en cascade :

• Tous les tournois et ligues rattachés à cette arène sont supprimés.
• Les paris en cours sont automatiquement remboursés aux joueurs.
• Les écuries liées à cette arène ont leur lien retiré (l'écurie elle-même survit — l'identité RP du gestionnaire ne dépend pas d'une arène en particulier).
• L'historique des combats et les statistiques liées sont effacés.

Dépannage administrateur

Une commande serveur unique permet de débloquer une arène coincée sans redémarrer la ressource (ce qui couperait paris et menus en cours partout sur le serveur).

L'accès requiert le groupe admin (VORP), la permission admin / god (RSG) ou la permission ace josk_arena.admin. La commande fonctionne aussi depuis la console serveur.

Voir l'inventaire des arènes

/arena_reset

Sans argument, la commande affiche toutes les arènes définies sur le serveur :

• D'abord les arènes occupées (paris ouverts, combat en cours, menu retenu) avec leur état détaillé : état des paris, cagnotte, mode de combat, arbitre (en ligne ou non), joueur détenant le menu.
• Ensuite les arènes libres, avec une étiquette [DESACTIVEE] le cas échéant.

Chaque ligne montre l'id (db1, db2...) et le nom de l'arène. Sert à trouver la cible à réinitialiser.

Réinitialiser une arène précise

/arena_reset <id|nom>

Force le reset d'une seule arène (les autres arènes qui tournent en parallèle ne sont pas touchées) :

• Rembourse les paris ouverts ou verrouillés (cagnotte rendue aux parieurs).
• Arrête le moniteur de combat côté serveur et retire les PNJ résiduels du ring.
• Libère le menu de zone si un joueur le détenait.
• Demande à chaque client de remettre à zéro le drapeau local « combat actif » pour cette arène.
• Le joueur combattant encore dans le ring (le cas échéant) est téléporté au point d'expulsion de l'arène et reçoit une notification.

L'argument accepte plusieurs formats :

Forme	Exemple
Id complet	/arena_reset db1
Numéro seul (préfixé db automatiquement)	/arena_reset 1
Nom de l'arène (insensible à la casse, sous-chaîne)	/arena_reset Saint Denis

Si plusieurs arènes portent un nom proche, la commande liste les candidats pour lever l'ambiguïté. L'action est journalisée dans la console serveur.

Cas typique : le gestionnaire qui a ouvert un combat crash en plein Royal Rumble alors qu'il reste des PNJ dans le ring. Le serveur dispose déjà de filets de sécurité (remboursement après 30 s s'il ne reste aucun joueur, détection du dernier joueur debout s'il en reste), mais /arena_reset permet à un administrateur de débloquer la situation immédiatement, sans attendre.

Étapes suivantes

• Combats — lancer un combat dans l'arène créée.
• Paris — ouvrir des paris au bookmaker.