Minecraft 插件开发：向指定玩家发送消息-java教程-PHP中文网

Minecraft 插件开发：向指定玩家发送消息

花韻仙語

发布： 2025-08-01 20:02:15

原创

270人浏览过

minecraft 插件开发：向指定玩家发送消息

本文将指导你如何开发一个 Minecraft 插件，该插件可以从配置文件中读取玩家列表，并在特定事件发生时，向这些玩家发送消息。我们将重点介绍如何正确读取配置文件、遍历玩家列表，以及安全地向在线玩家发送消息，避免常见的空指针异常。

从配置文件读取玩家列表并发送消息

1. 配置文件 (config.yml) 设置

首先，在你的插件的 config.yml 文件中，定义一个包含玩家名字的列表。例如：

MinePlayers:
  - me
  - someone_else
  - another_player

登录后复制

2. 插件代码实现

接下来，我们将创建一个监听器类，用于监听 BlockBreakEvent 事件，并在事件发生时，向配置文件中指定的玩家发送消息。

import org.bukkit.Bukkit;
import org.bukkit.Material;
import org.bukkit.block.Block;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.block.BlockBreakEvent;
import org.bukkit.plugin.Plugin;
import org.bukkit.plugin.java.JavaPlugin;

import java.util.List;

public class AntiXrayListener implements Listener {

    private final Plugin plugin;

    public AntiXrayListener(Plugin plugin) {
        this.plugin = plugin;
    }

    @EventHandler
    public void onBlockBreak(BlockBreakEvent event) {
        Player player = event.getPlayer();
        Block block = event.getBlock();
        Material blockType = block.getType();

        List<String> minePlayers = plugin.getConfig().getStringList("MinePlayers");

        for (String playerName : minePlayers) {
            Player targetPlayer = Bukkit.getPlayerExact(playerName);

            if (targetPlayer != null && targetPlayer.isOnline()) {
                sendMessage(blockType, targetPlayer, player);
            }
        }
    }

    private void sendMessage(Material blockType, Player targetPlayer, Player breaker) {
        targetPlayer.sendMessage("玩家 " + breaker.getName() + " 破坏了方块: " + blockType.name());
    }
}

登录后复制

代码解释:

星火作家大神

星火作家大神是一款面向作家的AI写作工具

查看详情

AntiXrayListener 类: 实现了 Listener 接口，用于监听 Minecraft 事件。
plugin 字段: 存储插件的实例，用于访问配置文件。
onBlockBreak 方法: 监听 BlockBreakEvent 事件，当玩家破坏方块时触发。
plugin.getConfig().getStringList("MinePlayers"): 从配置文件中读取名为 "MinePlayers" 的字符串列表。
Bukkit.getPlayerExact(playerName): 根据玩家名字获取 Player 对象。注意：此方法返回的 Player 对象可能为 null，如果玩家不在线。
targetPlayer != null && targetPlayer.isOnline(): 非常重要！ 检查 targetPlayer 是否为 null 并且玩家是否在线，避免空指针异常。
sendMessage 方法: 向目标玩家发送消息。

3. 注册监听器

在你的主插件类中，注册 AntiXrayListener 监听器。

import org.bukkit.plugin.java.JavaPlugin;

public class MyPlugin extends JavaPlugin {

    @Override
    public void onEnable() {
        getServer().getPluginManager().registerEvents(new AntiXrayListener(this), this);
    }
}

登录后复制