
Sentials 是一款适用于 Paper 的聊天插件。它负责处理你的聊天格式、标签、聊天和名称颜色、私聊、TPA(传送请求)、聊天游戏以及 Discord 桥接功能,并且自 2.1 版本起,它还可以独立进行聊天审核。它只有一个 jar 包,不需要依赖任何其他插件。如果安装了 PlaceholderAPI、Vault 或 LuckPerms,它会调用它们的功能。

聊天
每一行显示名字、标签(如果玩家有的话)和消息。名字可以是单色、十六进制颜色或渐变色,例如 Alice 的从红到蓝的渐变效果。
将鼠标悬停在名字上,你会看到一张小卡片,显示该玩家的生命值、延迟和标签。点击名字会在你的聊天框中填入 /msg <name>。当有人输入 @YourName 时,你会听到提示音,且你的名字会被高亮显示。
每 5 分钟会出现一个聊天游戏。默认选项包括数学题、单词重组、快速打字和 trivia 问答,你可以在配置文件中添加任意数量的自定义游戏。第一个回答正确的人通过 Vault 获得金钱奖励,或者执行你设置的任何奖励命令。

自动审核 (AutoMod)
这是 2.1 版本新增的部分。它在其他任何人看到之前拦截一条消息:
- 链接和域名,包括诸如
server (dot) net 之类的变体
- 服务器 IP 地址
- 字母刷屏(如
heyyyyyyy!!!!!! 会变成 heyyy!!!)
- 脏话,包括拼写变体如
sh1t、@sshole 或 fuuuck
- 匹配你在
blocked-patterns 下添加的任何正则表达式的内容
玩家会收到警告并获得一次违规记录。在累计 3 次违规后,他们将被静音 10 分钟,违规记录会在 30 分钟后消除。YouTube 链接默认允许,你可以添加更多允许的域名。
工作人员每条被拦截的消息占一行。悬停以查看实际输入的内容。在截图中,那是 Bob 试图发布 IP 地址。同样的警报也可以发送到 Discord 日志频道。
AutoMod 也会检查 /msg 和 /r。管理员以及拥有 sentials.automod.bypass 权限的玩家会被跳过检查。

聊天颜色和名称颜色
在命令后输入颜色:
/chatcolor pink
/chatcolor #ff66cc
/chatcolor gradient #ff0000 #0000ff
/namecolor gold
/namecolor gradient #ffaa00 #ff55ff
/namecolor off
名称颜色也会显示在标签页列表中,正如截图顶部所示。

如果没有指定颜色,/namecolor 和 /chatcolor 会打开一个菜单。你没有权限的颜色会显示为锁定状态。你也可以在 /settings 中找到名称颜色设置。

标签
玩家可以使用 /tags create <text> 创建自己的标签。Sentials 会首先检查它。它会拒绝过长的标签、脏话以及看起来像工作人员标签的内容。它还会拦截诸如 Adm1n 或 O w n e r 之类的变体。你可以在 custom-tags.reserved-words 下编辑受保留词的列表。管理员仍可使用这些词汇。
启用 sentials.tags.custom.colors 后,标签可以包含颜色,例如截图中的 /tags create &6Builder。
/tags custom 会将你自己的标签重新应用回来,/tags remove 会移除你当前佩戴的任何标签,而 /tags delete 会删除你自己的标签。使用 /createtag 创建的服务器标签功能保持不变。

/chatadmin
几乎所有内容都可以从这个菜单中进行更改,因此你很少需要打开配置文件。AutoMod 页面为每个检查项提供了开/关按钮,并且当你悬停每个按钮时会显示其功能说明。在“管理玩家”部分,你可以静音某人、更改他们的标签、聊天颜色或名称颜色、清除他们的 AutoMod 违规记录或移除他们的自定义标签。还有用于静音列表、标签、启动聊天游戏和重载配置的按钮。
这些菜单无法通过 Shift+点击、数字键或拖拽来窃取物品。
选择哪个文件
下载与你的服务器匹配的文件:Paper 1.21.11, 26.1, 26.2 或 26.3。只使用其中一个。26.x 文件需要 Java 25。1.21.11 文件可在 Java 21 或更高版本上运行。
从 GyxerChat 更新
停止服务器,删除旧的 GyxerChat jar 包,将 Sentials jar 包放入 plugins/ 目录并重新启动。Sentials 会将 plugins/GyxerChat 复制到 plugins/Sentials,包括你的配置文件、静音列表、忽略列表、标签、昵称和颜色。旧文件夹保留在原处,以便你在删除之前检查所有内容。旧的 gyxerchat.* 权限继续有效。
权限
| 权限 |
默认值 |
功能 |
sentials.nick |
op |
/nick |
sentials.nick.colors |
op |
/nick 中的颜色 |
sentials.chat.colors |
everyone |
聊天中的 & 颜色代码 |
sentials.chatcolor.<color> |
op |
菜单中的一个颜色 |
sentials.chatcolor.custom |
op |
任意十六进制颜色和任意渐变色 |
sentials.namecolor.<color> |
op |
一个名称颜色 |
sentials.namecolor.custom |
op |
任意名称颜色和任意渐变色 |
sentials.tags.custom |
op |
/tags create |
sentials.tags.custom.colors |
op |
自己标签中的颜色 |
sentials.automod.bypass |
nobody |
自动审核跳过你 |
everlynx.chat.admin |
op |
管理命令和 /chatadmin |
everlynx.chat.staff |
op |
工作人员聊天和自动审核警报 |
everlynx.spy |
op |
/socialspy |
要通过 LuckPerms 赋予所有人自定义颜色和标签:
/lp group default permission set sentials.chatcolor.custom true
/lp group default permission set sentials.namecolor.custom true
/lp group default permission set sentials.tags.custom true
Discord
在 Discord Developer Portal 创建一个机器人并开启 Message Content Intent(消息内容意图)。在 config.yml 中,设置 discord.enabled: true,粘贴 bot-token,填写频道 ID 并运行 /chatreload。来自 Discord 的控制台命令默认关闭。当你开启它们时,只有你列出的用户 ID 才能运行这些命令。

