1.0.1
Compatibility
Changes
Tuanzi's Server Mod 更新日志 - v1.0.1
版本号: 1.0.1
发布日期: 2026-04-26
适配版本: Minecraft 26.1 - Fabric
🚀 版本摘要
本次更新是 1.0 序列后的首个重大功能更新。我们正式引入了高度可定制的称号系统与极致安全的 CDK 礼包码系统,同时大幅增强了全服数据的统计与导出能力,旨在为服务器提供更丰富的个性化展示与运营工具。
🛠 新增功能
🏷️ 称号系统 (Title System)
一个基于原版机制的身份展示系统,让玩家在人群中脱颖而出。
- 全方位展示: 佩戴的称号将同步显示在聊天栏前缀、Tab 玩家列表以及玩家头顶名称上方。
- 颜色溢出防护: 支持彩色称号(使用
&代码),且经过特殊渲染优化,确保称号颜色不会错误染色到玩家自身的用户名上。 - 多样化获取:
- 特制命名牌: 玩家可使用由管理员生成的“称号命名牌”通过右键点击空气/方块来激活称号(使用后消耗)。
- 管理员发放: 支持一键给单人或全服(含离线)玩家发放荣誉称号。
- 离线排队通知: 离线玩家若被发放了称号,将在下次上线时收到系统自动补发的“获得称号”通知。
- 指令支持:
/titles list/set/clear: 玩家用于查看、切换和卸下称号。/titleadmin create/delete/give/getitem: 管理员用于全生命周期管理称号池。
🎁 CDK 礼包码系统 (CDK System)
一套兼顾灵活性与绝对安全性的礼包分发方案。
- 安全代跑架构: 玩家兑换时由后台控制台静默代执行指令(支持
%player%变量)。无需提升玩家权限即可安全实现发放物品、修改模式、生成实体等高级奖励。 - 多维度限制:
- 类型可选: 支持“全局一次性”(全服仅一人可得)与“玩家一次性”(每人限领一份)。
- 时效管理: 可为每个 CDK 设置精确到秒的过期时间(yyyy-MM-dd-HH:mm:ss)。
- 批量生成逻辑: 支持“模板克隆”机制。管理员可先创建一个带奖励的 CDK 模板,随后一键批量生成数百个随机代码。
- 交互式列表: 管理员可通过分页列表实时监控每个代码的状态,悬浮即可预览奖励指令,点击即可一键复制或删除。
- 导出与审计:
- 多格式导出: 支持将 CDK 池或玩家兑换历史导出为 CSV (Excel直读)、JSON 或 TXT。
- 历史溯源: 独立的
cdk_history.json记录所有兑换流水,导出的记录包含:玩家名、UUID、代码、时间戳及兑换时执行的指令快照。
📊 统计系统增强 (Statistics)
新增了 5 项核心统计指标,便于服主了解运营情况:
- 称号持有量: 玩家当前解锁的称号总数。
- 称号切换率: 玩家更换称号的频繁程度。
- 管理奖励数: 玩家通过管理员直接获得的称号数量。
- 道具激活数: 玩家通过命名牌自助激活的称号数量。
- CDK 兑换总数: 玩家成功兑换礼包码的总次数。
Tuanzi's Server Mod Update Log - v1.0.1
Version: 1.0.1
Release Date: April 26, 2026
Minecraft Version: 26.1 - Fabric
🚀 Version Summary
This release marks the first major feature update since v1.0.0. We are excited to introduce a highly customizable Title System and a bulletproof CDK System. Additionally, the update significantly expands server-wide data tracking and export capabilities, providing more tools for player personalization and server management.
🛠 New Features
🏷️ Title System
A vanilla-friendly identity display system designed to make players stand out.
- Ubiquitous Display: Equipped titles are shown as Chat Prefixes, in the Tab List, and above Player Heads.
- Color Bleed Protection: Full support for colored titles (using
&codes) with specific rendering logic to ensure colors do not bleed into player usernames. - Multiple Acquisition Methods:
- Custom Name Tags: Players can use "Title Name Tags" generated by admins to unlock titles via right-clicking.
- Admin Rewards: Supports instant granting of titles to individuals or the entire server (including offline players).
- Queued Offline Notifications: Players granted a title while offline will receive an automated notification upon their next login.
- Command Support:
/titles list/set/clear: For players to view and manage their titles./titleadmin create/delete/give/getitem: For administrators to manage the global title pool.
🎁 CDK (Gift Code) System
A powerful solution for gift distribution with maximum security.
- Secure Execution: Redemptions are executed silently via the backend console (supporting the
%player%variable). This allows for rewards like items, gamemode changes, or entity summons without elevating player permissions. - Flexible Constraints:
- Types: Choose between "Global Single-Use" (one per server) and "Player Single-Use" (one per player).
- Expiry Management: Set precise expiration dates for each CDK (yyyy-MM-dd-HH:mm:ss).
- Bulk Generation: Includes a "Template Cloning" mechanism. Admins can create a template with specific rewards and generate hundreds of unique random codes instantly.
- Interactive Admin List: Paginated dashboard for monitoring CDK status, with hover-to-preview rewards and one-click copy/delete functionality.
- Audit & Export:
- Multi-Format Export: Export CDK configurations or redemption histories to CSV (Excel compatible), JSON, or TXT.
- Audit Logs: Independent
cdk_history.jsontracks redemptions with details: Player Name, UUID, Code, Timestamp, and command snapshots at the time of redemption.
📊 Statistics Enhancement
Introduced 5 core statistical metrics for better server insight:
- Titles Owned: Total titles unlocked by a player.
- Title Switch Frequency: How often a player changes their title.
- Admin Awards: Number of titles received directly from administrators.
- Item Activations: Number of titles unlocked via Name Tags.
- CDK Redemptions: Total number of gift codes successfully redeemed.
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:RDMGNOTc:OwsMWnXd"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:RDMGNOTc:OwsMWnXd"
}

