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"

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