DR-docs/docs/main/howto/game/readme.md

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: 这个初始化加载阶段指扩展应在何时加载, 如启动时, 这个具体是看扩展都要修改哪些内容的

• 加载方法

  • 利用 本文 中的方法加载 dll 扩展模组
    • 模组应明确提供以下信息 (加 * 为可选内容)
      • 模组名称
      • 模组唯一可识别 ID
      • 模组版本
      • 模组作者
      • 模组作者链接
      • *模组描述 (限制字数在 x 以内)
        • x 暂未确定
      • 模组兼容游戏版本 (carte 版本表达式)
      • 模组使用的 DR SDK 版本
        • 此处应由软件自动生成
      • 模组构建时的 DR SDK 版本
        • 此处应由软件自动生成
      • 模组使用的 DR SDK API 版本
      • 模组使用的 DR SDK 内部协议版本
      • *模组可选依赖 (包括版本)
      • 模组必选依赖

• DR SDK版本 和 DR API 版本都需要写，都需要最高和最低，

• 然后······ 版本号是四位的格式

• 调用手段

  • UI 调用
    • 模组添加
  • 软件内调用
    • 加载时调用
  • 我先睡了，老爹催了