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

Git Merge

• Git Merge
  • Solve conflict
    • Tools
    • Commands

Solve conflict

Tools

In nvim, I use plugin fugitive

Commands

open two vertical buffer (one form target, another from feature)

1

:Gvdiffsplit!

stay on middle and use

1

:diffget [buffername](local)

OR
go to target/feature buffer and use

1

:diffput [buffername](target/feature)

save the local file and use

1
2

:Git add .
:Git commit -m "solve merge conflicts"

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>

This guide is for the wslg feature of windows 11.
Check for display:

1
2

$ echo $DISPLAY
:0

if not, change it with:

1

$ export DISPLAY=:0

check for X11 display socket

1
2

$ ls -la /tmp/.X11-unix
lrwxrwxrwx 1 spronovo spronovo 19 Apr 21 15:28 /tmp/.X11-unix -> /mnt/wslg/.X11-unix

This is setup during WSL’s INIT.
If doesn’t exist, re-create it to try things out:

1
2

$ sudo rm -r /tmp/.X11-unix
$ ln -s /mnt/wslg/.X11-unix /tmp/.X11-unix

Check whether X11 server is running:

1
2

$ ls /tmp/.X11-unix
X0

Catalog

• Course Introduction
  * Common Tenses and Voices
• Writing Email
• Resume
• CV
• Peer-reviewed Article Publishing
• Citation
• Technical Project Deliverables

Course Introduction

What is TC?
Communication that presents specific information to a specific audience for a specific purpose

• who is audience?
• what information are we commmunicating?
• why are we communicating

Criteria of TC:

• Accuracy
• Brevity
• • no need for complex sentense, idea itself is complicated enough
• Clarify

Topics:

• Workplace-related communications
• Technical project design through a problem-need-solution framework
• Diagrams and data visualization, reporting results
• Paraphrasing, direct quotation, citation(AIAA)
• presentation skills

Requirements

• No late homework submission
• Attendance and active participation
• HC & plagiarism

Common Tenses and Voices

Tenses

• Use present tense a lot.
• If action happens in the past and is done, use past tense (if is true till now, use present tense(project, theorms))

Voices

• Use active voice, engaged and easier to read
• Use passive voice to put emphasis on action or the subject is unknow
• Do not use we, be objective

Writing Email

Components:

• address lines
• subject line
• salutation
• introduction, body and conclusion
• closing
• signiture
• signiture section

Notes:

• no conversation
• don’t send confidential information
• one single page is enough
• forward to others only when is authorized
• pause before sending
• clean out mailboxes

Three different levels of formality:

1. Personal, brief notes
2. Memo style
3. Letter style: formal business emails

Be careful when using !, it is super strong tone, meaning frustrated, very very angry.

Resume

Common traits

How to state your impact?

• What was differnent or better when you finish?
• What were obstacles and how did you get around them?
• What did you learn in that experience?

Name & Time:

• Yulin Chen
• Chen, Yulin
• May 2022

#CV
Sections:

• Contact info
• Education
• Experience
• Teaching

Peer-reviewed Article Publishing

Process

• Manuscript prepared by authors
• Submission(System)
• • may reject by AI if format is wrong
• Initial Eval.(Managing editor)
• • may reject if logic wrong
• Editor’s Eval.(Chief editors)
• • if not good enough, may reject
• Reviewing(Reviewers)
• read review advice(Editor)
• • if need author’s Rev. give back to author, then submit again
• • no thing required, publish
• • or reject if still not good enough

Citation

• name [index]
• endOfSentense [index1-index2].
• • the sentense is a summary of works cited ad index1-index2(multiple references)
• endOfSentense. [index]
• • cover several sentenses ahead

General Rule : if not cited, you are claiming that it is your own work.
Five-consecutive-word Rule
So we need paraphrasing

• Use different vacabulary
• Change order of words
• Different grammar/sentense structure

Style:

• MLA
• • Modern Language Association
• APA
• CMS
• AAAS
• AIAA
• ACS
• IEEE has many different styles

Technical Project Deliverables

Deliverables:

• Project
• Solution
• Finding
• Publication
• Patent
  all end up with a report

TC element

