PComandosPlugin - README
中文(简体)
描述
PComandosPlugin 允许在 Minecraft 中将命令与物品关联,
使玩家在与这些物品互动时能够执行特定的命令。该插件支持使用次数、持续时间、
冷却时间和权限的配置,并与 PlaceholderAPI 集成以提供自定义消息。
命令
/comandoitem <持续时间(s/m/h/d)> [all]
将命令应用于主手所持的物品。
<comando>{=html}: 在 config.yml 中配置的命令名称。
<usos>{=html}: 使用次数(在 config.yml 中定义的最大值)。
<duração>{=html}: 权限持续时间(例如:10s、5m、2h、1d)。
- [all]: (可选)一次性使用所有充能(需要
pcomandos.useall 权限)。
- 权限:
pcomandos.usar
示例:
/comandoitem fly 5 10m
/comandoitem reload
重新加载插件配置(config.yml 和 messages.yml)。
- 权限:
pcomandos.reload
- 示例:
/comandoitem reload
/comandoitem ajuda
显示可用命令的帮助信息。
- 权限:
pcomandos.usar
- 示例:
/comandoitem ajuda
工作原理
命令应用
- 使用
/comandoitem <命令> <次数> <持续时间> [all] 将命令绑定到物品上。
- 物品必须位于主手,不能处于堆叠状态,且不能是受限物品。
- 命令会存储在物品的元数据中(包括使用次数、持续时间和冷却时间)。
物品使用
- 右键点击以执行关联的命令。
- 插件会检查权限、冷却时间、剩余使用次数以及命令是否已激活。
- 使用
[all] 或持有 pcomandos.useall 权限时蹲下,将消耗所有可用次数。
- 使用次数用尽后,物品将被更新或删除。
权限管理
- 基于指定持续时间的临时权限。
- 过期后恢复之前的状态。
- 过期前 1 分钟发送警告通知。
数据库集成
- 支持 MySQL 或 SQLite。
- 自动清理过期数据。
反馈
- 可自定义消息、标题、操作栏和音效。
- 集成 PlaceholderAPI。
权限
pcomandos.usar:允许使用 /comandoitem。
pcomandos.reload:允许重新加载插件。
pcomandos.useall:允许使用 [all] 模式。
English
描述
PComandosPlugin 允许将命令与 Minecraft 物品关联,使玩家能够通过交互执行命令。支持使用次数、持续时间、冷却时间、权限以及 PlaceholderAPI 集成。
命令
/comandoitem <持续时间(s/m/h/d)> [all]
为手持物品应用一个命令。
<command>{=html}: 在 config.yml 中定义。\
<uses>{=html}: 在 config.yml 中定义的最大使用次数。\
<duration>{=html}: 例如:10s、5m、2h、1d\
- [all]: 一次性消耗所有充能次数。\
- 权限:
pcomandos.usar
示例: /comandoitem fly 5 10m
/comandoitem reload
重新加载配置。
/comandoitem ajuda
显示帮助信息。
功能说明
命令应用
- 使用
/comandoitem 将命令应用到物品上。
- 物品必须位于主手,且不能堆叠或受限。
- 数据存储在物品的元数据中。
物品使用
- 右键点击以执行命令。
- 会检查权限、冷却时间、使用次数及激活状态。
- 使用
[all] 参数或潜行时消耗所有剩余使用次数。
- 物品使用次数更新或被移除。
权限管理
- 授予临时权限。
- 过期后恢复之前的权限状态。
- 在过期前 1 分钟发送警告消息。
数据库集成
- 支持 MySQL 和 SQLite。
- 自动清理过期的数据。
反馈
- 可配置的消息、标题(Titles)、操作栏(Action Bars)和音效。
- 支持 PlaceholderAPI。
权限
pcomandos.usar
pcomandos.reload
pcomandos.useall
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