async/examples/player-load

player-load

Loads <plugin data dir>/players/<uuid>.json when a player joins, hydrates a PlayerStats component on the world thread.

What it shows

• eventRegistry.registerGlobal(PlayerReadyEvent::class.java) { … } — the right overload for events with a non-Void key type.
• playerScope(player).launch { … } — coroutine bound to the player. Cancels on disconnect, so a slow disk read doesn't outlive the session.
• withContext(AsyncDispatchers.HytaleIO) { … } — file I/O off the world thread.
• modify<PlayerStats>(player.handle()) { … } — thread-safe component mutation. The dispatcher switches happen automatically.

Build

./gradlew shadowJar
# → build/libs/player-load.jar

Run

1. Drop the JAR in your dev server's mods/.
2. Wire PlayerStatsBinding.componentType() — replace the TODO() with whatever EntityStore.REGISTRY.register(PlayerStats::class.java, …) returns in your setup.
3. Seed <server>/data/Mythlane.PlayerLoad/players/<your-uuid>.json:

   {"level":42,"clan":"red"}
   

4. Connect. The values land on the live PlayerStats component.

The JSON parser in the example is intentionally minimal — use kotlinx.serialization in real plugins.