# Game Data

`game_data` is a global table with all data about the current game. You can directly work with it to change the behavior of the game on the server.

## How to find out what it contains

You can find out the contents of any table using the built-in function `debug_log(game_data)` it will write the result to the log file in the server root

## Change Tips

Try not to modify this file yourself, but use ready-made modules. For example, if you want two countries to start war with each other, then connect the relations module at the beginning of the plugin (relationships between countries)

```
local relations = require "core.relations"
```

And in the plugin code itself, at the right time, call

```
relations.register_war(land1, land2)
```

## game\_data summary

I won't list all the content here as it is very large. Only the main thing that may come in handy more often than others

| field      | short description |
| ---------- | ----------------- |
| difficulty | difficulty level  |
| queue      | sequence of moves |
| step       | current turn      |
| lands      | countries         |
| provinces  | provinces         |

**Country data**

Country data is stored in `game_data.lands[land_id]`, where land\_id is the country id (not the name, but the id)

The main, incomplete content of this table:

| field    | short description   |
| -------- | ------------------- |
| ideology | ideology            |
| money    | player's money      |
| economy  | income/expense data |
| allies   | allies              |
| enemies  | enemies             |

**Province data**

Province data is stored in `game_data.provinces[province]`, where province is the id of the province.

The contents of this table are:

| field | short description                                                                     |
| ----- | ------------------------------------------------------------------------------------- |
| water | is it water (true/false)                                                              |
| o     | id of the country that owns it                                                        |
| p     | population                                                                            |
| a     | table with data about the army in this province (key - country id, val - army number) |
| l\_a  | currently hired army that will be available next turn                                 |
| r     | table with resources (how to fill it in, you can see in the fill\_resources.lua file) |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://book.denismakhortov.com/server/game_data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.