Player Configs (mods/OMNICORE/players/)
Each player gets their own JSON file named <UUID>.json. These override the global defaults.
| Field | Type | Default | Description |
|---|---|---|---|
uuid | string | (generated) | Player UUID. |
username | string | (from server) | Player username at file creation. |
consoleVisible | boolean | true | Whether the console is shown for this player. |
firstJoin | number | (timestamp) | Timestamp of first connection. |
lastSeen | number | (timestamp) | Updated on each player activity. |
consoleDisplay | object | (inherited) | Player display preferences (same structure as defaultConsoleDisplay). |
Fields like uuid, username, firstJoin, and lastSeen are managed by the mod and usually should not be edited.
Minimal Player Example
{
"uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
"username": "PlayerOne",
"consoleVisible": true,
"firstJoin": 1707000000000,
"lastSeen": 1707500000000,
"consoleDisplay": {
"visual": {
"features": {
"timestamp": true,
"loggerName": true,
"gutter": true,
"repeatBadge": true
}
},
"filter": {
"minLevel": 0
},
"layout": {
"scale": 1.0,
"position": "TopLeft",
"offsetX": 0,
"offsetY": 0
},
"colors": {
"backgroundColor": "#0d1117eb"
}
}
}
Full Default Config Example
{
"maxLogLines": 2000,
"consoleRefreshIntervalMs": 500,
"defaultConsoleVisible": true,
"permissionMode": "none",
"defaultConsoleDisplay": {
"visual": {
"features": {
"consoleBackground": true,
"headerBackground": true,
"iconBackground": true,
"timestamp": true,
"logLevel": true,
"loggerName": true,
"newestFirst": true,
"gutter": true,
"repeatBadge": true,
"detailBar": true
}
},
"filter": {
"minLevel": 0,
"loggerFilter": null
},
"layout": {
"scale": 1.0,
"position": "TopLeft",
"offsetX": 0,
"offsetY": 0,
"defaultTailMode": true,
"timestampPosition": "Right"
},
"colors": {}
}
}
Common Mistakes
- JSON requires double quotes and no trailing commas.
- Visual features are nested under
visual.features-- this nesting matters when editing by hand. - Use
#RRGGBBAA(8-digit hex) for colors with transparency, not#RRGGBB(alpha). - Out-of-range values are clamped or reset to defaults on server startup.
- Changes to config files do not apply until the server restarts.
- Player config files are named by UUID, not by username.