给服务器加命令

安全取得玩家 · 位置见本节说明

if (!(sender instanceof Player player)) {
    sender.sendMessage("请在游戏里领取工具包");
    return true;
}
player.sendMessage(Component.text("背包主人确认完毕"));

错误的强制转换 · 故意错误，先预测再修复

Player player = (Player) sender; // 控制台执行会出错

只接受一个参数 · 位置见本节说明

if (args.length != 1) {
    player.sendMessage(Component.text("用法：/kit miner 或 /kit builder"));
    return true;
}

不受系统语言影响的比较 · 位置见本节说明

String name = args[0].toLowerCase(Locale.ROOT);

本课完整 plugin.yml · 完整文件

name: BlockAcademyL32
version: 1.0.0
main: de.teacherma.lesson32.KitPlugin
api-version: '1.21.11'
author: TeacherMa
website: https://www.teacher-ma.de
commands:
  kit:
    description: 领取课堂工具包
    usage: /kit <miner|builder>
permissions:
  blockacademy.kit:
    default: true

执行前查权限 · 位置见本节说明

if (!player.hasPermission("blockacademy.kit")) {
    player.sendMessage(Component.text("你还没有领取权限"));
    return true;
}

发物品并处理剩余 · 位置见本节说明

var leftovers = player.getInventory().addItem(
        new ItemStack(Material.TORCH, 16));
for (ItemStack item : leftovers.values()) {
    player.getWorld().dropItemNaturally(player.getLocation(), item);
}

反馈要符合结果 · 位置见本节说明

String message = leftovers.isEmpty()
        ? "全部放入背包" : "剩余物品掉在脚边";
player.sendMessage(Component.text(message));

从列表筛选补全项 · 位置见本节说明

String prefix = args[0].toLowerCase(Locale.ROOT);
return List.of("miner", "builder").stream()
        .filter(name -> name.startsWith(prefix)).toList();

不要访问不存在的参数 · 位置见本节说明

if (args.length != 1) return List.of();
if (!sender.hasPermission("blockacademy.kit")) return List.of();

用 switch 选配方 · 位置见本节说明

ItemStack[] items = switch (name) {
    case "miner" -> new ItemStack[] {
        new ItemStack(Material.STONE_PICKAXE),
        new ItemStack(Material.TORCH, 16)};
    default -> null;
};

KitPlugin 第1部分 · 本段1/2，顺序连接

package de.teacherma.lesson32;

import java.util.List;
import java.util.Locale;
import java.util.Objects;
import net.kyori.adventure.text.Component;
import org.bukkit.Material;
import org.bukkit.command.Command;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.inventory.ItemStack;
import org.bukkit.plugin.java.JavaPlugin;

public final class KitPlugin extends JavaPlugin {
    @Override
    public void onEnable() {
        var kit = Objects.requireNonNull(getCommand("kit"), "请检查 plugin.yml");
        kit.setExecutor(this);
        kit.setTabCompleter(this);
    }

    @Override
    public boolean onCommand(CommandSender sender, Command command,
                             String label, String[] args) {
        if (!(sender instanceof Player player)) {

KitPlugin 第1部分 · 本段2/2，顺序连接

            sender.sendMessage("请在游戏里领取工具包");
            return true;
        }
        if (!player.hasPermission("blockacademy.kit")) {
            player.sendMessage(Component.text("你还没有领取权限"));
            return true;
        }
        if (args.length != 1) {
            player.sendMessage(Component.text("用法：/kit miner 或 /kit builder"));
            return true;
        }

KitPlugin 第2部分 · 本段1/2，顺序连接

        ItemStack[] items = switch (args[0].toLowerCase(Locale.ROOT)) {
            case "miner" -> new ItemStack[] {
                new ItemStack(Material.STONE_PICKAXE),
                new ItemStack(Material.TORCH, 16)};
            case "builder" -> new ItemStack[] {
                new ItemStack(Material.OAK_PLANKS, 32),
                new ItemStack(Material.GLASS, 16)};
            default -> null;
        };
        if (items == null) {
            player.sendMessage(Component.text("只认识 miner 和 builder"));
            return true;
        }
        var leftovers = player.getInventory().addItem(items);
        for (ItemStack item : leftovers.values()) {
            player.getWorld().dropItemNaturally(player.getLocation(), item);
        }
        player.sendMessage(Component.text(leftovers.isEmpty()
                ? "工具包已放入背包" : "背包已满，剩余物品掉在脚边"));
        return true;
    }

    @Override
    public List<String> onTabComplete(CommandSender sender, Command command,
                                       String alias, String[] args) {

KitPlugin 第2部分 · 本段2/2，顺序连接

        if (!sender.hasPermission("blockacademy.kit") || args.length != 1)
            return List.of();
        String prefix = args[0].toLowerCase(Locale.ROOT);
        return List.of("miner", "builder").stream()
                .filter(name -> name.startsWith(prefix)).toList();
    }
}

提取一个配方方法 · 位置见本节说明

private ItemStack[] minerKit() {
    return new ItemStack[] {
        new ItemStack(Material.STONE_PICKAXE),
        new ItemStack(Material.TORCH, 16)};
}

帮助消息也要一致 · 位置见本节说明

player.sendMessage(Component.text("用法：/kit miner 或 /kit builder"));
// plugin.yml 中 usage 写成同样的选择范围