/Butian

Primary LanguageC#Apache License 2.0Apache-2.0

补天 - Butian

张三不给力,我们来补天

鬼谷八荒 Mod

与 Hylas 的关系

本来是在 Hylas 上修改的,但残月经常性失联,上次游戏更新才 PR 了一次,加上我要做更多功能在 Hylas 有些限制,又不好改 Hylas 的基础架构,干脆另开项目

使用说明

初次使用

  1. 删除 鬼谷八荒\Mods 目录下的 Hylas.dll(不要删除 Hylas 文件夹)
  2. YamlDotNet.dll 放入 鬼谷八荒\MelonLoader\Managed 目录
  3. Butian.dll 放入 鬼谷八荒\Mods 目录
  4. 启动鬼谷八荒(初次运行自动从 Hylas 导入)
  5. 导入的图片若显示不全,修改资源配置文件的 newSprite: true 就好了

更新

  1. Butian.dll 放入 鬼谷八荒\Mods 目录
  2. 启动鬼谷八荒(配置文件自动更新,保证向下兼容)

asset.yml 模板

# 隐藏原版的其他子组件
# 双修光柱就是这俩货,干掉
hidden: ["Particle System", "Particle System (1)"]
# 图片列表,可以多个,不需要跟 assets 完全一致,可以比他多,但不能比他少哦
sprite:
  image:
    # 文件名,必须是同级目录下有的文件(不需要是 image.png,以实际文件来)
    file: image.png
    # 模板完整路径,跟上面的 template 可以同时设置,都设置的情况下以这个为准
    # 如战斗小人衣服模板 Battle/Human/Man/Body/101/yifu
    # 设置了模板的 newSprite 将被设置为 true,不然不能进缓存
    # 由于战斗小人的特殊性,若此小人是原版没有的(105以后的),则必须设置 template,且设置为不能预加载,不能缓存
    # 一般情况下替换原版资源请删除掉此配置
    template: Battle/Human/Man/Body/101/yifu
    # 是否是创建新的 sprite,如果为 false,则除了图片为自定义,其他均使用原版,如大小,边框
    # 强烈建议为 false,加载速度比 true 快一倍,但原版立绘有边框,这种情况下建议用 true
    newSprite: true
    rect:
      position:
        x: 0
        y: 0
      # 创建图片的大小,尽量压下图吧,图片越大越慢,还占内存
      size:
        x: 800
        y: 500
    pivot:
      x: 0.5
      y: 0.5
    # 没单位的显示的像素,可以理解为缩放,100 是原大小,200 是缩小一倍, 50 是放大一倍
    pixelsPerUnit: 100
    extrude: 1
    # 可选值 Tight 和 FullRect
    # FullRect 是生成一个矩形网格,网格数少,如果生成的物体数量很多,用这个比较好
    # Tight 会根据图片的alpha 通道生成相应的网格。网格数多但是根据 alpha 裁剪了透明的网格,减少了渲染, 如果图片是少量存在并且超级大,用这个比较合适。
    meshType: Tight
    border:
      x: 0
      y: 0
      z: 0
      w: 0
    generateFallbackPhysicsShape: true

更多

补天会自动生成配置文件 config.yml,配置文件中我加了大量注释,相信你看得懂。

已知问题

由于战斗小人的特殊性,只能使用原版模板,且不能 newSprite,所以不能进缓存,设置了缓存也无效,由于 hylas 采用的是 101 为模板,所以第一套衣服的小人会被修改,解决方法也简单,设置第一套小人的外挂资源(高级玩家可能自己设置的不是 101,这时候需要给相应的模板设置外挂资源)