基础用法：在游戏内向玩家发送文本消息
使用 Player#sendMessage 方法
在 Minecraft 插件开发中，向玩家发送文本消息是最基础的交互能力之一。Spigot/Bukkit 提供的 核心 API 能让你直接将文本投送给单个玩家，常用的方法是 Player.sendMessage，也有全服务器广播的接口 Bukkit.broadcastMessage。
最常见的场景是向目标玩家发送简单文本，例如欢迎信息、提示或指令引导。将信息发送给特定玩家是最直观的实现方式，也是很多后续富文本与交互消息的基础。注意不同版本对文本格式的支持略有差异，务必结合目标版本进行测试。
import org.bukkit.ChatColor;
import org.bukkit.entity.Player;// 假设已获取 Player 实例
Player player = ...;// 发送简单文本
player.sendMessage(ChatColor.GREEN + "欢迎来到服务器！");
除了单次发送，还可以逐步构建多行文本消息。多段文本发送通常使用多次调用 sendMessage，也可以在一个消息中包含换行符实现多行展示。下面是另一种常见写法示例：
player.sendMessage(ChatColor.YELLOW + "这是第一行消息");
player.sendMessage(ChatColor.YELLOW + "这是第二行消息");
// 也可以在一个字符串中使用换行
player.sendMessage("第一行文本\n第二行文本");
富文本与组件化消息
使用文本组件实现可点击文本
当需要实现颜色、下划线、悬浮提示、以及点击立即执行命令等交互行为时，文本组件是推荐方案。早期的实现基于 BungeeCord 的文本组件，后来逐渐向 Kyori Adventure 组件迁移，提供更丰富的格式化能力。可以在同一条消息中组合多段文本、不同颜色和事件，提升玩家体验。以下展示了两种常见的实现方式。
第一种是使用 BungeeCord 的 TextComponent 方案，适用于较旧的 Spigot 版本，便于添加点击事件和悬浮文本：
import net.md_5.bungee.api.chat.TextComponent;
import net.md_5.bungee.api.chat.ClickEvent;
import net.md_5.bungee.api.chat.HoverEvent;
import net.md_5.bungee.api.chat.ComponentBuilder;
import net.md_5.bungee.api.ChatColor;// 构建带交互的文本消息
TextComponent message = new TextComponent("点击这里");
message.setColor(ChatColor.GREEN);
message.setClickEvent(new ClickEvent(ClickEvent.Action.RUN_COMMAND, "/shop"));
message.setHoverEvent(new HoverEvent(HoverEvent.Action.SHOW_TEXT,new ComponentBuilder("打开商店").create()));// 通过 Spigot 的文本发送接口发送组件
player.spigot().sendMessage(message);
第二种是使用 Kyori Adventure 的组件体系，适用于较新版本且需要与服务器端的 Adventure 适配层结合的场景。Adventure 提供 Component、ClickEvent、HoverEvent 等 API，能无缝与现代文本渲染结合。下面给出一个简化示例，展示如何用组件构建一个带点击和悬浮提示的文本：
import net.kyori.adventure.text.Component;
import net.kyori.adventure.text.event.ClickEvent;
import net.kyori.adventure.text.event.HoverEvent;
import net.kyori.adventure.text.format.NamedTextColor;// 构建互动文本
Component message = Component.text("点击这里").color(net.kyori.adventure.text.format.NamedTextColor.GREEN).clickEvent(ClickEvent.runCommand("/shop")).hoverEvent(HoverEvent.showText(Component.text("打开商店")));// 需要服务器端对 Adventure 的适配支持（方法签名可能因版本而异）
player.sendMessage(message);
跨版本兼容性与消息发送方式的选择
适配不同版本的消息发送方案
在不同的 Minecraft 版本中，消息发送的 API 有所差异。旧版本往往以字符串方式发送文本和简单颜色，而新版本可以借助 TextComponent/Adventure API 实现更丰富的交互能力。开发时要根据目标服务器的版本选择合适的实现路径，以确保插件兼容性和稳定性。
如果你的服务器版本较新，推荐使用 Kyori Adventure 的文本组件和事件，这样可以获得更一致的跨客户端渲染和交互能力；如果需要兼容性更广的老版本，可以保留 TextComponent 的实现，并在构建时对版本进行检测和降级处理。务必在实现前进行版本检测和单元测试，避免运行时崩溃。
// 旧版本兼容示例：仅使用文本与简单颜色
player.sendMessage("欢迎来到服务器！");// 新版本 Adventure 集成示例（需服务器端适配层支持 Adventure 转换）
import net.kyori.adventure.text.Component;
import net.kyori.adventure.text.event.ClickEvent;Component msg = Component.text("前往商店").color(net.kyori.adventure.text.format.NamedTextColor.GREEN).clickEvent(ClickEvent.runCommand("/shop"));
player.sendMessage(msg);
实践示例：发送带按钮的交互式消息
实现可点击的导航信息
通过交互式文本，可以在游戏内实现类似按钮的效果，让玩家在点击文本时执行命令或打开链接。点击事件（ClickEvent）和 悬浮提示（HoverEvent）是实现的核心。注意在使用点击事件时，请确保相关指令在服务器端具备执行权限，并对玩家进行相应的权限校验。
下面给出一个常见场景：通过点击文本执行服务器指令，例如打开商店。示例分为旧文本组件和新 Adventure 的实现两部分，便于在不同版本的服务器上迁移与对比。
// 使用 Bungee 文本组件实现带点击的文本
import net.md_5.bungee.api.chat.TextComponent;
import net.md_5.bungee.api.chat.ClickEvent;TextComponent t = new TextComponent("点击这里打开商店");
t.setClickEvent(new ClickEvent(ClickEvent.Action.RUN_COMMAND, "/shop"));
player.spigot().sendMessage(t);
// 使用文本组件的悬浮提示 + 点击事件
import net.md_5.bungee.api.chat.TextComponent;
import net.md_5.bungee.api.chat.ClickEvent;TextComponent t = new TextComponent("官方论坛");
t.setClickEvent(new ClickEvent(ClickEvent.Action.OPEN_URL, "https://example.com"));
t.setHoverEvent(new HoverEvent(HoverEvent.Action.SHOW_TEXT, new ComponentBuilder("前往官方论坛").create()));
player.spigot().sendMessage(t);
// 使用 Kyori Adventure 构建的交互文本（现代做法）
import net.kyori.adventure.text.Component;
import net.kyori.adventure.text.event.ClickEvent;Component c = Component.text("打开商店").color(net.kyori.adventure.text.format.NamedTextColor.GREEN).clickEvent(ClickEvent.runCommand("/shop"));
player.sendMessage(c);
