Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

arena-1.yml

arena-2.yml

commands.yml

config.yml

menus.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento dos combates X1. Abaixo estão todas as opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados dos X1s serão armazenados. O plugin suporta três tipos de armazenamento:

SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.

database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yX1/data.db.

redis

Configurações do servidor Redis para sincronização entre servidores (BungeeCord/Velocity).

redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 6379]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

Quando usar Redis:

Rede BungeeCord/Velocity com múltiplos servidores
Sincronização em tempo real de dados entre servidores
Stats de X1 funcionando entre servidores

general

Configurações gerais do sistema de X1. Controla o comportamento geral dos combates e funcionalidades de salvamento.

general:
  # Tempo máximo de duração de um X1 em segundos (0 = infinito)
  max-duration: 0
  # Quantidade de vezes que um jogador pode recusar um X1 antes de perder o "mito"
  refuse-limit: 3
  # Se deve salvar o inventário do jogador ao entrar em um X1
  save-inventory: true
  # Se deve salvar a experiência do jogador ao entrar em um X1
  save-experience: true

Descrição dos campos:

Campo	Descrição
`max-duration`	Define quanto tempo máximo um X1 pode durar. Use `0` para nenhum limite de tempo.
`refuse-limit`	Quantas vezes um jogador pode recusar um desafio antes de perder seu "mito" (status especial).
`save-inventory`	Se ativado, salva o inventário do jogador ao entrar em um X1 e restaura ao sair.
`save-experience`	Se ativado, salva a experiência do jogador ao entrar e restaura ao sair.

O "mito" é um status que indica que o jogador está participando ativamente de X1s. Perder o mito por recusas excessivas pode afetrar a reputação do jogador.

spectator

Configurações do modo camarote (espectador simulado). Permite que outros jogadores assistam aos X1s sem interferir.

spectator:
  # Se deve ativar o modo camarote
  enabled: true
  # Tempo em segundos que o modo camarote dura (0 = infinito)
  duration: 0
  # Se deve restaurar a saúde dos espectadores ao sair
  restore-health: true
  # Se deve restaurar a fome dos espectadores ao sair
  restore-hunger: true

Quando ativar:

Se você quer permitir que outros jogadores assistam aos X1s
Em servidores com comunidade forte que aprecia espectadores
Para criar um ambiente mais social em torno dos combates

betting

Configurações do sistema de apostas multi-economy. Permite que jogadores apostem em X1s.

betting:
  # Se deve ativar o sistema de apostas
  enabled: true
  # Valor mínimo de aposta
  min-value: 1000.0
  # Valor máximo de aposta
  max-value: 50000.0
  # Economia padrão para apostas (se não especificada no comando)
  default-provider: 'money'
  # Porcentagem de taxa que o servidor fica de cada aposta
  tax-percentage: 10.0

Descrição dos campos:

Campo	Descrição
`enabled`	Ativa ou desativa o sistema de apostas completamente.
`min-value`	Valor mínimo que um jogador pode apostar em um X1.
`max-value`	Valor máximo que um jogador pode apostar em um X1.
`default-provider`	Qual economia será usada por padrão se o jogador não especificar.
`tax-percentage`	Porcentagem que o servidor fica de cada aposta realizada.

Recomenda-se manter o sistema de apostas desativado se seu servidor é voltado para jogadores jovens ou tem regras rígidas contra jogo de azar.

Configuração das arenas (`arenas/<arena>.yml`)

Cada arena pode definir um nome exibido em menus e mensagens.

# Nome exibido em menus e mensagens
display-name: '&aPadrão'

Use este campo para manter nomes amigáveis sem depender apenas do nome do arquivo da arena.

Nesta página