hytale 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00d6560e486235a55ab2450d656b61421b6fddb8b9b40c3c3226a1df754f8724
-  data.tar.gz: 81194f4a57ffb54903a48f2d6361e101ab35049245cd654e7631e81f30949187
+  metadata.gz: c1ecc8d6da6ef59f252740739b05fad04f49e0a6cd628c94a085a6dbd43cb918
+  data.tar.gz: 804efc4f07dc64ac5a68ba5d28043c1ac0094f6c42ba6cf1734c7f1c985b4380
 SHA512:
-  metadata.gz: 80355bb885697efd829c1807ba7ae3d91436fb654ee1a40f0af1a4d3de0a5f6794ffa0801e3b06f5f832b8b01b7d27cccc25c0d8b96882fee57a32eb283696af
-  data.tar.gz: d219d3d0363f5e4fd79d1affb96e272c53a5e3565d0ede2a9a2837e269aa449441324dbd55b44c9f6dd07c1bf2930ca415baffe29e1926b2ba8a3590f22ca9ef
+  metadata.gz: a1be72b9c7373e5fa9b682758b5b756384d25350df8b14fc5bdb555a09f9577f93ecd50b297b56c436e94dee76872c2d6972316d6b202f4b9ada06b335980aec
+  data.tar.gz: e73dc31ff553991792fafbc611d58c037770af922366075e27a1982294eb90618c58fb89cd38d552bfbcc394084f3a24f0eb0f163bf4f73e826a2f4604c8647d

data/README.md

