TotemAnnouncement ☠️
一款简单且超轻量级的 Spigot/Paper 插件,专为 Hardcore (HC)、Ultra Hardcore (UHC) 或 Survival MultiPlayer (SMP) 游戏模式设计。
此插件允许你严格控制和追踪服务器上的玩家死亡和图腾使用情况(Totem POPs),而无需使用繁重的审计插件或复杂数据库(如 CoreProtect、LuckPerms 或 EssentialsX)来增加基础设施负担。
✨ 功能特性
- ? 自定义消息: 在聊天中完全自定义全局死亡和图腾激活消息,支持完整的颜色代码 (
&)。
- ? 通过配置文件切换: 如果你更喜欢使用原版游戏的默认消息,可以轻松地在配置文件中独立启用或禁用全局聊天公告。
- ? 实时控制台日志: 向控制台发送即时、清晰的日志,指明事件涉及的玩家、世界以及精确坐标。
- ?️ 本地 YAML 数据库: 自动在插件文件夹内生成
logs.yml 文件,按玩家和时间戳 (System.currentTimeMillis()) 进行 chronological 排序,便于快速审计。
- ⚡ 高度优化: 几乎零资源消耗。旨在防止卡顿并避免过度占用服务器的处理器性能。
- ? [NEW] Discord Webhook 集成: 当玩家使用不死图腾或死亡时,向 Discord 发送实时通知,包含玩家头像、世界详情和精确坐标。
?️ 配置 (config.yml)
配置文件直观易懂,方便服务器管理员编辑:
# 启用或禁用图腾使用消息。
totem-alert: true
# 图腾使用的自定义文本。
totem-message: "&6&lTotemAnnouncement &8» &e%player% &7has used a &6Totem of Undying&7."
# 启用或禁用死亡消息。
death-alert: true
# 死亡的自定义文本。
death-message: "&6&lTotemAnnouncement &8» &8[&c☠&8]&e%player% &7has passed away."
# 重载插件的权限
reload-permission: "toteman.admin"
# [BETA] Discord webhook URL
# 新功能,用于在 Discord 频道中公告“死亡”和“图腾激活”;
# 由于该功能处于测试阶段,内容为预定义格式,
# 你只需输入在 Discord 频道中创建的 webhook 的 URL。
webhook-url: ""
? 审计格式 (logs.yml)
数据以原生的 YAML 格式结构化存储,非常适合直接从服务器的 FTP 客户端打开,无需处理杂乱的纯文本文件:
deaths:
Arashi:
'1713542400000':
world: world
coords: 120, 64, -300
totems:
Arashi:
'1713542415000':
world: world_nether
coords: 15, 80, 44
? 安装方法
-
下载 TotemAnnouncement.jar 文件。
-
将其放入服务器的 /plugins/ 目录中。
-
启动或重启你的 Spigot/Paper 服务器以生成默认的配置文件文件夹。
-
一切就绪!根据需要调整 config.yml 中的消息。
⌨️ 命令与权限
/totemannounce # 主要管理命令。
toteman.admin # 用于重载插件配置的默认权限节点(可在 config.yml 中自定义)。
? 许可证
本项目采用 GNU AGPLv3(GNU Affero General Public License v3.0)许可协议。你可以自由使用、修改和分发此代码,但任何修改或衍生版本都必须在完全免费的前提下,按照此相同的许可证公开共享。
TotemAnnouncement ☠️
A simple and ultra-lightweight Spigot/Paper plugin specifically designed for Hardcore (HC), Ultra Hardcore (UHC), or Survival MultiPlayer (SMP) game modes.
This plugin allows you to maintain rigorous control and tracking of player deaths and totem usage (Totem POPs) on your server, without bloating your infrastructure with heavy auditing plugins or complex databases (such as CoreProtect, LuckPerms, or EssentialsX).
✨ Features
- ? Custom Messages: Fully customize global death and totem pop messages in the chat with full color code (
&) support.
- ? Toggleable via Config: Easily enable or disable global chat announcements independently if you prefer using the base game's default messages.
- ? Real-Time Console Logs: Sends immediate, clean logs to the console specifying the player, world, and exact coordinates of the event.
- ?️ Local YAML Database: Automatically generates a
logs.yml file inside the plugin folder, chronologically organized by player and timestamp (System.currentTimeMillis()) for quick auditing.
- ⚡ Highly Optimized: Virtually zero resource consumption. Designed to prevent lag and avoid overworking your server's processor.
- ? [NEW] Discord Webhooks Integration: Send real-time notifications to Discord when a player uses a Totem of Undying or dies, featuring player avatars, world details, and exact coordinates.
?️ Configuration (config.yml)
The configuration file is intuitive and easy to edit for server administrators:
# Enable or Disable Totem usage messages.
totem-alert: true
# Custom text for Totem usage.
totem-message: "&6&lTotemAnnouncement &8» &e%player% &7has used a &6Totem of Undying&7."
# Enable or Disable death messages.
death-alert: true
# Custom text for death.
death-message: "&6&lTotemAnnouncement &8» &8[&c☠&8]&e%player% &7has passed away."
# Permission to reload the plugin
reload-permission: "toteman.admin"
# [BETA] Discord webhook URL
# New feature to announce 'Death' and 'Totem POP' in a Discord channel;
# since the feature is in beta, the content is predefined,
# and you simply need to enter the URL of a webhook created in a Discord channel.
webhook-url: ""
? Audit Format (logs.yml)
Data is structured natively in YAML format, making it ideal to open directly from your server's FTP client without dealing with messy plain text files:
deaths:
Arashi:
'1713542400000':
world: world
coords: 120, 64, -300
totems:
Arashi:
'1713542415000':
world: world_nether
coords: 15, 80, 44
? Installation
-
Download the TotemAnnouncement.jar file.
-
Drop it into your server's /plugins/ directory.
-
Start or restart your Spigot/Paper server to generate the default configuration folder.
-
You are all set! Adjust the messages in the config.yml to your liking.
⌨️ Commands & Permissions
/totemannounce # Main administration command.
toteman.admin # Default permission node to reload the plugin configuration (Customizable in config.yml).
? License
This project is licensed under the GNU AGPLv3 (GNU Affero General Public License v3.0). You are free to use, modify, and distribute this code, as long as any modified or derived version is shared openly and completely free of charge under this exact same license.
评论 0
登录后参与评分
还没有评论,来抢沙发吧