arkparser 0.3.1__tar.gz → 0.3.2__tar.gz

{arkparser-0.3.1 → arkparser-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arkparser
-Version: 0.3.1
+Version: 0.3.2
 Summary: Pure Python parser for ARK: Survival Evolved and ARK: Survival Ascended save files
 Author: Vertyco
 License-Expression: MIT
@@ -250,6 +250,7 @@ The legacy ASVExport.exe emitted only the visible 8 stats (`hp`, `stam`, `melee`
 | `last_baby_age_update` | added | ISO 8601 datetime of `LastUpdatedBabyAgeAtTime`. |
 | `last_gestation_update` | added | ISO 8601 datetime of `LastUpdatedGestationAtTime`. |
 | `next_cuddle` | added | ISO 8601 datetime of `BabyNextCuddleTime`. |
+| `current_stats` | added | Live in-world stat values from the dino's status component (`CurrentStatusValues[0..11]`) as a `{hp, stam, torp, oxy, food, water, temp, weight, melee, speed, fort, craft}` dict of floats. These are the *current* values (e.g. `hp: 11013.62` = current HP, drops as the dino takes damage). Max values are NOT persisted by ARK — compute downstream from species stat tables + `*-w`/`*-t` points + `imprint` + server multipliers if you need them. `null` when the status component carries no `CurrentStatusValues` entries (e.g. uninitialised baby actor). |
 
 #### `ASV_Wild` schema
 
@@ -267,6 +268,7 @@ The legacy ASVExport.exe emitted only the visible 8 stats (`hp`, `stam`, `melee`
 | `trait` | legacy | first entry of `CreatureTraits` (or empty string) |
 | `traits` | added | full `CreatureTraits` list |
 | `wild_spawn_region` | added | `OriginalNPCVolumeName` — `NPCZoneVolume` the creature spawned in. |
+| `current_stats` | added | Live in-world stat values from the creature's status component (`CurrentStatusValues[0..11]`) as a `{hp, stam, torp, oxy, food, water, temp, weight, melee, speed, fort, craft}` dict of floats. Max values are NOT in the save (would need species stat tables). `null` when uninitialised. |
 
 #### Player data: `.arkprofile` vs in-world pawn
 
@@ -318,6 +320,7 @@ For the richest output, hand `export_players` **both** — assemble a wrapper fo
 | `corpse_destruction` | added | ISO 8601 datetime of `CorpseDestructionTime`. |
 | `chibi_levels` | added | `NumChibiLevelUps` — bonus levels from chibi pets. |
 | `ascensions_scorched` | added | `NumAscensionsScorched` — ASE ascension counter (legacy `ContentPlayer` parses the ASA ascension block differently; this is the ASE-specific field). |
+| `current_stats` | added | Live in-world stat values for the player from the pawn's `MyCharacterStatusComponent` (`CurrentStatusValues[0..11]`) as a `{hp, stam, torp, oxy, food, water, temp, weight, melee, speed, fort, craft}` dict of floats. For profile-sourced records the parser joins on `PlayerDataID == LinkedPlayerDataID` to find the spawned pawn in the world save. `null` when the player has no in-world pawn (never spawned this server / corpse cleared) or the status component has no values — only currently / recently spawned characters have live stats. Max values are NOT persisted by ARK. |
 
 #### `ASV_Tribes` schema
 

{arkparser-0.3.1 → arkparser-0.3.2}/README.md

@@ -216,6 +216,7 @@ The legacy ASVExport.exe emitted only the visible 8 stats (`hp`, `stam`, `melee`
 | `last_baby_age_update` | added | ISO 8601 datetime of `LastUpdatedBabyAgeAtTime`. |
 | `last_gestation_update` | added | ISO 8601 datetime of `LastUpdatedGestationAtTime`. |
 | `next_cuddle` | added | ISO 8601 datetime of `BabyNextCuddleTime`. |
+| `current_stats` | added | Live in-world stat values from the dino's status component (`CurrentStatusValues[0..11]`) as a `{hp, stam, torp, oxy, food, water, temp, weight, melee, speed, fort, craft}` dict of floats. These are the *current* values (e.g. `hp: 11013.62` = current HP, drops as the dino takes damage). Max values are NOT persisted by ARK — compute downstream from species stat tables + `*-w`/`*-t` points + `imprint` + server multipliers if you need them. `null` when the status component carries no `CurrentStatusValues` entries (e.g. uninitialised baby actor). |
 
 #### `ASV_Wild` schema
 
@@ -233,6 +234,7 @@ The legacy ASVExport.exe emitted only the visible 8 stats (`hp`, `stam`, `melee`
 | `trait` | legacy | first entry of `CreatureTraits` (or empty string) |
 | `traits` | added | full `CreatureTraits` list |
 | `wild_spawn_region` | added | `OriginalNPCVolumeName` — `NPCZoneVolume` the creature spawned in. |
+| `current_stats` | added | Live in-world stat values from the creature's status component (`CurrentStatusValues[0..11]`) as a `{hp, stam, torp, oxy, food, water, temp, weight, melee, speed, fort, craft}` dict of floats. Max values are NOT in the save (would need species stat tables). `null` when uninitialised. |
 
 #### Player data: `.arkprofile` vs in-world pawn
 
@@ -284,6 +286,7 @@ For the richest output, hand `export_players` **both** — assemble a wrapper fo
 | `corpse_destruction` | added | ISO 8601 datetime of `CorpseDestructionTime`. |
 | `chibi_levels` | added | `NumChibiLevelUps` — bonus levels from chibi pets. |
 | `ascensions_scorched` | added | `NumAscensionsScorched` — ASE ascension counter (legacy `ContentPlayer` parses the ASA ascension block differently; this is the ASE-specific field). |
+| `current_stats` | added | Live in-world stat values for the player from the pawn's `MyCharacterStatusComponent` (`CurrentStatusValues[0..11]`) as a `{hp, stam, torp, oxy, food, water, temp, weight, melee, speed, fort, craft}` dict of floats. For profile-sourced records the parser joins on `PlayerDataID == LinkedPlayerDataID` to find the spawned pawn in the world save. `null` when the player has no in-world pawn (never spawned this server / corpse cleared) or the status component has no values — only currently / recently spawned characters have live stats. Max values are NOT persisted by ARK. |
 
 #### `ASV_Tribes` schema
 

{arkparser-0.3.1 → arkparser-0.3.2}/arkparser/__init__.py

@@ -91,4 +91,4 @@ __all__ = [
     "ArkParseError",
 ]
 
-__version__ = "0.3.1"
+__version__ = "0.3.2"

{arkparser-0.3.1 → arkparser-0.3.2}/arkparser/export.py

@@ -203,6 +203,57 @@ def _stat_array(status: t.Any, prop_name: str) -> list[int]:
     return out
 
 
+def _current_stat_floats(status: t.Any) -> list[float] | None:
+    """Read ``CurrentStatusValues[0..11]`` from a character status component.
+
+    Status components persist the live in-world values of all 12 stats. The
+    array is indexed by ARK's ``EPrimalCharacterStatusValue`` enum:
+    0=hp, 1=stam, 2=torpor, 3=oxy, 4=food, 5=water, 6=temp, 7=weight,
+    8=melee, 9=speed, 10=temp-fortitude, 11=crafting.
+
+    Returns ``None`` when the status component is missing or carries no
+    CurrentStatusValues entries (e.g. uninitialised baby actor) so callers
+    can distinguish "no data" from "all zeros".
+    """
+    if status is None:
+        return None
+    out: list[float] = [0.0] * 12
+    seen = False
+    getter = getattr(status, "get_properties_by_name", None)
+    if callable(getter):
+        # Real GameObject: get_properties_by_name surfaces every indexed
+        # entry. Empty result == component carries no CurrentStatusValues
+        # at all (uninitialised); return None so callers can distinguish
+        # "no data" from "all zeros".
+        for prop in getter("CurrentStatusValues"):
+            idx = getattr(prop, "index", 0)
+            if 0 <= idx < 12:
+                out[idx] = _float(getattr(prop, "value", 0.0))
+                seen = True
+        return out if seen else None
+    # Synthetic / cryopod stand-in: per-index get_property_value lookups.
+    for i in range(12):
+        val = _prop(status, "CurrentStatusValues", default=None, index=i)
+        if val is not None:
+            out[i] = _float(val)
+            seen = True
+    return out if seen else None
+
+
+def _current_stats_dict(status: t.Any) -> dict[str, float] | None:
+    """Return current stat values keyed by short stat name.
+
+    Pre-conditions: ``status`` is the character status component (creature or
+    player). May be ``None`` (e.g. offline player with no spawned pawn).
+    Post-conditions: returns a dict ``{hp, stam, ..., craft}`` of floats, or
+    ``None`` when no CurrentStatusValues are persisted on the component.
+    """
+    floats = _current_stat_floats(status)
+    if floats is None:
+        return None
+    return {_STAT_NAMES[i]: floats[i] for i in range(12)}
+
+
 def _flat_stats(points: list[int], suffix: str = "") -> dict[str, int]:
     """Emit all 12 stats as a flat dict.
 
@@ -674,6 +725,7 @@ def _tamed_dict(
             )) is not None
             else None
         ),
+        "current_stats": _current_stats_dict(status),
         "imprinter_player_id": _int(_prop(obj, "ImprinterPlayerDataID")),
         "imprinter_net_id": _str(_prop(obj, "ImprinterPlayerUniqueNetId")),
         "taming_team_id": _int(_prop(obj, "TamingTeamID")),
@@ -870,6 +922,7 @@ def _wild_dict(
         # CreatureTraits list is exposed alongside as ``traits``.
         "trait": traits[0] if traits else "",
         "traits": traits,
+        "current_stats": _current_stats_dict(status),
         "wild_spawn_region": _str(_prop(obj, "OriginalNPCVolumeName")),
     }
     data.update(_gps_payload(obj, map_config))
@@ -882,13 +935,24 @@ def export_wild(save: t.Any, map_config: MapConfig | None = None) -> list[dict[s
     return [_wild_dict(obj, _status_for(obj, lookup), map_config) for obj in objects]
 
 
-def _player_from_profile(profile: Profile, save: t.Any = None) -> dict[str, t.Any]:
+def _player_from_profile(
+    profile: Profile,
+    save: t.Any = None,
+    pawn_status_by_id: dict[int, t.Any] | None = None,
+) -> dict[str, t.Any]:
     stat_points = [_int(profile.get_stat(i)["added"]) for i in range(12)]
     gamertag = profile.player_name or ""
     character = profile.character_name or gamertag
     steam_id = profile.unique_id or ""
     active_dt = _approx_real_datetime(profile.last_login_time, save)
 
+    # Live HP/stam/etc live on the player's in-world pawn's status component,
+    # not in the profile. Resolve via PlayerDataID -> pawn -> status. Absent
+    # when the player has no spawned body (never spawned / corpse cleared).
+    status = None
+    if pawn_status_by_id and profile.player_id:
+        status = pawn_status_by_id.get(int(profile.player_id))
+
     out: dict[str, t.Any] = {
         "playerid": profile.player_id or 0,
         "steam": _str(gamertag),
@@ -907,6 +971,7 @@ def _player_from_profile(profile: Profile, save: t.Any = None) -> dict[str, t.An
         "netAddress": "",
         "engram_points": profile.total_engram_points,
         "experience": _int(profile.experience),
+        "current_stats": _current_stats_dict(status),
     }
     if steam_id:
         out["steamid"] = steam_id
@@ -981,17 +1046,43 @@ def _player_from_object(
         "body_colors": body_colors,
         "died_at": died_iso,
         "corpse_destruction": corpse_iso,
+        "current_stats": _current_stats_dict(status),
     }
     return _compact(data, LEGACY_PLAYER_KEYS)
 
 
+def _player_status_by_data_id(save: t.Any, lookup: dict[t.Any, t.Any]) -> dict[int, t.Any]:
+    """Index ``MyCharacterStatusComponent`` per player by ``LinkedPlayerDataID``.
+
+    Walks every ``PlayerPawnTest_*_C`` / ``PlayerCharacter_*`` in the world
+    save, reads its ``LinkedPlayerDataID``, follows ``MyCharacterStatusComponent``
+    via ``lookup``, and stores the resolved status object. Lets profile-based
+    player exports surface live HP/stamina/food/etc. without legacy ASVPack
+    having to do the same join.
+    """
+    out: dict[int, t.Any] = {}
+    objects = getattr(save, "objects", None) or []
+    for obj in objects:
+        cn = str(getattr(obj, "class_name", "") or "")
+        if "PlayerPawn" not in cn and "PlayerCharacter" not in cn:
+            continue
+        pid = _int(_prop(obj, "LinkedPlayerDataID"))
+        if not pid:
+            continue
+        status = _status_for(obj, lookup)
+        if status is not None:
+            out[pid] = status
+    return out
+
+
 def export_players(save: t.Any, map_config: MapConfig | None = None) -> list[dict[str, t.Any]]:
     profiles = _collection(save, "profiles", Profile)
     lookup = _save_lookup(save)
+    pawn_status_by_id = _player_status_by_data_id(save, lookup)
     results: list[dict[str, t.Any]] = []
     for entry in profiles:
         if isinstance(entry, Profile):
-            results.append(_player_from_profile(entry, save))
+            results.append(_player_from_profile(entry, save, pawn_status_by_id))
             continue
         profile_obj = getattr(entry, "profile", None)
         if profile_obj is None and getattr(entry, "objects", None):

{arkparser-0.3.1 → arkparser-0.3.2}/arkparser.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arkparser
-Version: 0.3.1
+Version: 0.3.2
 Summary: Pure Python parser for ARK: Survival Evolved and ARK: Survival Ascended save files
 Author: Vertyco
 License-Expression: MIT
@@ -250,6 +250,7 @@ The legacy ASVExport.exe emitted only the visible 8 stats (`hp`, `stam`, `melee`
 | `last_baby_age_update` | added | ISO 8601 datetime of `LastUpdatedBabyAgeAtTime`. |
 | `last_gestation_update` | added | ISO 8601 datetime of `LastUpdatedGestationAtTime`. |
 | `next_cuddle` | added | ISO 8601 datetime of `BabyNextCuddleTime`. |
+| `current_stats` | added | Live in-world stat values from the dino's status component (`CurrentStatusValues[0..11]`) as a `{hp, stam, torp, oxy, food, water, temp, weight, melee, speed, fort, craft}` dict of floats. These are the *current* values (e.g. `hp: 11013.62` = current HP, drops as the dino takes damage). Max values are NOT persisted by ARK — compute downstream from species stat tables + `*-w`/`*-t` points + `imprint` + server multipliers if you need them. `null` when the status component carries no `CurrentStatusValues` entries (e.g. uninitialised baby actor). |
 
 #### `ASV_Wild` schema
 
@@ -267,6 +268,7 @@ The legacy ASVExport.exe emitted only the visible 8 stats (`hp`, `stam`, `melee`
 | `trait` | legacy | first entry of `CreatureTraits` (or empty string) |
 | `traits` | added | full `CreatureTraits` list |
 | `wild_spawn_region` | added | `OriginalNPCVolumeName` — `NPCZoneVolume` the creature spawned in. |
+| `current_stats` | added | Live in-world stat values from the creature's status component (`CurrentStatusValues[0..11]`) as a `{hp, stam, torp, oxy, food, water, temp, weight, melee, speed, fort, craft}` dict of floats. Max values are NOT in the save (would need species stat tables). `null` when uninitialised. |
 
 #### Player data: `.arkprofile` vs in-world pawn
 
@@ -318,6 +320,7 @@ For the richest output, hand `export_players` **both** — assemble a wrapper fo
 | `corpse_destruction` | added | ISO 8601 datetime of `CorpseDestructionTime`. |
 | `chibi_levels` | added | `NumChibiLevelUps` — bonus levels from chibi pets. |
 | `ascensions_scorched` | added | `NumAscensionsScorched` — ASE ascension counter (legacy `ContentPlayer` parses the ASA ascension block differently; this is the ASE-specific field). |
+| `current_stats` | added | Live in-world stat values for the player from the pawn's `MyCharacterStatusComponent` (`CurrentStatusValues[0..11]`) as a `{hp, stam, torp, oxy, food, water, temp, weight, melee, speed, fort, craft}` dict of floats. For profile-sourced records the parser joins on `PlayerDataID == LinkedPlayerDataID` to find the spawned pawn in the world save. `null` when the player has no in-world pawn (never spawned this server / corpse cleared) or the status component has no values — only currently / recently spawned characters have live stats. Max values are NOT persisted by ARK. |
 
 #### `ASV_Tribes` schema
 

{arkparser-0.3.1 → arkparser-0.3.2}/arkparser.egg-info/SOURCES.txt

@@ -43,6 +43,7 @@ tests/test_asa_header_position.py
 tests/test_binary_reader.py
 tests/test_binary_reader_layouts.py
 tests/test_cloud_inventory.py
+tests/test_current_stats.py
 tests/test_data_models.py
 tests/test_export.py
 tests/test_game_objects.py

{arkparser-0.3.1 → arkparser-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "arkparser"
-version = "0.3.1"
+version = "0.3.2"
 description = "Pure Python parser for ARK: Survival Evolved and ARK: Survival Ascended save files"
 readme = "README.md"
 license = "MIT"

arkparser-0.3.2/tests/test_current_stats.py

@@ -0,0 +1,133 @@
+"""Unit tests for live CurrentStatusValues extraction.
+
+ARK persists every character's instantaneous stat values on the status
+component as ``CurrentStatusValues[0..11]``. ``_current_stats_dict`` reads
+those entries (using either ``get_properties_by_name`` for objects that
+expose it or per-index ``get_property_value`` lookups for synthetic /
+cryopod objects) and returns ``{hp, stam, torp, oxy, food, water, temp,
+weight, melee, speed, fort, craft}``.
+"""
+
+from __future__ import annotations
+
+import typing as t
+from dataclasses import dataclass
+
+from arkparser.export import _current_stat_floats, _current_stats_dict
+
+_STAT_ORDER = (
+    "hp", "stam", "torp", "oxy", "food", "water",
+    "temp", "weight", "melee", "speed", "fort", "craft",
+)
+
+
+@dataclass
+class _IndexedProp:
+    """Stand-in for an arkparser property with an array index."""
+
+    name: str
+    index: int
+    value: float
+
+
+class _FakeStatus:
+    """Minimal stand-in for a character status component.
+
+    Supports the ``get_properties_by_name`` interface used by
+    ``_current_stat_floats``.
+    """
+
+    def __init__(self, current: list[tuple[int, float]]) -> None:
+        self._props = [_IndexedProp("CurrentStatusValues", idx, val) for idx, val in current]
+
+    def get_properties_by_name(self, name: str) -> list[_IndexedProp]:
+        return [p for p in self._props if p.name == name]
+
+
+class _PerIndexStatus:
+    """Synthetic stand-in (matches ``_SyntheticGameObject`` interface).
+
+    Stores values as ``CurrentStatusValues_{idx}`` keys, and
+    ``get_property_value`` returns the indexed value.
+    """
+
+    def __init__(self, current: dict[int, float]) -> None:
+        self._values = current
+
+    def get_property_value(
+        self,
+        name: str,
+        default: t.Any = None,
+        index: int | None = None,
+    ) -> t.Any:
+        if name != "CurrentStatusValues":
+            return default
+        if index is None:
+            return default
+        return self._values.get(index, default)
+
+
+def test_none_status_returns_none() -> None:
+    assert _current_stat_floats(None) is None
+    assert _current_stats_dict(None) is None
+
+
+def test_empty_status_returns_none() -> None:
+    """Status component carrying no CurrentStatusValues at all -> ``None``."""
+    status = _FakeStatus(current=[])
+    assert _current_stat_floats(status) is None
+    assert _current_stats_dict(status) is None
+
+
+def test_sparse_indices_fill_with_zeros() -> None:
+    """Real saves only persist the stats that diverge from defaults; the
+    rest get zero. Wyvern test: hp + stam + oxy set, the rest zero."""
+    status = _FakeStatus(current=[
+        (0, 25238.14),   # hp
+        (1, 806.40),     # stam
+        (3, 660.0),      # oxy
+    ])
+    result = _current_stats_dict(status)
+    assert result is not None
+    assert result["hp"] == 25238.14
+    assert result["stam"] == 806.40
+    assert result["oxy"] == 660.0
+    assert result["torp"] == 0.0
+    assert result["food"] == 0.0
+    assert result["water"] == 0.0
+    assert result["weight"] == 0.0
+    assert result["melee"] == 0.0
+    assert result["speed"] == 0.0
+    assert result["temp"] == 0.0
+    assert result["fort"] == 0.0
+    assert result["craft"] == 0.0
+
+
+def test_all_twelve_indices_round_trip() -> None:
+    """Verify every stat slot maps to the correct name (catches off-by-one)."""
+    status = _FakeStatus(current=[(i, float(i + 1) * 10) for i in range(12)])
+    result = _current_stats_dict(status)
+    assert result is not None
+    for i, name in enumerate(_STAT_ORDER):
+        assert result[name] == float(i + 1) * 10, f"slot {i} ({name}) mismatched"
+
+
+def test_synthetic_object_uses_per_index_getter() -> None:
+    """Cryopod-decoded creatures expose status via ``get_property_value``
+    with an explicit ``index`` arg, not ``get_properties_by_name``."""
+    status = _PerIndexStatus(current={0: 1000.0, 1: 500.0, 4: 3000.0})
+    result = _current_stats_dict(status)
+    assert result is not None
+    assert result["hp"] == 1000.0
+    assert result["stam"] == 500.0
+    assert result["food"] == 3000.0
+    assert result["torp"] == 0.0
+
+
+def test_out_of_range_indices_are_ignored() -> None:
+    """Defensive: stray index 12+ entries must not blow past the 12-slot array."""
+    status = _FakeStatus(current=[(0, 100.0), (12, 999.0), (15, 999.0)])
+    result = _current_stats_dict(status)
+    assert result is not None
+    assert result["hp"] == 100.0
+    assert len(result) == 12