# Documentação do Plugin MekaLimits
Bem-vindo à documentação oficial do MekaLimits! Aqui encontrará tudo o que precisa para configurar e gerir o plugin no seu servidor.
## 1. Comandos
| Comando | Descrição | Permissão |
| -------------------------------- | ----------------------------------------------------------------------- | -------------------- |
| `/remover` | Remove o bloco limitado que o jogador está a olhar (se for o dono). | (Nenhuma) |
| `/mekalimits help` | Mostra a lista de comandos disponíveis. | (Nenhuma) |
| `/mekalimits reload` | Recarrega os ficheiros `config.yml` e `messages.yml`. | `mekalimits.admin` |
| `/mekalimits add <quantidade>` | Adiciona o item na mão do admin à lista de limites. | `mekalimits.admin` |
| `/mekalimits tp <id>` | Teleporta o admin para o local de uma infração de "fake player". | `mekalimits.admin` |
## 2. Permissões
* `mekalimits.admin`
* Concede acesso a todos os comandos de administração (`/mekalimits reload`, `/mekalimits add`, `/mekalimits tp`).
* Por defeito, esta permissão é atribuída a todos os OPs.
## 3. Ficheiro de Configuração (`config.yml`)
O ficheiro `config.yml` é o coração do plugin. Aqui pode definir todos os comportamentos principais.
```yaml
# Cooldown em segundos para o jogador poder usar o comando /remover novamente.
# Use 0 para desativar o cooldown. Valor decimal (ex: 0.5) é aceite.
remover-cooldown: 0.1
# Configurações da proteção contra 'Fake Players' (blocos colocados por mods).
fake-player-protection:
# Ativa ou desativa completamente esta funcionalidade.
enabled: true
# Se true, o bloco que o fake player tentou colocar será dropado no chão.
# Se false, o bloco é simplesmente destruído.
drop-block: true
# Esta é a secção principal onde você define os limites.
# O formato é: NOME_DO_BLOCO_EM_MAIÚSCULAS: LIMITE_MÁXIMO
limited-blocks:
# Exemplo: Limita os Spawners a 5 por jogador.
SPAWNER: 5
# Exemplo para um bloco de mod (o nome deve ser o ID oficial do item):
# INDUSTRIALFOREGOING_BIOMASS_REACTOR: 1
```
## 4. Ficheiro de Mensagens (`messages.yml`)
Este ficheiro permite-lhe personalizar **todas** as mensagens que o plugin envia aos jogadores. Pode traduzir para qualquer língua e usar códigos de cor com `&`.
```yaml
# Mensagens Gerais
prefix: "&8[&6MekaLimits&8] "
reload-success: "&aConfiguracao e mensagens recarregadas com sucesso!"
no-permission: "&cVoce nao tem permissao para usar este comando."
player-only: "&cEste comando so pode ser usado por jogadores."
# Comando /remover
remover:
look-at-block: "&cVoce precisa estar olhando para um bloco."
# A variável %owner% será substituída pelo nome do dono.
not-your-block: "&cEste bloco pertence a &e%owner%&c e esta protegido."
not-limited-block: "&cEste bloco nao e seu ou nao esta na lista de blocos limitados."
inventory-full: "&cSeu inventario esta cheio! Libere espaco para remover o bloco."
success: "&aBloco removido e adicionado ao seu inventario!"
# A variável %time% será substituída pelo tempo restante.
cooldown: "&cAguarde &e%time% &csegundos para usar este comando novamente."
# Colocar Bloco
block-place:
# Variáveis: %limit%, %type%
limit-reached: "&cVoce atingiu o limite de &e%limit% &cblocos do tipo &e%type%&c."
# Variáveis: %current%, %limit%, %type%
success: "&aBloco colocado! Voce tem &e%current%&8/&e%limit% &ablocos de &e%type%&a."
# ... e todas as outras mensagens ...
```