@@ -363,6 +363,57 @@ item.durability_percent # => 14.9
 item.damaged?           # => true
 ```
 
+**Respawn points:**
+
+```ruby
+player.respawn_points.each do |point|
+  puts "#{point.name} at #{point.position}"
+end
+# => Kweebec village at (-2150.5, 119.05, -403.1)
+# => Bed at (-795.1, 121.05, 29.47)
+```
+
+**Death positions:**
+
+```ruby
+player.death_positions.each do |death|
+  puts "Died on day #{death.day} at #{death.position}"
+end
+# => Died on day 68 at (-677.67, 27.99, -153.48)
+```
+
+**Discovered instances (dungeons, locations):**
+
+```ruby
+player.discovered_instances
+# => ["4781d0dd-5370-4962-a1fc-521ec7ff3e23", ...]
+```
+
+**Player state:**
+
+```ruby
+player.flying?              # => false
+player.first_spawn?         # => false
+player.head_rotation        # => Rotation object (separate from body)
+player.current_world        # => "default"
+```
+
+**Saved hotbars:**
+
+```ruby
+player.saved_hotbars        # => [ItemStorage, ...]
+player.current_hotbar_index # => 0
+```
+
+**Progress tracking:**
+
+```ruby
+player.known_recipes        # => []
+player.unique_item_usages   # => ["Upgrade_Backpack_1"]
+player.active_objectives    # => []
+player.reputation_data      # => {}
+```
+
 ### Zones and Regions
 
 Hytale organizes the world into zones (biomes) and regions (areas within zones):
@@ -880,6 +931,55 @@ process.pid      # => 12345
 | `player_skins` | List all cached PlayerSkin objects |
 | `player_skin(uuid)` | Find PlayerSkin by UUID |
 
+### Hytale::Client::Player
+
+| Method | Description |
+|--------|-------------|
+| `name` | Player display name |
+| `uuid` | Player UUID |
+| `position` | Current Position object |
+| `rotation` | Current body Rotation object |
+| `head_rotation` | Current head Rotation object |
+| `velocity` | Current Vector3 velocity |
+| `stats` | EntityStats object (health, stamina, etc.) |
+| `inventory` | Inventory object |
+| `game_mode` | Current game mode ("Adventure", "Creative", etc.) |
+| `current_world` | Current world name |
+| `discovered_zones` | Array of Zone::Region objects |
+| `discovered_instances` | Array of discovered dungeon/location UUIDs |
+| `respawn_points` | Array of RespawnPoint objects |
+| `death_positions` | Array of DeathPosition objects |
+| `memories` | Array of PlayerMemory objects |
+| `known_recipes` | Array of learned recipe IDs |
+| `unique_item_usages` | Array of used item IDs (upgrades, etc.) |
+| `active_objectives` | Array of active quest UUIDs |
+| `reputation_data` | Hash of faction reputations |
+| `saved_hotbars` | Array of saved ItemStorage hotbars |
+| `current_hotbar_index` | Currently selected hotbar slot |
+| `flying?` | Is player currently flying |
+| `first_spawn?` | Has player spawned before |
+| `skin` | PlayerSkin object |
+| `avatar_preview_path` | Path to cached avatar image |
+
+### Hytale::Client::Player::RespawnPoint
+
+| Method | Description |
+|--------|-------------|
+| `name` | Respawn point name (e.g., "Ria's bed") |
+| `position` | Exact respawn Position |
+| `block_position` | Block coordinates Position |
+| `x`, `y`, `z` | Shortcut position accessors |
+
+### Hytale::Client::Player::DeathPosition
+
+| Method | Description |
+|--------|-------------|
+| `marker_id` | Death marker UUID |
+| `day` | Game day of death |
+| `position` | Death Position object |
+| `rotation` | Death Rotation object |
+| `x`, `y`, `z` | Shortcut position accessors |
+
 ### Hytale::Client::Zone
 
 | Method | Description |

data/lib/hytale/client/player/death_position.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Hytale
+  module Client
+    class Player
+      class DeathPosition
+        attr_reader :data
+
+        def initialize(data)
+          @data = data
+        end
+
+        def marker_id
+          data["MarkerId"]
+        end
+
+        def day
+          data["Day"]
+        end
+
+        def position
+          transform = data["Transform"] || {}
+
+          Position.new(transform["X"], transform["Y"], transform["Z"])
+        end
+
+        def rotation
+          transform = data["Transform"] || {}
+
+          Rotation.new(transform["Pitch"], transform["Yaw"], transform["Roll"])
+        end
+
+        def x = position.x
+        def y = position.y
+        def z = position.z
+
+        def to_s
+          "Death on day #{day} at #{position}"
+        end
+
+        def inspect
+          "#<DeathPosition day=#{day} position=#{position}>"
+        end
+      end
+    end
+  end
+end

data/lib/hytale/client/player/respawn_point.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Hytale
+  module Client
+    class Player
+      class RespawnPoint
+        attr_reader :data
+
+        def initialize(data)
+          @data = data
+        end
+
+        def name
+          data["Name"]
+        end
+
+        def position
+          pos = data["RespawnPosition"] || {}
+
+          Position.new(pos["X"], pos["Y"], pos["Z"])
+        end
+
+        def block_position
+          pos = data["BlockPosition"] || {}
+
+          Position.new(pos["X"], pos["Y"], pos["Z"])
+        end
+
+        def x = position.x
+        def y = position.y
+        def z = position.z
+
+        def to_s
+          "#{name} at #{position}"
+        end
+
+        def inspect
+          "#<RespawnPoint name=#{name.inspect} position=#{position}>"
+        end
+      end
+    end
+  end
+end

data/lib/hytale/client/player.rb

@@ -22,12 +22,14 @@ module Hytale
       def position
         transform = components["Transform"] || {}
         pos = transform["Position"] || {}
+
         Position.new(pos["X"], pos["Y"], pos["Z"])
       end
 
       def rotation
         transform = components["Transform"] || {}
         rot = transform["Rotation"] || {}
+
         Rotation.new(rot["Pitch"], rot["Yaw"], rot["Roll"])
       end
 
@@ -62,8 +64,22 @@ module Hytale
         end
       end
 
+      def discovered_instances
+        @discovered_instances ||= (player_data.dig("PlayerData", "DiscoveredInstances") || []).map do |instance|
+          decode_binary_uuid(instance)
+        end.compact
+      end
+
       def respawn_points
-        player_data.dig("PlayerData", "PerWorldData", "default", "RespawnPoints") || []
+        @respawn_points ||= (player_data.dig("PlayerData", "PerWorldData", "default", "RespawnPoints") || []).map do |point|
+          RespawnPoint.new(point)
+        end
+      end
+
+      def death_positions
+        @death_positions ||= (player_data.dig("PlayerData", "PerWorldData", "default", "DeathPositions") || []).map do |pos|
+          DeathPosition.new(pos)
+        end
       end
 
       def memories
@@ -72,6 +88,48 @@ module Hytale
         end
       end
 
+      def known_recipes
+        player_data.dig("PlayerData", "KnownRecipes") || []
+      end
+
+      def unique_item_usages
+        components.dig("UniqueItemUsages", "UniqueItemUsed") || []
+      end
+
+      def head_rotation
+        rot = components.dig("HeadRotation", "Rotation") || {}
+
+        Rotation.new(rot["Pitch"], rot["Yaw"], rot["Roll"])
+      end
+
+      def flying?
+        player_data.dig("PlayerData", "PerWorldData", "default", "LastMovementStates", "Flying") || false
+      end
+
+      def first_spawn?
+        player_data.dig("PlayerData", "PerWorldData", "default", "FirstSpawn") || false
+      end
+
+      def active_objectives
+        @active_objectives ||= (player_data.dig("PlayerData", "ActiveObjectiveUUIDs") || []).map do |obj|
+          decode_binary_uuid(obj)
+        end.compact
+      end
+
+      def reputation_data
+        player_data.dig("PlayerData", "ReputationData") || {}
+      end
+
+      def saved_hotbars
+        @saved_hotbars ||= (player_data.dig("HotbarManager", "SavedHotbars") || []).compact.map do |hotbar|
+          ItemStorage.new(hotbar)
+        end
+      end
+
+      def current_hotbar_index
+        player_data.dig("HotbarManager", "CurrentHotbar")
+      end
+
       def skin
         @skin ||= PlayerSkin.find(uuid)
       end
@@ -96,6 +154,18 @@ module Hytale
           raise ParseError, "Failed to parse player data: #{e.message}"
         end
       end
+
+      private
+
+      def decode_binary_uuid(data)
+        return nil unless data.is_a?(Hash) && data["$binary"]
+
+        bytes = Base64.decode64(data["$binary"])
+        return nil unless bytes.length == 16
+
+        hex = bytes.unpack1("H*")
+        "#{hex[0, 8]}-#{hex[8, 4]}-#{hex[12, 4]}-#{hex[16, 4]}-#{hex[20, 12]}"
+      end
     end
   end
 end

data/lib/hytale/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hytale
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/lib/hytale.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "base64"
 require "json"
 require "time"
 require "zeitwerk"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hytale
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Marco Roth
@@ -9,6 +9,20 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: chunky_png
   requirement: !ruby/object:Gem::Requirement
@@ -98,12 +112,14 @@ files:
 - lib/hytale/client/npc_memory.rb
 - lib/hytale/client/permissions.rb
 - lib/hytale/client/player.rb
+- lib/hytale/client/player/death_position.rb
 - lib/hytale/client/player/entity_stats.rb
 - lib/hytale/client/player/inventory.rb
 - lib/hytale/client/player/item.rb
 - lib/hytale/client/player/item_storage.rb
 - lib/hytale/client/player/player_memory.rb
 - lib/hytale/client/player/position.rb
+- lib/hytale/client/player/respawn_point.rb
 - lib/hytale/client/player/rotation.rb
 - lib/hytale/client/player/vector3.rb
 - lib/hytale/client/player_skin.rb
@@ -152,5 +168,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.3
 specification_version: 4
-summary: Ruby bindings for reading Hytale game data
+summary: Ruby gem for reading Hytale game data
 test_files: []