Sistema de apuestas
El Sistema de Apuestas añade un casino completo a EliteMobs. Los jugadores pueden apostar sus Monedas Élite en cuatro minijuegos distintos, endeudarse cuando se queden sin dinero y afrontar las consecuencias cuando el Cobrador de Deudas venga a llamar a su puerta. Los administradores del servidor pueden configurar todos los aspectos del sistema, desde los multiplicadores de pago hasta los límites de deuda.
Configuración
Al sistema de apuestas se accede a través de NPC configurados especialmente. Cada juego y cada visualización tiene su propio tipo de interacción de NPC.
Para preparar un NPC de apuestas, crea un archivo de configuración de NPC y establece el interactionType en uno de los siguientes valores:
| Tipo de interacción | Descripción |
|---|---|
GAMBLING_BLACKJACK | Abre el menú de apuestas del Blackjack |
GAMBLING_COINFLIP | Abre el menú de apuestas de Cara o Cruz |
GAMBLING_SLOTS | Abre el menú de apuestas de la Máquina Tragaperras |
GAMBLING_HIGHERLOWER | Abre el menú de apuestas de Mayor o Menor |
El NPC Dueño de la Casa de Apuestas no usa un tipo de interacción especial. Para configurarlo, crea un NPC con el nombre de archivo gambling_den_owner.yml. La visualización de las ganancias de la casa aparecerá automáticamente sobre el NPC a partir de ese nombre de archivo.
Juegos
Blackjack
Se aplican las reglas estándar del Blackjack. El objetivo es acercarse a 21 lo más posible sin pasarse.
Reglas
- Tanto el jugador como el crupier reciben dos cartas.
- La segunda carta del crupier está oculta hasta que el jugador se planta.
- Los ases cuentan como 11 o como 1 (se ajustan automáticamente para evitar pasarse cuando es posible).
- Las figuras (J, Q, K) cuentan como 10.
- El crupier se planta con 17.
- Los jugadores pueden tener hasta 5 cartas.
Acciones
| Acción | Descripción |
|---|---|
| Pedir | Roba otra carta. |
| Plantarse | Conserva tu mano actual; después juega el crupier. |
| Doblar | Dobla tu apuesta, roba exactamente una carta y luego te plantas automáticamente. Solo está disponible en tu primera acción (cuando tienes 2 cartas) y solo si puedes permitirte doblar tu apuesta. |
Pagos
| Resultado | Multiplicador por defecto |
|---|---|
| Victoria normal (el total del jugador supera al del crupier, o el crupier se pasa) | 2.0x |
| Blackjack (21 con las dos primeras cartas) | 2.5x |
| Empate (push) | 1.0x (se devuelve la apuesta) |
| Derrota (el jugador se pasa o el total del crupier es mayor) | 0x (se pierde la apuesta) |
Cerrar el menú
Si un jugador cierra el menú durante el turno del crupier, la mano del crupier se juega automáticamente y el resultado se resuelve. Si un jugador cierra el menú antes de plantarse, pierde la apuesta.
Cara o Cruz
Un simple juego al 50/50. Elige cara o cruz, y la moneda decide tu destino.
Cómo jugar
- El juego se abre con un botón de cara y un botón de cruz.
- Haz clic en uno para elegir.
- Se reproduce una animación de lanzamiento de moneda.
- Se muestra el resultado.
Pagos
| Resultado | Multiplicador por defecto |
|---|---|
| Acierto | 1.9x |
| Canto (la moneda cae de canto) | 5.0x |
| Fallo | 0x (se pierde la apuesta) |
El resultado de canto
Hay un 1% de probabilidad de que la moneda caiga de canto en lugar de cara o cruz. Cuando esto ocurre, el jugador siempre gana independientemente de su elección y recibe un pago de 5x sobre su apuesta. Para este evento tan raro se muestran un mensaje de chat y una visualización especiales.
Cerrar el menú
Si un jugador cierra el menú antes de elegir, pierde la apuesta.
Máquina Tragaperras
Gira tres rodillos y combina símbolos para ganar. Los símbolos más raros pagan más.
Cómo jugar
- El juego se abre con una cuadrícula de rodillos de 3x3 y un botón de girar.
- Haz clic en girar para poner en marcha los rodillos.
- Cada rodillo se detiene en secuencia con una animación.
- La fila central (la línea de pago) determina el resultado.
Símbolos y pagos
Cada símbolo tiene un peso que determina con qué frecuencia aparece. El multiplicador de pago por conseguir tres símbolos iguales se calcula como 100 / weight. Conseguir dos símbolos iguales paga el 25% del pago de tres iguales de ese símbolo.
| Símbolo | Peso | Probabilidad | Pago con 3 iguales | Pago con 2 iguales |
|---|---|---|---|---|
| Cereza | 35 | 35% | 2.86x | 0.71x |
| Limón | 28 | 28% | 3.57x | 0.89x |
| Naranja | 20 | 20% | 5.0x | 1.25x |
| Campana Dorada | 10 | 10% | 10.0x | 2.5x |
| Barra de Plata | 5 | 5% | 20.0x | 5.0x |
| 7 de la Suerte | 2 | 2% | 50.0x | 12.5x |
Tres 7 de la Suerte son el Jackpot y reciben un efecto visual y de sonido especial.
Cerrar el menú
Si un jugador cierra el menú antes de girar, pierde la apuesta.
Mayor o Menor
Un juego de cartas basado en rachas. Adivina si la siguiente carta es mayor o menor que la actual y acumula un multiplicador. Retírate en cualquier momento o arriésgalo todo.
Cómo jugar
- Se roba y se muestra una carta (los valores van de 2 a 14, donde el as = 14).
- Adivina si la siguiente carta será Mayor o Menor que la carta actual.
- Si aciertas, tu multiplicador aumenta y la carta revelada pasa a ser la nueva carta actual.
- Puedes Retirarte en cualquier momento tras al menos un acierto.
- Si te equivocas, pierdes toda tu apuesta.
- Si la siguiente carta es igual a la carta actual, cuenta como derrota.
Multiplicador de racha
Cada acierto multiplica tus ganancias por el multiplicador configurado (por defecto 1.3x). El multiplicador se acumula:
| Racha | Multiplicador (por defecto) | Pago con una apuesta de 100 monedas |
|---|---|---|
| 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 |
Racha máxima y retirada automática
La racha máxima es 12. Cuando un jugador alcanza 12 aciertos, se retira automáticamente y se le otorgan sus ganancias. Esto evita multiplicadores desbocados.
Cerrar el menú
Si un jugador cierra el menú mientras tiene una racha ganadora, se retira automáticamente y recibe sus ganancias actuales. Si lo cierra antes de hacer ninguna predicción, pierde la apuesta.
Apuestas
Antes de que empiece cualquier juego, se le presenta al jugador un menú de apuestas para seleccionar su apuesta.
Límites de apuesta
| Ajuste | Valor por defecto |
|---|---|
| Apuesta mínima | 10 |
No hay una apuesta máxima configurable. Los jugadores pueden apostar todo lo que puedan permitirse (incluido el crédito del sistema de deuda).
Controles del menú de apuestas
El menú de apuestas ofrece varios controles:
- Botones de incremento -- Tres tamaños de botones de aumento y de disminución. Si el jugador tiene al menos 100 monedas y ninguna deuda, los incrementos son porcentuales (5%, 10% y 25% del saldo). En caso contrario, se usan cantidades fijas de 10, 50 y 100.
- Todo a una -- Establece la apuesta al máximo que el jugador puede permitirse (incluido el crédito disponible).
- Restablecer -- Restablece la apuesta al mínimo.
- Jugar -- Inicia el juego con la apuesta actual. Solo está activo si el jugador puede permitirse la apuesta.
- Cancelar -- Cierra el menú sin apostar.
El menú muestra el saldo actual del jugador, cualquier deuda existente y el crédito disponible.
Sistema de deuda
Los jugadores pueden apostar más allá de su saldo endeudándose. El casino concede crédito hasta un límite fijo.
Cómo funciona la deuda
- Cuando un jugador hace una apuesta que supera su saldo, la cantidad restante se añade como deuda de juego.
- La deuda máxima que un jugador puede acumular es de 500 monedas. Está fijada en el código y no es configurable.
- Los jugadores no pueden hacer apuestas que empujarían su deuda más allá del máximo.
- Cuando un jugador gana, sus ganancias se aplican primero a saldar la deuda antes de sumarse a su saldo.
Crédito disponible
El crédito disponible de un jugador se calcula como: maxDebt - currentDebt. Se muestra en el menú de apuestas.
Advertencia de deuda
Cuando un jugador se endeuda, recibe un mensaje de advertencia. El Cobrador de Deudas puede ir a por él mientras arrastre deuda pendiente.
Jefe Cobrador de Deudas
El Cobrador de Deudas es un jefe personalizado que aparece para cazar a los jugadores que tienen deudas de juego.
Condiciones de aparición
- El jugador debe tener deuda de juego pendiente.
- Se ejecuta una comprobación periódica cada 60 minutos (configurable) para todos los jugadores conectados.
- Cada comprobación tiene un 50% de probabilidad (configurable) de hacer aparecer al Cobrador de Deudas para un jugador que cumpla los requisitos.
- Solo puede haber un Cobrador de Deudas activo por jugador a la vez.
- El Cobrador de Deudas usa el archivo de jefe personalizado
debt_collector.yml.
Escalado de nivel
El nivel del Cobrador de Deudas se basa en el nivel de combate del jugador objetivo. Sus estadísticas (salud, daño, etc.) se determinan mediante el archivo de configuración de jefe personalizado debt_collector.yml, siguiendo las mismas reglas que cualquier otro jefe personalizado de EliteMobs.
Comportamiento
- El Cobrador de Deudas aparece a entre 5 y 10 bloques del jugador.
- Selecciona inmediatamente como objetivo al jugador para el que apareció.
- Tiene un tiempo límite de 600 segundos (10 minutos) por defecto. Si no se le mata en ese tiempo, desaparece y advierte al jugador de que volverá.
Resultados
| Resultado | Efecto |
|---|---|
| El jugador mata al Cobrador de Deudas | El jefe desaparece. La deuda del jugador no se reduce, pero recibe un mensaje de que volverá. |
| El Cobrador de Deudas mata al jugador | La deuda del jugador se reduce en 50 monedas (configurable). Si esto liquida la deuda por completo, se notifica al jugador. El Cobrador de Deudas desaparece tras 5 segundos. |
| Tiempo agotado (no se le mató a tiempo) | El Cobrador de Deudas desaparece y envía un mensaje de advertencia. Intentará aparecer de nuevo en la siguiente comprobación. |
Dueño de la Casa de Apuestas
El Dueño de la Casa de Apuestas es un NPC especial que muestra las Ganancias de la Casa sobre su cabeza como un texto flotante. Esto refleja el beneficio o la pérdida total que la casa ha acumulado con toda la actividad de apuestas.
- Las ganancias positivas se muestran en verde (p. ej.
+1234.56). - Las ganancias negativas (los jugadores ganan más de lo que pierden) se muestran en rojo (p. ej.
-567.89). - La visualización se actualiza cada segundo.
- Las ganancias de la casa se guardan en
house_earnings.ymly sobreviven a los reinicios del servidor.
Configuración
Todos los ajustes de apuestas se almacenan en GamblingSettings.yml. A continuación están los ajustes clave que afectan a la jugabilidad.
Ajustes generales
| Clave | Descripción | Por defecto |
|---|---|---|
gamblingEnabled | Habilita o deshabilita todo el sistema de apuestas. Cuando está deshabilitado, los NPC de apuestas no funcionan y el Cobrador de Deudas no aparece. | true |
minBet | Cantidad mínima de apuesta para todos los juegos de apuestas. | 10 |
Nota: La deuda máxima (500.0) está fijada en el código y no es configurable.
Multiplicadores de pago
| Clave | Descripción | Por defecto |
|---|---|---|
payouts.blackjack.normal | Multiplicador de pago para una victoria normal en Blackjack. | 2.0 |
payouts.blackjack.blackjack | Multiplicador de pago por conseguir un Blackjack natural (21 con las dos primeras cartas). | 2.5 |
payouts.coinFlip | Multiplicador de pago por ganar a Cara o Cruz. Ponlo por debajo de 2.0 para dar ventaja a la casa (1.9 = 5% de ventaja de la casa). | 1.9 |
payouts.coinFlip.edgeChance | Probabilidad (0.0 a 1.0) de que la moneda caiga de canto (victoria con bonificación). Ponlo a 0.0 para deshabilitarlo. | 0.01 |
payouts.coinFlip.edgePayout | Multiplicador de pago cuando la moneda cae de canto. | 5.0 |
payouts.higherLower.multiplierV2 | Multiplicador aplicado por cada acierto en Mayor o Menor. Se acumula de forma multiplicativa. | 1.3 |
Pagos de la Máquina Tragaperras
Los pagos de la máquina tragaperras no son configurables. Se calculan automáticamente a partir de los pesos de los símbolos usando la fórmula 100 / weight:
| Símbolo | Peso | Pago con 3 iguales | Pago con 2 iguales |
|---|---|---|---|
| Cereza | 35 | 2.86x | 0.71x |
| Limón | 28 | 3.57x | 0.89x |
| Naranja | 20 | 5.0x | 1.25x |
| Campana | 10 | 10.0x | 2.50x |
| Barra | 5 | 20.0x | 5.00x |
| 7 de la Suerte | 2 | 50.0x | 12.50x |
En GamblingSettings.yml no existe ninguna clave payouts.slots.* — las únicas entradas de la máquina tragaperras en el archivo son las cadenas de interfaz slots.* (nombres de botones, etiquetas y títulos de resultado). Los pagos siempre se derivan de los pesos de los símbolos fijados en el código.
Ajustes del Cobrador de Deudas
| Clave | Descripción | Por defecto |
|---|---|---|
debtCollector.spawnChance | Probabilidad (0.0 a 1.0) de que el Cobrador de Deudas aparezca en cada comprobación. | 0.5 |
debtCollector.checkIntervalMinutes | Con qué frecuencia (en minutos) se comprueba si el Cobrador de Deudas debe aparecer para los jugadores endeudados. | 60 |
debtCollector.timeoutSeconds | Cuánto tiempo (en segundos) pasa antes de que el Cobrador de Deudas desaparezca si no se le mata. | 600 |
debtCollector.debtReductionOnPlayerDeath | Cantidad de deuda que se reduce cuando el Cobrador de Deudas mata al jugador. | 50.0 |
Seguridad de la economía
El sistema de apuestas usa un modelo de transacciones que prioriza la seguridad. Todas las apuestas se descuentan y los resultados se resuelven financieramente antes de que se reproduzca cualquier animación visual. Esto evita exploits en los que un jugador podría desconectarse a mitad de la animación para esquivar una pérdida o duplicar una ganancia. Si un jugador se desconecta en cualquier momento durante o después de una animación, su estado financiero ya es correcto.