? AuricChat - 你的服务器所需的所有聊天功能
AuricChat 是一款轻量级、完全双语且独立运行的 Minecraft 服务器聊天插件。通过单一且文档详尽的配置文件,全面掌控格式化、管理、私聊、等级等功能,无需任何强制依赖。
? 依赖项
- PlaceholderAPI (可选)
- LuckPerms (可选)
- MiniPlaceholders (可选)
? 安装
- 将
AuricChat.jar 放入服务器的 plugins 文件夹中。
- 启动或重启服务器。
- 根据
plugins/AuricChat/ 目录下生成的文件配置 AuricChat。
? 更新
- 对于小版本更新(例如
1.1.0 → 1.1.1),只需将现有的 .jar 文件替换为新版本并重启服务器即可。
- 对于大版本更新(例如
1.1.0 → 1.2.0),请先备份当前的配置文件和重要的插件数据,然后替换 .jar 文件,删除旧的 plugins/AuricChat/ 文件夹,并重启服务器以生成新文件。
- 更新后,恢复或重新应用之前的配置,并在继续之前查看任何新增的配置选项。
✨ 主要功能
- 双占位符支持: 每个令牌既可作为 PlaceholderAPI
%auricchat_x% 占位符,也可作为原生 MiniPlaceholders <auricchat_x> 标签使用——选择你现有设置所依赖的那一种即可。
- 无需 LuckPerms 的等级系统:
ranks.yml 中有三种可互换的模式——直接从 LuckPerms 获取、将其组匹配到你自己的列表,或者完全跳过 LuckPerms 而使用普通权限。
- 安全的 MiniMessage 格式化: 在聊天格式中完整支持渐变、悬停和点击动作,并通过分层权限控制,确保玩家仅获得你实际授予他们的格式化能力。

- 数据包聊天气泡: 发送者头顶上方的浮动文本气泡实验性功能。使用 packetevents 实现仅客户端渲染,在安装时几乎不增加服务器开销;若未安装则自动回退到轻量级的真实实体显示。

