Omnicore docs

Console Display Reference

Home

Console Display Reference

Visual, filter, layout, and color settings for OmniCore console display.

Console Display (defaultConsoleDisplay / consoleDisplay)

Display settings are split into four sections: visual, filter, layout, and colors.

"defaultConsoleDisplay": {
  "visual": { ... },
  "filter": { ... },
  "layout": { ... },
  "colors": { ... }
}

Visual Settings (visual)

Feature toggles are stored as boolean flags. All default to enabled (true) unless explicitly set to false.

Feature KeyDefaultDescription
consoleBackgroundtrueShow main console panel background.
headerBackgroundtrueShow header/title bar background.
iconBackgroundtrueShow icon element backgrounds.
timestamptrueDisplay log entry timestamps.
logLeveltrueDisplay log severity levels (INFO/WARN/ERR).
loggerNametrueDisplay logger/source name for each entry.
newestFirsttrueShow newest logs at bottom.
guttertrueShow vertical gutter line and dot indicators.
repeatBadgetrueShow "xN" badge for repeated consecutive messages.
detailBartrueShow detail panel when clicking a log row.

Example:

"visual": {
  "features": {
    "consoleBackground": true,
    "headerBackground": true,
    "timestamp": true,
    "logLevel": true,
    "loggerName": true,
    "gutter": true,
    "repeatBadge": true,
    "detailBar": true,
    "newestFirst": true,
    "iconBackground": true
  }
}

Note: Omitted features default to true. You only need to include features you want to disable.

Filter Settings (filter)

FieldTypeDefaultDescription
minLevelnumber0 (ALL)Minimum Java logging level threshold.
loggerFilterstringnullFilter logs to a specific logger/source name.

Log Level Values

Display NameJava Level ValueShows
ALL0Everything
INFO800INFO, WARNING, SEVERE
WARN900WARNING, SEVERE
ERR1000SEVERE only

Example:

"filter": {
  "minLevel": 800,
  "loggerFilter": "MyPlugin"
}

This shows only INFO-level and above messages from the "MyPlugin" logger.

Layout Settings (layout)

FieldTypeDefaultRangeDescription
scalenumber1.00.25 - 1.5UI scale multiplier.
positionstring"TopLeft"-Console anchor position.
offsetXnumber0-200 - 200Horizontal pixel offset.
offsetYnumber0-200 - 200Vertical pixel offset.
defaultTailModebooleantrue-Whether to show newest logs by default (tail mode).
timestampPositionstring"Right"-Position of timestamp in log rows.

Clamping Rules

  • scale: NaN or Infinite values reset to 1.0, otherwise clamped to 0.25 - 1.5.
  • offsetX / offsetY: clamped to -200 - 200.

Example:

"layout": {
  "scale": 1.0,
  "position": "TopLeft",
  "offsetX": 0,
  "offsetY": 0,
  "defaultTailMode": true,
  "timestampPosition": "Right"
}

Color Settings (colors)

All color fields are optional. When set to null or omitted, the built-in default color is used. Colors must use #RRGGBB or #RRGGBBAA.

FieldDescription
timestampColorTimestamp text color.
messageColorLog message text color.
loggerNameColorLogger/source name color.
gutterDotColorDot indicator color in the gutter.
gutterLineColorVertical line color in the gutter.
backgroundColorMain console panel background.
headerBackgroundHeader/title bar background.
detailBarBackgroundDetail panel background.
inputBackgroundCommand input field background.
repeatBadgeColor"xN" repeat badge color.

Example:

"colors": {
  "backgroundColor": "#0d1117eb",
  "headerBackground": "#161b22ff",
  "messageColor": "#c9d1d9ff",
  "timestampColor": "#8b949eff"
}

Important: Use 8-digit hex (#RRGGBBAA) for colors with transparency, not #RRGGBB(alpha).