• Audience
• • Potential/existing customers, fellow engineers, colleagues from other departments
• • Professors, classmates, staffs
• • General readers interested
• Information
• • Project’s ‘result’ (not everything of the project)
• Purpose
• • Promote new product, share experience, establish status within, provide solution…

General Design Logic

• Describe problem at hand
• • General/broad topic
• • Narrow down gradually
• Analyze need

Catalog

• Introduce
  • Motivation
  • Objective
• Implementation
  • Environment Preparation
  • Foundation
  • Code Review
    • Function detect_target
      • Overview
      • Get the estimated area of the target by color filtering

Introduce

Motivation

We want to apply computer vision to the plane to fullfill ground investigation task automatically.

Objective

The input image looks like this:

And we hope the output prediction to be 56.

Implementation

Environment Preparation

• python3
• numpy
• torch
• torchvision
• opencv-python
• other basic or dependency package

(requirment.txt will be added afterwards)

Foundation

Basic OpenCV methods is required.

Recommended learning site:

• For OpenCV
• • Bilibili video tutorial (Only 1-27 is required for this project)
• • Offical document
• For CNN(implemented by pytorch)
• • What is CNN
• • Official tutorial
• • Hand -written number recognition

Code Review

Source code
in detect.py, there are two large function

1
2
3
4

def detect_target(image):
    ...
def get_numberShot(img, rect_list, ROI):
    ...

Function detect_target

Overview

detect_target receive image data(three channels, BGR), detect the colored targets and returns the index of them.

index:

• rect_list
• • the list whose elements are Box2D type rect, indicating the information of the minimum bounding rectangle
• ROI
• • the list whose elements are index([x,y,w,h]) of orthogonal bounding rectangle
    
    In this picture, the blue frames are the minimum bounding Rectangle and the green ones are ordinary bounding box.

Note: What is Box2D type rect?

Get the estimated area of the target by color filtering

First we need to convert the color layout from BGR to HSV, which is easier to judge color.

1

image_hsv=cv2.cvtColor(image_cut,cv2.COLOR_BGR2HSV)

Then define a mask that filter the color(hue) range from 160-179 or 0-10 (red),

1
2
3
4
5
6
7

red1=np.array([0,100,100])
red2=np.array([10,255,255])
red3=np.array([160,100,100])
red4=np.array([179,255,255])
mask1=cv2.inRange(image_hsv,red1,red2)
mask2=cv2.inRange(image_hsv,red3,red4)
mask=cv2.bitwise_or(mask1,mask2)

And apply the mask to the picture

1

after_mask=cv2.add(image_cut, np.zeros(np.shape(image_cut), dtype=np.uint8), mask=mask)

Turn the after mask image into binary image and adapt close and open processing to fill holes and cancel noise.

1
2
3

kernel=np.ones([3,3],np.uint8)
close=cv2.morphologyEx(binary,cv2.MORPH_CLOSE,kernel,iterations=3)
Open=cv2.morphologyEx(close,cv2.MORPH_OPEN,kernel,iterations=1)

Then, find the contours of the processed image.

For each contour, adapt filters such as area, the ratio of the height and width of bounding rectangle.

If these restrictions are fullfilled, append the index of bounding rectangle and min area rectangle to two lists respectively, and return the lists.

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

contours, hier=cv2.findContours(Open,cv2.RETR_EXTERNAL,cv2.CHAIN_APPROX_NONE)
res_img=image.copy()
ROI=[]
rect_list=[]
for i in range(len(contours)):
    if cv2.contourArea(contours[i])<100:
        continue
    epsl=0.01*cv2.arcLength(contours[i],True)
    approx=cv2.approxPolyDP(contours[i],epsl,True)
    x,y,w,h=cv2.boundingRect(approx)
    if (float(w/h)<2) and (float(w/h)>0.5):
        res_img=cv2.rectangle(res_img,(x,y),(x+w,y+h),(0,255,0),1)
        ROI.append([x,y,w,h])
        rect = cv2.minAreaRect(approx)
        box = cv2.boxPoints(rect)
        box = np.int0(box)
        rect_list.append(rect)
        res_img=cv2.drawContours(res_img, [box], 0, (255, 0, 0), 2)
cv2.imshow('res_img',res_img)
return rect_list,ROI