
Tuanzi's Server Mod
This is an all-in-one server management module specifically designed for Fabric 26.1. It deeply integrates advanced piracy detection, multi-currency dynamic economic system, visualized intelligent store, and comprehensive player behavior statistics.
- Загрузки
- 117
- Подписчики
- 1
- Обновлён
- 20 июня 2026 г.
- Лицензия
- MIT
Опубликован 7 апреля 2026 г.
Tuanzi's Server Mod (团子服务器增强模组)
基于 Minecraft 26.1 (1.22) Fabric 开发的服务器端全能增强模组,集成了高级身份验证、多币种经济、智能商店、称号系统、CDK 礼包码、Warp 地标传送及全维度玩家统计系统。无需客户端安装模组即可使用。
核心特性
1. 商店系统 (Smart Shop)
- 引导式创建:右键点击空木牌即可开启交互式引导,支持聊天框按钮选择和数字输入。
- 分类型动态定价:
- 收购模式 (BUY): $P = x + (y - x) \cdot \frac{K}{K + S}$ (价格随收购量增加而回归保底价 $x$)
- 出售模式 (SELL): $P = x + (y - x) \cdot \frac{S}{K + S}$ (价格随销售量增加而上升)
- 视觉展示:基于
ItemEntity的悬浮物品展示,具备防吸取、物理静止及非持久化特性(重启自动恢复)。 - 多维度支持:支持在主世界、下界和末地创建并自动维护商店(定时衰减与展示自适应当前维度,支持旧商店维度自愈扫描)。
- 安全与体验:集成漏斗防护(防止通过漏斗或漏斗矿车窃取),以及背包满时购买物品自动安全掉落机制(绝不吞物)。
2. 经济系统 (Advanced Economy)
- 多钱包架构:支持管理员自定义多种货币(如金币、点券)。
- 动态翻译:货币名称及交易反馈完全适配玩家客户端语言。
- 离线交易:支持玩家向离线玩家转账(需已注册)。
- 多开防刷限制:支持开启同 IP 转账检测(
allowSameIPTransfer),防范小号刷钱。支持配置热重载(/econ-admin config reload)。
3. 身份验证与假人联动 (Mixed Auth & Carpet Bot)
- 正盗版混合验证:自动识别 Mojang 正版账户并免密登录;盗版玩家需注册登录。
- 安全防护:登录前禁止所有物理和交互操作,防止位置信息泄露和非法破坏。
- Carpet 假人免密登录:自动识别并置假人为已登录状态,方便假人在后台流畅运作。
- 假人防盗安全拦截:正版真人首次登录自动记录至
premium_players.json。假人生成时进行“已注册”和“正版真人登录历史”二阶段校验,严防恶意生成假人免密登录盗取玩家背包物资。 - 白名单管理:集成 UUID 映射的增强白名单系统。
4. Warp 地标系统 (Warp System)
- 高效传送:允许玩家使用
/warp <地标名>在不同地标传送,支持/warpback回传至前一次传送点(跨维度精准支持)。 - 安全机制:传送需原地站立等待 3 秒,若期间移动或受到伤害将被自动打断。
- 管理员地标库:支持管理员创建(
/warpadmin create,支持~ ~ ~相对坐标)、删除及列表查询,数据自动持久化。
5. 称号系统 (Title System)
- 多处展示:称号同步显示在聊天栏前缀、Tab 玩家列表及玩家头顶名称上方。
- 颜色优化:支持
&彩色代码,特殊渲染优化防止颜色溢出到用户名。 - 激活方式:支持管理员直接发放或通过特殊的“称号命名牌”由玩家自行激活。
- 限时与赛季管理:支持限时命名牌(激活叠加时长)及全局到期时间设置,到期自动卸下、定时清理并发送离线/在线通知。
- 离线兼容:支持为离线玩家发放称号,玩家上线后将自动收到通知。
6. CDK 礼包码系统 (CDK System)
- 后台指令执行:玩家兑换时由控制台代执行指令,无需提升玩家权限即可发放复杂奖励。
- 多维度限制:
- 类型丰富:支持全局一次性、玩家一次性、全服限量单人一次(
GLOBAL_LIMIT)及个人限量(PLAYER_LIMIT)。 - 时效管理:可设置精确到秒的过期时间,支持
yyyy-MM-dd及"yyyy-MM-dd HH:mm:ss"格式设置。
- 类型丰富:支持全局一次性、玩家一次性、全服限量单人一次(
- 批量生成与导出:支持基于模板批量生成随机代码,并可导出为 CSV、JSON 或 TXT 格式。
- 详尽审计:独立记录所有兑换流水,包含时间、指令快照及玩家信息。
7. 统计系统 (Total Stats)
- 全方位指标:记录移动距离、击杀、挖掘、在线时间、称号持有量、CDK 兑换数等 25+ 项指标,针对假人/非正常断线离线玩家进行了在线时间累加修正。
- 实时排行榜:支持侧边栏计分板自动轮换和悬浮文字动态展示。
- 数据导出:支持统计数据的一键导出与重置。
8. 备份回滚与数据安全 (Backup & IO Safety)
- 自动化备份:支持按小时自动打包所有核心数据。存储于
./mod_backups/。 - 安全恢复:一键回滚至指定时间点,含聊天框确认和 pre_restore 强制定时快照备份,恢复后自动停机。
- 防断电 IO 保护:所有本地数据读写引入“备份回滚 (.bak) + 临时文件原子替换 (.tmp)”双重保护,彻底防范断电/崩溃引起的文件损坏或清空。
指令索引
玩家常用指令
| 指令 | 描述 | 备注 |
|---|---|---|
/login <密码> |
账户登录 | 正版玩家免密 |
/register <密码> <确认密码> |
账户注册 | 仅需一次 |
/pay <玩家> <货币ID> <数量> |
转账金币 | 支持货币 ID 补全 |
/balance [货币ID] |
查询余额 | 缺省显示所有钱包 |
/stats [player] [type] |
查看个人或他人统计 | 支持 25+ 种子项 |
/titles <list/set/clear> |
称号管理 | 查看、佩戴或卸下称号(支持查看有效期) |
/cdk <代码> |
兑换礼包码 | 成功后自动执行奖励指令 |
/warp <地标名> |
传送至指定地标 | 原地站立等待 3 秒,受伤或移动打断 |
/warpback |
返回传送前的位置 | 跨维度支持 |
/shop help |
商店功能指南 | 包含买/卖操作说明 |
管理员指令 (Level 4)
| 指令 | 描述 | 备注 |
|---|---|---|
/auth whitelist <add/remove/list> |
白名单管理 | 支持 UUID 自动生成 |
/econ-admin balance <set/add/remove> |
管理玩家余额 | 全货币支持 |
/econ-admin config reload |
重新加载经济模块配置 | 不重启动态生效 |
/econ-admin config set allowSameIPTransfer <true/false> |
开启/关闭同 IP 转账检测 | 防止小号/多开刷钱 |
/eco backup |
执行全量备份 | 存储于 ./mod_backups/ |
/eco restore <timestamp> |
恢复指定备份 | 含有确认流程,自动强制定时快照,恢复后关闭服务器 |
/eco interval <hours> |
设置备份周期 | 默认为 12 小时 |
/warpadmin create <地标名> <x> <y> <z> |
创建新地标 | 支持 ~ 相对坐标 |
/warpadmin delete <地标名> |
删除指定地标 | |
/warpadmin list |
列出所有地标 | |
/titleadmin <create/delete/give/getitem> |
称号库管理 | 现支持 [days] 时间参数 |
/titleadmin setexpiry <id> <date> |
称号全局过期设置 | 设置全服称号的结束时间 |
/titleadmin modifyplayer <targets> <id> <set/add/remove> <days> |
玩家称号时间管理 | 设定/延长/缩短玩家持有时间 |
/cdkadmin <create/batch/list/export> |
CDK 系统管理 | 支持批量生成与历史导出 |
/cdkadmin setexpiry <id> <date> |
CDK 过期时间管理 | 支持 yyyy-MM-dd 或 "yyyy-MM-dd HH:mm:ss" 格式 |
/shopadmin info |
查看商店调试数据 | 展示 S, K, 衰减率等 |
/shopadmin setupDynamic |
开启引导式动态定价设置 | 分三步设置核心变量 |
/scoreboard <start/stop/interval> |
计分板轮换控制 | 支持动态调整速度 |
/floatingtext <create/delete/set> |
悬浮文字排行榜管理 | 支持颜色和位置调整 |
技术规格
- 平台: Minecraft 26.1 (1.22) Fabric
- Java 版本: Java 25 (推荐 Zulu-25)
- 性能与调试:
- 商店展示采用 5-tick 节流维护。
- 统计数据采用异步保存机制。
- 展示实体采用非持久化方案,零存档负担。
- 集成统一全局调试日志系统 (
TuanzisServerMod.debug),生产环境默认静默,避免刷屏。
国际化 (i18n)
本模组完全支持中英双语。系统会根据玩家在 Minecraft 客户端设置的语言自动切换:
- 中文 (简体):
zh_cn(含zh_tw,zh_hk自动规范化) - English:
en_us(默认兜底)
English Version
Tuanzi's Server Mod
A comprehensive server-side enhancement mod developed for Minecraft 26.1 (1.22) Fabric, integrating advanced authentication, multi-currency economy, smart shops, title system, CDK gift codes, Warp landmark teleportation, and an all-dimensional player statistics system. No client-side mod required.
Core Features
1. Smart Shop System
- Guided Creation: Right-click an empty sign to start an interactive guide with chat button selection and numerical input.
- Typed Dynamic Pricing:
- BUY Mode (Purchasing): $P = x + (y - x) \cdot \frac{K}{K + S}$ (Price converges to floor $x$ as stock increases)
- SELL Mode (Selling): %P = x + (y - x) \cdot \frac{S}{K + S}% (Price rises as sales volume increases)
- Visual Display:
ItemEntity-based floating item displays with anti-pickup, physical stillness, and non-persistence features (auto-restored on reboot). - Multi-Dimension Support: Create and maintain shops in the Overworld, Nether, and End automatically. Supports multi-dimension display management without dimensional collision, auto-adaptive decay updates, and self-healing scanning for old shops.
- Security & Protection: Integrated hopper protection preventing illegal extraction via hoppers or hopper minecarts.
- Overflow Drop: Safely drops overflow items at the player's feet when buying with a full inventory, preventing item loss.
2. Advanced Economy
- Multi-Wallet Architecture: Supports custom currencies (e.g., Gold, Credits).
- Dynamic Translation: Currency names and transaction feedback fully adapt to the player's client language.
- Offline Transactions: Supports transfers to registered offline players.
- Same IP Transfer Detection: Added
allowSameIPTransfersetting to detect/prevent transfers between players on the same IP to combat alt-account abuse. Supports config hot reloading (/econ-admin config reload).
3. Mixed Authentication & Carpet Bot Integration
- Mixed Verification: Automatically identifies Mojang premium accounts for password-less login; offline players must register.
- Security Sandbox: Restricts all physical and interactive operations before login to prevent information leaks or unauthorized damage.
- Carpet Bot Auto-Login: Automatically identifies and logs in Carpet fake players (
carpet.patches.EntityPlayerMPFake), allowing seamless background operations. - Carpet Bot Security Restriction: Persists premium players' login history into
premium_players.json. Implements a two-stage verification (registered check and premium history check) when spawning a bot via/playerto block malicious password-less bot spawns stealing player inventories. - Whitelist Management: Enhanced whitelist system integrated with UUID mapping.
4. Warp Landmark System
- Efficient Teleportation: Allows players to use
/warp <name>to teleport to established landmarks, and/warpbackto return to the location before teleport (fully supports cross-dimension). - Safety Lock: Requires players to stand still for 3 seconds; movement or taking damage will interrupt teleportation.
- Landmark Management: Admins can create (supporting
~ ~ ~relative coordinates), delete, and list landmarks with automatic data persistence.
5. Title System
- Multi-location Display: Titles are synchronized in the chat prefix, Tab player list, and above the player's head.
- Color Optimization: Supports
&color codes with special rendering optimization to prevent color bleeding to the username. - Activation Methods: Supports direct issuance by administrators or activation via special "Title Name Tags" by players.
- Expiry & Season Management: Supports temporary titles, global title expiry dates, cumulative duration for multiple activations, real-time hover expiry check, and automatic background cleanup with alerts.
- Offline Compatibility: Supports issuing titles to offline players, who will automatically receive a notification upon logging in.
6. CDK System (Gift Codes)
- Backend Command Execution: Commands are executed by the console upon redemption, allowing for complex rewards without elevating player permissions.
- Multi-dimensional Restrictions:
- Types: Supports global one-time, player one-time, global limit with single redemption (
GLOBAL_LIMIT), and player-specific limit (PLAYER_LIMIT). - Expiration Management: Set precise expiration dates down to the second, supporting
yyyy-MM-ddand"yyyy-MM-dd HH:mm:ss"formats.
- Types: Supports global one-time, player one-time, global limit with single redemption (
- Batch Generation & Export: Supports batch generation of random codes based on templates and exporting to CSV, JSON, or TXT formats.
- Detailed Auditing: Independently records all redemption history, including timestamps, command snapshots, and player info.
7. Total Statistics System
- All-round Metrics: Records 25+ metrics including distance traveled, kills, mining, online time, title ownership, CDK redemptions, etc. Fixes the issue where Carpet bots or abruptly disconnected offline players continued accumulating online time.
- Real-time Leaderboards: Supports automatic sidebar scoreboard rotation and dynamic floating text displays.
- Data Export: Supports one-click exporting and resetting of statistical data.
8. Backup, Recovery & Data Safety
- Automated Backups: Periodically packages all core data (Economy, Shop, Stats, CDK, Titles, Whitelist) into
./mod_backups/. - Secure Recovery: One-click rollback to a specific timestamp, incorporating double confirmation, automatic emergency pre-restore backup, followed by a safe shutdown.
- Anti-Power-Loss IO Protection: Local data and configurations are protected by a double mechanism: Backup Rollback (.bak) + Temporary File Atomic Replacement (.tmp), entirely preventing corruption or truncation due to sudden crashes.
Command Index
Common Player Commands
| Command | Description | Note |
|---|---|---|
/login <password> |
Account login | Auto-login for Premium |
/register <pass> <confirm> |
Account registration | Required only once |
/pay <player> <walletId> <qty> |
Transfer currency | Tab-completion supported |
/balance [walletId] |
Check balances | Shows all wallets by default |
/stats [player] [type] |
View player stats | Supports 25+ metrics |
/titles <list/set/clear> |
Title management | View, wear, or remove titles (with expiry display) |
/cdk <code> |
Redeem gift code | Executes reward commands on success |
/warp <name> |
Teleport to a landmark | Stand still for 3 seconds, interrupted by movement/damage |
/warpback |
Return to previous location | Cross-dimension supported |
/shop help |
Shop functionality guide | Includes Buy/Sell instructions |
Admin Commands (Level 4)
| Command | Description | Note |
|---|---|---|
/auth whitelist <add/remove/list> |
Whitelist management | Supports UUID generation |
/econ-admin balance <set/add/rem> |
Manage player balances | Multi-currency support |
/econ-admin config reload |
Reload economy config | Applies dynamically |
/econ-admin config set allowSameIPTransfer <true/false> |
Toggle same IP transfer check | Prevents alt-account abuse |
/eco backup |
Perform full backup | Stored in ./mod_backups/ |
/eco restore <timestamp> |
Restore from backup | Double confirmation, pre-restore backup, stops server |
/eco interval <hours> |
Set backup interval | Default is 12 hours |
/warpadmin create <name> <x> <y> <z> |
Create a landmark | Supports ~ relative coordinates |
/warpadmin delete <name> |
Delete a landmark | |
/warpadmin list |
List all landmarks | |
/titleadmin <create/delete/give/getitem> |
Title repository | Supports [days] duration parameter |
/titleadmin setexpiry <id> <date> |
Global title expiry | Set end date for a title for all players |
/titleadmin modifyplayer <targets> <id> <set/add/rem> <days> |
Player title duration | Set/extend/shorten holding time |
/cdkadmin <create/batch/list/export> |
CDK management | Batch generation and history export |
/cdkadmin setexpiry <id> <date> |
CDK expiry date | Supports yyyy-MM-dd or "yyyy-MM-dd HH:mm:ss" |
/shopadmin info |
Shop debug data | Shows S, K, Decay rate, etc. |
/shopadmin setupDynamic |
Guided dynamic pricing setup | 3-step core variable setup |
/scoreboard <start/stop/interval> |
Scoreboard rotation control | Adjust rotation speed |
/floatingtext <create/delete/set> |
Floating text leaderboards | Color and position adjustment |
Technical Specifications
- Platform: Minecraft 26.1 (1.22) Fabric
- Java Version: Java 25 (Zulu-25 recommended)
- Performance & Logging:
- Shop displays maintained using a 5-tick throttle.
- Statistics data saved using an asynchronous mechanism.
- Display entities use a non-persistent scheme, zero save bloat.
- Integrated unified global debug log system (
TuanzisServerMod.debug), silent by default in production.
Internationalization (i18n)
This mod fully supports English and Chinese. The system automatically switches based on the player's client language:
- Chinese:
zh_cn(Includes automatic normalization forzh_tw,zh_hk) - English:
en_us(Default fallback)
Ченджлог
1.0.6Релиз26.2 · 20 июня 2026 г.
v1.0.6 更新日志
兼容性与适配
- 升级至 Minecraft 26.2 适配:
- 调整代码以兼容 Minecraft 26.2 的 API 变更。
v1.0.6 Changelog
Compatibility & Adaptation
- Adaptation to Minecraft 26.2:
- Adjusted codebase to align with Minecraft 26.2 API changes.
1.0.4Релиз26.1, 26.1.1, 26.1.2 · 7 июня 2026 г.
v1.0.4 更新日志
修复与优化
- 地毯假人安全防护拦截(正版真人登录历史识别):
- 彻底解决了玩家可以通过地毯模组的
/player <name> spawn命令生成与已注册账号或正版玩家同名的假人,进而免密继承并盗取他人背包和物资的安全漏洞。 - 引入了全新的
PremiumPlayerManager组件,在正版玩家真人首次登录服务器时,安全、自动地将该玩家的登录历史持久化至config/auth/premium_players.json。 - 现在当使用
/player生成假人时,系统将执行两阶段智能检查:- 已注册校验:检查假人名字是否在
accounts.json中已注册。若是,强制拒绝生成。 - 正版真人登录历史校验:检查假人名字是否是正版玩家,且是否在
premium_players.json中存在真人登录历史。若是,强制拒绝生成;若其虽然是正版,但从未有真人登录过(仅做测试或为全新玩家名字),则不予拦截,确保灵活便捷。
- 已注册校验:检查假人名字是否在
- 所有假人的登录判定与拦截记录,均使用
TuanzisServerMod.debug(String)规范地输出至调试日志中,方便随时回溯与分析安全事件。
- 彻底解决了玩家可以通过地毯模组的
v1.0.4 Changelog
Bug Fixes & Optimizations
- Carpet Fake Player Security Defense (Premium Real Player Login Tracking):
- Completely resolved the security exploit where players could use Carpet Mod's
/player <name> spawncommand to spawn fake players with the same name as registered accounts or premium players, bypassing authentication and looting their inventories or items. - Introduced the new
PremiumPlayerManagercomponent to automatically and securely persist premium players' real login history intoconfig/auth/premium_players.jsonupon their first connection. - Spawning fake players via
/playernow triggers a two-phase smart check:- Registered Account Check: Verifies if the fake player name is registered in
accounts.json. If yes, the spawn attempt is strictly rejected. - Premium Login History Check: Verifies if the name belongs to a premium account and has real login records in
premium_players.json. If yes, the spawn attempt is strictly rejected. If the premium account has never logged in as a real player (e.g. testing or a new player name), the spawn is allowed.
- Registered Account Check: Verifies if the fake player name is registered in
- All fake player checks and safety block incidents are logged using the standardized
TuanzisServerMod.debug(String)method for convenient auditing and trace analyses.
- Completely resolved the security exploit where players could use Carpet Mod's
1.0.3.3Релиз26.1, 26.1.1, 26.1.2 · 7 июня 2026 г.
v1.0.3.3 更新日志
修复与优化
商店多维度悬浮物(展示物品)彻底修复:
- 彻底解决了上个版本(支持多维度商店)后,非主世界维度(地狱、末地)商店悬浮展示物品消失、或者在主世界错误重建悬浮物品的重大逻辑缺陷。
- 重构了
ShopDisplayManager的悬浮物初始化与维护逻辑,现在能智能地根据每个商店实例保存的dimensionId精准匹配并同步世界 level,实现在不同维度间的安全分流与渲染,绝不跨维度串扰。
假人与离线玩家时间统计修复:
- 彻底解决了当 Carpet 假人(或非正常断开连接的玩家)下线后,其在线时间在积分板、统计命令以及排行榜浮空字中仍会持续累加的系统缺陷。
- 现在系统在累加当前会话在线时间之前,将严格实时校验玩家在服务器中的真实在线状态。如果玩家已离线,则其当次会话的计时增加额强制归零,并自动、安全地从底层登录时间缓存中移除,避免潜在的内存泄漏与数据残留。
CDK 过期时间设定指令优化:
- 修复了
/cdkadmin setexpiry指令中时间格式解析报错的缺陷。 - 现在支持直接输入
yyyy-MM-dd格式(如2026-06-01),系统将默认填充时间为00:00:00并成功设置。 - 如需指定具体时间,可输入
yyyy-MM-dd HH:mm:ss(需使用双引号""框住,如"2026-06-01 12:00:00"),系统将能够完美解析并保存。
- 修复了
商店交易背包溢出掉落优化:
- 修复了当玩家背包满时,在商店购买物品会直接消失但正常扣除金额的问题.
- 现在当购买的物品无法完全放入背包时,溢出部分的物品将安全、自动地以掉落物形式掉落到玩家脚下的地面上,绝不吞物.
全新全局调试日志机制:
- 在
TuanzisServerMod主类中引入了全局静态调试方法debug(String, Object...),支持开发环境下输出 INFO 级别的直观调试、生产环境下静默输出 DEBUG 级别至日志文件中。 - 已将全模组(包括身份验证、核心 Mixin 钩子、商店与告示牌、统计信息与计分板等全部 30 个子系统文件)中所有非必须展示在控制台的核心调试与调试期业务日志,彻底重构并整体迁移至该全局调试方法。
- 在
v1.0.3.3 Changelog
Bug Fixes & Optimizations
Fixed Shop Multi-Dimension Floating Items (Display Items):
- Completely resolved the major logical flaw where floating display items in non-overworld dimensions (Nether, End) would disappear or incorrectly regenerate in the Overworld after the multi-dimension shop support update.
- Refactored
ShopDisplayManagerinitialization and maintenance logic to accurately match and sync each shop instance'sdimensionIdwith the corresponding active world level. This ensures secure rendering and isolation across different dimensions without cross-dimensional interference.
Fixed Play Time Accumulation for Fake Players & Offline Players:
- Completely resolved the issue where fake players (from Carpet) or players who disconnected abnormally would still have their online play time continuously incremented on scoreboards, statistics commands, and floating text leaderboards.
- The system now strictly verifies the player's active online status on the server before accumulating session play time. If a player is offline, their current session time increment is forced to zero, and they are automatically and safely cleared from the login time cache to prevent memory leaks and residual data.
Optimized CDK Expiry Command:
- Fixed the date-time format parsing error in
/cdkadmin setexpirycommand. - Now supports directly inputting
yyyy-MM-ddformat (e.g.,2026-06-01), which will default the time to00:00:00. - If a specific time is required, players can input
yyyy-MM-dd HH:mm:ssenclosed in double quotes""(e.g.,"2026-06-01 12:00:00"), which will be successfully parsed and stored.
- Fixed the date-time format parsing error in
Optimized Trade Item Drop on Full Inventory:
- Fixed the bug where purchased items would disappear entirely and money would still be deducted if the buyer's inventory was full.
- Now, any overflow items that cannot fit into the player's inventory during a shop transaction will automatically and safely drop to the ground at the player's feet.
Brand New Global Debug Logging Mechanism:
- Introduced a global static
debug(String, Object...)method in theTuanzisServerModmain class, supporting highly visible INFO level logging in development environments and silent DEBUG level logging to file in production. - Successfully refactored and migrated all non-essential console logs across the entire mod (including authentication, core Mixin hooks, shop and sign systems, statistics and scoreboard modules, spanning a total of 30 subsystem files) to this new global debug method.
- Introduced a global static
1.0.3.2Релиз26.1, 26.1.1, 26.1.2 · 7 июня 2026 г.
v1.0.3.2 更新日志
新增功能
- Carpet 假人智能联动:
- 新增与 Carpet 模组的智能联动功能。
- 登录验证模块现能自动、智能识别 Carpet 生成的假人信息(
carpet.patches.EntityPlayerMPFake)。
- 登录验证模块现能自动、智能识别 Carpet 生成的假人信息(
- 假人加入时将自动激活免密登录(安全置为已登录状态),无需输入
/login或/register人在后台流畅运作。
- 假人加入时将自动激活免密登录(安全置为已登录状态),无需输入
修复与优化
- 商店多维度支持与告示牌更新错误修复:
- 商店实例(
ShopInstance)现在完全在持久化数据和内存模型中存储并索引维度信息(dimensionId),杜绝了相同坐标跨维度的哈希键碰撞。 - 定时衰减系统不再默认使用主世界更新告示牌,而是自适应检索并使用每个商店所在的维度(如
minecraft:the_nether等),彻底修复了非主世界下界商店因跨世界查找抛出的“目标方块实体不是告示牌”警告。 - 优化了定时告示牌刷新逻辑的区块状态检测,对于未加载的区块不再强制读取,极大降低卡顿开销。
- 旧商店智能维度修复系统:在服务器启动时,能够全自动扫描所有未标识维度的旧版商店。若在主世界对应坐标处没有告示牌,而在下界或末地能检测到该告示牌,系统将自动将商店属性修补为正确的维度并永久保存。用户无需手动打任何指令,也不用劳神去修改存档 NBT 文件。
- 商店实例(
v1.0.3.2 Update Log
New Features
- Carpet Mod Fake Player Support:
- Added smart integration with Carpet mod fake players (
carpet.patches.EntityPlayerMPFake). - The login system automatically bypasses verification and registers carpet fake players as logged in, enabling them to operate smoothly without typing
/loginor/register.
- Added smart integration with Carpet mod fake players (
Bug Fixes & Optimizations
- Shop Multi-Dimension Support & Sign Update Fix:
- The
ShopInstancenow stores and indexes dimension info (dimensionId) across persistence and memory, preventing coordinate hash key collisions across different dimensions. - The system stock decay task now dynamically resolves the corresponding
ServerLevelof each shop instead of only using Overworld, resolving the "block entity is not a sign" warning in non-overworld shops. - Added chunk loaded checks to prevent crash issues or performance drops during sign updates.
- Legacy Shop Auto-Repair System: On server startup, the mod automatically scans all legacy shops (defaulted to
minecraft:overworld). If a sign is missing at that location in Overworld but present in Nether/End, it will silently migrate the shop dimension and write it back to save. No manual action or NBT editing required!
- The
1.0.3.1Релиз26.1, 26.1.1, 26.1.2 · 7 июня 2026 г.
v1.0.3.1 更新日志
新增功能
- Warp 地标系统:
- 新增指令
/warpadmin create <name> <x> <y> <z>,允许管理员创建地标,支持相对坐标(如~ ~ ~)。 - 新增指令
/warpadmin delete <name>和/warpadmin list用于管理地标。 - 新增指令
/warp <name>,允许玩家传送到指定地标。 - 新增指令
/warpback,允许玩家传送到上次使用/warp前所在的位置。 - 安全的传送机制: 玩家使用传送指令后,需要原地站立等待 3 秒。如果期间发生移动或受到伤害,传送将会被打断。
- 跨维度支持: 传送系统完美支持跨纬度传送,并且
/warpback也能准确记住跨维度前的位置。 - 地标数据持久化保存,重启服务器不会丢失。
- 新增指令
系统优化
- 全局防断电/防崩溃 IO 保护:
- 重构了所有本地配置文件和 JSON 数据的读写逻辑(包括认证模块、经济、统计、CDK历史等)。
- 引入了 “备份回滚 (.bak) + 临时文件原子替换 (.tmp)” 的双重保护机制。
- 这可以完全避免服务器在保存数据时发生突然断电或崩溃而导致的配置文件或数据文件损坏/清空的问题。
v1.0.3.1 Change Log
New Features
- Warp System:
- Added command
/warpadmin create <name> <x> <y> <z>allowing administrators to create warps. Supports relative coordinates (e.g.,~ ~ ~). - Added commands
/warpadmin delete <name>and/warpadmin listto manage warps. - Added command
/warp <name>allowing players to teleport to a specific warp. - Added command
/warpbackallowing players to return to their location prior to using a/warpcommand. - Safe Teleportation: Players must stand still for 3 seconds after requesting a teleport. The teleport will be cancelled if the player moves or takes damage.
- Cross-Dimension Support: The teleportation system fully supports cross-dimension travel.
/warpbackaccurately remembers the dimension and location. - Warp data is saved persistently and will not be lost upon server restarts.
- Added command
- Carpet Fake Player Integration:
- Added integration with the Carpet mod.
- The authentication module now automatically and intelligently recognizes fake players created by Carpet (
carpet.patches.EntityPlayerMPFake). - Upon joining, fake players automatically bypass authentication (safely marked as logged in). They do not need to enter
/loginor/registercommands and are completely exempt from the whitelist and timeout kick mechanics, ensuring smooth operation.
System Improvements
- Global Power-Loss/Crash IO Protection:
- Refactored all local configuration and JSON data read/write logic across all modules (Auth, Economy, Statistics, CDK History, etc.).
- Introduced a dual-protection mechanism: "Backup Fallback (.bak) + Atomic Temp File Replacement (.tmp)".
- This completely prevents configuration or data file corruption/loss if the server crashes or loses power during a save operation.
1.0.3Релиз26.1, 26.1.1, 26.1.2 · 7 июня 2026 г.
v1.0.3 更新日志
修复与优化
- CDK 模块重构:
- 重新设计了 CDK 分类逻辑。
- 新增
GLOBAL_LIMIT类型:全服限量领取,且每个玩家仅限领取一次。 - 新增
PLAYER_LIMIT类型:个人限量领取,全服总领用人数不限,但每个玩家有领用次数上限。 - 数据追踪优化:现在可以精确记录每个玩家对每个 CDK 的领用次数。
- 兼容性处理:自动将旧版本的 CDK 数据映射到新系统中,确保无缝升级。
- 本地化增强:
- 更新了 CDK 相关的中文翻译,提示信息更加准确。
- 在管理列表中增加了限制类型的详细悬浮提示。
v1.0.3 Change Log
Fixes and Improvements
- CDK Module Refactoring:
- Redesigned CDK classification logic.
- New
GLOBAL_LIMITtype: Server-wide total usage limit, with each player restricted to a single redemption. - New
PLAYER_LIMITtype: Personal usage limit per player, with no restriction on the total number of players who can redeem. - Data Tracking Optimization: Now accurately tracks redemption counts per player for each CDK.
- Compatibility Handling: Automatically maps legacy CDK data to the new system for seamless upgrades.
- Localization Enhancements:
- Updated CDK-related English translations for better clarity.
- Added detailed hover tooltips for limit types in the admin list.
1.0.2Релиз26.1, 26.1.1, 26.1.2 · 7 июня 2026 г.
Tuanzi's Server Mod 更新日志 - v1.0.2
版本号: 1.0.2 适配版本: Minecraft 26.1 (1.22) - Fabric
🚀 版本摘要
本次更新重点解决了服务器数据安全与灾难恢复问题。我们引入了全新的备份回滚系统,支持全量数据的自动化备份与带安全机制的一键恢复,为服务器运营提供坚实的数据保障。
🛠 新增功能
💾 备份回滚系统 (Backup System)
针对自定义存储可能存在的文件损坏或数据异常风险,新增了全方位的自动化备份方案。
- 全数据覆盖: 自动打包经济账户、多币种配置、商店数据、CDK 池、称号库、玩家统计数据及白名单。
- 自动化备份: 支持按小时设置定时备份(默认为 12 小时),文件统一存储在
./mod_backups/。 - 安全回滚机制:
- 二次确认: 执行恢复指令后需点击聊天框内的确认按钮方可继续,防止误操作。
- 自动快照: 在执行任何恢复操作前,系统会强制对当前数据进行一次紧急备份(pre_restore),确保即使回滚错误也能再次恢复。
- 安全停机: 恢复完成后系统会自动安全停机以确保数据完整性。
- 指令支持:
/eco backup: 手动立即执行全量备份。/eco restore <timestamp>: 从指定的时间戳备份文件恢复数据(含确认环节)。/eco interval <hours>: 设置自动备份的周期。
🏷️ 称号系统增强 (Title System Enhancement)
为称号系统引入了精密的“时间轴”管理功能,支持限时称号与全局赛季称号。
- 全局有效期控制: 管理员可为称号设定统一的结束时间(如赛季称号),到期后全服玩家将自动卸下并失去该称号。
- 限时道具支持: 生成称号命名牌时可指定持有天数。玩家激活后将获得限时称号,多次激活同名道具可累加时长。
- 实时端显示: 玩家在执行
/titles list时,悬浮在称号上即可查看精确到分钟的有效期。 - 后台自动化管理: 系统每分钟会自动扫描并清理到期称号,并向在线玩家发送到期通知。
- 管理指令扩展:
/titleadmin setexpiry <id> <date>: 设置称号的全局到期时间./titleadmin modifyplayer <targets> <id> <set/add/remove> <days>: 灵活调整特定玩家的称号持有时间。/titleadmin give/getitem: 现已支持在末尾添加[days]参数。
💰 经济系统配置扩展 (Economy Config Expansion)
- 同 IP 转账检测: 新增
allowSameIPTransfer配置项,允许管理员禁止处于相同 IP 地址的玩家进行转账,有效防止通过多开进行刷钱或违规交易。 - 配置热重载: 支持无需重启服务器即可重载经济模块配置。
- 管理指令:
/econ-admin config reload: 重新加载经济配置文件。/econ-admin config set allowSameIPTransfer <true/false>: 动态开启或关闭同 IP 转账限制。
🐞 漏洞修复 (Bug Fixes)
- 商店漏斗保护: 修复了漏斗或漏斗矿车可以从商店容器(如箱子)中非法提取物品的严重漏洞。现已通过多层拦截确保商店库存的绝对安全。
Tuanzi's Server Mod Update Log - v1.0.2
Version: 1.0.2
Release Date: April 27, 2026
Minecraft Version: 26.1 (1.22) - Fabric
🚀 Version Summary
This update focuses on server data security and disaster recovery. We have introduced a brand-new Backup & Rollback System, supporting automated full-data backups and a one-click recovery process with built-in safety mechanisms to ensure solid data protection for server operations.
🛠 New Features
💾 Backup & Rollback System
Introduced a comprehensive automated backup solution to mitigate risks of data corruption or exploitation.
- Full Data Coverage: Automatically packages economic accounts, currency configs, shop data, CDK pools, title repositories, player statistics, and whitelists.
- Automated Backups: Supports scheduled backups (default: every 12 hours) with files stored in
./mod_backups/. - Safe Rollback Mechanism:
- Double Confirmation: Restoration requires a second confirmation via a clickable button in the chat, preventing accidental execution.
- Auto-Snapshot: Before any restoration, the system forces an emergency backup (
pre_restore) of the current data to ensure safety. - Safe Shutdown: After restoration, the system automatically shuts down to guarantee data integrity.
- Command Support:
/eco backup: Execute a full backup manually./eco restore <timestamp>: Restore data from a specific timestamp (includes confirmation step)./eco interval <hours>: Set the automated backup cycle.
🏷️ Title System Enhancement
Introduced precise "Timeline" management for the title system, supporting limited-time titles and global seasonal titles.
- Global Expiry Control: Admins can set a unified end date for a title (e.g., for seasonal rewards). Once expired, all players will automatically unequip and lose the title.
- Timed Item Support: Title Name Tags can now be generated with a specific duration in days. Players gain a timed title upon activation; using multiple tags for the same title will stack the duration.
- Real-time Expiry Display: In the
/titles listmenu, players can hover over a title to see its exact expiration time (up to the minute). - Automated Backend Management: The system scans every minute to clean up expired titles and sends expiration notifications to online players.
- Extended Admin Commands:
/titleadmin setexpiry <id> <date>: Set a global expiration date for a title./titleadmin modifyplayer <targets> <id> <set/add/remove> <days>: Flexibly adjust title durations for specific players./titleadmin give/getitem: Now supports an optional[days]parameter at the end.
💰 Economy Configuration Expansion
- Same IP Transfer Detection: Added
allowSameIPTransferconfiguration, allowing admins to prohibit transfers between players on the same IP address to prevent multi-account exploitation or illegal trading. - Hot-Reload Support: Supports reloading economy module configurations without a server restart.
- Admin Commands:
/econ-admin config reload: Reload the economy configuration file./econ-admin config set allowSameIPTransfer <true/false>: Dynamically toggle the same IP transfer restriction.
🐞 Bug Fixes
- Shop Hopper Protection: Fixed a critical vulnerability where hoppers or hopper minecarts could illegally extract items from shop containers (e.g., chests). Multi-layer interception now ensures absolute safety for shop inventories.
1.0.1Релиз26.1, 26.1.1, 26.1.2 · 25 апреля 2026 г.
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.
Комментарии
Загружаем…