TTS-Backup：3步构建Tabletop Simulator数据保护屏障-拓冰建站

TTS-Backup：3步构建Tabletop Simulator数据保护屏障

【免费下载链接】tts-backupBackup Tabletop Simulator saves and assets into comprehensive Zip files.项目地址: https://gitcode.com/gh_mirrors/tt/tts-backup

Tabletop Simulator玩家经常面临一个严峻挑战：数小时精心搭建的模组和游戏存档，可能因系统故障或误操作瞬间消失。TTS-Backup正是为解决这一痛点而生的专业数据保护工具，它能够智能解析TTS的JSON保存文件，自动收集所有引用的图像、模型、音频资源，并将它们打包成完整的Zip存档，为你的数字桌游资产提供全方位的安全保护。

🔥 问题洞察：TTS数据管理的三大痛点

Tabletop Simulator作为数字桌游平台，其数据管理存在几个关键问题：首先，游戏数据分散在多个目录中，JSON保存文件仅包含引用，实际资源存储在本地缓存中；其次，模组更新或系统重装时，缓存资源容易丢失；第三，跨设备迁移时，手动收集所有相关文件几乎不可能。

资源分散化是核心挑战。一个典型的TTS模组可能包含：

JSON格式的保存文件（游戏状态、玩家进度）
本地缓存的图像资源（卡牌、棋盘、token）
3D模型文件（自定义棋子、配件）
音频文件（背景音乐、音效）
PDF文档（规则手册、参考表）

更糟糕的是，当游戏物品存放在袋子中时，TTS默认只缓存从袋子中取出的物品。这意味着即使你加载过模组，部分资源可能仍未下载到本地缓存中。

💡 解决方案：智能资源聚合与跨平台兼容

TTS-Backup的核心价值在于其智能资源识别机制。工具通过src/tts_tools/libtts.py中的seekURL函数递归遍历JSON结构，提取所有引用的URL路径，然后根据平台差异自动定位缓存目录：

# 跨平台缓存目录映射 gamedata_map = { "Windows": "~/Documents/My Games/Tabletop Simulator", "Darwin": "~/Library/Tabletop Simulator", # macOS "Linux": "~/.local/share/Tabletop Simulator", }

模块化架构让TTS-Backup既灵活又强大：

src/tts_tools/backup/: 核心备份功能，支持CLI和GUI两种界面
src/tts_tools/prefetch/: 资源预下载模块，确保所有资源可用
src/tts_tools/libgui/: 图形界面组件，提供直观操作体验

我们建议的安装方式简单直接：

git clone https://gitcode.com/gh_mirrors/tt/tts-backup cd tts-backup pip install .

安装完成后，系统会自动注册四个入口点：

tts-backup: 命令行备份工具
tts-prefetch: 命令行预下载工具
tts-backup-gui: 图形界面备份工具
tts-prefetch-gui: 图形界面预下载工具

🚀 实战演练：从基础备份到高级自动化

基础备份操作：保护你的游戏存档

最简单的备份命令只需要指定JSON保存文件：

tts-backup my_save_game.json

工具会自动生成带时间戳的备份文件，如my_save_game_20250101_120000.zip。对于需要更多控制的场景，TTS-Backup提供了丰富的参数选项：

# 预览模式：只显示将备份的文件，不实际创建 tts-backup --dry-run complex_mod.json # 容错处理：遇到缺失文件时继续执行 tts-backup --ignore-missing incomplete_mod.json # 自定义输出：指定备份文件名和位置 tts-backup -o "backups/mod_v2.0.zip" my_mod.json # 添加注释：为备份添加描述信息 tts-backup --comment "v3.0新增扩展包" my_mod.json -o mod_v3.0_backup.zip

资源预下载：确保缓存完整性

TTS-Prefetch解决了"袋子物品"问题——当模组使用袋子容器时，TTS默认只缓存从袋子中取出的物品。使用预下载功能可以确保所有资源都在本地：

# 基本预下载 tts-prefetch my_mod.json # 强制重新下载已存在的资源 tts-prefetch --refetch updated_mod.json # 批量处理多个模组 tts-prefetch mod1.json mod2.json mod3.json # 预览模式：查看将下载的资源 tts-prefetch --dry-run large_mod.json

自动化脚本：构建持续保护体系

对于模组开发者或重度用户，自动化是提升效率的关键。以下脚本展示了如何构建自动备份系统：

#!/bin/bash # auto_backup.sh - 自动备份所有重要模组 BACKUP_DIR="/path/to/backups" MOD_DIR="/path/to/tts/mods" # 创建按日期组织的目录结构 DATE=$(date +%Y%m%d) mkdir -p "${BACKUP_DIR}/${DATE}" # 备份所有JSON文件 for mod_file in "${MOD_DIR}"/*.json; do if [[ -f "$mod_file" ]]; then mod_name=$(basename "$mod_file" .json) echo "备份模组: ${mod_name}" # 先预下载确保资源完整 tts-prefetch "$mod_file" # 创建带版本注释的备份 tts-backup --comment "自动备份 ${DATE}" "$mod_file" \ -o "${BACKUP_DIR}/${DATE}/${mod_name}_backup.zip" fi done # 清理30天前的旧备份 find "${BACKUP_DIR}" -type d -mtime +30 -exec rm -rf {} \;

🌐 生态扩展：与开发工作流深度集成

版本控制集成：模组开发的黄金标准

对于模组开发者，TTS-Backup可以与Git等版本控制系统完美集成。最佳实践是在每次重要更新前创建完整备份：

# 开发工作流示例 git add . git commit -m "功能更新：新增卡牌系统" # 创建版本化备份 tts-backup --comment "Git提交: $(git rev-parse --short HEAD)" \ my_mod.json -o "backups/mod_$(git describe --tags).zip"

持续集成/持续部署（CI/CD）支持

在团队协作环境中，可以将TTS-Backup集成到CI/CD流水线中，确保每次构建都包含完整的资源备份：

# .gitlab-ci.yml 示例 stages: - prefetch - backup - deploy prefetch_assets: stage: prefetch script: - tts-prefetch --refetch src/mod.json artifacts: paths: - cache/ create_backup: stage: backup script: - tts-backup --comment "CI构建 ${CI_PIPELINE_ID}" src/mod.json -o dist/mod_backup.zip artifacts: paths: - dist/mod_backup.zip deploy_to_server: stage: deploy script: - scp dist/mod_backup.zip user@server:/backups/