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。