- 完整的管理工具包: 消息冷却时间、聊天慢速模式、重复消息过滤、反大写、反脏话审查以及完整的聊天静音——每一项均可独立开关。它们不会对玩家进行惩罚,仅控制发送给其他人的内容。
- 昵称: 默认强制执行长度和唯一性限制,并提供一个可选权限,允许受信任的等级在昵称中使用完整的 MiniMessage 样式。
- 私聊与社会间谍:
/msg、/reply、/ignore 命令,以及 /socialspy 切换开关,让工作人员可以审查私聊对话——控制台也包含在内。
- 广播: 通过 Tab 补全实现多行公告、自动居中、可选边框,以及基于定时器的自动循环广播。
- 自定义事件消息: 用你自己的消息替换原版的加入、退出、死亡和成就广播——死亡消息会从实际伤害来源解析真实的
{attacker}/{victim},而不是解析原版文本。
- 完全双语: 所有面向玩家的讯息开箱即用即提供英文和西班牙文——只需在
config.yml 中更改一行即可切换,或添加你自己的语言文件。
⚙️ 命令
以下所有命令也支持使用 /auricchat <name> <args> 格式执行。
/auricchat reload - 实时重载配置、语言和等级。 (auricchat.command.reload)
/auricchat preview [rank] [message] - 预览你自己的聊天格式,或任意等级的格式。 (auricchat.command.preview)
/msg <player> <message> - 发送私聊消息。 (auricchat.command.msg)
/reply <message> - 回复上一条私聊消息。 (auricchat.command.reply)
/ignore <player> - 忽略或取消忽略某位玩家。 (auricchat.command.ignore)
/socialspy - 切换查看其他玩家的私聊消息。 (auricchat.command.socialspy)
/nick <nickname|off> - 设置或移除你的聊天昵称。 (auricchat.command.nick)
/broadcast <message> - 发送全服公告。 (auricchat.command.broadcast)
/chatslow <seconds|off> - 切换聊天慢速模式。 (auricchat.command.chatslow)
/chatmute <duration|off> - 静音或解除整个聊天频道的静音。 (auricchat.command.chatmute)
/clearchat - 清除所有人可见的聊天记录。 (auricchat.command.clearchat)
? 权限
auricchat.admin 节点一次性授予所有工作人员命令——包括重载、预览、私聊、回复、忽略、社会间谍、昵称、广播、慢速模式、静音和清屏。聊天格式化是可选的,需单独授予。
auricchat.admin - 授予上述所有工作人员命令,以及更新通知
auricchat.command.msg / .reply / .ignore / .nick - 默认授予所有玩家
auricchat.command.reload / .preview / .socialspy / .broadcast / .chatslow / .chatmute / .clearchat - 工作人员命令,默认仅限 OP
auricchat.command.nick.custom - 允许在昵称本身内部使用 MiniMessage 样式
auricchat.command.nick.unsafe - 绕过昵称长度和唯一性检查
auricchat.chat.format / auricchat.chat.advanced - 在输入的聊天消息中允许颜色和链接及点击动作
auricchat.bypass.chatmute / .chatslow / .filters - 绕过管理工具包的限制
auricchat.rank.<key> - 仅在 ranks.yml 的权限模式下使用,用于在不使用 LuckPerms 的情况下分配等级
? 占位符
同时注册为 PlaceholderAPI 扩展和原生 MiniPlaceholders 扩展——使用你现有设置所依赖的任何一种语法,或同时使用两者。
%auricchat_name% / <auricchat_name> - 玩家设置的昵称,若未设置则为其真实用户名
%auricchat_player% / <auricchat_player> - 始终为真实用户名,忽略任何昵称
%auricchat_hasname% / <auricchat_hasname> - 根据是否设置了昵称返回 true/false
%auricchat_prefix% / <auricchat_prefix> - 玩家的头衔前缀,通过 ranks.yml 解析
%auricchat_suffix% / <auricchat_suffix> - 玩家的头衔后缀,通过 ranks.yml 解析
? 我的社交渠道(西班牙语内容 / Contenido en Español)
注意:我的社交媒体频道和社区完全使用西班牙语!欢迎加入,但请注意语言障碍。
? Auric 测试计划
抢先体验即将推出的 Auric 插件,并在其发布前帮助测试新功能。
如果你对测试插件感兴趣,请加入。
- 无需经验,你可以仅测试你感兴趣的部分,且无需提供任何回报。
?
? AuricChat - Every Chat Feature Your Server Needs
AuricChat is a lightweight, fully bilingual, and completely standalone chat plugin for your Minecraft server. Take full control of formatting, moderation, private messages, ranks and more — all from a single, thoroughly documented config file, with zero mandatory dependencies.
? Dependencies
- PlaceholderAPI (Optional)
- LuckPerms (Optional)
- MiniPlaceholders (Optional)
? Installation
- Place
AuricChat.jar into your server's plugins folder.
- Start or restart your server.
- Configure AuricChat from the files generated in
plugins/AuricChat/.
? Updating
- For minor updates (for example,
1.1.0 → 1.1.1), simply replace the existing .jar file with the new version and restart your server.
- For major updates (for example,
1.1.0 → 1.2.0), back up your current configuration and important plugin data, replace the .jar file, delete the old plugins/AuricChat/ folder, and restart the server so the new files can be generated.
- After the update, restore or reapply your previous configuration and review any new configuration options before continuing.
✨ Key Features
- Dual Placeholder Support: Every token works both as a PlaceholderAPI
%auricchat_x% placeholder and a native MiniPlaceholders <auricchat_x> tag — pick whichever your setup already relies on.
- Ranks Without LuckPerms: Three interchangeable modes in
ranks.yml — pull straight from LuckPerms, match its groups to your own list, or skip LuckPerms entirely using plain permissions.
- Safe MiniMessage Formatting: Full gradient, hover and click-action support in your chat format, with layered permissions so players only get the formatting power you actually grant them.

- Packet Chat Bubbles: An experimental floating text bubble above the sender's head. Uses packetevents for a client-side-only render with virtually no server overhead when installed, and falls back to a lightweight real entity automatically when it isn't.