Sentials is a chat plugin for Paper. It handles your chat format, tags, chat and name colors, private messages, TPA, chat games and a Discord bridge, and since 2.1 it can also moderate chat by itself. It's one jar and doesn't need any other plugin. If PlaceholderAPI, Vault or LuckPerms are installed, it uses them.

Chat
Each line shows the name, the tag (if the player has one) and the message. Names can be one color, a hex color or a gradient, like Alice's red-to-blue one.
Hover over a name and you get a small card with that player's health, ping and tag. Clicking the name puts /msg <name> in your chat box. When someone writes @YourName, you hear a ding and your name is highlighted.
A chat game shows up every 5 minutes. The defaults are a math problem, a word to unscramble, a type-it-fast and a trivia question, and you can add as many as you want in the config. The first right answer wins money through Vault, or runs whatever reward command you set.

AutoMod
This is the new part in 2.1. It blocks a message before anyone else sees it:
- links and domains, including tricks like
server (dot) net
- server IPs
- letter spam (
heyyyyyyy!!!!!! turns into heyyy!!!)
- swearing, including spellings like
sh1t, @sshole or fuuuck
- anything that matches a regex you add under
blocked-patterns
The player gets a warning and a strike. After 3 strikes they're muted for 10 minutes, and strikes wear off after 30 minutes. YouTube links are allowed by default, and you can add more domains.
Staff get one line per blocked message. Hover it to see what was actually typed. In the screenshot, that's Bob trying to post an IP. The same alert can go to a Discord log channel.
AutoMod checks /msg and /r too. Admins and anyone with sentials.automod.bypass are skipped.

Chat color and name color
Type a color after the command:
/chatcolor pink
/chatcolor #ff66cc
/chatcolor gradient #ff0000 #0000ff
/namecolor gold
/namecolor gradient #ffaa00 #ff55ff
/namecolor off
The name color also shows in the tab list, as you can see at the top of the screenshot.

Without a color, /namecolor and /chatcolor open a menu instead. Colors you don't have permission for show as locked. You'll also find the name color in /settings.

Tags
Players can make their own tag with /tags create <text>. Sentials checks it first. It refuses tags that are too long, swear words, and anything that looks like a staff tag. It also catches tricks like Adm1n or O w n e r. You can edit the list of blocked words under custom-tags.reserved-words. Admins can still use those words.
With sentials.tags.custom.colors the tag can have colors, like /tags create &6Builder in the screenshot.
/tags custom puts your own tag back on, /tags remove takes off whatever tag you're wearing, and /tags delete deletes yours. Server tags you make with /createtag work like before.

/chatadmin
Almost everything can be changed from this menu, so you rarely need to open the config. The AutoMod page has an on/off button for each check, and each button shows what it does when you hover it. Under Manage Players you can mute someone, change their tag, chat color or name color, clear their AutoMod strikes or remove their custom tag. There are also buttons for the muted list, tags, starting a chat game and reloading.
The menus can't be robbed with shift-click, number keys or dragging.
Which file
Download the file that matches your server: Paper 1.21.11, 26.1, 26.2 or 26.3. Use only one. The 26.x files need Java 25. The 1.21.11 file runs on Java 21 or newer.
Updating from GyxerChat
Stop the server, delete the old GyxerChat jar, put the Sentials jar in plugins/ and start again. Sentials copies plugins/GyxerChat to plugins/Sentials, including your config, mutes, ignores, tags, nicknames and colors. The old folder stays where it is so you can check everything before you delete it. Old gyxerchat.* permissions keep working.
Permissions
| Permission |
Default |
What it does |
sentials.nick |
op |
/nick |
sentials.nick.colors |
op |
colors in /nick |
sentials.chat.colors |
everyone |
& color codes in chat |
sentials.chatcolor.<color> |
op |
one menu color |
sentials.chatcolor.custom |
op |
any hex color and any gradient |
sentials.namecolor.<color> |
op |
one name color |
sentials.namecolor.custom |
op |
any name color and any gradient |
sentials.tags.custom |
op |
/tags create |
sentials.tags.custom.colors |
op |
colors in your own tag |
sentials.automod.bypass |
nobody |
AutoMod skips you |
everlynx.chat.admin |
op |
admin commands and /chatadmin |
everlynx.chat.staff |
op |
staff chat and AutoMod alerts |
everlynx.spy |
op |
/socialspy |
To give everyone custom colors and tags with LuckPerms:
/lp group default permission set sentials.chatcolor.custom true
/lp group default permission set sentials.namecolor.custom true
/lp group default permission set sentials.tags.custom true
Discord
Make a bot in the Discord Developer Portal and turn on Message Content Intent. In config.yml, set discord.enabled: true, paste the bot-token, fill in the channel IDs and run /chatreload. Console commands from Discord are off by default. When you turn them on, only the user IDs you list can run them.
评论 0
登录后参与评分
还没有评论,来抢沙发吧