Sistema de Apuestas
El Sistema de Apuestas añade un casino completamente funcional a EliteMobs. Los jugadores pueden apostar sus Monedas de Élite en cuatro minijuegos diferentes, endeudarse cuando se quedan sin dinero, y enfrentar las consecuencias cuando el Cobrador de Deudas llama a su puerta. Los administradores de servidor pueden configurar cada aspecto del sistema, desde los multiplicadores de pago hasta los límites de deuda.
Configuración
Se accede al sistema de apuestas a través de NPCs especialmente configurados. Cada juego y pantalla tiene su propio tipo de interacción de NPC.
Para configurar un NPC de apuestas, crea un archivo de configuración de NPC y establece el interactionType a uno de los siguientes valores:
| Tipo de Interacción | Descripción |
|---|---|
GAMBLING_BLACKJACK | Abre el menú de apuestas para Blackjack |
GAMBLING_COINFLIP | Abre el menú de apuestas para Lanzamiento de Moneda |
GAMBLING_SLOTS | Abre el menú de apuestas para Máquina Tragamonedas |
GAMBLING_HIGHERLOWER | Abre el menú de apuestas para Mayor o Menor |
El NPC Dueño del Casino 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 ganancias de la casa aparecerá automáticamente sobre el NPC basándose en este nombre de archivo.
Juegos
Blackjack
Se aplican las reglas estándar de Blackjack. El objetivo es acercarse lo más posible a 21 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 1 (ajustados automáticamente para evitar pasarse cuando sea posible).
- Las figuras (Jota, Reina, Rey) cuentan como 10.
- El crupier se planta en 17.
- Los jugadores pueden tener hasta 5 cartas.
Acciones
| Acción | Descripción |
|---|---|
| Pedir | Roba otra carta. |
| Plantarse | Mantén tu mano actual; el crupier entonces juega. |
| Doblar | Dobla tu apuesta, roba exactamente una carta, luego te plantas automáticamente. Solo 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 (total del jugador supera al crupier, o crupier se pasa) | 2.0x |
| Blackjack (21 con las primeras dos cartas) | 2.5x |
| Empate | 1.0x (apuesta devuelta) |
| Derrota (jugador se pasa o total del crupier es mayor) | 0x (apuesta perdida) |
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, la apuesta se pierde.
Lanzamiento de Moneda
Un juego simple de 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 hacer tu elección.
- Se reproduce una animación de lanzamiento de moneda.
- Se muestra el resultado.
Pagos
| Resultado | Multiplicador por Defecto |
|---|---|
| Acierto correcto | 1.9x |
| Borde (la moneda cae de canto) | 10.0x |
| Acierto incorrecto | 0x (apuesta perdida) |
El Resultado de Borde
Hay una probabilidad del 1% de que la moneda caiga de canto en lugar de Cara o Cruz. Cuando esto sucede, el jugador siempre gana independientemente de su elección, y recibe un pago de 10x sobre su apuesta. Se muestra un mensaje especial de chat y una visualización para este evento raro.
Cerrar el Menú
Si un jugador cierra el menú antes de hacer una elección, la apuesta se pierde.
Máquina Tragamonedas
Gira tres rodillos y haz coincidir 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 rodillo 3x3 y un botón de Girar.
- Haz clic en Girar para iniciar los rodillos.
- Cada rodillo se detiene en secuencia con una animación.
- La fila del medio (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 hacer coincidir tres de un símbolo se calcula como 100 / peso. Hacer coincidir dos símbolos paga el 25% del pago de tres coincidencias para ese símbolo.
| Símbolo | Peso | Probabilidad | Pago 3 Coincidencias | Pago 2 Coincidencias |
|---|---|---|---|---|
| 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 es el Premio Mayor y recibe un efecto visual y de sonido especial.
Cerrar el Menú
Si un jugador cierra el menú antes de girar, la apuesta se pierde.
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. Retira en cualquier momento o arriesga todo.
Cómo Jugar
- Se roba y muestra una carta (los valores van de 2 a 14, donde As = 14).
- Adivina si la siguiente carta será Mayor o Menor que la carta actual.
- Si adivinas correctamente, tu multiplicador aumenta y la carta revelada se convierte en la nueva carta actual.
- Puedes Retirar en cualquier momento después de al menos un acierto correcto.
- Si adivinas incorrectamente, pierdes toda tu apuesta.
- Si la siguiente carta es igual a la carta actual, cuenta como una pérdida.
Multiplicador de Racha
Cada acierto correcto multiplica tus ganancias por el multiplicador configurado (por defecto 1.5x). El multiplicador se apila:
| Racha | Multiplicador (por defecto) | Pago en Apuesta de 100 Monedas |
|---|---|---|
| 1 | 1.5x | 150 |
| 2 | 2.25x | 225 |
| 3 | 3.375x | 337.5 |
| 4 | 5.0625x | 506.25 |
| 5 | 7.59x | 759 |
| ... | ... | ... |
| 12 | ~129.75x | ~12,975 |
Racha Máxima y Retiro Automático
La racha máxima es 12. Cuando un jugador alcanza 12 aciertos correctos, se retira automáticamente y se otorgan sus ganancias. Esto previene multiplicadores descontrolados.
Cerrar el Menú
Si un jugador cierra el menú mientras tiene una racha ganadora, se retira automáticamente y recibe sus ganancias actuales. Si cierra antes de hacer cualquier acierto, la apuesta se pierde.
Apuestas
Antes de que comience cualquier juego, al jugador se le presenta un menú de apuestas para seleccionar su apuesta.
Límites de Apuesta
| Configuración | Valor por Defecto |
|---|---|
| Apuesta Mínima | 10 |
| Apuesta Máxima | 1000 |
Controles del Menú de Apuestas
El menú de apuestas proporciona varios controles:
- Botones de Incremento -- Tres tamaños de botones de aumento y disminución. Si el jugador tiene al menos 100 monedas y sin deuda, los incrementos se basan en porcentajes (5%, 10%, 25% del saldo). De lo contrario, se usan cantidades fijas de 10, 50 y 100.
- Todo -- Establece la apuesta al máximo que el jugador puede permitirse (incluyendo crédito disponible).
- Reiniciar -- Reinicia la apuesta al mínimo.
- Jugar -- Comienza el juego con la apuesta actual. Solo 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 extiende crédito hasta un límite configurable.
Cómo Funciona la Deuda
- Cuando un jugador realiza una apuesta que excede su saldo, la cantidad restante se añade como deuda de apuestas.
- La deuda máxima que un jugador puede acumular es de 500 monedas por defecto.
- Los jugadores no pueden realizar apuestas que empujen su deuda más allá del máximo.
- Cuando un jugador gana, sus ganancias se aplican primero para pagar la deuda antes de añadirse a su saldo.
Crédito Disponible
El crédito disponible de un jugador se calcula como: deudaMáxima - deudaActual. Esto 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 venir por ellos mientras tengan deuda pendiente.
Jefe Cobrador de Deudas
El Cobrador de Deudas es un jefe personalizado que aparece para cazar a los jugadores que tienen deuda de apuestas.
Condiciones de Aparición
- El jugador debe tener deuda de apuestas pendiente.
- Se ejecuta una verificación periódica cada 60 minutos (configurable) para todos los jugadores en línea.
- Cada verificación tiene una probabilidad del 50% (configurable) de generar al Cobrador de Deudas para un jugador elegible.
- 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. Su salud se multiplica por un multiplicador de salud configurable (por defecto 5.0x) y su daño por un multiplicador de daño (por defecto 1.0x).
Comportamiento
- El Cobrador de Deudas aparece a 5 a 10 bloques de distancia del jugador.
- Inmediatamente apunta al jugador para el que fue generado.
- Tiene un tiempo de espera de 600 segundos (10 minutos) por defecto. Si no es eliminado dentro de ese tiempo, desaparece y advierte al jugador que volverá.
Resultados
| Resultado | Efecto |
|---|---|
| El jugador mata al Cobrador de Deudas | El jefe desaparece. La deuda del jugador no se reduce, pero reciben un mensaje de que volverá. |
| El Cobrador de Deudas mata al jugador | La deuda del jugador se reduce en 50 monedas (configurable). Si esto limpia la deuda completamente, se notifica al jugador. El Cobrador de Deudas desaparece después de 5 segundos. |
| Tiempo de espera (no eliminado a tiempo) | El Cobrador de Deudas desaparece y envía un mensaje de advertencia. Intentará aparecer de nuevo en la siguiente verificación. |
Dueño del Casino
El Dueño del Casino es un NPC especial que muestra las Ganancias de la Casa sobre su cabeza como una visualización de texto flotante. Esto muestra la ganancia o pérdida total que la casa ha acumulado de toda la actividad de apuestas.
- Las ganancias positivas se muestran en verde (ej.,
+1234.56). - Las ganancias negativas (jugadores ganando más de lo que pierden) se muestran en rojo (ej.,
-567.89). - La visualización se actualiza cada segundo.
- Las ganancias de la casa se persisten en
house_earnings.ymly sobreviven a los reinicios del servidor.
Configuración
Todas las configuraciones de apuestas se almacenan en GamblingSettings.yml. A continuación se muestran las configuraciones clave que afectan el juego.
Configuraciones Generales
| Clave | Descripción | Por Defecto |
|---|---|---|
gamblingEnabled | Habilita o deshabilita todo el sistema de apuestas. Cuando está deshabilitado, los NPCs de apuestas no funcionarán y el Cobrador de Deudas no aparecerá. | true |
maxDebt | Cantidad máxima de deuda que un jugador puede acumular de las apuestas. | 500.0 |
minBet | Cantidad mínima de apuesta para todos los juegos de apuestas. | 10 |
maxBet | Cantidad máxima de apuesta para todos los juegos de apuestas. | 1000 |
Multiplicadores de Pago
| Clave | Descripción | Por Defecto |
|---|---|---|
payouts.blackjack.normal | Multiplicador de pago para una victoria normal de Blackjack. | 2.0 |
payouts.blackjack.blackjack | Multiplicador de pago por conseguir un Blackjack natural (21 con las primeras dos cartas). | 2.5 |
payouts.coinFlip | Multiplicador de pago para ganar un Lanzamiento de Moneda. Establecido por debajo de 2.0 para ventaja de la casa (1.9 = 5% de ventaja de la casa). | 1.9 |
payouts.higherLower.multiplier | Multiplicador aplicado por cada acierto correcto en Mayor/Menor. Se apila multiplicativamente. | 1.5 |
Pagos de Máquina Tragamonedas
Los pagos de la máquina tragamonedas no son configurables. Se calculan automáticamente a partir de los pesos de los símbolos usando la fórmula 100 / peso:
| Símbolo | Peso | Pago 3 Coincidencias | Pago 2 Coincidencias |
|---|---|---|---|
| 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 |
Las claves payouts.slots.* existen en GamblingSettings.yml pero no son usadas por la lógica del juego. Los pagos reales siempre se basan en el peso.
Configuraciones 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 verificación. | 0.5 |
debtCollector.checkIntervalMinutes | Con qué frecuencia (en minutos) verificar si el Cobrador de Deudas debería aparecer para jugadores endeudados. | 60 |
debtCollector.timeoutSeconds | Cuánto tiempo (en segundos) antes de que el Cobrador de Deudas desaparezca si no es eliminado. | 600 |
debtCollector.healthMultiplier | Multiplicador de salud para el jefe Cobrador de Deudas. | 5.0 |
debtCollector.damageMultiplier | Multiplicador de daño para el jefe Cobrador de Deudas. | 1.0 |
debtCollector.debtReductionOnPlayerDeath | Cantidad de deuda reducida cuando el Cobrador de Deudas mata al jugador. | 50.0 |
Seguridad Económica
El sistema de apuestas utiliza un modelo de transacción que prioriza la seguridad. Todas las apuestas se deducen y los resultados se resuelven financieramente antes de que se reproduzcan las animaciones visuales. Esto previene exploits donde un jugador podría desconectarse a mitad de animación para evitar una pérdida o duplicar una victoria. Si un jugador se desconecta en cualquier punto durante o después de una animación, su estado financiero ya es correcto.