Système de jeux de hasard
Le système de jeux de hasard ajoute un casino complet à EliteMobs. Les joueurs peuvent miser leurs Elite Coins sur quatre mini-jeux différents, s'endetter lorsqu'ils n'ont plus d'argent, et en subir les conséquences lorsque le Recouvreur de dettes vient frapper à leur porte. Les administrateurs de serveur peuvent configurer chaque aspect du système, des multiplicateurs de gains aux limites d'endettement.
Mise en place
Le système de jeux de hasard est accessible via des PNJ configurés spécialement. Chaque jeu et chaque affichage possède son propre type d'interaction PNJ.
Pour mettre en place un PNJ de jeu, créez un fichier de configuration de PNJ et réglez interactionType sur l'une des valeurs suivantes :
| Type d'interaction | Description |
|---|---|
GAMBLING_BLACKJACK | Ouvre le menu de mise pour le Blackjack |
GAMBLING_COINFLIP | Ouvre le menu de mise pour le Pile ou Face |
GAMBLING_SLOTS | Ouvre le menu de mise pour la Machine à sous |
GAMBLING_HIGHERLOWER | Ouvre le menu de mise pour Plus ou Moins |
Le PNJ Propriétaire de la salle de jeux n'utilise pas de type d'interaction spécial. Pour le mettre en place, créez un PNJ avec le nom de fichier gambling_den_owner.yml. L'affichage des gains de la maison apparaîtra automatiquement au-dessus du PNJ en fonction de ce nom de fichier.
Jeux
Blackjack
Les règles standard du Blackjack s'appliquent. L'objectif est de s'approcher le plus possible de 21 sans le dépasser.
Règles
- Le joueur et le croupier reçoivent chacun deux cartes.
- La deuxième carte du croupier est cachée jusqu'à ce que le joueur reste.
- Les as valent 11 ou 1 (ajusté automatiquement pour éviter de sauter lorsque c'est possible).
- Les figures (Valet, Dame, Roi) valent 10.
- Le croupier reste à 17.
- Les joueurs peuvent tenir jusqu'à 5 cartes.
Actions
| Action | Description |
|---|---|
| Hit | Tirer une carte supplémentaire. |
| Stand | Conserver votre main actuelle ; le croupier joue ensuite. |
| Double Down | Doubler votre mise, tirer exactement une carte, puis rester automatiquement. Disponible uniquement lors de votre première action (quand vous avez 2 cartes) et seulement si vous avez les moyens de doubler votre mise. |
Gains
| Résultat | Multiplicateur par défaut |
|---|---|
| Victoire normale (le total du joueur bat celui du croupier, ou le croupier saute) | 2.0x |
| Blackjack (21 avec les deux premières cartes) | 2.5x |
| Égalité (push) | 1.0x (mise rendue) |
| Défaite (le joueur saute ou le total du croupier est supérieur) | 0x (mise perdue) |
Fermeture du menu
Si un joueur ferme le menu pendant le tour du croupier, la main du croupier est jouée automatiquement et le résultat est résolu. Si un joueur ferme le menu avant de rester, la mise est perdue.
Pile ou Face
Un simple jeu à 50/50. Choisissez Pile ou Face, et la pièce décide de votre sort.
Comment jouer
- Le jeu s'ouvre avec un bouton Pile et un bouton Face.
- Cliquez sur l'un d'eux pour faire votre choix.
- Une animation de lancer de pièce se joue.
- Le résultat est affiché.
Gains
| Résultat | Multiplicateur par défaut |
|---|---|
| Bonne prédiction | 1.9x |
| Tranche (la pièce retombe sur la tranche) | 5.0x |
| Mauvaise prédiction | 0x (mise perdue) |
Le résultat « tranche »
Il y a 1 % de chance que la pièce retombe sur la tranche au lieu de Pile ou Face. Dans ce cas, le joueur gagne toujours, quel que soit son choix, et reçoit un gain de 5x sur sa mise. Un message de chat et un affichage visuel spéciaux sont montrés pour cet événement rare.
Fermeture du menu
Si un joueur ferme le menu avant de faire un choix, la mise est perdue.
Machine à sous
Faites tourner trois rouleaux et alignez des symboles pour gagner. Les symboles les plus rares rapportent davantage.
Comment jouer
- Le jeu s'ouvre avec une grille de rouleaux 3x3 et un bouton Spin.
- Cliquez sur Spin pour lancer les rouleaux.
- Chaque rouleau s'arrête tour à tour avec une animation.
- La rangée du milieu (ligne de paiement) détermine le résultat.
Symboles et gains
Chaque symbole possède un poids qui détermine sa fréquence d'apparition. Le multiplicateur de gain pour trois symboles identiques est calculé avec 100 / weight. Deux symboles identiques rapportent 25 % du gain de trois symboles identiques pour ce symbole.
| Symbole | Poids | Chance | Gain 3 symboles | Gain 2 symboles |
|---|---|---|---|---|
| Cerise | 35 | 35% | 2.86x | 0.71x |
| Citron | 28 | 28% | 3.57x | 0.89x |
| Orange | 20 | 20% | 5.0x | 1.25x |
| Cloche dorée | 10 | 10% | 10.0x | 2.5x |
| Barre d'argent | 5 | 5% | 20.0x | 5.0x |
| Lucky 7 | 2 | 2% | 50.0x | 12.5x |
Trois Lucky 7 constituent le Jackpot et déclenchent un effet visuel et sonore spécial.
Fermeture du menu
Si un joueur ferme le menu avant de lancer les rouleaux, la mise est perdue.
Plus ou Moins
Un jeu de cartes basé sur les séries. Devinez si la carte suivante est plus haute ou plus basse que la carte actuelle, et faites monter un multiplicateur. Encaissez à tout moment ou risquez le tout.
Comment jouer
- Une carte est tirée et affichée (les valeurs vont de 2 à 14, où l'As = 14).
- Devinez si la carte suivante sera plus haute ou plus basse que la carte actuelle.
- Si vous devinez correctement, votre multiplicateur augmente et la carte révélée devient la nouvelle carte actuelle.
- Vous pouvez encaisser à tout moment après au moins une bonne prédiction.
- Si vous vous trompez, vous perdez la totalité de votre mise.
- Si la carte suivante est égale à la carte actuelle, cela compte comme une défaite.
Multiplicateur de série
Chaque bonne prédiction multiplie vos gains par le multiplicateur configuré (par défaut 1.3x). Le multiplicateur se cumule :
| Série | Multiplicateur (par défaut) | Gain sur une mise de 100 pièces |
|---|---|---|
| 1 | 1.3x | 130 |
| 2 | 1.69x | 169 |
| 3 | 2.197x | 219.7 |
| 4 | 2.856x | 285.6 |
| 5 | 3.713x | 371.3 |
| ... | ... | ... |
| 12 | ~23.3x | ~2,330 |
Série maximale et encaissement automatique
La série maximale est de 12. Lorsqu'un joueur atteint 12 bonnes prédictions, il encaisse automatiquement et ses gains lui sont attribués. Cela évite les multiplicateurs incontrôlables.
Fermeture du menu
Si un joueur ferme le menu alors qu'il est en série gagnante, il encaisse automatiquement et reçoit ses gains actuels. S'il ferme le menu avant d'avoir fait la moindre prédiction, la mise est perdue.
Mises
Avant le début de chaque partie, un menu de mise est présenté au joueur pour choisir son enjeu.
Limites de mise
| Réglage | Valeur par défaut |
|---|---|
| Mise minimale | 10 |
Il n'existe pas de mise maximale configurable. Les joueurs peuvent miser autant qu'ils peuvent se le permettre (crédit du système de dette inclus).
Commandes du menu de mise
Le menu de mise propose plusieurs commandes :
- Boutons d'incrément -- Trois tailles de boutons d'augmentation et de diminution. Si le joueur possède au moins 100 pièces et n'a aucune dette, les incréments sont basés sur des pourcentages (5 %, 10 %, 25 % du solde). Sinon, des montants fixes de 10, 50 et 100 sont utilisés.
- All In -- Règle la mise sur le maximum que le joueur peut se permettre (crédit disponible inclus).
- Reset -- Réinitialise la mise au minimum.
- Play -- Lance la partie avec la mise actuelle. Actif uniquement si le joueur peut se permettre la mise.
- Cancel -- Ferme le menu sans miser.
Le menu affiche le solde actuel du joueur, toute dette existante et le crédit disponible.
Système de dette
Les joueurs peuvent miser au-delà de leur solde en s'endettant. Le casino accorde un crédit jusqu'à une limite fixe.
Fonctionnement de la dette
- Lorsqu'un joueur place une mise supérieure à son solde, le montant restant est ajouté en tant que dette de jeu.
- La dette maximale qu'un joueur peut accumuler est de 500 pièces. Cette valeur est codée en dur et n'est pas configurable.
- Les joueurs ne peuvent pas placer de mises qui pousseraient leur dette au-delà du maximum.
- Lorsqu'un joueur gagne, ses gains servent d'abord à rembourser sa dette avant d'être ajoutés à son solde.
Crédit disponible
Le crédit disponible d'un joueur est calculé ainsi : maxDebt - currentDebt. Il est affiché dans le menu de mise.
Avertissement de dette
Lorsqu'un joueur s'endette, il reçoit un message d'avertissement. Le Recouvreur de dettes peut venir le chercher tant qu'il porte une dette impayée.
Boss Recouvreur de dettes
Le Recouvreur de dettes est un custom boss qui apparaît pour traquer les joueurs endettés au jeu.
Conditions d'apparition
- Le joueur doit avoir une dette de jeu impayée.
- Une vérification périodique s'exécute toutes les 60 minutes (configurable) pour tous les joueurs connectés.
- Chaque vérification a 50 % de chances (configurable) de faire apparaître le Recouvreur de dettes pour un joueur éligible.
- Un seul Recouvreur de dettes peut être actif par joueur à la fois.
- Le Recouvreur de dettes utilise le fichier de custom boss
debt_collector.yml.
Mise à l'échelle du niveau
Le niveau du Recouvreur de dettes est basé sur le niveau de combat du joueur ciblé. Ses statistiques (points de vie, dégâts, etc.) sont déterminées par le fichier de configuration de custom boss debt_collector.yml, en suivant les mêmes règles que n'importe quel autre custom boss d'EliteMobs.
Comportement
- Le Recouvreur de dettes apparaît à une distance de 5 à 10 blocs du joueur.
- Il cible immédiatement le joueur pour lequel il est apparu.
- Il possède un délai d'expiration de 600 secondes (10 minutes) par défaut. S'il n'est pas tué dans ce laps de temps, il disparaît et avertit le joueur qu'il reviendra.
Résultats
| Résultat | Effet |
|---|---|
| Le joueur tue le Recouvreur de dettes | Le boss disparaît. La dette du joueur n'est pas réduite, mais il reçoit un message indiquant qu'il reviendra. |
| Le Recouvreur de dettes tue le joueur | La dette du joueur est réduite de 50 pièces (configurable). Si cela efface entièrement la dette, le joueur en est informé. Le Recouvreur de dettes disparaît au bout de 5 secondes. |
| Délai expiré (non tué à temps) | Le Recouvreur de dettes disparaît et envoie un message d'avertissement. Il tentera de réapparaître lors de la prochaine vérification. |
Propriétaire de la salle de jeux
Le Propriétaire de la salle de jeux est un PNJ spécial qui affiche les gains de la maison au-dessus de sa tête sous forme de texte flottant. Cela indique le bénéfice ou la perte totale que la maison a accumulé grâce à l'ensemble de l'activité de jeu.
- Les gains positifs sont affichés en vert (par ex.
+1234.56). - Les gains négatifs (les joueurs gagnent plus qu'ils ne perdent) sont affichés en rouge (par ex.
-567.89). - L'affichage se met à jour chaque seconde.
- Les gains de la maison sont enregistrés dans
house_earnings.ymlet survivent aux redémarrages du serveur.
Configuration
Tous les réglages de jeu sont stockés dans GamblingSettings.yml. Vous trouverez ci-dessous les principaux réglages influant sur le gameplay.
Réglages généraux
| Clé | Description | Par défaut |
|---|---|---|
gamblingEnabled | Active ou désactive l'intégralité du système de jeux de hasard. Lorsqu'il est désactivé, les PNJ de jeu ne fonctionnent pas et le Recouvreur de dettes n'apparaît pas. | true |
minBet | Montant de mise minimum pour tous les jeux de hasard. | 10 |
Remarque : la dette maximale (500.0) est codée en dur et n'est pas configurable.
Multiplicateurs de gains
| Clé | Description | Par défaut |
|---|---|---|
payouts.blackjack.normal | Multiplicateur de gain pour une victoire normale au Blackjack. | 2.0 |
payouts.blackjack.blackjack | Multiplicateur de gain pour un Blackjack naturel (21 avec les deux premières cartes). | 2.5 |
payouts.coinFlip | Multiplicateur de gain pour une victoire au Pile ou Face. Réglez-le en dessous de 2.0 pour un avantage de la maison (1.9 = 5 % d'avantage). | 1.9 |
payouts.coinFlip.edgeChance | Chance (de 0.0 à 1.0) que la pièce retombe sur la tranche (victoire bonus). Réglez sur 0.0 pour désactiver. | 0.01 |
payouts.coinFlip.edgePayout | Multiplicateur de gain lorsque la pièce retombe sur la tranche. | 5.0 |
payouts.higherLower.multiplierV2 | Multiplicateur appliqué à chaque bonne prédiction dans Plus ou Moins. Se cumule de façon multiplicative. | 1.3 |
Gains de la machine à sous
Les gains de la machine à sous ne sont pas configurables. Ils sont calculés automatiquement à partir des poids des symboles selon la formule 100 / weight :
| Symbole | Poids | Gain 3 symboles | Gain 2 symboles |
|---|---|---|---|
| Cerise | 35 | 2.86x | 0.71x |
| Citron | 28 | 3.57x | 0.89x |
| Orange | 20 | 5.0x | 1.25x |
| Cloche | 10 | 10.0x | 2.50x |
| Barre | 5 | 20.0x | 5.00x |
| Lucky 7 | 2 | 50.0x | 12.50x |
Il n'existe aucune clé payouts.slots.* dans GamblingSettings.yml — les seules entrées de machine à sous du fichier sont les chaînes d'interface slots.* (noms de boutons, libellés, titres de résultats). Les gains sont toujours dérivés des poids de symboles codés en dur.
Réglages du Recouvreur de dettes
| Clé | Description | Par défaut |
|---|---|---|
debtCollector.spawnChance | Chance (de 0.0 à 1.0) que le Recouvreur de dettes apparaisse à chaque vérification. | 0.5 |
debtCollector.checkIntervalMinutes | Fréquence (en minutes) de la vérification déterminant si le Recouvreur de dettes doit apparaître pour les joueurs endettés. | 60 |
debtCollector.timeoutSeconds | Durée (en secondes) avant que le Recouvreur de dettes ne disparaisse s'il n'est pas tué. | 600 |
debtCollector.debtReductionOnPlayerDeath | Montant de dette effacé lorsque le Recouvreur de dettes tue le joueur. | 50.0 |
Sécurité économique
Le système de jeux de hasard utilise un modèle de transaction privilégiant la sécurité. Toutes les mises sont déduites et les résultats sont résolus financièrement avant que la moindre animation ne se joue. Cela empêche les exploits où un joueur pourrait se déconnecter en pleine animation pour éviter une perte ou dupliquer un gain. Si un joueur se déconnecte à n'importe quel moment pendant ou après une animation, son état financier est déjà correct.