本页目录

跑团Replay视频制作工具(TRPG-Replay-Generator / 回声工坊)

TRPG-Replay-Generator · DanDDXuanX/TRPG-Replay-Generator

Python 编写的跑团 replay 与类视觉小说视频制作工具,按「像写文档一样」的思路编排剧本以减少重复劳动;README 提到支持自定义界面布局、VSCode 插件编辑剧本、海豹骰 log 导出剧本格式、导出 PR 项目与透明背景视频素材。仓库目前只提...

文字冒险 其他 Pygame Python 音频系统 UI 系统 中级
★ Stars 179 Forks 30 License GPL-3.0 更新 2026-11-14

国内开发环境适配

Windows
官方声明支持
Linux
未知
macOS
未知
引擎 / 框架:Pygame 暂无中文教程标记 未标记站长实测
依赖需自行准备:ffmpeg 可执行文件要解压到仓库根目录,7z 需安装并加入环境变量(打包用),另需安装阿里云智能语音服务 Python SDK;源码版不含内置语音合成权限,需自行注册语音服务账号并在【首选项】填写 key。Steam 商店与爱发电激活码渠道可能涉及外部网络访问,其他网络/镜像问题待核验。

中文项目介绍

回声工坊(仓库名 TRPG-Replay-Generator)是一款用 Python 编写的、面向跑团 replay 视频的专业制作工具。仓库的 GitHub 描述把它概括为「像编写文档一样简单地创作跑团 replay 视频」:使用者不需要在时间轴上反复拖拽素材,而是以编排脚本文档的方式描述画面、媒体与流程,从而把视频生产流程压缩成写文档一样的操作。

需要先说明的是版本形态:该软件已经在 Steam 商店正式发行,商业发行版名称为 回声工坊 RplGenStudio,发行商为 Betelgeuse Industry。正式发行之后,本仓库不再提供开包即用的二进制可执行文件,仅提供源代码;同时,源代码版本不拥有内置语音合成服务的权限,需要使用者自行注册语音合成账号,并把 key 填写到软件的【首选项】中。

核心功能

简化工作

显著减少跑团 replay 视频与类视觉小说视频制作中的重复劳动,把视频制作简化到如同编写文档一样简单。

高度自定义

提供多种复杂的媒体类型,支持自定义复杂的视频界面布局,适合搭建有个人风格的 replay 画面。

生态开放

作者强调上下游软件的联动能力,包括:

创意分享

支持创意工坊,用户可以分享与下载预设样式模板,并借助模板实现「一键成片」。

技术架构分析

构建与环境要求

若要基于源码自行运行或打包,README 列出的环境与依赖如下:

  1. Python >= 3.8
  2. pygame >= 2.0.1
  3. numpy >= 1.18.5
  4. pandas >= 1.0.5
  5. Pillow >= 7.2.0
  6. ffmpeg-python >= 0.2.0
  7. pydub >= 0.25.1
  8. openpyxl >= 3.0.4
  9. azure-cognitiveservices-speech >= 1.31.0
  10. ttkbootstrap >= 1.10.1
  11. tkextrafont == 0.6.3
  12. chlorophyll == 0.3.1
  13. pyttsx3 == 2.90
  14. websocket-client == 1.0.1
  15. pinyin == 0.4.0

除 Python 包之外,还需要额外准备:

  • 下载 ffmpeg 的可执行文件,并解压到本仓库根目录;
  • 安装阿里云智能语音服务 Python SDK;
  • 安装 7z 并添加到环境变量,打包时需要(README 标注为推荐)。

完成环境准备后,使用仓库中的打包脚本(bulid.ps1)即可完成软件的打包。从依赖构成可以看出,这个项目把界面(pygame、ttkbootstrap、字体相关库)、数据处理(numpy、pandas、openpyxl)、音视频处理(ffmpeg-python、pydub、pyttsx3、Azure 语音 SDK)组合成一条完整的桌面生产流水线。

补充说明

获取方式与版本差异

README 给出两条获取渠道,二者最终都指向 Steam 平台:

  • Steam 商店:售价 13 美元,或人民币 50 元;自动更新、创意工坊、内置语音服务等能力只在该版本中提供。
  • 爱发电:同样销售 Steam 激活码(CDkey),定价 50 元;购买后需要在 Steam 平台激活,功能等价于在 Steam 商店直接购买。

而本 GitHub 仓库的定位是源码仓库:可以自行构建、修改、二次开发,但需要自己准备语音合成服务并配置 key,也需要自行处理运行依赖。

配置要求

README 给出的配置分两档:

  • 最低配置:Windows 10、4GB 内存、1GB 硬盘空间。
  • 最佳配置:Windows 10、8GB 内存、1GB 硬盘空间。

也就是说官方明确列出的目标系统为 Windows 10;README 中未提及其他操作系统的支持情况。

操作手册与文档

仓库本身不承载完整教程,README 指向外部文档:回声工坊 RplGenStudio 操作手册(wolai 页面)。想了解剧本字段、媒体类型与界面布局的具体用法,应以该手册为准,仓库 README 只覆盖概述、下载渠道、配置要求与构建方式。

开源协议与使用限制

本软件采用 GPL3.0 协议开源,允许自由使用、修改本软件,或将其中部分代码用于自己的项目,但作者特别强调两点:

  1. 开源要求:如果在其他项目中使用了本项目的功能或代码,遵照 GPL3.0 的规范,该项目也应当开源,并规范地注明引用关系。
  2. 使用限制:基于本项目进行二次开发时,不允许使用本软件的图标、名称、吉祥物等第三方享有著作权的资产。

适用人群与学习建议

从仓库信息看,这个项目更适合已有明确产出目标的使用者,而不是当作入门教程:

  • 想高效产出跑团 replay / 类视觉小说视频的创作者,可以通过 Steam 版本直接获得完整能力;
  • 希望研究「文档驱动型视频生产」思路的开发者,可以阅读源码观察剧本如何被解析为画面与媒体,以及最终如何经 ffmpeg 合成输出;
  • 对桌面 GUI + 音视频处理组合感兴趣的 Python 学习者,也可以把它当作一个涉及界面布局、字体、音频与视频导出等多环节的实践样本,但需要预期到依赖较多(ffmpeg、7z、语音 SDK 都需自行准备)。

需要注意仓库仅提供源码、不提供开箱即用的可执行文件,且源码版不含内置语音合成权限;涉及商业发行版本的功能(创意工坊、自动更新、内置语音)在源码中不可用,评估时应以官方 README 与操作手册为准。

开源许可证与版权说明

许可证标识:GPL-3.0。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目