关于T3SF
T3SF是一款功能全面的桌面端技术练习模拟框架,该工具针对基于主场景事件列表的各种事件提供了模块化的架构,并包含了针对每一个练习定义的规则集,以及允许为对应平台参数定义参数的配置文件。
该工具的主模块能够执行与其他特定模块的通信,例如Discord、Slack、Telegram等,而这些模块可以将事件信息以对象的形式通过输入信道传递并显示到每一个平台中。除此之外,该框架支持不同的用户场景,其中包括“单个组织、多个地区”、“多个组织、单个地区”和“多个组织,多个地区”。
工具架构
支持的平台
Discord
Slack
Telegram
工具要求
Python 3.6+
Pip
工具安装
由于该工具基于Python 3.6开发,因此我们首先需要在并本地设备上安装并配置好Python 3.6+环境。
然后创建一个虚拟环境以避免依赖组件问题:
python3 -m venv venv
运行下列命令即可安装T3SF:
pip install T3SF
基于平台的安装
上述命令已经完成了工具核心框架的安装,接下来我们还需要针对每一个平台安装额外的代码库。
Discord
pip install "T3SF[Discord]"
Slack
pip install "T3SF[Slack]"
工具使用
本地使用
安装并配置好T3SF之后,可以直接使用我们提供的模板main.py,并修改下列代码。下列代码中,可以使用T3SF配合Discord bot和GUI一起运行:
from T3SF import T3SF import asyncio async def main(): await T3SF.start(MSEL="MSEL_TTX.json", platform="Discord", gui=True) if __name__ == '__main__': asyncio.run(main())
或者,如果你不想使用GUI,并且项是哟ingSlack的话,可以修改对应参数:
await T3SF.start(MSEL="MSEL_TTX.json", platform="Slack", gui=False)
Docker使用
结合Slack使用:
$ docker run --rm -t --env-file .env -v $(pwd)/MSEL.json:/app/MSEL.json base4sec/t3sf:slack
结合Discord使用:
$ docker run --rm -t --env-file .env -v $(pwd)/MSEL.json:/app/MSEL.json base4sec/t3sf:discord
工具运行截图
许可证协议
本项目的开发与发布遵循GPL-3.0开源许可证协议。
项目地址
T3SF:【GitHub传送门】
参考资料
T3SF - Technical Tabletop Exercises Simulation Framework — T3SF 2.5 documentation