P_Comandos

# 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)> ` 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). - **\**: (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> ` 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 `` 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 ``. ------------------------------------------------------------------------ # 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)> ` 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\ - **\**: 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. - `` 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`