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.

Estrutura de arquivos

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

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do sistema presidencial. 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

database

Define como e onde os dados do sistema presidencial 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: ''

redis

Configurações do servidor Redis para sincronização multi-servidor (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 do presidente entre servidores
• Eleições funcionando em toda a rede

mohist-chat

Ativa compatibilidade com plugins de chat específicos no Mohist.

# Ativar a troca do sistema de chat quando estiver no mohist
# compatível apenas com: UltimateChat, nChat e Legendchat
mohist-chat: false

Compatível com: UltimateChat, nChat e LegendChat.

general

Configurações gerais do sistema presidencial. Aqui você define como funcionam os mandatos, eleições e impostos.

general:
  # TAG para o presidente
  tag: '&6[PRESIDENTE]'
  # Duração do mandato em ticks (1 segundo = 20 ticks)
  mandate-duration: 7200
  # Duração da eleição em ticks (1 segundo = 20 ticks)
  # A eleição irá começar 1200 ticks antes da finalização do mandato (conforme a configuração acima e abaixo)
  election-duration: 1200
  # Taxa mínima permitida para os impostos
  min-tax: 0.0
  # Taxa máxima permitida para os impostos
  max-tax: 75.0
  # Tempo necessário para votar ou se candidatar
  # em segundos (yTempoOnline)
  need-time: 10
  # Comandos que serão executados ao iniciar o mandato
  start-mandate-commands: []
  # Comandos que serão executados ao finalizar o mandato
  end-mandate-commands: []

Explicação dos tempos:

• mandate-duration: 7200 ticks = 360 segundos = 6 minutos de mandato
• election-duration: 1200 ticks = 60 segundos = 1 minuto de eleição
• Fluxo: Quando faltarem 1200 ticks para o mandato acabar, a eleição começa automaticamente

Conversão de ticks:

Impostos:

• min-tax: Taxa mínima que o presidente pode definir (0% = sem imposto)
• max-tax: Taxa máxima que o presidente pode definir (75% = imposto alto)

Tempo mínimo (yTempoOnline):

Requer o plugin yTempoOnline instalado. Define quanto tempo de jogo o jogador precisa ter para votar ou se candidatar.

Comandos automáticos:

Execute ações automáticas quando o mandato inicia ou termina.

Exemplo:

general:
  start-mandate-commands:
    - 'broadcast &a{player} foi eleito presidente!'
    - 'give {player} diamond 5'
  end-mandate-commands:
    - 'broadcast &cO mandato de {player} terminou!'

Placeholders disponíveis: {player} (nome do presidente)

npc

Configure a aparência e localização do NPC que representa o presidente.

npc:
  # Altura do holograma
  off-set: 3.1
  hologram:
    - '&6&lPRESIDENTE'
    - '&7Presidente Atual &c{player}&7.'

off-set: Altura do holograma acima da cabeça do NPC (em blocos)

hologram: Linhas de texto exibidas acima do NPC

Placeholders disponíveis:

• {player} - Nome do presidente atual

Como usar:

1. Vá para o local onde deseja o NPC
2. Execute /presidente setnpc
3. O NPC será criado com o skin do presidente atual
4. Para remover: /presidente delnpc

announces

Sistema de anúncios automáticos durante eleições. Envia mensagens no chat em momentos específicos.

announces:
  election-finishing:
    - '1190,&e⚡ Falta §f1 minuto §epara o fim das eleições!'
    - '600,&e⚡ Faltam §f30 segundos §epara o fim das eleições!'
    - '200,&c⚡ Faltam §f10 segundos §cpara o fim das eleições!'
  election-starting:
    - '1200,&e⚡ Falta §f1 minuto §epara o início das eleições!'
    - '600,&e⚡ Faltam §f30 segundos §epara o início das eleições!'
    - '200,&a⚡ Faltam §f10 segundos §apara o início das eleições!'

Formato: 'ticks,mensagem'

• ticks: Tempo em ticks antes do evento
• mensagem: Texto a ser enviado no chat

election-starting: Anúncios antes da eleição começar (contagem regressiva baseada no election-duration)

election-finishing: Anúncios antes da eleição terminar (contagem regressiva durante a eleição)

Exemplo de fluxo:

1. Mandato tem 6 minutos (7200 ticks)
2. Eleição tem 1 minuto (1200 ticks)
3. Quando faltarem 1200 ticks do mandato: "Falta 1 minuto para início das eleições"
4. Quando faltarem 600 ticks do mandato: "Faltam 30 segundos para início das eleições"
5. Eleição começa
6. Durante eleição: "Falta 1 minuto para fim das eleições", etc.