AnonymousPotion
处于隐身效果下的玩家,其用户名在死亡消息中永远不会显示。它会被替换为混淆文本——即 Minecraft 客户端动画显示的乱码字符。
一种例外情况:当隐身的玩家死亡时,其自身名称会以明文形式显示。
Zeffut was slain by ▓╫≡┼╪▒≈╬
Zeffut tried to swim in lava to escape ▓╫≡┼╪▒≈╬
Steve was slain by Zeffut ← Zeffut is invisible, but he is the victim
没有任何玩家(包括操作员)能看到真实的用户名——游戏玩法对所有人保持一致,而服务器日志则保留真实身份以用于管理。
Features
- 所有类型的死亡。 近战、弓箭、三叉戟、驯服的狼、间接死亡(如 "tried to swim in lava to escape…")。插件重写消息树且不解析句子本身,因此每种死亡类型和每种客户端语言都能正常工作,无需维护案例列表。
- 固定长度的混淆。 无论击杀者是谁,宽度始终相同。如果长度与真实用户名匹配,在在线玩家较少的服务器上可能会暴露身份。
- 悬停无泄露。 在原版游戏中,悬停用户名会显示真实姓名和 UUID,点击它会预填
/tell <name>。这些功能在替换文本中均被移除。
- 自定义武器名称也会被处理。 重命名的剑同样可以标识其所有者。默认启用混淆,可切换关闭。
- 离线击杀者也被覆盖。 击中某人后断开连接,让其摔死——你在 60 秒内保持匿名。如果没有此功能,退出游戏将成为免费绕过手段。
- 故障安全(Fail-closed)。 如果在处理死亡时发生任何异常,消息将被丢弃而不是发送出去。绝不允许因 bug 泄露用户名——这正是本插件存在的唯一目的。
- 不影响其他内容。 聊天、加入/离开消息、进度、标签页列表和名称标签均保持原版行为。
Configuration
| Key |
Default |
What it does |
obfuscated-length |
8 |
混淆文本中的字符数,1–32。对所有玩家统一。 |
filler-character |
a |
基础字符。Minecraft 会将每个字符替换为具有相同宽度的随机字形,因此此设置固定了屏幕上的宽度。 |
obfuscate-weapon-name |
true |
同时混淆自定义武器名称,这可能会暴露击杀者。 |
log-real-names |
true |
将混淆玩家的真实用户名写入服务器日志,以便管理。 |
telemetry |
true |
发送匿名使用统计信息。设置为 false 可关闭所有发送。 |
telemetry-host |
https://eu.i.posthog.com |
统计数据发送到的 PostHog 实例。更改它以指向自托管实例。 |
/anonymouspotion reload 就地重载配置——需要权限 anonymouspotion.admin,操作员默认拥有该权限。
Known limitations
- 如果隐身效果在箭矢飞行期间过期,射手将以明文形式显示名称。效果是在死亡时刻而非射击时刻读取的。
- 关闭
log-real-names 会移除击杀者的所有痕迹:服务器自身的日志也会显示混淆后的名称,因此该选项不仅裁剪管理输出,而是完全移除它。
- 插件以
HIGHEST 优先级重写死亡消息。另一个用纯文本替换消息或在此之后写入消息的插件可能会绕过混淆。
Telemetry
插件向 PostHog 发送匿名使用统计信息。在 config.yml 中设置 telemetry: false 可关闭此功能。
发送的内容: 首次启动时生成的随机安装 ID、附加到每个事件的四个属性,以及五个事件。
无论事件类型如何,每个事件都包含以下四个属性:
app:插件的短名称,始终为 anonymouspotion。它将本插件与共享同一 PostHog 项目的其他项目区分开来。
source:服务器平台,始终为 paper。
mc_version:服务器的 Minecraft 版本,例如 1.21.11。
component_version:插件版本,例如 1.0.0。
正文还携带 $ip 设置为 null。这不是数据——这是告诉 PostHog 不记录请求的 IP 地址,也不从中推导地理位置的指令。如果没有它,服务器的公网 IP 将被服务存储。
五个事件:
plugin_enabled(启动时):服务器版本、obfuscated-length、obfuscate-weapon-name、log-real-names 以及服务器的在线模式(服务器设置,非插件设置)。
death_obfuscated(每次发生名称被混淆的死亡):混淆了多少个名称、此次死亡是否实际混淆了武器名称、其中一个击杀者是否离线,以及死亡类型(原版翻译键,从不渲染文本)。
obfuscation_failed(如果混淆失败):Java 异常类型,从不包含其消息。
command_used(每次 /anonymouspotion 命令):使用的子命令(reload)。
session_heartbeat(每 30 分钟):服务器运行时长以及自启动以来已混淆的死亡次数。
绝不发送的内容: 没有用户名、没有 IP 地址、没有玩家 UUID、没有消息内容。本插件的存在是为了阻止用户名泄露——它不会将这些相同的用户名发送到其他地方。
Requirements
Paper 1.21.x, Java 21. No dependencies.
AnonymousPotion
A player under Invisibility never has their username shown in a death message. It is replaced with obfuscated text — the scrambling characters Minecraft animates client-side.
One exception: when the invisible player dies, their own name is shown in plain text.
Zeffut was slain by ▓╫≡┼╪▒≈╬
Zeffut tried to swim in lava to escape ▓╫≡┼╪▒≈╬
Steve was slain by Zeffut ← Zeffut is invisible, but he is the victim
No player ever sees the real username — operators included. The gameplay is the same for everyone, and the server log keeps the real identity for moderation.
Features
- Every kind of death. Melee, bow, trident, tamed wolves, indirect deaths such as "tried to swim in lava to escape…". The plugin rewrites the message tree and never parses the sentence, so every death type and every client language works without a list of cases.
- Fixed-length obfuscation. Always the same width, whoever the killer is. A length that matched the real username would give it away on a server with few players online.
- No leak on hover. In vanilla, hovering a username shows the real name and UUID, and clicking it pre-fills
/tell <name>. Both are stripped from the replacement.
- Custom weapon names too. A renamed sword can identify its owner just as well as a username. Obfuscated by default, switchable off.
- Offline killers covered. Hit someone, disconnect, and let them die of the fall — you stay anonymous for 60 seconds. Without this, quitting was a free bypass.
- Fail-closed. If anything throws while handling a death, the message is dropped rather than sent through. A bug must never leak a username — that is the one thing this plugin exists to prevent.
- Nothing else is touched. Chat, join and quit messages, advancements, the tab list and nametags all stay vanilla.
Configuration
| Key |
Default |
What it does |
obfuscated-length |
8 |
Number of characters in the obfuscated text, 1–32. The same for every player. |
filler-character |
a |
Base character. Minecraft swaps each character for a random glyph of the same width, so this setting fixes the width on screen. |
obfuscate-weapon-name |
true |
Also obfuscate custom weapon names, which can give the killer away. |
log-real-names |
true |
Write the real usernames of obfuscated players to the server log, for moderation. |
telemetry |
true |
Send anonymous usage statistics. false turns every send off. |
telemetry-host |
https://eu.i.posthog.com |
The PostHog instance the statistics are sent to. Change it to point at a self-hosted instance. |
/anonymouspotion reload reloads the config in place — permission anonymouspotion.admin, operators by default.
Known limitations
- If the Invisibility effect expires while an arrow is in flight, the archer is named in plain text. The effect is read at the moment of death, not at the moment of the shot.
- Turning
log-real-names off removes every trace of the killer: the server's own log shows the obfuscated name too, so the option does not merely trim moderation output, it removes it.
- The plugin rewrites the death message at
HIGHEST priority. Another plugin that replaces the message with flat text, or that writes after this one, can bypass the obfuscation.
Telemetry
The plugin sends anonymous usage statistics to PostHog. Set telemetry: false in
config.yml to turn it off.
What is sent: a random installation id generated on first start, four properties attached to
every event, plus five events.
The four properties present on every event, whichever it is:
app: the plugin's short name, always anonymouspotion. It tells this plugin apart from
other projects sharing the same PostHog project.
source: the server platform, always paper.
mc_version: the server's Minecraft version, for example 1.21.11.
component_version: the plugin version, for example 1.0.0.
The body also carries $ip set to null. That is not data — it is the instruction telling
PostHog not to record the request's IP address, nor derive a geolocation from it. Without it,
the server's public IP would be stored by the service.
The five events:
plugin_enabled (on startup): server version, obfuscated-length,
obfuscate-weapon-name, log-real-names, and the server's online mode (a server setting,
not a plugin setting).
death_obfuscated (each death where a name was obfuscated): how many names were
obfuscated, whether a weapon name was actually obfuscated at that death, whether one of the
killers was offline, and the kind of death (the vanilla translation key, never the rendered
text).
obfuscation_failed (if obfuscation fails): the Java exception type, never its message.
command_used (each /anonymouspotion command): the subcommand used (reload).
session_heartbeat (every 30 minutes): server uptime and how many deaths have been
obfuscated since startup.
What is never sent: no usernames, no IP addresses, no player UUIDs, no message contents.
This plugin exists to stop a username from leaking — it is not going to ship those same
usernames somewhere else.
Requirements
Paper 1.21.x, Java 21. No dependencies.
评论 0
登录后参与评分
还没有评论,来抢沙发吧