/tera-data

Platform agnostic information about TERA packets and enums.

TERA protocol data. Reference parser can be found at tera-data-parser.

Contained files

map

  • protocol.<shareRevision>.map - Maps packet names to numerical opcodes (randomized by BHS each patch).
  • sysmsg.<majorPatchVersion>.map - Maps system messages to IDs.

protocol

  • <packetName>.<version>.def - Defines a packet structure.

.map specification

A simple enum format. Each line may contain a single key-value pair seperated by space(s), tab(s) and/or =. Additionally supports comments preceded by #.

# This is a comment
ONE = 1
TWO = 2
THREE = 3 # This is another comment

.def specification

Each line may contain the following, in order:

  • A series of - specifying nested property depth.
  • A data type (listed below), with optional <subType> and/or [arrayLength]. subType defaults to object if nested fields are specified.
  • A field name.
  • ^addedVersion[-removedVersion] specifying which game versions this field exists in.

A # and anything after it on the line are treated as comments and should be ignored when parsing.

array someArray # Has nested fields, making this equivalent to array<object>
- int32 value1
- int32 value2
- array nestedArray
- - int32 value1
- - int32 value2

array<int32>           int32Array          # Sub-types
array<array<int32[2]>> exampleArray        # Nested sub-types
uint64                 gameId              # Your character
byte[5]                unk                 # 5 bytes of unknown data
bool                   oldBool      ^0-80  # Removed in patch 80
bool                   newBool      ^76-78 # Added in patch 76, removed in patch 78
bool                   newBool      ^80    # Added again in patch 80

Fixed Types

  • bool - 1-byte boolean (0 = false, 1 = true).
  • byte - Unsigned 1-byte integer.*
  • int16 - 2-byte signed integer. Common uses: Player stats
  • uint16 - 2-byte unsigned integer.
  • int32 - 4-byte signed integer.
  • uint32 - 4-byte unsigned integer. Common uses: UniqueID
  • int64 - 8-byte signed integer. Common uses: Money, Date
  • uint64 - 8-byte unsigned integer. Common uses: GameID
  • float - 4-byte floating point. Common uses: Scale, Speed
  • double - 8-byte floating point.*
  • angle - 2-byte rotation (usually represented as radians). Common uses: Direction
  • vec3 - 12-byte vector of 3 floats. Common uses: Position
  • vec3fa - 12-byte vector of 3 angles inefficiently stored as integer floats. Common uses: Cosmetic rotation
  • skillid - 8-byte (patch >=74) or 4-byte (patch <74) skill ID.
  • customize - 8-byte array of character customization fields.

* Rarely used.

Variable-Length Types

  • string - Unicode string.
  • array - A forward-linked list.
  • bytes - An array of bytes.

Meta-Types

  • object - Lets you group other data in its own namespace.

Packet data structure

  • All data types are little-endian.
  • All packets start with uint16 size, uint16 packetID.
  • string: uint16 offset directly after header, which points to a 0-terminated UCS2 string.
  • bytes: uint16 offset, uint16 count directly after header, which points to an array of bytes.
  • array: uint16 count, uint16 offset directly after the header, which points to the first <node>.
    • <node>: uint16 offset, uint16 nextOffset, followed by data.

.def versioning

When submitting changes, contributors must leave older versions untouched unless they are trivially backwards compatible. Instead, submit the changed definition as a new file with the version number incremented.