1.0.2
Compatibility
Changes
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.
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:PKVDr7oU"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:RDMGNOTc:PKVDr7oU"
}

