Player API

Entity
  └── Mob
        └── Player
              ├── LocalPlayer (client-side)
              └── MultiplayerLocalPlayer (client multiplayer)

static const int MAX_NAME_LENGTH = 20;      // 16 + 4
static const int MAX_HEALTH = 20;
static const int SWING_DURATION = 6;
static const int SLEEP_DURATION = 100;
static const int WAKE_UP_DURATION = 10;
static const int DEATHFADE_DURATION = 21;

// Chat visibility
static const int CHAT_VISIBILITY_FULL = 0;
static const int CHAT_VISIBILITY_SYSTEM = 1;
static const int CHAT_VISIBILITY_HIDDEN = 2;

shared_ptr<Inventory> inventory;           // Player inventory (hotbar + main)
Abilities abilities;                       // Flight, invulnerability, etc.

wstring name;                              // Player username
wstring displayName;                       // Display name (Xbox Live, PSN)
int dimension;                             // Current dimension ID

int score;                                 // Player score (death counter)
int experienceLevel;                       // XP level (enchanting)
int totalExperience;                       // Total XP earned
float experienceProgress;                  // Progress to next level (0-1)

Stats *stats;                              // Statistics and achievements

bool swinging;                             // Is arm swinging?
int swingTime;                             // Swing animation timer

AbstractContainerMenu *inventoryMenu;      // Player inventory UI
AbstractContainerMenu *containerMenu;      // Current open container

enum EPlayerGamePrivileges {
    ePlayerGamePrivilege_CannotMine,
    ePlayerGamePrivilege_CannotBuild,
    ePlayerGamePrivilege_CannotAttackMobs,
    ePlayerGamePrivilege_CannotAttackPlayers,
    ePlayerGamePrivilege_Op,
    ePlayerGamePrivilege_CanFly,
    ePlayerGamePrivilege_ClassicHunger,
    ePlayerGamePrivilege_Invisible,
    ePlayerGamePrivilege_Invulnerable,
    // ... more
};

// Get player from level
auto player = level->players[0];

// Check player state
if (player->isSleeping()) {
    player->stopSleepInBed(false, true, true);
}

// Get player name
wstring name = player->getName();

// Get held item
auto heldItem = player->getSelectedItem();
if (heldItem) {
    int itemId = heldItem->id;
    int count = heldItem->count;
}

// Check armor
int totalArmor = player->getArmorValue();
auto helmet = player->getArmor(0);

// Award XP
player->increaseXp(50);

// Check level
if (player->experienceLevel >= 30) {
    // Can enchant at level 30
}

// Get progress to next level
float progress = player->experienceProgress;  // 0.0 - 1.0

// Attack entity
if (auto target = dynamic_pointer_cast<Entity>(targetEntity)) {
    player->attack(target);
    
    // Critical hit?
    if (player->fallDistance > 0 && !player->onGround) {
        player->crit(target);
    }
}

// Apply damage
auto source = new EntityDamageSource("mob", attacker);
player->hurt(source, 5);

// Enable flight
player->abilities.canFly = true;
player->abilities.flying = true;
player->onUpdateAbilities();

// Set speed
player->abilities.flyingSpeed = 0.1f;
player->abilities.walkingSpeed = 0.2f;

// Get food data
auto food = player->getFoodData();
int foodLevel = food->getFoodLevel();      // 0-20
float saturation = food->getSaturation();

// Add exhaustion (mining, sprinting, etc.)
player->causeFoodExhaustion(0.025f);

// Check if can eat
if (player->canEat(false)) {
    // Start eating
}