- Full Moderation Toolkit: Message cooldown, chat slow mode, duplicate-message filtering, anti-caps, anti-swear censorship and a full chat mute — every one independently toggleable. None of them punish the player, they only control what reaches other people.
- Nicknames: Length and uniqueness enforced by default, with an optional permission to unlock full MiniMessage styling for trusted ranks.
- Private Messages & Social Spy:
/msg, /reply, /ignore, and a /socialspy toggle so staff can review private conversations — console included.
- Broadcasts: Multi-line announcements via tab completion, automatic centering, an optional border, and a rotating auto-broadcast on a timer.
- Custom Event Messages: Replace vanilla join, quit, death and advancement broadcasts with your own — death messages resolve a real
{attacker}/{victim} from the actual damage source, not from parsing vanilla text.
- Fully Bilingual: Every single player-facing message ships in English and Spanish out of the box — switch with one line in
config.yml, or add your own language file.
⚙️ Commands
Every command below also works as /auricchat <name> <args>.
/auricchat reload - Reloads the config, languages and ranks live. (auricchat.command.reload)
/auricchat preview [rank] [message] - Preview your own chat format, or any rank's. (auricchat.command.preview)
/msg <player> <message> - Sends a private message. (auricchat.command.msg)
/reply <message> - Replies to the last private message. (auricchat.command.reply)
/ignore <player> - Ignores or stops ignoring a player. (auricchat.command.ignore)
/socialspy - Toggles viewing other players' private messages. (auricchat.command.socialspy)
/nick <nickname|off> - Sets or removes your chat nickname. (auricchat.command.nick)
/broadcast <message> - Sends a server-wide announcement. (auricchat.command.broadcast)
/chatslow <seconds|off> - Toggles chat slow mode. (auricchat.command.chatslow)
/chatmute <duration|off> - Mutes or unmutes the entire chat. (auricchat.command.chatmute)
/clearchat - Clears the visible chat for everyone. (auricchat.command.clearchat)
? Permissions
The auricchat.admin node grants every staff command at once — reload, preview, msg, reply, ignore, socialspy, nick, broadcast, chatslow, chatmute and clearchat. Chat formatting is opt-in and granted separately.
auricchat.admin - Grants every staff command listed above, plus update notifications
auricchat.command.msg / .reply / .ignore / .nick - Granted to everyone by default
auricchat.command.reload / .preview / .socialspy / .broadcast / .chatslow / .chatmute / .clearchat - Staff commands, op by default
auricchat.command.nick.custom - Allows MiniMessage styling inside the nickname itself
auricchat.command.nick.unsafe - Bypasses the nickname length and uniqueness checks
auricchat.chat.format / auricchat.chat.advanced - Colors, then links and click actions, inside typed chat messages
auricchat.bypass.chatmute / .chatslow / .filters - Bypass the moderation toolkit
auricchat.rank.<key> - Used only in ranks.yml's permissions mode, to assign a rank without LuckPerms
? Placeholders
Registers as both a PlaceholderAPI expansion and a native MiniPlaceholders expansion — use whichever syntax your setup already relies on, or both at once.
%auricchat_name% / <auricchat_name> - The player's nickname if set, otherwise their real username
%auricchat_player% / <auricchat_player> - Always the real username, ignoring any nickname
%auricchat_hasname% / <auricchat_hasname> - Returns true/false depending on whether a nickname is set
%auricchat_prefix% / <auricchat_prefix> - The player's rank prefix, resolved through ranks.yml
%auricchat_suffix% / <auricchat_suffix> - The player's rank suffix, resolved through ranks.yml
? My Socials (Spanish Content / Contenido en Español)
Note: My social media channels and community are entirely in Spanish! You are welcome to join, but please keep the language barrier in mind.
? Auric Tester Program
Get early access to upcoming Auric plugins and help test new features before their release.
Join if you're interested in testing plugins.
- No experience required, you can test only what you want and there's nothing to give in return.
?
评论 0
登录后参与评分
还没有评论,来抢沙发吧