Player format

players/<uuid>.json files are used to store the state of individual players. The players UUID is the name of the file. These files are in JSON format.

JSON format

: Root object.
- Components: All the components this player has.
  - Nameplate: The players unmodified name.
    - Text: The players name.
  - EffectController: Currently unknown.
  - ObjectiveHistory: Currently unknown.
    - ObjectiveHistory: Currently unknown.
    - ObjectiveLineHistory: Currently unknown.
  - DisplayName: The players display name information.
    - DisplayName
      - RawText: The players display name.
      - Bold: true if the name should be displayed in a bold font.
      - Italic: true if the name should be displayed in a italic font.
      - Monospace: true if the name should be displayed in a monospace font.
      - Underline: true if the name should be displayed with an underline.
  - UIComponentList: Currently unknown.
  - Transform: The players position and rotation in the world.
    - Position: The players position.
      - X: X position of the player.
      - Y: Y position of the player.
      - Z: Z position of the player.
    - Rotation: The players rotation.
      - Pitch: The X rotation of the player.
      - Yaw: The Y rotation of the player.
      - Roll: The Z rotation of the player.
  - BuilderTools: Currently unknown.
    - SelectionHistory: Currently unknown.
  - Velocity: The players velocity.
    - Velocity
      - X: X direction velocity value.
      - Y: Y direction velocity value.
      - Z: Z direction velocity value.
  - Player: Contains common player data.
    - Version: The player format version used when saved.
    - UUID: The players UUID stored in binary form encoded in base64.
      - $binary: The base64 encoded binary UUID value.
      - $type: The BSON binary type. Always 04 for UUID.
    - Inventory: Contains all items across all inventories for this player.
      - Version: The inventory format version used when saved.
      - Storage: Contains all items in the main inventory.
        
        Id: The inventory type id. Normally Simple.
        
        Capacity: The total number of inventory slots available.
        
        Items: List of items in this inventory. Empty if no items are present.
        
        <#>: An item at the given inventory index.
        
        Id: The item id.
        
        Quantity: The item count.
        
        Durability: The items current durability.
        
        MaxDurability: The items total durability when un-damaged.
        
        OverrideDropItemAnimation: Currently unknown.
      - Armor: Contains all items in the armor slots.
        
        Id: The inventory type id. Normally Simple.
        
        Capacity: The total number of inventory slots available.
        
        Items: List of items in this inventory. Empty if no items are present.
        
        <#>: An item at the given inventory index.
        
        Id: The item id.
        
        Quantity: The item count.
        
        Durability: The items current durability.
        
        MaxDurability: The items total durability when un-damaged.
        
        OverrideDropItemAnimation: Currently unknown.
      - HotBar: Contains all items in the hotbar.
        
        Id: The inventory type id. Normally Simple.
        
        Capacity: The total number of inventory slots available.
        
        Items: List of items in this inventory. Empty if no items are present.
        
        <#>: An item at the given inventory index.
        
        Id: The item id.
        
        Quantity: The item count.
        
        Durability: The items current durability.
        
        MaxDurability: The items total durability when un-damaged.
        
        OverrideDropItemAnimation: Currently unknown.
      - Utility: Contains all items in the utility/offhand wheel.
        
        Id: The inventory type id. Normally Simple.
        
        Capacity: The total number of inventory slots available.
        
        Items: List of items in this inventory. Empty if no items are present.
        
        <#>: An item at the given inventory index.
        
        Id: The item id.
        
        Quantity: The item count.
        
        Durability: The items current durability.
        
        MaxDurability: The items total durability when un-damaged.
        
        OverrideDropItemAnimation: Currently unknown.
      - Backpack: Contains all items in the entity's backpack.
        
        Id: The inventory type id. Normally Simple.
        
        Capacity: The total number of inventory slots available.
        
        Items: List of items in this inventory. Empty if no items are present.
        
        <#>: An item at the given inventory index.
        
        Id: The item id.
        
        Quantity: The item count.
        
        Durability: The items current durability.
        
        MaxDurability: The items total durability when un-damaged.
        
        OverrideDropItemAnimation: Currently unknown.
      - ActiveHotbarSlot: The entity's currently selected hotbar slot.
      - Tool: Currently unknown.
        
        Id: The inventory type id. Normally Simple.
        
        Capacity: The total number of inventory slots available.
        
        Items: List of items in this inventory. Empty if no items are present.
        
        <#>: An item at the given inventory index.
        
        Id: The item id.
        
        Quantity: The item count.
        
        Durability: The items current durability.
        
        MaxDurability: The items total durability when un-damaged.
        
        OverrideDropItemAnimation: Currently unknown.
      - ActiveToolsSlot: The entity's currently selected tool slot. -1 if none.
      - ActiveUtilitySlot: The entity's currently selected utility/offhand slot.
      - SortType: The entity's inventory item sort type.
    - PlayerData:
      - BlockIdVersion: The block id version at the time of saving.
      - World: The current world/universe the player is in.
      - KnownRecipes: Currently unknown.
      - PerWorldData: Contains per world information for this player.
        
        <instanceName>: Contains this players per world data for this world.
        
        LastPosition: The players last position and rotation in this world.
        
        X: The players X position of where they last were in this world.
        
        Y: The players Y position of where they last were in this world.
        
        Z: The players Z position of where they last were in this world.
        
        Pitch: The players X rotation of where they were last looking in this world.
        
        Yaw: The players Y rotation of where they were last looking in this world.
        
        Roll: The players Z rotation of where they were last looking in this world.
        
        LastMovementStates: The players last movement state.
        
        Flying: true if the player was flying when they were last in this world.
        
        FirstSpawn: Currently unknown.
        
        RespawnPoints: List of all respawn points for this player.
        
        : A respawn point.
        
        BlockPosition:
        
        X: X position of the respawn block.
        
        Y: Y position of the respawn block.
        
        Z: Z position of the respawn block.
        
        RespawnPosition:
        
        X: X position of where the player respawns at this location.
        
        Y: Y position of where the player respawns at this location.
        
        Z: Z position of where the player respawns at this location.
        
        Name: The name of this respawn location.
        
        DeathPositions: Contains all the players death map markers.
        
        : A death position.
        
        MarkerId: The death markers id. Has the format of death-marker-<uuid>
        
        Transform: The position and rotation information of where the player died.
        
        X: The X position of where the player died.
        
        Y: The Y position of where the player died.
        
        Z: The Z position of where the player died.
        
        Pitch: The X rotation of the player when they died. (Unused in practice. Always 0.0)
        
        Yaw: The Y rotation of the player when they died. (Unused in practice. Always 0.0)
        
        Roll: The Z rotation of the player when they died. (Unused in practice. Always 0.0)
        
        Day: The day number that the player died on.
        
        UserMarkers: Contains all player made map markers that aren't shared with other players.
        
        : A custom map marker.
        
        Id: The id of this marker. Has the format of user_personal_<uuid>.
        
        X: The X position of this map marker.
        
        Z: The Z position of this map marker.
        
        Name: The name of this map marker.
        
        Icon: The icon file name for this map marker.
        
        ColorTint: The hex tint color to apply to the marker icon.
        
        CreatedByUuid: The UUID of the player who created this map marker stored in binary form encoded in base64.
        
        $binary: The base64 encoded binary UUID value.
        
        $type: The BSON binary type. Always 04 for UUID.
        
        CreatedByName: The name of the player who created this map marker.
      - DiscoveredZones: Contains all the zones the player has discovered.
        
        : A zone the player has discoverd.
      - DiscoveredInstances: Contains the UUIDs of all instances this player discovered.
        
        : A discovered instance.
        
        $binary: The discovered instances base64 encoded binary UUID value.
        
        $type: The BSON binary type. Always 04 for UUID.
      - ReputationData: Currently unknown.
      - ActiveObjectiveUUIDs: Currently unknown.
    - BlockPlacementOverride: Currently unknown.
    - HotbarManager: Contains the players saved hotbar information.
      - SavedHotbars: Contains all the players saved hotbars.
        
        : A saved hotbar row. null if this row is empty.
        
        Id: The inventory type id. Normally Simple.
        
        Capacity: The total number of inventory slots available.
        
        Items: List of items in this inventory. Empty if no items are present.
        
        <#>: An item at the given inventory index.
        
        Id: The item id.
        
        Quantity: The item count.
        
        Durability: The items current durability.
        
        MaxDurability: The items total durability when un-damaged.
        
        OverrideDropItemAnimation: Currently unknown.
      - CurrentHotbar: The currently loaded saved hotbar.
    - GameMode: This players current gamemode.
  - Invulnerable: if present the player is invulnerable.
  - HitboxCollision: Currently unknown.
    - HitboxCollisionConfigIndex: Currently unknown.
  - UniqueItemUsages: Tracks 1 time uses unique items that the player has used.
    - UniqueItemUsed: Contains all unique items this player has used.
      - : An unique item that this player has used.
  - Instance: Currently unknown.
  - UUID: The players UUID stored in binary form encoded in base64. (Again)
    - UUID
      - $binary: The base64 encoded binary UUID value.
      - $type: The BSON binary type. Always 04 for UUID.
  - EntityStats: Contains all stats of this player, such as their oxygen level, mana level, and more.
    - Version: The player stats format version used when saved.
    - Stats: Contains all stats of this player.
      - <stat>: A player stat.
        
        Id: The id of the stat. Normally matches document key name.
        
        Value: The value of the player stat.
  - CreativeHub: Information for the Creative mode hub.
    - ParentHubWorldUuid: The stringified UUID of the creative world hub.
  - HeadRotation: The players initial head rotation.
    - Rotation
      - Pitch: The initial X rotation of the player.
      - Yaw: The initial Y rotation of the player.
      - Roll: The initial Z rotation of the player.

Inventory slot numbers

The image below shows the slot numbers of the player's inventory slots as of Hytale 2026.01.13-dcad8778f.

The gray names reflect what each inventory section is called in the json.

player_inventory_numbers

History

Early Access
2026.01.13-dcad8778f	The player format is introduced.
2026.02.17-255364b8e	Added UserMarkers array to PerWorldData to store information for the new User-Placed Map Markers