Attribute Blocks

Each client player has an attribute block and the server also holds such an attribute block for every player. All attribute blocks the server holds are included in the save game. The client and server synchronize their blocks. The server sends its block to the client at game start or reload. The client sends an updated block at each end of turn to the server. Since the maximum packet size is limited to currently 4kB and the attribute block can have arbitrary size (the limit is currently 256kB), the attribute block cannot be transferred in one packet. Therefore, the attribute block is divided into attribute chunks which are reassembled at the receiver. No part of the server knows any inner structure of the attribute block. For the server an attribute block is just a block of bytes.

User Interface

Since an attribute block is not a good user interface the user can access the attributes through a mapping, dictionary, hashmap, or hashtable interface. This hashtable will get serialized to the attribute block and the other way around. The key of the hashtable consists of: the (real) key, x, y, and an id. The (real) key is an integer, which defines the use and format of this attribute. The values of the hashtable can have arbitrary length. The internal structure of a value is opaque to the attribute handling.

For easier access there are wrapper functions for the common case of city attributes, that are used to store governor data.