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 |
Combat Focus
| Field | Type | Default | Description |
|---|---|---|---|
combatFocusSeconds | number | 5 | How long the info panel keeps showing the mob you hit (or that hit you) after the last hit, when you are not looking at an entity. Players can pick their own duration in the settings (Target Info > Creatures). |
Default Player Settings
Used for players who have not changed the setting themselves.
| 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,center_left,center_right,bottom_left,bottom_center,bottom_right - Equipment HUD:
top_left,top_right,center_left,center_right,bottom_left,bottom_right
When the clock and the info panel share a corner, the info panel is stacked below the clock automatically.
Example config.json
{
"eyeHeight": 1.62,
"maxReach": 10.0,
"rayStartOffset": 0.4,
"lookUpdateIntervalTicks": 3,
"clockUpdateIntervalTicks": 20,
"combatFocusSeconds": 5,
"defaultHudMode": "OFF",
"defaultHudSize": "medium",
"defaultInfoPosition": "top_right",
"defaultClockPosition": "top_right",
"defaultClockVisible": true,
"permissionMode": "none",
"guiElements": {
"infoPanelEnabled": true,
"clockEnabled": true,
"equipmentEnabled": true
}
}