LastHolo - 全息聊天插件

Last Holo —— 全息聊天引领者

Last Holo 是一款功能强大的全息聊天插件，它能在玩家说话时，在其头顶生成带有聊天内容的全息文字。插件高度可定制，支持多行显示、区域限制、音效等丰富功能，且无需依赖其他插件，旨在为任何类型的服务器提供流畅、美观的聊天增强体验。

💡核心特性

• 开源且轻量：代码开源，性能高效，对服务器负担小。
• 内置全息系统：无需依赖 HolographicDisplays 等插件。
• 高度可定制：可调整全息文字的位置、持续时间、格式、长度等。
• 多行与长度限制：支持自动换行，并可限制单条消息的最大长度。
• 区域与世界控制：支持基于 WorldGuard 区域和特定世界的启用/禁用。
• 邻近显示：可设置为仅让一定范围内的玩家看到全息文字。
• 聊天隐藏：可选择是否同时发送原始聊天消息到公屏。
• 权限支持：所有功能均可通过权限节点控制。
• PlaceholderAPI 支持：可在聊天格式中使用 PlaceholderAPI 变量。
• SuperVanish 支持：兼容 SuperVanish 插件，隐身玩家聊天不会暴露。
• 整洁模式：智能排列全息文字，防止重叠，视觉效果更佳。
• 跟随全息：全息文字会跟随玩家移动而移动。
• 音效系统：支持为发送者和接收者播放自定义音效。

🎮指令与权限

指令列表

• /lastholo reload - 重载插件配置。需要权限：holo.reload
• /lastholo toggle - 开关你自己的全息聊天显示。需要权限：holo.toggle
• /lastholo blacklist - 管理词语黑名单。需要权限：lastholo.blacklist.<use/add/remove/list>
• /lastholo info - 查看插件版本信息。
• /lastholo clear - BUG 修复工具，清除 4x4x4 半径内残留的实体全息。

主要权限节点

• holo.chat - 允许使用全息聊天。
• holo.color - 允许在全息聊天中使用颜色代码。
• lastholo.superplaceholder - 允许在聊天消息中解析 PlaceholderAPI 变量（超级变量）。

🔧配置详解 (`config.yml`)

以下为关键配置项说明，完整配置请查看插件文件。

基础设置

• async_chat_processing: true - 启用异步聊天处理以提升性能（重启生效）。
• holo_offset: 2.4 - 全息文字在玩家站立位置之上的最终高度。
• holo_livetick: 95 - 全息文字的持续时间（单位：刻，20刻=1秒）。
• holo_firstoffset: 1.5 - 全息文字首次生成时的起始高度。
• chat_format: "&6Says: &r%CHAT%" - 全息文字的显示格式，%CHAT% 为原始消息占位符。

功能开关

• nearby_only.use_system: true - 启用仅附近玩家可见功能。
• nearby_only.min_range: 13 - 附近玩家的最小可见范围。
• original_chat.hidden: false - 是否隐藏原始聊天消息（不发送到公屏）。
• original_chat.requires_toggle: true - 是否需要玩家使用 /lh toggle 手动开启全息聊天。

长度与换行

• enable_max_length: false - 是否启用消息长度限制。
• max_length: 35 - 消息最大长度（包含颜色码、空格等所有字符）。
• enable_new_line_if_full: true - 当消息过长时是否自动换行。
• each_line_length: 15 - 自动换行后，每行允许的最大字符数。

区域与世界控制

• disable_certain_worlds: true - 是否在特定世界禁用全息聊天。
• disabled_worlds: 列表，例如 - "MD5"。
• disable_certain_regions: true - 是否在特定 WorldGuard 区域禁用全息聊天。
• disabled_regions: 列表，例如 - "PVP"。
• ignore_region_option: false - 设为 true 可完全忽略 WorldGuard/WorldEdit 相关错误。

音效

• enable_local_sound: true - 是否为发送者播放本地音效。
• local_sounds: 列表，格式为 <SOUND>-<VOLUME>-<PITCH>，例如 "ENTITY_VILLAGER_YES-1.0-0.8"。
• enable_global_sound_effect: true - 是否为所有听到消息的玩家播放全局音效。
• global_sounds: 列表，格式同上，例如 "NOTE_PLING-0.5-2.0"。

❓常见问题 (FAQ)

• Q: 全息文字重叠在一起了怎么办？
• A: 尝试在配置中禁用 marker_armorstand 选项，或调整 holo_gap 值。

• Q: async_chat_processing 选项是做什么的？
• A: 用于异步处理聊天事件以提升性能。如果遇到异步错误，请禁用它（需要重启服务器）。

• Q: 全息文字不显示！
• A: 请检查配置：nearby_only（附近显示）、original_chat.hidden（隐藏聊天）、世界限制是否设置正确，并确保插件运行正常。

• Q: 出现关于 BlockVector3、WorldEdit、WorldGuard、Vector 等的错误。
• A: 在配置中将 ignore_region_option 设为 true 可以完全忽略这些错误。

• Q: 有一些因BUG残留的旧全息文字无法移除！
• A: 使用指令 /lh clear，它可以清除 4x4x4 半径内的所有全息文字实体。

• Q: special_armorstand 是做什么的？
• A: 它使用来自 NMS 的特殊实体创建盔甲架，效果更好。如果遇到错误，可以禁用它，插件将使用普通的盔甲架。

• Q: async_holo_removal 和 async_teleportation 是做什么的？
• A: 它们分别用于异步移除全息实体和异步传送实体。如果服务器在异步线程中执行这些操作时报错，启用这些选项可以解决。

⭐开发者 API

插件提供了事件 API，方便其他开发者集成。

/*
 * PreHoloChatEvent 在全息文字构建前调用。
 * PostHoloChatEvent 在全息文字创建后调用。
 */
@EventHandler
public void onHoloChat(PreHoloChatEvent e) {
    HoloData data = e.getHoloData();
    Player owner = data.getOwner();
    if (this.isHandsome(owner)) {
        return;
    }
    e.setCancelled(true);
}

@EventHandler
public void onHoloChat(PostHoloChatEvent e) {
    if (this.isAllowed(e.getLineDatas()) {
        return;
    }
    e.setCancelled(true);
}

**音效列表参考（最新版本）**

请访问 SpigotMC 论坛的相关帖子查找可用的音效枚举名称。

✨链接与支持

• SpigotMC 主页: 点击访问
• Discord 社区: 欢迎加入以获取支持和更新。
• Facebook: [点击连接](作者Facebook链接)

**致谢**

• 特别感谢 @AntonioRush (DiamondRushXD) 制作的英文宣传视频。
• 感谢 @Ajneb97 制作的法语宣传视频（注：该视频基于 1.9.6.5 版本之前录制）。

**关于依赖**

自 3.0.0 版本起，插件已移除对 HolographicDisplays 的依赖。