Player Configs & Common Mistakes

File: mods/OMNISIGHT/players/<username>_<uuid>.json

Each player has their own config file that overrides global defaults. Created automatically on first join.

Editable Fields

Field	Type	Default	Description
`hudMode`	string	`"OFF"`	`OFF`, `SIMPLE`, `FULL`, or `CLOCK`
`hudSize`	string	`"medium"`	`small`, `medium`, or `large` (overridden by `hudScale`)
`hudScale`	number	`1.0`	Custom scale factor (`0.25` - `1.5`). Overrides `hudSize` when set
`infoPosition`	string	`"top_right"`	Info panel position
`clockPosition`	string	`"top_right"`	Clock position
`clockVisible`	boolean	`true`	Show/hide clock
`infoHudVisible`	boolean	`true`	Show/hide info panel when looking at targets
`hideDevEntities`	boolean	`true`	Hide spawners and dev markers from look-at
`containerCacheEnabled`	boolean	`true`	Cache container contents for faster lookups
`infoScale`	number	(inherits `hudScale`)	Info panel scale (`0.25` - `1.5`). Overrides `hudScale` for info only
`clockScale`	number	(inherits `hudScale`)	Clock scale (`0.25` - `1.5`). Overrides `hudScale` for clock only
`equipmentScale`	number	(inherits `hudScale`)	Equipment scale (`0.25` - `1.5`). Overrides `hudScale` for equipment only
`infoOffsetX`	number	`0`	Info panel horizontal offset (`-200` to `200`)
`infoOffsetY`	number	`0`	Info panel vertical offset (`-200` to `200`)
`clockOffsetX`	number	`0`	Clock horizontal offset (`-200` to `200`)
`clockOffsetY`	number	`0`	Clock vertical offset (`-200` to `200`)
`clockDisplay`	object	-	Clock config (see Clock Display page)
`simpleDisplay`	object	-	Display config (see Simple Display page)

Non-Editable Fields (managed by the mod)

Field	Description
`uuid`	Player UUID
`username`	Player name
`firstJoin`	First join timestamp
`lastSeen`	Last seen timestamp
`lastOpenedSettingsCategory`	Remembers which settings tab was last open

Example Player Config

{
  "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
  "username": "PlayerOne",
  "hudMode": "SIMPLE",
  "hudScale": 1.0,
  "infoScale": 1.0,
  "clockScale": 1.0,
  "equipmentScale": 1.0,
  "infoPosition": "top_right",
  "clockPosition": "top_left",
  "clockVisible": true,
  "infoHudVisible": true,
  "hideDevEntities": true,
  "containerCacheEnabled": true,
  "infoOffsetX": 0,
  "infoOffsetY": 0,
  "clockOffsetX": 0,
  "clockOffsetY": 0,
  "clockDisplay": {
    "layout": {
      "use24Hour": false,
      "showBackground": true,
      "textAlignment": "Center",
      "timezoneOffset": 0
    },
    "elements": {
      "time": { "show": true, "color": "#ffffff", "secondRow": false, "order": 1 },
      "date": { "show": true, "color": "#ffffff", "secondRow": false, "order": 2 },
      "biome": { "show": true, "color": "#2ecc71", "secondRow": true, "order": 3 }
    }
  },
  "simpleDisplay": {
    "block": {
      "features": {
        "features": {
          "blockId": false,
          "modSource": true
        }
      }
    },
    "entity": {
      "features": {
        "features": {
          "health": true,
          "activeEffects": true
        }
      }
    },
    "equipment": {
      "features": {
        "features": {
          "equipmentHud": true,
          "durability": true
        }
      },
      "position": "BottomRight",
      "bottomRightOffsetY": 120
    }
  }
}

Common Mistakes

JSON requires double quotes and no trailing commas.
- Wrong: {'key': 'value',}
- Right: {"key": "value"}
features.features must be nested exactly.
- A single "features": { "blockId": true } is silently ignored.
Positions are normalized to snake_case.
- "TopRight", "top-right", "top right" become "top_right" on load.
Changes require a server restart.
- Editing player config files while server is running will not apply until restart or re-login.
hudScale overrides hudSize.
- If hudScale is set, hudSize is ignored. Remove hudScale to return to size-based scaling.