mirror of
https://github.com/Pixinn/rogue-like.git
synced 2024-06-01 12:41:29 +00:00
261b7276b5
New features * Levels features can be configured * Placing items and monsters * Can navigate through many levels * Game state can be restored Many bug corrections
56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# Documentation
|
|
|
|
## Actors
|
|
|
|
Actors can be **static** or **dynamic**.
|
|
Static actors are immutable while dynamic have a link to their status. Both react to the player's actions. For instance a floor or an opened door will let the player pass, while a table or a monster will block him. Dynamic actors can also have a behavior which can evolute by itself each turn, driven by a finite state machine.
|
|
|
|
There can be 128 actors of 128 different kinds in a single level. Actor #0 is always the player.
|
|
|
|
As there are immutable, many instances of a static actor can be represented by a single ID, while each instance of a dynamic actor require a unique ID.
|
|
|
|
In memory, tiles contain the actor ID, which serves as an offset to render the tile, compute its behavior, and so on.
|
|
|
|
## Level generation
|
|
|
|
Read [this page](https://www.xtof.info/random-level-generation-on-apple-ii.html) for a presentation of the general principle concerning the random level generation.
|
|
|
|
The level configuration is given by the *level.conf* file.
|
|
|
|
### LEVELS.CONF
|
|
|
|
Description of the levels for the random builder.
|
|
All values are 8-bit integers.
|
|
|
|
```text
|
|
[NB_LEVELS]
|
|
# level conf * NB_LEVELS
|
|
[NUMBER]
|
|
[SIZE]
|
|
# number of actors of each types * NB_ACTORS_MAX (128)
|
|
[NB_ACTORS]
|
|
.
|
|
.
|
|
.
|
|
[NB_ACTORS]
|
|
```
|
|
|
|
### STATES
|
|
|
|
State of the levels
|
|
|
|
```text
|
|
"LVLS"
|
|
CURRENT_LEVEL 1 byte
|
|
NB_LEVELS 1 byte
|
|
# level state * NB_LEVELS
|
|
"LVL"
|
|
VISITED 1 byte
|
|
PLAYER_TILE 1 byte
|
|
LAYOUT 4096 bytes
|
|
"ACTS"
|
|
# actor state * NB_LEVELS
|
|
"ACT"
|
|
STATE sizeof(actor_t)
|
|
```
|