Free PlayerData V1

PlayerData Plugin Description

Features

PlayerData is a player tracking and session-history plugin for ARK servers. It records identity changes, tribe changes, map presence, IP history, and join/leave session data so server owners can keep long-term records of player activity.

• Player identity tracking – records Steam name, character name, SteamID, and player ID
• Tribe tracking – records tribe ID and tribe name and updates when they change
• Session tracking – opens a session when a player joins and closes it when they leave
• Join / leave time recording – stores when players join and when they disconnect
• Session length tracking – calculates total session duration on logout
• IP history tracking – records player IPs and counts unique IP usage over time
• Map tracking – records the player's current map and logs map changes
• Logout position/orientation capture – stores the player's last logout coordinate/orientation string
• Change history logging – records important player-data changes over time
• Bootstrap support – can initialize tracking for players already online when the plugin loads
• Live cache updates – keeps active player records updated while they are online
• MySQL support – can persist tracked player data into database tables
• Reload support – allows config reload without restarting

What It Does

PlayerData builds a snapshot of each player while they are online and updates that record as relevant details change.

It tracks information such as:

• SteamID
• player ID
• Steam name
• character name
• tribe ID
• tribe name
• IP address
• current map
• logout coordinate/orientation data

When a player joins:

• a live cache entry is created or refreshed
• a session is opened
• current player information is stored

While the player is online:

• changed identity/session data can be refreshed and persisted
• player, tribe, IP, and map changes are detected
• history entries are generated for changed values

When a player logs out:

• the session is closed
• leave time is stored
• session duration is calculated
• last logout coordinate/orientation data is saved
• player summary data is updated

History / Change Tracking

The plugin records change history for important fields, including:

• player ID changes
• Steam name changes
• character name changes
• tribe changes
• IP changes
• map changes
• logout position/orientation changes

This makes it useful for identifying renamed players, tribe swaps, map movement, and IP history over time.

Summary / Stats Behavior

PlayerData also maintains summary-style values for each tracked player, including:

• first seen
• last seen
• first IP
• last IP
• session count
• unique IP count
• last join time
• last leave time

Commands

- playerdata.reload

Configuration

The plugin supports:

• enable/disable MySQL persistence
• MySQL connection settings
• debug logging
• plugin/server naming fields

Requirements

• ARK: Survival Evolved Dedicated Server
• Ark Server API 3.56