Unity 本体

新的Input System:https://gamedevbeginner.com/input-in-unity-made-easy-complete-guide-to-the-new-system/#how_to_manage_input

物理引擎

目前的想法是将unity的physx和mujoco结合在一起，简化physx的对于相对运动很少的刚体间的物理解算。
Mujoco:https://mujoco.readthedocs.io/en/latest/unity.html

参考

Besiege

核心功能

机械建造

需要更高的建造自由度：例如刚体零件的顶点自定义，3轴移动，3轴旋转，3轴缩放。
可视化内容更丰富：例如碰撞箱，连接点。

物理优化

目前还是使用phsX引擎，考虑一下GPU加速这块功能。
零件之间的连接考虑使用joint以外的方式，特别是某些刚性连接。

逻辑电路体系

参考我写的BesiegeModern Mod

零件材质自定义

{金属，木，玻璃}
需要自己写shader material实现该功能。

次要功能

更好的机械破坏系统

譬如撞击变形，高速击穿之类的
很难
在已有父刚体在运行中，更改碰撞箱布置是非常耗费性能的。

场景建造

自定义场景元素

教程系统

参考mc机械动力模组的“思索”
animation制作

故事模式

起部分教程作用，添加沉浸感，吸引一些非硬核玩家

三渲二

难，可能对电脑性能有较高要求。

目前需要的技术栈

unity shader
unity animation
美术相关工具
物理引擎Game Physics Engine Development
unity URP

Basic

Useful tools

• Dnspy: decompile the runtime library of ONI
• Visual Studio (though it’s too fat)
• Poedit: read the .po file for zh-en translation

Hello world

Apply patches on the Initialize() method in Db class.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

public class Patches
    {
        [HarmonyPatch(typeof(Db))]
        [HarmonyPatch("Initialize")]
        public class Db_Initialize_Patch
        {
            public static void Prefix()
            {
                Debug.Log("Hello! Welcome to CuppyUniverse! [before Db.Initialize]");
            }

            public static void Postfix()
            {
                Debug.Log("CuppyUniverse initialized! [after Db.Initialize]");
            }
        }
        [HarmonyPatch(typeof(ElectrolyzerConfig))]
        [HarmonyPatch("CreateBuildingDef")]
        public class ElectrolyzerConfig_Patch
        {
            public static void Postfix(ref BuildingDef __result)
            {
                __result.EnergyConsumptionWhenActive = 114f;
            }
        }
    }

Add new building

Take gold washer (just like water purifier but output small amount of gold) as an example.

1. Find the source code for water purifier.
   i.e.

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60

   using System; using TUNING; using UnityEngine; // Token: 0x0200039A RID: 922 public class WaterPurifierConfig : IBuildingConfig { // Token: 0x06001314 RID: 4884 RVA: 0x000665C4 File Offset: 0x000647C4 public override BuildingDef CreateBuildingDef() { string id = "WaterPurifier"; int width = 4; int height = 3; string anim = "waterpurifier_kanim"; int hitpoints = 100; float construction_time = 30f; float[] tier = BUILDINGS.CONSTRUCTION_MASS_KG.TIER3; string[] all_METALS = MATERIALS.ALL_METALS; float melting_point = 800f; BuildLocationRule build_location_rule = BuildLocationRule.OnFloor; EffectorValues tier2 = NOISE_POLLUTION.NOISY.TIER3; BuildingDef buildingDef = BuildingTemplates.CreateBuildingDef(id, width, height, anim, hitpoints, construction_time, tier, all_METALS, melting_point, build_location_rule, BUILDINGS.DECOR.PENALTY.TIER2, tier2, 0.2f); ... return buildingDef; } // Token: 0x06001315 RID: 4885 RVA: 0x000666A8 File Offset: 0x000648A8 public override void ConfigureBuildingTemplate(GameObject go, Tag prefab_tag) { ... } // Token: 0x06001316 RID: 4886 RVA: 0x0006688B File Offset: 0x00064A8B public override void DoPostConfigureComplete(GameObject go) { ... } // Token: 0x04000A88 RID: 2696 public const string ID = "WaterPurifier"; // Token: 0x04000A89 RID: 2697 private const float FILTER_INPUT_RATE = 1f; // Token: 0x04000A8A RID: 2698 private const float DIRTY_WATER_INPUT_RATE = 5f; // Token: 0x04000A8B RID: 2699 private const float FILTER_CAPACITY = 1200f; // Token: 0x04000A8C RID: 2700 private const float USED_FILTER_OUTPUT_RATE = 0.2f; // Token: 0x04000A8D RID: 2701 private const float CLEAN_WATER_OUTPUT_RATE = 5f; // Token: 0x04000A8E RID: 2702 private const float TARGET_OUTPUT_TEMPERATURE = 313.15f; }

