This is my attempt at building a simulation engine/game. The main concept is based on games like "The Tribez" and similiar.

The simulation is based on one world. The world itself can have many islands.

The simulation can run in two different modes: Immediate - This means that every resource will be collected immediately after a work unit has finished Collect - The user has to collect the resources which are marked as collectable after a work unit has finished

The following will describe the basic parts of the simulation. Everything is defined in CSV files so nothing is actually hardcoded. The references are handled by signs. These are basically two letter words used as unqiue identifier.

The simulation supports six different kind of work items. There are three different stages when a work is executed. First it will be started (S). This may costs certain resources. The prices are defined in the price registry and described below. After the duration the work will be finished (F). Depending on the simulation mode the resources will be collected (C) immediately or the user has to do it.

Starts the work on building.

Will upgrade a building

If the building is destructable it will remove the building

There are several registries for each type. The types are described below. The acutal data is defined in txt files. The format is a kind of named csv file or a shortened form of JSON. Although this makes the files itself much more verbose it just helps to edit the data. All files are located in the data subdirectory.

First we need to define the resources that are available within our world. The file is called resource_definitions.txt. Every definition has a sign which is a two character symbol which must be unique within this list. There is also a flag defining the resource is global or local. The resource Money for example is global so there is only one for the entire world. All local resources are only available on each island.

Example:

sign : MO , global : Y , name : "Money"
sign : IR , global : N , name : "Iron"
sign : FO , global : N , name : "Food"
sign : WD , global : N , name : "Wood"

The available buildings are defined in the buildings.txt file. The CSV file consists of

Example:

sign : HB , size_x : 2 , size_y : 2 , permanent : N , regular : Y , max_amount :  1 , destructable : N , name : "Home Base"
sign : HT , size_x : 1 , size_y : 1 , permanent : N , regular : Y , max_amount :  3 , destructable : Y , name : "Hut"
sign : HN , size_x : 1 , size_y : 1 , permanent : N , regular : Y , max_amount :  3 , destructable : Y , name : "Nice Hut"

The Hut with the symbol HT will occupy one tile in each direction. It produces no permanent resources. But it produces regular resources as for example tax (money). The maximum level is 3 and it is destructable.

The maximum amount of resources for every building and level can be defined in the max_resources.txt. The total amount of maximum resources on any island will be the sum of all buildings and levels taken from this list.

building : WH , level : 1 , resource : FO , amount : 250 
building : WH , level : 1 , resource : WD , amount : 250

For example Warehouse (WH) with level 1 will contribute 250 food and 250 wood to the maximum storable resources on this island.

In order to upgrade or build certain buildings there might be requirements which must be fullfilled. For example it might be necessary to have 3 Huts of level 4 before the player can upgrade the home base to level 2. The requirements are defined in requirements.txt

building : HB , level : 2 , required_building : HT , required_level : 3 , required_amount : 3

There is no single defining the costs of any work. For every building there should be a corresponding file using the sign as name. For example for the building HT (Hut) there should be a HT.txt file.

There are three different stages of work. First there is start (S). All resources and there amount will be used when you start a work. After the duration the work will be finished (F). If the world is running in manual collection mode then there is also collectable (C). Otherwise the collectable resources will be picked up immediately.

Example:

building : HT , level : 1 , work : B , stage : S , duration:  60 , resource : WO , amount : 1
building : HT , level : 1 , work : B , stage : S , duration:  60 , resource : FO , amount : 20
building : HT , level : 1 , work : B , stage : S , duration:  60 , resource : WD , amount : 20
building : HT , level : 1 , work : B , stage : S , duration:  60 , resource : MO , amount : 10
building : HT , level : 1 , work : B , stage : F , duration:   0 , resource : WO , amount : 2
building : HT , level : 1 , work : U , stage : F , duration:   0 , resource : XP , amount : 10

Example:

id : 1 , island :  0 , type : D , resource : FO , building : BB , level : 1 , amount :   1 , previous : -1 , text : "Pick Berries by removing one berry brush"
id : 2 , island :  0 , type : D , resource : WD , building : TR , level : 1 , amount :   2 , previous :  1 , text : "Chop down 2 trees"
id : 3 , island : -1 , type : C , resource : MO , building : -- , level : 1 , amount : 300 , previous : -1 , text : "Collect 300 money"

There should be some rewards for task. The rewards are defined in the rewards.txt

Example:

task_id : 1 , resource : XP , amount : 10
task_id : 1 , resource : MO , amount : 100

There is none. Right now it is an ascii based UI with a command line.