| Home | Documents | Code Breakdown | Source Code | Wiki | GIT Web | Bugs (70 open) |
Object Definition for Thousand Parsec
Last updated 24 March 2004.
The document outlines the various objects in the TP universe and the extra data associated with them.
These definitions will only change in a backward compatable way. Any change that is not backward compatable will change the Object Type Numbers affected by the change.
Basics
This document will follow the same style as the protocol doc, IE, a 32 bit integer is shown as <n> and a 64 bit integer as <<n>>
The extra data sections show follow the standard data for each object.
Object Types
There are many in game Object types. Each has an object type number, as shown in the table below:
| Type Number | Object Type |
|---|---|
| 0 | Universe |
| 1 | Galaxy |
| 2 | Star System |
| 3 | Planet |
| 4 | Fleet |
Universe
The Universe is the top level object, everyone can always get it. It does not handle much itself.
It only has one piece of data, that is the int32 turn number, also know as the year since game start.
Extra data
- a UInt32, the current year/turn number
Galaxy
The Galaxy is a container for a large group of close star systems, like the Milky Way.
The Galaxy contains no extra data.
Extra data
No extra data.
Star System
A star system contains one or more stars and any related objects. The star itself is not yet modeled.
Star System objects do not have any extra data.
Extra data
No extra data.
Planet
A planet is any body in space which is very large and naturally occuring.
Planet objects have int32 Player id, which is the owner of the planet.
Extra data
- a SInt32, the id of the player who "owns" this planet or -1 if not owned or unknown
- a list of,
- a UInt32, the resource id
- a UInt32, the units of this resource on the "surface"
- a UInt32, the maximum units of this resource remaining which are minable
- a UInt32, the maximum units of this resource remaining which are inaccessable
Fleet
A fleet is a collection of ships. Many different ships can make up a fleet.
A fleet has an owner, int32 Player ID.
Extra data
- a SInt32, the id of the player who owns this fleet or -1 if not owned or unknown
- a list of,
- a UInt32, the type of the ship
- a Uint32, the number of the ships in the fleet
- a UInt32, the amount of damage the fleet currently has