Create a new csharp class file in VS and copy the content into it.
Remember to rename

• the class name
• id in method CreateBuildingDef()
• ID in class
  In this example change them to GoldWasher

2. Add GoldWasher to build menu.
   create a new patch for GeneratedBuildings

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

   using System; using HarmonyLib; namespace ONI_CuppyUniverse_Mod { [HarmonyPatch(typeof(GeneratedBuildings), "LoadGeneratedBuildings")] public class GeneratedBuildings_LoadGeneratedBuildings { public static void Prefix() { Strings.Add(new string[] { "STRINGS.BUILDINGS.PREFABS.GOLDWASHER.NAME", "淘金器" }); Strings.Add(new string[] { "STRINGS.BUILDINGS.PREFABS.GOLDWASHER.EFFECT", "从纯净水中淘取黄金" }); Strings.Add(new string[] { "STRINGS.BUILDINGS.PREFABS.GOLDWASHER.DESC", "你是信无中生有的" }); ModUtil.AddBuildingToPlanScreen("Food", "GoldWasher"); } } }

Reference

• Some mod src
• ONI Mod Guidance
• Harmony Guidance

mod name: ModernAirCombat

Setup of mod

1

$createmod "ModernAirCombat"

modify ./Mod.xml

• Author
• Description

1

$createblock "ModernAirCombat" "SRAAM"

1

mkdir ./Resources/SRAAM

add assets of SRAAM block r73.obj, r73.png

modify ./Mod.xml

• Add resources

  1 2	<Mesh name="SRAAM Mesh" path="SRAAM\r73.obj"/> <Texture name="SRAAM Texture" path="SRAAM\r73.png"/>

  

modify ./SRAAM.xml

• Mass
• Mesh name
• Texture name
• Icon
• Colliders
• Points

create assembly for scripts

1

createassembly "ModernAirCombat" compiled MacAssembly ModernAirCombat forceUnityTools

open project with VStudio

edit ModernAirCombat.cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

using System;
using Modding;
using UnityEngine;

namespace ModernAirCombat
{
    public enum BlockList
    {
        SRAAM = 1,
        MRAAM = 2,
        LRAAM = 3
    }
    public class ModernAirCombat : ModEntryPoint
    {
        public static GameObject Mod;
        public override void OnLoad()
		    {
            Mod = new GameObject("Morden Firearm Kit Mod");
            UnityEngine.Object.DontDestroyOnLoad(Mod); \\avoid destroy mod instance when changing levels
            Debug.Log("Hello, this is Modern Air Combat！");
            // Called when the mod is loaded.
        }
    }
}

Write Block Scripts

add a block class SRAAM.cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Xml.Serialization;
using System.Collections;

using Modding.Modules;
using Modding;
using Modding.Blocks;
using UnityEngine;

namespace ModernAirCombat
{
    class SRAAMBlock : BlockScript
    {
        public MToggle IFF;
        public MSlider detectAngleSlider;
        private Transform myTransform;      //实例化Transform对象
        private Rigidbody myRigidbody;

        public override void SafeAwake()
        {
            IFF = AddToggle("开启友伤", "IFF", true);
            detectAngleSlider = AddSlider("探测角度", "detection angle", 45.0f, 0.0f, 150.0f);
        }
        private void Start()
        {
            myTransform = gameObject.GetComponent<Transform>();        //获取相应对象的引用
            myRigidbody = gameObject.GetComponent<Rigidbody>();
            myRigidbody.drag = 2;
            myRigidbody.angularDrag = 4;
        }

        public override void OnSimulateStart()
        {
            base.OnSimulateStart();
        }

        public override void OnSimulateStop()
        {
            base.OnSimulateStop();
        }
        
        private void Update() {
            myRigidbody.AddRelativeForce(new Vector3(0, 1, 0), ForceMode.Impulse);
        }
    }
}

modify SRAAM.xml

1

<Script>ModernAirCombat.SRAAMBlock</Script>