Skip to main content

​
Player State Artifact

The btc_player_state_artifact is a catch-all storage for player-specific RPG data that doesn’t fit into professions or inventory. It is critical for the persistence of character stats and temporary effects. Type: Artifact Entry ID: btc_player_state_artifact

​
Configuration

FieldTypeDefaultDescription
artifactIdString"player_state"The unique ID used to reference this storage.

​
Stored Data

  • Permanent Stats: Stats modified by commands or events (e.g., base Strength, Max Mana).
  • Effect Snapshots: A snapshot of active item effects/gem bonuses to restore them properly on login.
  • Potion Effects: Active vanilla potion effects are saved here to persist across server restarts or logout/login.
  • Reward Menus: Tracks which slots have been claimed in QuestRewardMenuEntry instances.

​
Usage

This artifact works silently in the background to ensure a seamless RPG experience where players don’t lose their customized stats or buffs when disconnecting.