👤 User Data Configuration

DANGER

These files were created automatically and should not be edited manually to avoid errors. Instead, use the commands from Essentials Plus.

File Information

📁 File Location: mods/fof1092_EssentialsPlus/users/
🔙 Back to Configuration Overview

The users/ directory contains individual JSON files for each player. Each player's data is stored in a file named by their UUID: user-uuid.json.

Example User File (users/123e4567-e89b-12d3-a456-426614174000.json):

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "username": "Player1",
  "frozen": false,
  "firstJoinTimestamp": 1705334422000,
  "lastJoinTimestamp": 1705420822000,
  "playtime": 29914177,
  "balance": 1000.0,
  "mutedUser": null,
  "tempBannedUser": null,
  "ipHistory": [
    {
      "ip": "192.168.1.100",
      "lastUsed": 1738234567890
    },
    {
      "ip": "10.0.0.50",
      "lastUsed": 1738220123456
    }
  ],
  "ignoredPlayers": []
}

Muted Player Example:

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "username": "Player1",
  "mutedUser": {
    "muteEndTimestamp": 1803221798475,
    "reason": "No reason specified"
  },
  "frozen": false,
  "firstJoinTimestamp": 1705334422000,
  "lastJoinTimestamp": 1705420822000,
  "playtime": 29914177,
  "balance": 500.0,
  "ignoredPlayers": []
}

Temp-Banned Player Example:

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "username": "Player1",
  "tempBannedUser": {
    "banEndTimestamp": 1771686114345,
    "reason": "No reason specified",
    "bannedBy": "Console"
  },
  "frozen": false,
  "firstJoinTimestamp": 1705334422000,
  "lastJoinTimestamp": 1705420822000,
  "playtime": 29914177,
  "balance": 0.0,
  "mutedUser": null,
  "ignoredPlayers": [
    "987e6543-e21b-12d3-a456-426614174999"
  ]
}

User Properties:

• uuid - Player's unique identifier
• username - Player's current username
• frozen - Whether the player is currently frozen (true/false)
• firstJoinTimestamp - When player first joined (milliseconds)
• lastJoinTimestamp - When player last joined (milliseconds)
• playtime - Total playtime in milliseconds
• balance - Player's current economy balance (default: 0.0)
• mutedUser - Mute information (null if not muted)
  • muteEndTimestamp - When mute expires (milliseconds timestamp)
  • reason - Reason for mute
• tempBannedUser - Temporary ban information (null if not banned)
  • banEndTimestamp - When ban expires (milliseconds timestamp)
  • reason - Reason for ban
  • bannedBy - Who issued the ban
• ignoredPlayers - Array of UUIDs of players being ignored
• ipHistory - Array of the last 5 IP addresses used by the player
  • ip - IP address
  • lastUsed - Timestamp when this IP was last used (milliseconds)
  • Automatically managed: oldest entries are removed when limit is reached
  • Used for tracking and displayed in /whois command

Note: User files are automatically created on first join and updated automatically. Each player has their own file for better performance and organization.