AdvancedMention (DISCONTINUED) - AdvancedMention - 高级聊天提及系统

AdvancedMention 是一款功能全面的玩家提及插件，支持在聊天中通过@来提醒其他玩家或全体成员，并提供丰富的视觉、声音和统计反馈，同时具备高度的可定制性。

💡重要提示

• 如果你计划将此插件与 DiscordSRV 一同使用，请务必在 DiscordSRV 的配置文件中禁用提及（mentions）功能。未来如果需要，我会为其添加专门的支持。

🎮核心功能

• 玩家提及：在聊天中提及特定玩家。
• 全体提及：在聊天中使用 @everyone 提醒服务器全体成员。
• 新玩家加入通知：当有新玩家加入服务器时发出提及通知。
• 提及颜色：自定义提及文本的颜色。
• 提及计数器：统计提及次数。
• 动作栏支持：在玩家的动作栏显示提及通知。
• 标题支持：在玩家屏幕中央显示标题形式的提及通知。
• 音效：播放自定义音效作为提醒。
• 粒子效果：生成粒子效果增强视觉反馈。
• 可编辑标签符号：自定义提及使用的符号（如 @）。
• 带空格的醒目提及：使提及的消息更突出（可配置）。
• 功能开关：可独立启用或禁用玩家提及和全体提及功能。
• 插件API：为开发者提供集成接口。
• 内置更新检查器：自动检查插件更新。
• 多语言支持：支持多种语言。
• 隐身兼容：支持与隐身（Vanish）类插件协同工作。

🔧支持的服务器核心

• Bukkit / Spigot
• Paper / PaperSpigot

如果你使用的服务器核心导致插件无法完全正常工作，请通过 Discord 或 SpigotMC 私信联系我。

❓常见问题解答

兼容性

此插件支持其他聊天插件吗？

是的，完全支持。本插件仅替换消息中的特定“提及”部分。没有自带提及功能的聊天插件应该100%兼容。如果你发现本插件与其他插件冲突，请尽快私信我。

功能与配置

聊天中有人用空格反复提及我，导致刷屏，该怎么办？

你可以在配置文件中禁用“空格”功能（可以为两种提及类型分别设置）。如果你被标签刷屏，建议安装一个反刷屏插件。我将在未来的更新中尝试加入提及防刷屏系统。

所有功能都可以编辑吗？

是的，100%可以。所有功能都可以在 config.yml 中进行配置。目前消息文本本身不可编辑，但消息内容本身也没什么需要编辑的（未来可能会为动作栏消息添加编辑支持）。

AdvancedMention 不支持我的语言？

如果是这样，请在 Spigot 上给我发消息或加入我的 Discord 服务器，我会尽快添加对该语言的支持。

获得支持的最佳/最快方式是什么？

通过 Discord。是的，Discord 能获得最快的回复。你也可以通过 Spigot 对话私信我。你可以加入我的 Discord（滚动到页面底部，点击“CLICK HERE”即可加入）。

工作原理与优势

这个插件是如何工作的？

• 玩家提及：在消息中说出玩家名字，或使用 @<玩家名>，即可提及该玩家。如果启用（默认启用），还会为被提及的玩家将消息间隔开，使其更醒目。
• 全体提及：在消息中使用 @everyone，即可提及服务器上的所有人。如果启用（默认启用），同样会间隔消息使其更醒目。

为什么选择 AdvancedMention？

不仅因为它是免费的，还因为它没有性能问题，并且兼容多个版本！本插件包含超过10项功能，且全部可配置，其功能超越了市面上大多数付费或免费的提及插件（你不再需要花一分钱）。

⭐开发者 API

本插件内置了 API。请确保在你的 plugin.yml 中添加：soft-depend: [AdvancedMention]

API 功能概览

import me.syxteen.advancedmention.API.amAPI;
amAPI api;

提及与音效

• mentionEveryone(String msg); - 在聊天中提及所有人（广播）。
• sendEveryoneSound(Sound sound, float volume, float pitch); - 向所有人发送音效。
• mentionPlayer(Player target, String msg); - 在聊天中提及特定玩家（发送消息）。
• sendPlayerSound(Player target, Sound sound, float volume, float pitch); - 向特定玩家发送音效。

统计数据

• getPlayerMentions(); - 返回玩家被提及的次数。
• getEveryoneMentions(); - 返回全体提及的次数。
• getTotalMentions(); - 返回提及总次数（玩家提及+全体提及）。

其他功能

• isEveryoneMention(); - 检查全体提及功能是否启用。
• isPlayerMention(); - 检查玩家提及功能是否启用。
• setLanguage(String lang); - 设置插件语言。
• getCurrentLanguage(); - 获取当前语言。

🔧命令与权限

命令

• /am - 显示版本/帮助信息。
• /am help - 显示帮助页面。
• /am reload - 重载插件配置文件。
• /am stats - 实时获取提及统计信息。

权限

• am.* - 授予所有权限（管理员权限）。
• am.command.access - 允许使用 /am 命令。
• am.command.help - 允许使用 /am help 命令。
• am.command.reload - 允许使用 /am reload 命令。
• am.command.stats - 允许使用 /am stats 命令。
• am.command.resetstats - 允许使用 /am resetstats 命令。
• am.mention.player - 允许提及玩家/被玩家提及。
• am.mention.everyone - 允许使用全体提及。
• am.newplayer.notify - 当有新玩家加入时获得通知，不再错过新人。
• am.updatechecker - 当有新版本更新时获得更新提醒。

✨资源与链接

• 支持的音效版本：1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15 及最新版。
• 粒子效果列表：请参考 Spigot Javadoc。
• 插件统计 (bStats)：查看 AdvancedMention 统计页面。

🔧使用 AdvancedMention 的服务器示例

• play.terraemc.net
• mgu.one

如果需要帮助，请加入我的 Discord 服务器：CLICK HERE。