开源项目 · Flutter · 桌面端

Roll & Roll 🐲

一款基于 Flutter 的桌面端 TTRPG 辅助工具
角色管理 · 地图编辑 · 骰子投掷 · 多人联机 · 直播模式

▼ 向下滚动
01

项目介绍

Roll & Roll 是一个面向 TRPG(桌面角色扮演游戏)主持人与玩家的桌面端辅助工具, 提供从创建角色、管理存档到多人联机冒险、直播推流的一站式体验。

🧙

角色创建

编辑角色职业、种族、属性、技能、装备、物品,支持头像上传,灵活适配任意规则体系。

🗺️

地图编辑

创建/管理冒险地图,部署敌人和角色 Token,拖拽调整位置,所见即所得。

🎲

骰子投掷

支持 d202d6+3 等标准骰子表达式,以及属性修饰符如 d20+力量

🌐

多人联机

主持人创建房间 → 玩家加入 → 共同冒险,基于 WebSocket 协议,WebRTC 规划中。

📺

直播模式

主持视角 + 独立玩家副屏窗口,通过 desktop_multi_window 实现双屏推流。

💾

存档管理

ZIP 格式存档(角色 + 地图 + 规则书),支持导入/导出与进度保存。

🛠️ 技术栈

基于 Flutter 框架构建,使用 Dart 语言,一套代码覆盖 Windows / macOS / Linux 三大桌面平台。 采用 Clean Architecture 分层架构,清晰分离数据层、领域层与展示层。

📝

更多项目细节待补充

可以在这里添加项目背景、设计理念、与其他工具对比、路线图等内容

02

使用教程

从零开始,快速上手 Roll & Roll。以下为基础安装与启动流程,详细教程待补充。

1

安装 Flutter SDK

确保已安装 Dart ^3.12.2Flutter SDK。 参考 Flutter 官方安装指南

2

克隆仓库

从 GitHub 获取项目源码:

$ git clone https://github.com/ravencrow1108-beep/roll_and_roll.git
$ cd roll_and_roll
3

安装依赖

$ flutter pub get
4

运行应用

$ flutter run
5

构建发布版本(可选)

# 构建 Windows 版本
$ flutter build windows

# 构建 macOS 版本
$ flutter build macos

# 构建 Linux 版本
$ flutter build linux
🎬

详细使用教程待补充

可以在这里添加:功能详解、截图演示、视频教程、常见问题 FAQ 等

03

GitHub 下载

项目源码完全开源,托管在 GitHub。选择你的方式获取项目。

⚡ 一键克隆

git clone https://github.com/ravencrow1108-beep/roll_and_roll.git
📋

版本发布信息待补充

可以在这里添加:Release Notes、各版本下载链接、更新日志、系统要求详情等

04

作者介绍

项目的开发者与贡献者信息。

🐲

ravencrow1108-beep

Roll & Roll 的作者,热爱 TRPG 与开源开发。 使用 Flutter 构建跨平台桌面应用。

🤝

贡献者信息待补充

可以在这里添加:贡献者列表、致谢、联系方式、赞助入口等