Skip to content

Players

Players are tracked across all servers in your cluster, providing a unified view of your community members.

Player Tracking

Arcadium automatically tracks players when they:

  1. Join any game server in your cluster
  2. Make a purchase in the shop
  3. Link their Discord account
  4. Register on your website (if enabled)

Player Information

Each player profile contains:

Identity

  • Username - In-game name
  • Steam ID - Unique Steam identifier (if applicable)
  • Discord - Linked Discord account
  • UUID - Minecraft UUID (for Java Edition)

Activity

  • Total Playtime - Hours across all servers
  • First Seen - When they first joined
  • Last Seen - Most recent activity
  • Current Server - Where they're playing now
  • Session History - Join/leave timestamps

Engagement

  • Purchases - Shop transaction history
  • Rank - Current rank/tier (if using shop system)
  • Notes - Admin notes about the player
  • Flags - Custom tags (VIP, Donor, Staff, etc.)

Player List

The dashboard provides several views:

All Players

Complete list with filters:

  • Online now
  • Seen in last 7 days
  • Never seen (shop purchases only)
  • By playtime (top players)

Server-Specific

Players currently on a specific server with real-time updates:

  • Current count
  • Live join/leave events
  • Kick/ban actions

Find players by:

  • Username (partial match)
  • Steam ID
  • Discord username
  • Rank/flags

Player Actions

Moderation

Kick Player:

Removes player from server
Requires RCON access
Can provide kick reason

Ban Player:

Prevents player from rejoining
Ban types: Temporary or Permanent
Can be server-specific or cluster-wide

Whitelist:

Allow-list for private servers
Import from file or add manually

Communication

Direct Message: Send in-game message to specific player via RCON

Broadcast: Announce to all players on a server

Discord Notifications: Notify player via Discord webhook when:

  • Server restarts scheduled
  • Rank purchased
  • Admin action taken

Discord Integration

Link Discord for enhanced features:

Benefits

  • Unified identity across game servers and Discord
  • Role syncing (game rank → Discord role)
  • Activity notifications in Discord channels
  • Discord commands to query player stats
  • Join/leave notifications

Setup

  1. Create Discord bot application
  2. Add bot to your Discord server
  3. Configure in Cluster Settings → Integrations
  4. Players link accounts via /link command

Player Groups

Organize players into groups:

Built-in Groups

  • Owner - Full cluster access
  • Admin - Server management
  • Moderator - Player moderation only
  • VIP - Enhanced permissions
  • Player - Default group

Custom Groups

Create custom groups with:

  • Specific permissions
  • Color coding in dashboard
  • Auto-assignment rules (e.g., by playtime)

Shop & Monetization

Players can purchase:

Ranks

  • One-time purchase or subscription
  • Grants in-game perks and permissions
  • Syncs to Discord roles
  • Auto-applied via RCON on join

Items

  • Virtual goods (weapons, resources, kits)
  • Delivered via RCON command
  • One-time or consumable

Packages

  • Bundles of ranks + items
  • Limited-time offers
  • Discount pricing

See Shop System for details.

Privacy & GDPR

Arcadium respects player privacy:

Data Collection

Only collects:

  • Public identifiers (Steam ID, username)
  • Voluntarily linked accounts (Discord)
  • Gameplay metrics (playtime, server activity)
  • Transaction history (purchases)

Player Rights

Players can request:

  • Data Export - JSON download of all their data
  • Data Deletion - Remove all personal information
  • Opt-out - Disable tracking (limits features)

Admin Controls

  • Anonymize player data
  • Auto-delete inactive players (configurable)
  • Redact sensitive information

Player Analytics

Understand your community:

Dashboard Metrics

  • Total Players - Unique players all-time
  • Active Players - Seen in last 7/30 days
  • New Players - Recently joined
  • Retention Rate - Return rate after first session

Charts

  • Player count over time
  • Peak hours/days
  • Server popularity
  • Playtime distribution

Reports

  • Top players by playtime
  • Revenue by player/rank
  • Churn analysis
  • Geographic distribution (if available)

API Access

Programmatically access player data:

typescript
// Get player by Steam ID
GET /api/v1/clusters/{clusterId}/players?steamId={steamId}

// List online players
GET /api/v1/servers/{serverId}/players

// Update player flags
PATCH /api/v1/players/{playerId}

See API Reference for complete documentation.

Best Practices

First Impression

Set up welcome messages via RCON tasks to greet new players.

Retention

Reward playtime milestones with ranks or items to encourage return visits.

Privacy

Never share player personal information without consent. Follow GDPR/CCPA guidelines.

Bans

Document ban reasons. Cluster-wide bans should be reserved for serious violations.

Next Steps

Released under the MIT License.