Global Config Reference
File: mods/OMNISIGHT/config.json
Raycast Settings
| Field | Type | Default | Range | Description |
|---|---|---|---|---|
eyeHeight | number | 1.62 | 0.0 - 10.0 | Player eye height for raycasting |
maxReach | number | 10.0 | 1.0 - 100.0 | Max distance for block/entity lookups |
rayStartOffset | number | 0.4 | 0.0 - 5.0 | Offset from eyes to raycast start |
Tick Intervals
| Field | Type | Default | Range | Description |
|---|---|---|---|---|
lookUpdateIntervalTicks | number | 3 | 1 - 100 | Look-at data update frequency |
clockUpdateIntervalTicks | number | 20 | 1 - 100 | Clock display update frequency |
Default Player Settings
| Field | Type | Default | Description |
|---|---|---|---|
defaultHudMode | string | "OFF" | OFF, SIMPLE, FULL, or CLOCK |
defaultHudSize | string | "medium" | small, medium, or large |
defaultInfoPosition | string | "top_right" | Info panel screen position |
defaultClockPosition | string | "top_right" | Clock screen position |
defaultClockVisible | boolean | true | Clock visibility for new players |
defaultClockDisplay | object | - | Clock layout config (see Clock Display page) |
defaultSimpleDisplay | object | - | Info panel config (see Simple Display page) |
Server-Wide Feature Toggles (guiElements)
Controls which HUD components are available server-wide. When a component is disabled, its settings are hidden from the GUI.
"guiElements": {
"infoPanelEnabled": true,
"clockEnabled": true,
"equipmentEnabled": true
}
| Field | Type | Default | Description |
|---|---|---|---|
infoPanelEnabled | boolean | true | Enables/disables the info panel server-wide |
clockEnabled | boolean | true | Enables/disables the clock server-wide |
equipmentEnabled | boolean | true | Enables/disables the equipment display server-wide |
Legacy migration: if flat clockEnabled or equipmentEnabled fields are found at the config root, they are automatically migrated into the guiElements object and removed.
Permissions
| Field | Type | Default | Description |
|---|---|---|---|
permissionMode | string | "none" | "none", "op", or "custom" (see Permissions page) |
Legacy migration: if requiresOp: true is found in config, it is automatically migrated to permissionMode: "op" and requiresOp is removed.
Supported Positions
OmniSight accepts flexible input (like TopRight, top-right, top right) and normalizes to snake_case.
- Info panel:
top_left,top_center,top_right - Clock:
top_left,top_center,top_right,bottom_left,bottom_center,bottom_right - Equipment HUD:
top_left,top_right,bottom_left,bottom_right
Example config.json
{
"eyeHeight": 1.62,
"maxReach": 10.0,
"rayStartOffset": 0.4,
"lookUpdateIntervalTicks": 3,
"clockUpdateIntervalTicks": 20,
"defaultHudMode": "OFF",
"defaultHudSize": "medium",
"defaultInfoPosition": "top_right",
"defaultClockPosition": "top_right",
"defaultClockVisible": true,
"permissionMode": "none",
"guiElements": {
"infoPanelEnabled": true,
"clockEnabled": true,
"equipmentEnabled": true
}
}