PComandosPlugin - README

Português (BR)

Descrição

O PComandosPlugin permite associar comandos a itens no Minecraft,
possibilitando que jogadores executem comandos específicos ao interagir
com esses itens. O plugin suporta configurações de usos, duração,
cooldowns e permissões, com integração ao PlaceholderAPI para mensagens
personalizadas.

Comandos

/comandoitem <duração(s/m/h/d)> [all]

Aplica um comando ao item segurado na mão principal.

• <comando>{=html}: Nome do comando configurado no config.yml.
• <usos>{=html}: Número de usos (máximo definido no
  config.yml).
• <duração>{=html}: Duração da permissão (ex.: 10s, 5m, 2h, 1d).
• [all]: (Opcional) Usa todas as cargas de uma vez (requer
  permissão pcomandos.useall).
• Permissão: pcomandos.usar

Exemplo:
/comandoitem fly 5 10m

---

/comandoitem reload

Recarrega as configurações do plugin (config.yml e messages.yml).

• Permissão: pcomandos.reload
• Exemplo: /comandoitem reload

---

/comandoitem ajuda

Exibe a mensagem de ajuda com os comandos disponíveis.

• Permissão: pcomandos.usar
• Exemplo: /comandoitem ajuda

---

Funcionamento

Aplicação de Comandos

• Use /comandoitem <comando> <usos> <duração> [all] para associar um
  comando a um item.
• O item deve estar na mão principal, não pode estar em stack e não
  pode ser um item restrito.
• O comando é armazenado no item com metadados (usos, duração,
  cooldown).

Uso de Itens

• Clique com o botão direito para executar o comando associado.
• O plugin verifica permissões, cooldown, usos restantes e se o
  comando já está ativo.
• Com [all] ou ao agachar com permissão pcomandos.useall, todos os
  usos são consumidos.
• O item é atualizado ou removido ao terminar os usos.

Gerenciamento de Permissões

• Permissões temporárias baseadas na duração informada.
• Estados anteriores são restaurados ao expirar.
• Aviso enviado 1 minuto antes da expiração.

Integração com Banco de Dados

• Suporte a MySQL ou SQLite.
• Limpeza automática de dados expirados.

Feedback

• Mensagens, títulos, action bars e sons configuráveis.
• Integração com PlaceholderAPI.

---

Permissões

• pcomandos.usar: Permite usar /comandoitem.
• pcomandos.reload: Permite recarregar o plugin.
• pcomandos.useall: Permite usar o modo [all].

---

English

Description

The PComandosPlugin allows associating commands with Minecraft items,
enabling players to execute commands by interacting with them. Supports
uses, duration, cooldowns, permissions, and PlaceholderAPI integration.

Commands

/comandoitem <duration(s/m/h/d)> [all]

Applies a command to the held item.

• <command>{=html}: Defined in config.yml.\
• <uses>{=html}: Maximum defined in config.yml.\
• <duration>{=html}: Ex.: 10s, 5m, 2h, 1d\
• [all]: Uses all charges at once.\
• Permission: pcomandos.usar

Example: /comandoitem fly 5 10m

---

/comandoitem reload

Reloads configurations.

• Permission: pcomandos.reload

---

/comandoitem ajuda

Displays help.

• Permission: pcomandos.usar

---

Functionality

Command Application

• Apply commands to items using /comandoitem.
• Must be in the main hand, not stacked, not restricted.
• Stored in item metadata.

Item Usage

• Right‑click to execute the command.
• Checks permissions, cooldown, uses, active state.
• [all] or sneaking consumes all uses.
• Item updates or is removed.

Permission Management

• Temporary permissions granted.
• Previous states restored on expiration.
• Warning sent 1 minute before expiration.

Database Integration

• Supports MySQL and SQLite.
• Automatic cleanup of expired data.

Feedback

• Configurable messages, titles, action bars, sounds.
• PlaceholderAPI support.

---

Permissions

• pcomandos.usar
• pcomandos.reload
• pcomandos.useall