如何在Minecraft中通过.jar插件开发自定义OP命令

开发前准备 #

• 已配置对应服务端版本的 Spigot/Paper API 开发依赖，JDK版本与服务端要求匹配（1.17+版本服务端需使用JDK16及以上，旧版本可使用JDK8）
• 已完成插件基础框架搭建，包含主类（继承JavaPlugin）、plugin.yml配置文件

步骤1：注册命令声明 #

在plugin.yml中添加自定义命令的配置信息，示例如下：

commands:
  giveop: # 此处可替换为你想要的自定义命令名
    description: 为指定玩家授予服务器管理员权限
    usage: /<command> <玩家ID>
    permission: customplugin.op.grant # 自定义权限节点，仅持有该节点的用户可执行命令
    permission-message: 你无权限使用该命令

步骤2：编写命令执行逻辑 #

新建命令执行类，实现CommandExecutor接口，重写onCommand方法实现核心逻辑，代码示例：

import org.bukkit.Bukkit;
import org.bukkit.command.Command;
import org.bukkit.command.CommandExecutor;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;

public class GrantOpCommand implements CommandExecutor {
    @Override
    public boolean onCommand(CommandSender sender, Command cmd, String label, String[] args) {
        // 参数校验
        if (args.length != 1) {
            sender.sendMessage("用法错误，请输入：/giveop <目标玩家ID>");
            return false;
        }
        // 获取目标玩家实例
        Player targetPlayer = Bukkit.getPlayerExact(args[0]);
        if (targetPlayer == null) {
            sender.sendMessage("错误：指定玩家不存在或当前不在线");
            return true;
        }
        // 授予OP权限
        targetPlayer.setOp(true);
        sender.sendMessage("操作成功，已为玩家 " + targetPlayer.getName() + " 授予OP权限");
        targetPlayer.sendMessage("你已获得服务器管理员（OP）权限");
        return true;
    }
}

步骤3：绑定命令到插件主类 #

在主类的onEnable生命周期方法中，注册命令对应的执行器，代码示例：

@Override
public void onEnable() {
    // 此处的命令名需和plugin.yml中注册的命令名完全一致
    this.getCommand("giveop").setExecutor(new GrantOpCommand());
}

注意事项 #

• 请严格控制命令的权限节点分配，避免低权限用户可执行该命令引发服务器安全风险
• 可根据需求扩展逻辑，比如添加操作日志记录、禁止为更高权限用户授OP等校验规则
• 开发完成后请先在测试环境验证逻辑正确性，再部署到正式服务器

内容的提问来源于stack exchange，提问作者Pupper