Struct PersistentPlayerData 

pub struct PersistentPlayerData {

    pub pos: [f64; 3],
    pub motion: [f64; 3],
    pub rotation: [f32; 2],
    pub on_ground: bool,
    pub fall_flying: bool,
    pub remaining_fire_ticks: i32,
    pub ticks_frozen: i32,
    pub is_in_powder_snow: bool,
    pub was_in_powder_snow: bool,
    pub has_visual_fire: bool,
    pub health: f32,
    pub game_mode: i32,
    pub prev_game_mode: Option<i32>,
    pub abilities: PersistentAbilities,
    pub inventory: Vec<PersistentSlot>,
    pub selected_slot: i32,
    pub world: String,
    pub food_level: i32,
    pub food_saturation_level: f32,
    pub food_exhaustion_level: f32,
    pub food_tick_timer: i32,
    pub data_version: i32,
    pub experience_level: i32,
    pub experience_progress: f32,
    pub experience_total: i32,
    pub score: i32,
    pub seen_credits: bool,
    pub root_vehicle: Option<PersistentRootVehicle>,
    pub ender_pearls: Vec<PersistentEnderPearl>,
}

Persistent player data saved by Steel’s storage backend.

This is Steel’s runtime save snapshot. Vanilla import/export should live outside server runtime storage so compatibility logic does not constrain the native format.

Fields

pos: [f64; 3]

Position (x, y, z) in absolute world coordinates.

motion: [f64; 3]

Velocity (x, y, z) in blocks per tick.

rotation: [f32; 2]

Rotation (yaw, pitch) in degrees.

on_ground: bool

Whether the player is on the ground.

fall_flying: bool

Whether the player is elytra gliding.

remaining_fire_ticks: i32

Vanilla remainingFireTicks.

ticks_frozen: i32

Synchronized vanilla TicksFrozen.

is_in_powder_snow: bool

Vanilla isInPowderSnow.

was_in_powder_snow: bool

Vanilla wasInPowderSnow.

has_visual_fire: bool

Vanilla hasVisualFire.

health: f32

Current health points.

game_mode: i32

Current game mode (0=survival, 1=creative, 2=adventure, 3=spectator).

prev_game_mode: Option<i32>

Previous game mode of the player, or None if vanilla has not recorded one yet.

abilities: PersistentAbilities

Player abilities (flight, invulnerability, etc.).

inventory: Vec<PersistentSlot>

Inventory items with slot indices.

selected_slot: i32

Currently selected hotbar slot (0-8).

world: String

Loaded world identifier (e.g., “minecraft:overworld”).

food_level: i32

Current food level (0–20, default 20).

food_saturation_level: f32

Food saturation level (0.0–food_level, default 5.0).

food_exhaustion_level: f32

Accumulated food exhaustion (0.0–40.0, default 0.0).

food_tick_timer: i32

Internal tick timer for regen/starvation (default 0).

data_version: i32

Data version for format migrations.

experience_level: i32

Current experience level

experience_progress: f32

Vanilla progress toward the next experience level.

experience_total: i32

Vanilla Player.totalExperience, updated by point grants but independent of level/progress.

score: i32

Vanilla death-screen score. Point grants change it with Java int wrapping.

seen_credits: bool

Vanilla ServerPlayer.seenCredits.

root_vehicle: Option<PersistentRootVehicle>

Vanilla one-player root vehicle tree stored with the player instead of chunk data.

ender_pearls: Vec<PersistentEnderPearl>

Vanilla in-flight ender pearls stored with the player (ServerPlayer.enderPearls).

Implementations

impl PersistentPlayerData

pub fn from_player(player: &Player) -> Self

Extracts persistent data from a live player.

fn ender_pearls_from_player(player: &Player) -> Vec<PersistentEnderPearl>

Snapshots the player’s live in-flight ender pearls for persistence.

fn root_vehicle_from_player(player: &Player) -> Option<PersistentRootVehicle>

impl PersistentPlayerData

pub fn apply_to_player(&self, player: &Player)

Applies the saved data to a player.

This restores position, rotation, inventory, abilities, etc.

pub fn apply_to_player_without_location(&self, player: &Player)

Applies saved gameplay state without restoring world-local location data.

Used when the saved world is unavailable or differs from an explicitly selected world, which must use the target spawn instead.

fn apply_to_player_inner(&self, player: &Player, restore_location: bool)

Trait Implementations

impl Clone for PersistentPlayerData

fn clone(&self) -> PersistentPlayerData

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PersistentPlayerData

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.