TTS-Backup：5步构建Tabletop Simulator数据保护的终极解决方案-拓冰建站

TTS-Backup：5步构建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游戏存档、模组及所有相关资源智能打包成完整的Zip文件，为你的数字桌游资产提供全方位保护。这个开源工具支持Windows、macOS和Linux系统，通过智能资源识别和完整数据保护机制，确保你的创意成果永不丢失。

为什么需要专业的TTS数据备份工具？🎯

Tabletop Simulator不仅是一个游戏平台，更是玩家创意和心血的结晶。然而，游戏数据分散在多个文件中——JSON格式的保存文件记录游戏状态、本地缓存的图像和模型构成模组核心、音频文件和脚本增强游戏体验。手动备份这些文件不仅繁琐，而且容易遗漏关键资源。

更糟糕的是，当你想在不同设备间迁移数据时，常常会遇到资源丢失的尴尬局面！TTS-Backup的三大核心优势让你彻底告别这些烦恼：

智能资源识别：自动解析JSON文件，识别所有引用的资源路径
完整数据保护：确保备份包含所有必要的图像、模型和音频文件
跨平台兼容性：在三大主流操作系统上都能稳定运行

快速入门：5分钟完成首次备份⏱️

环境准备与安装

确保系统已安装Python 3.3或更高版本。打开命令行工具，执行以下命令获取TTS-Backup：

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

选择适合你的操作界面

TTS-Backup提供了两种操作方式，满足不同用户的需求：

界面类型	适合人群	启动方式	核心优势
图形界面	新手用户、偏好可视化操作	`python src/tts_tools/backup/gui.py`	直观易用，无需记忆命令
命令行界面	技术爱好者、需要自动化	`python src/tts_tools/backup/cli.py`	灵活高效，支持脚本化操作

执行备份操作

图形界面操作流程：

运行GUI程序后，选择你的TTS游戏数据目录
选择要备份的JSON保存文件
点击"开始备份"按钮，等待完成

命令行界面基本用法：

python src/tts_tools/backup/cli.py your_save_file.json

理解备份过程

在备份过程中，TTS-Backup会执行以下关键步骤：

解析JSON保存文件：识别所有引用的资源URL和本地路径
查找对应资源：在TTS缓存目录中定位图像、模型和音频文件
打包成Zip文件：将所有相关文件整合到带时间戳的压缩包中
添加元数据：可选地包含注释信息，便于版本管理

验证与恢复

备份完成后，建议打开生成的Zip文件检查内容完整性。恢复数据时，只需将Zip文件解压到TTS的游戏数据目录即可。

核心功能深度解析🔧

智能资源识别机制

TTS-Backup的核心逻辑位于src/tts_tools/libtts.py，该模块实现了智能的资源识别算法：

def seekURL(dic, trail=[]): """递归搜索保存游戏结构并返回URL及其路径""" for k, v in dic.items(): newtrail = trail + [k] if k == "AudioLibrary": for elem in v: try: yield (newtrail, elem["Item1"]) except KeyError: raise NotImplementedError( "AudioLibrary has unexpected structure: {}".format(v) )

这个函数能够深度遍历TTS的JSON结构，识别出所有引用的资源URL，包括图像、模型、音频等不同类型。

跨平台路径处理

项目支持Windows、macOS和Linux三大平台，自动识别不同系统的TTS数据目录：

gamedata_map = { "Windows": "~/Documents/My Games/Tabletop Simulator", "Darwin": "~/Library/Tabletop Simulator", # MacOS "Linux": "~/.local/share/Tabletop Simulator", }

命令行参数详解

TTS-Backup提供了丰富的命令行参数，让你可以灵活定制备份策略：

参数选项	命令示例	适用场景	效果说明
预览模式	`--dry-run`或`-n`	首次使用或不确定时	只显示要备份的文件列表，不实际创建备份
容错处理	`--ignore-missing`或`-i`	资源不完整时	遇到缺失文件时继续执行，不中断备份
添加备注	`--comment "重要更新"`或`-c`	版本管理	在备份文件中添加描述信息，便于识别
指定输出	`-o my_backup.zip`	自定义命名	设置备份文件的名称和位置
自定义目录	`--gamedata /path/to/tts`	非标准安装	指定TTS游戏数据目录的位置

高级应用场景与实战技巧🚀

模组开发者的版本管理

对于模组开发者，TTS-Backup是完美的版本控制工具。每次重要更新前进行备份：

python src/tts_tools/backup/cli.py --comment "v2.0新增卡牌系统" my_mod.json -o my_mod_v2.0_backup.zip

这样你就有了完整的历史记录，随时可以回溯到任意版本。建议将备份文件与源代码一起纳入版本控制系统。

批量备份与自动化脚本

通过简单的Shell脚本，你可以实现自动化备份：

#!/bin/bash # 备份所有重要的JSON文件 BACKUP_DIR="backups_$(date +%Y%m%d)" mkdir -p "$BACKUP_DIR" for file in *.json; do python src/tts_tools/backup/cli.py "$file" -o "$BACKUP_DIR/backup_${file%.json}.zip" echo "已备份: $file" done echo "批量备份完成！备份文件保存在: $BACKUP_DIR"

TTS-Prefetch：智能资源下载助手

除了备份功能，项目还包含一个强大的工具——TTS-Prefetch。这个工具可以自动下载模组中引用的所有在线资源，确保你的本地缓存完整无缺。

使用场景：

模组更新后确保所有新资源都已下载
使用包含袋子的模组时，TTS默认只缓存从袋子中取出的物品
准备离线游戏，提前下载所有资源
清理缓存后重新下载所有必需的资源

基本用法：

python src/tts_tools/prefetch/cli.py my_mod.json

高级参数：

# 重新下载已存在的资源 python src/tts_tools/prefetch/cli.py --refetch my_mod.json # 仅预览，不实际下载 python src/tts_tools/prefetch/cli.py --dry-run my_mod.json # 批量处理多个文件 python src/tts_tools/prefetch/cli.py mod1.json mod2.json mod3.json

项目架构与模块设计📁

TTS-Backup采用模块化设计，代码结构清晰：

src/tts_tools/ ├── backup/ # 备份模块 │ ├── __init__.py │ ├── cli.py # 命令行接口 │ └── gui.py # 图形界面 ├── prefetch/ # 预取模块 │ ├── __init__.py │ ├── cli.py │ └── gui.py ├── libgui/ # GUI组件 │ ├── __init__.py │ ├── entry.py │ └── frame.py ├── __init__.py ├── libtts.py # 核心解析逻辑 └── util.py # 工具函数