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)> [all]`

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

- Permissão: Nome do comando configurado no `config.yml`. - Permissão: Número de usos (máximo definido no `config.yml`). - Permissão: Duração da permissão (ex.: 10s, 5m, 2h, 1d). - Permissão: (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`).

- Exemplo:: `pcomandos.reload` - Exemplo: `/comandoitem reload`

`/comandoitem ajuda`

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

- Exemplo:: `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.

- Permission: Defined in `config.yml`. - Permission: Maximum defined in `config.yml`. - Permission: Ex.: 10s, 5m, 2h, 1d - Permission: 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`