71 lines
2.1 KiB
Markdown
71 lines
2.1 KiB
Markdown
# Difficult Rocket 游戏功能设计文档
|
|
|
|
> by shenjackyuanjie and BlueFunny_
|
|
|
|
`Difficult Rocket` 游戏本体功能由 `DR mod` 实现
|
|
|
|
## DR mod
|
|
|
|
- `DR mod` 包含以下几个部分
|
|
- `DR_mod`: Python 实现的主体
|
|
- `DR_rs`: DR_mod 的 Rust 扩展
|
|
|
|
- 命名空间
|
|
- 命名空间遵循本体原则 全拼
|
|
- `Difficult_Rocket_mod`
|
|
- `Difficult_Rocket_rs`
|
|
|
|
## DR_rs
|
|
|
|
> DR_rs 扩展为 DR mod 的 Rust 扩展
|
|
|
|
- 内容
|
|
- `simluation`
|
|
- 物理引擎交互
|
|
- `sr1_data`
|
|
- SR1 数据读取 格式转化
|
|
- `types`
|
|
- 主要的 Rust 数据格式定义
|
|
|
|
### `DR_rs` Rust 插件加载逻辑
|
|
|
|
- 加载模式
|
|
- 冷加载
|
|
- 游戏启动前扫描 Rust 扩展目录, 并加载所有的可识别后缀名扩展, 然后启动游戏
|
|
- 热加载
|
|
- 游戏进行中进行 `热加载` / `热卸载` / `热重载` 等操作
|
|
- **不推荐使用此方式, 因为这可能导致某些插件未正常加载导致异常**
|
|
- 使用此方式必须提供**明确的**初始化加载阶段, 否则将拒绝加载
|
|
- PS: 这个初始化加载阶段指扩展应在何时加载, 如启动时, 这个具体是看扩展都要修改哪些内容的
|
|
- 加载方法
|
|
- 利用 [本文](https://docs.rs/libloading/latest/libloading/) 中的方法加载 dll 扩展模组
|
|
- 模组应明确提供以下信息 (加 `*` 为可选内容)
|
|
- 模组名称
|
|
- 模组唯一可识别 ID
|
|
- 模组版本
|
|
- 模组作者
|
|
- 模组作者链接
|
|
- *模组描述 (限制字数在 x 以内)
|
|
- x 暂未确定
|
|
- 模组兼容游戏版本 (carte 版本表达式)
|
|
- 模组使用的 DR SDK 版本
|
|
- 此处应由软件自动生成
|
|
- 模组构建时的 DR SDK 版本
|
|
- 此处应由软件自动生成
|
|
- 模组使用的 DR SDK API 版本
|
|
- 模组使用的 DR SDK 内部协议版本
|
|
- *模组可选依赖 (包括版本)
|
|
- 模组必选依赖
|
|
|
|
- DR SDK版本 和 DR API 版本都需要写，都需要最高和最低，
|
|
- 然后······ 版本号是四位的格式
|
|
|
|
- 调用手段
|
|
- UI 调用
|
|
- 模组添加
|
|
- 软件内调用
|
|
- 加载时调用
|
|
- 我先睡了，老爹催了
|
|
|
|
|