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.json tracks 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.

---