Sistema de Apostas
O Sistema de Apostas adiciona um cassino completo ao EliteMobs. Os jogadores podem apostar suas Moedas Elite em quatro minijogos diferentes, entrar em dívida quando ficam sem dinheiro e enfrentar as consequências quando o Cobrador de Dívidas vem chamá-los. Os administradores de servidor podem configurar todos os aspectos do sistema, desde multiplicadores de pagamento até limites de dívida.
Configuração
O sistema de apostas é acessado através de NPCs especialmente configurados. Cada jogo e tela tem seu próprio tipo de interação de NPC.
Para configurar um NPC de apostas, crie um arquivo de configuração de NPC e defina o interactionType para um dos seguintes valores:
| Tipo de Interação | Descrição |
|---|---|
GAMBLING_BLACKJACK | Abre o menu de apostas para Blackjack |
GAMBLING_COINFLIP | Abre o menu de apostas para Cara ou Coroa |
GAMBLING_SLOTS | Abre o menu de apostas para Caça-Níqueis |
GAMBLING_HIGHERLOWER | Abre o menu de apostas para Maior ou Menor |
O NPC Dono do Cassino não usa um tipo de interação especial. Para configurá-lo, crie um NPC com o nome de arquivo gambling_den_owner.yml. A exibição de ganhos da casa aparecerá acima do NPC automaticamente com base neste nome de arquivo.
Jogos
Blackjack
Regras padrão de Blackjack se aplicam. O objetivo é chegar o mais próximo possível de 21 sem ultrapassar.
Regras
- Tanto o jogador quanto o dealer recebem duas cartas.
- A segunda carta do dealer fica oculta até o jogador parar.
- Ases contam como 11 ou 1 (ajustado automaticamente para evitar estourar quando possível).
- Cartas de figura (Valete, Dama, Rei) contam como 10.
- O dealer para em 17.
- Os jogadores podem ter até 5 cartas.
Ações
| Ação | Descrição |
|---|---|
| Pedir | Comprar outra carta. |
| Parar | Manter sua mão atual; o dealer então joga. |
| Dobrar | Dobrar sua aposta, comprar exatamente uma carta e então parar automaticamente. Disponível apenas na primeira ação (quando você tem 2 cartas) e apenas se puder pagar para dobrar sua aposta. |
Pagamentos
| Resultado | Multiplicador Padrão |
|---|---|
| Vitória Normal (total do jogador vence dealer, ou dealer estoura) | 2.0x |
| Blackjack (21 com as duas primeiras cartas) | 2.5x |
| Empate (empate) | 1.0x (aposta devolvida) |
| Derrota (jogador estoura ou total do dealer é maior) | 0x (aposta perdida) |
Fechar o Menu
Se um jogador fechar o menu durante a vez do dealer, a mão do dealer é jogada automaticamente e o resultado é resolvido. Se um jogador fechar o menu antes de parar, a aposta é perdida.
Cara ou Coroa
Um jogo simples 50/50. Escolha Cara ou Coroa, e a moeda decide seu destino.
Como Jogar
- O jogo abre com um botão Cara e um botão Coroa.
- Clique em um para fazer sua escolha.
- Uma animação de lançamento de moeda é reproduzida.
- O resultado é mostrado.
Pagamentos
| Resultado | Multiplicador Padrão |
|---|---|
| Palpite correto | 1.9x |
| Borda (moeda cai de lado) | 10.0x |
| Palpite errado | 0x (aposta perdida) |
O Resultado Borda
Há 1% de chance da moeda cair de lado em vez de Cara ou Coroa. Quando isso acontece, o jogador sempre ganha independentemente de sua escolha e recebe um pagamento de 10x em sua aposta. Uma mensagem especial no chat e exibição visual são mostradas para este evento raro.
Fechar o Menu
Se um jogador fechar o menu antes de fazer uma escolha, a aposta é perdida.
Caça-Níqueis
Gire três rolos e combine símbolos para ganhar. Símbolos mais raros pagam mais.
Como Jogar
- O jogo abre com uma grade de rolos 3x3 e um botão Girar.
- Clique em Girar para iniciar os rolos.
- Cada rolo para em sequência com uma animação.
- A linha do meio (linha de pagamento) determina o resultado.
Símbolos e Pagamentos
Cada símbolo tem um peso que determina com que frequência aparece. O multiplicador de pagamento para combinar três de um símbolo é calculado como 100 / peso. Combinar dois símbolos paga 25% do pagamento de três símbolos para aquele símbolo.
| Símbolo | Peso | Chance | Pagamento 3 Símbolos | Pagamento 2 Símbolos |
|---|---|---|---|---|
| Cereja | 35 | 35% | 2.86x | 0.71x |
| Limão | 28 | 28% | 3.57x | 0.89x |
| Laranja | 20 | 20% | 5.0x | 1.25x |
| Sino Dourado | 10 | 10% | 10.0x | 2.5x |
| Barra de Prata | 5 | 5% | 20.0x | 5.0x |
| 7 da Sorte | 2 | 2% | 50.0x | 12.5x |
Três 7 da Sorte é o Jackpot e recebe um efeito visual e sonoro especial.
Fechar o Menu
Se um jogador fechar o menu antes de girar, a aposta é perdida.
Maior ou Menor
Um jogo de cartas baseado em sequências. Adivinhe se a próxima carta é maior ou menor que a atual e construa um multiplicador. Saque a qualquer momento ou arrisque tudo.
Como Jogar
- Uma carta é comprada e mostrada (valores variam de 2 a 14, onde Ás = 14).
- Adivinhe se a próxima carta será Maior ou Menor que a carta atual.
- Se você acertar, seu multiplicador aumenta e a carta revelada se torna a nova carta atual.
- Você pode Sacar a qualquer momento após pelo menos um palpite correto.
- Se você errar, você perde toda sua aposta.
- Se a próxima carta for igual à carta atual, conta como derrota.
Multiplicador de Sequência
Cada palpite correto multiplica seus ganhos pelo multiplicador configurado (padrão 1.5x). O multiplicador acumula:
| Sequência | Multiplicador (padrão) | Pagamento em Aposta de 100 Moedas |
|---|---|---|
| 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 |
Sequência Máxima e Saque Automático
A sequência máxima é 12. Quando um jogador atinge 12 palpites corretos, ele é automaticamente sacado e seus ganhos são concedidos. Isso evita multiplicadores descontrolados.
Fechar o Menu
Se um jogador fechar o menu enquanto tem uma sequência vencedora, ele é automaticamente sacado e recebe seus ganhos atuais. Se fechar antes de fazer qualquer palpite, a aposta é perdida.
Apostas
Antes de qualquer jogo começar, o jogador é apresentado a um menu de apostas para selecionar sua aposta.
Limites de Aposta
| Configuração | Valor Padrão |
|---|---|
| Aposta Mínima | 10 |
| Aposta Máxima | 1000 |
Controles do Menu de Apostas
O menu de apostas fornece vários controles:
- Botões de Incremento -- Três tamanhos de botões de aumento e diminuição. Se o jogador tiver pelo menos 100 moedas e sem dívida, os incrementos são baseados em porcentagem (5%, 10%, 25% do saldo). Caso contrário, são usados valores fixos de 10, 50 e 100.
- Tudo -- Define a aposta para o máximo que o jogador pode pagar (incluindo crédito disponível).
- Resetar -- Reseta a aposta para o mínimo.
- Jogar -- Inicia o jogo com a aposta atual. Ativo apenas se o jogador puder pagar a aposta.
- Cancelar -- Fecha o menu sem apostar.
O menu mostra o saldo atual do jogador, qualquer dívida existente e crédito disponível.
Sistema de Dívida
Os jogadores podem apostar além de seu saldo entrando em dívida. O cassino estende crédito até um limite configurável.
Como a Dívida Funciona
- Quando um jogador faz uma aposta que excede seu saldo, o valor restante é adicionado como dívida de apostas.
- A dívida máxima que um jogador pode acumular é 500 moedas por padrão.
- Os jogadores não podem fazer apostas que empurrariam sua dívida além do máximo.
- Quando um jogador ganha, seus ganhos são primeiro aplicados para pagar a dívida antes de serem adicionados ao saldo.
Crédito Disponível
O crédito disponível de um jogador é calculado como: dívida máxima - dívida atual. Isso é exibido no menu de apostas.
Aviso de Dívida
Quando um jogador entra em dívida, ele recebe uma mensagem de aviso. O Cobrador de Dívidas pode vir atrás deles enquanto carregam dívida pendente.
Chefe Cobrador de Dívidas
O Cobrador de Dívidas é um chefe personalizado que aparece para caçar jogadores que estão em dívida de apostas.
Condições de Aparição
- O jogador deve ter dívida de apostas pendente.
- Uma verificação periódica executa a cada 60 minutos (configurável) para todos os jogadores online.
- Cada verificação tem 50% de chance (configurável) de gerar o Cobrador de Dívidas para um jogador elegível.
- Apenas um Cobrador de Dívidas pode estar ativo por jogador por vez.
- O Cobrador de Dívidas usa o arquivo de chefe personalizado
debt_collector.yml.
Escalonamento de Nível
O nível do Cobrador de Dívidas é baseado no nível de combate do jogador alvo. Sua vida é multiplicada por um multiplicador de vida configurável (padrão 5.0x) e seu dano por um multiplicador de dano (padrão 1.0x).
Comportamento
- O Cobrador de Dívidas aparece de 5 a 10 blocos de distância do jogador.
- Ele imediatamente mira no jogador para o qual foi gerado.
- Ele tem um tempo limite de 600 segundos (10 minutos) por padrão. Se não for morto dentro desse tempo, ele desaparece e avisa o jogador que retornará.
Resultados
| Resultado | Efeito |
|---|---|
| Jogador mata o Cobrador de Dívidas | O chefe desaparece. A dívida do jogador não é reduzida, mas ele recebe uma mensagem que retornará. |
| Cobrador de Dívidas mata o jogador | A dívida do jogador é reduzida em 50 moedas (configurável). Se isso limpar completamente a dívida, o jogador é notificado. O Cobrador de Dívidas desaparece após 5 segundos. |
| Tempo limite (não morto a tempo) | O Cobrador de Dívidas desaparece e envia uma mensagem de aviso. Ele tentará aparecer novamente na próxima verificação. |
Dono do Cassino
O Dono do Cassino é um NPC especial que exibe os Ganhos da Casa acima de sua cabeça como uma exibição de texto flutuante. Isso mostra o lucro total ou perda que a casa acumulou de toda atividade de apostas.
- Ganhos positivos são mostrados em verde (ex.:
+1234.56). - Ganhos negativos (jogadores ganhando mais do que perdendo) são mostrados em vermelho (ex.:
-567.89). - A exibição atualiza a cada segundo.
- Os ganhos da casa são persistidos em
house_earnings.ymle sobrevivem a reinicializações do servidor.
Configuração
Todas as configurações de apostas são armazenadas em GamblingSettings.yml. Abaixo estão as principais configurações que afetam a jogabilidade.
Configurações Gerais
| Chave | Descrição | Padrão |
|---|---|---|
gamblingEnabled | Ativa ou desativa todo o sistema de apostas. Quando desativado, NPCs de apostas não funcionarão e o Cobrador de Dívidas não aparecerá. | true |
maxDebt | Valor máximo de dívida que um jogador pode acumular de apostas. | 500.0 |
minBet | Valor mínimo de aposta para todos os jogos de apostas. | 10 |
maxBet | Valor máximo de aposta para todos os jogos de apostas. | 1000 |
Multiplicadores de Pagamento
| Chave | Descrição | Padrão |
|---|---|---|
payouts.blackjack.normal | Multiplicador de pagamento para uma vitória normal de Blackjack. | 2.0 |
payouts.blackjack.blackjack | Multiplicador de pagamento para conseguir um Blackjack natural (21 com as duas primeiras cartas). | 2.5 |
payouts.coinFlip | Multiplicador de pagamento para ganhar um Cara ou Coroa. Definir abaixo de 2.0 para vantagem da casa (1.9 = 5% de vantagem da casa). | 1.9 |
payouts.higherLower.multiplier | Multiplicador aplicado por palpite correto em Maior/Menor. Acumula multiplicativamente. | 1.5 |
Pagamentos de Caça-Níqueis
Os pagamentos de caça-níqueis não são configuráveis. Eles são calculados automaticamente dos pesos dos símbolos usando a fórmula 100 / peso:
| Símbolo | Peso | Pagamento 3 Símbolos | Pagamento 2 Símbolos |
|---|---|---|---|
| Cereja | 35 | 2.86x | 0.71x |
| Limão | 28 | 3.57x | 0.89x |
| Laranja | 20 | 5.0x | 1.25x |
| Sino | 10 | 10.0x | 2.50x |
| Barra | 5 | 20.0x | 5.00x |
| 7 da Sorte | 2 | 50.0x | 12.50x |
As chaves payouts.slots.* existem em GamblingSettings.yml mas não são usadas pela lógica do jogo. Os pagamentos reais são sempre baseados em peso.
Configurações do Cobrador de Dívidas
| Chave | Descrição | Padrão |
|---|---|---|
debtCollector.spawnChance | Chance (0.0 a 1.0) de que o Cobrador de Dívidas apareça em cada verificação. | 0.5 |
debtCollector.checkIntervalMinutes | Com que frequência (em minutos) verificar se o Cobrador de Dívidas deve aparecer para jogadores em dívida. | 60 |
debtCollector.timeoutSeconds | Quanto tempo (em segundos) antes do Cobrador de Dívidas desaparecer se não for morto. | 600 |
debtCollector.healthMultiplier | Multiplicador de vida para o chefe Cobrador de Dívidas. | 5.0 |
debtCollector.damageMultiplier | Multiplicador de dano para o chefe Cobrador de Dívidas. | 1.0 |
debtCollector.debtReductionOnPlayerDeath | Valor de dívida reduzido quando o Cobrador de Dívidas mata o jogador. | 50.0 |
Segurança Econômica
O sistema de apostas usa um modelo de transação que prioriza a segurança. Todas as apostas são deduzidas e os resultados são financeiramente resolvidos antes de qualquer animação visual ser reproduzida. Isso evita explorações onde um jogador poderia desconectar no meio da animação para evitar uma perda ou duplicar uma vitória. Se um jogador desconectar em qualquer ponto durante ou após uma animação, seu estado financeiro já está correto.