Research.data

Back to modding

The research.data file is used for creating the research tree. You are able to create new researchs or modify existant ones, and also reorganize how they are interconected to each other.

## Structure

### "Bridge" research

```
   {
       "x":2,
       "y":0,
       "id":"research_start",
       "duration":100,
       "projectSize":1,
       "connections":[
           {"id":"research_pill_maker","start":"left","end":"right"},
           {"id":"research_dissolver","start":"left","end":"right"},
           {"id":"research_evaporator","start":"right","end":"left"},
           {"id":"research_unlock_forest","start":"right","end":"left"},
           {"id":"research_alternate_delivery_methods","start":"top","end":"left"},
           {"id":"research_basic_auxiliary","start":"top","end":"right"},
           {"id":"research_infrastructure1","start":"bottom","end":"left"}
       ]
   },

```

NOTE: The comma at the end of the structure is required if the research is not at the end of the file, and the last one can't have it. Your file will be invalid if you don't place properly the commas, resulting in your mod not being loaded.

The example above is the central node of the research tree (Basic Pharma). This research structure is used for "bridge" researchs, which have no effect but lead to another researchs.

* **"x"**: horizontal position on the research grid
* **"y"**: vertical position on the research grid
* **"id"**: Identifies your research. This identificator is used for setting up connections and for assigning strings in the strings\_en.data file. If the strings required are not present on the strings\_en.data file, placeholders will be shown instead.
* **"duration"**: How many days are required for the project to be researched.
* **"projectSize"**: How many scientists are required to research the project.
* **"connections"**: Indicates what research projects are connected to this project.

### Upgradable research

```
   {
       "x":1,
       "y":1,
       "id":"research_pill_maker",
       "duration":30,
       "yields":[
           {"stringValue":"unlock_machine.pill_maker"}
       ],
       "upgrades":[
           [{"intValue":{"id":"pillBonus","change":3}}],
           [{"intValue":{"id":"pillBonus","change":3}}],
           [{"intValue":{"id":"pillBonus","change":3}}],
           [{"intValue":{"id":"pillBonus","change":3}}],
           [{"intValue":{"id":"pillBonus","change":3}}]
       ],
       "connections":[
           {"id":"research_start","start":"right","end":"left","receive":true}
       ]
   },

```

The example above unlocks a machine (the pill maker), and it's upgradable. It incorporates the fields "yields" and "upgrades". They hold which "bonuses" will be granted when researching or upgrading a project.

* **"yields"**: This field is performed when the project is researched.
* **"upgrades"**: This field performs, in order, the "bonuses" placed between [ ] for each upgrade.

Possible Upgrades include:

* pill\_bonus
* sachetBonus
* syringeBonus
* syringeStrengthIncrease
* creamSideEffectReduction

* process\_cost

* packer\_capacity

* allPurchasePrice
* plotCost
* salaries
* cureRatingBonus

* patentMaxCureLevel
* patentSpeed
* patentCost

* spying\_ingredients
* spying\_research
* spying\_profit
* spying\_ingredients\_next
* spying\_research\_next
* spying\_patents

### Modded example

```
   "yields":[
           {"stringValue":"unlock_machine.pill_maker"},
           {"stringValue":"unlock_machine.evaporator"}
       ],
       "upgrades":[
           [{"intValue":{"id":"pillBonus","change":1}}],
           [{"intValue":{"id":"pillBonus","change":2}}],
           [{"intValue":{"id":"pillBonus","change":3}}],
           [{"intValue":{"id":"pillBonus","change":4}}],
           [{"intValue":{"id":"pillBonus","change":5}}]
       ],

```

If we set the "yields" and "upgrades" fields as above, we'll get the following:

* The project will unlock both pill maker and evaporator machines.
* Upgrading to level 1 will increase on 1 the pill bonus, upgrading to level 2 will increase on 2 the pill bonus, etc.

## The Research Grid

The Research grid is an in-game resource used for displaying each research project where they must be placed. It allows to easily reorganize the research tree as desired when modding. Both "x" and "y" labels are used in order to place the project on the research grid. Note that decimal numbers can be used.