Ember’s Log Filtering

LogFilter

A highly configurable log filtering mod for Minecraft. Suppress noisy log messages, highlight important ones, and keep your console clean, all with hot-reloadable rules.

Wiki: https://tysontheember.dev/log-filter/intro/

Features

• Regex message filtering: Match and suppress log messages by content using regular expressions
• Logger name filtering: Filter by exact logger name or regex pattern, with hierarchical matching
• Log level filtering: Target specific log levels (DEBUG, INFO, WARN, ERROR)
• Filter actions: DENY (suppress), ALLOW (force show), or NEUTRAL (pass through) per rule
• Per-rule enable/disable: Toggle individual rules without removing them
• Hot-reload: Edit logfilter.json and changes apply instantly, no restart needed
• Default rules included: Ships with pre-made (disabled) rules for common log spam

Configuration

LogFilter stores its config in logfilter.json in your Minecraft config directory. The file is created automatically on first launch with sensible defaults.

Example Config

{
  "configVersion": 1,
  "enabled": true,
  "rules": [
    {
      "name": "Suppress OpenAL spam",
      "enabled": true,
      "type": "MESSAGE_REGEX",
      "pattern": "(?i)openal",
      "action": "DENY",
      "level": null
    },
    {
      "name": "Block debug logs from server level",
      "enabled": true,
      "type": "LOGGER_NAME",
      "pattern": "net.minecraft.server.level",
      "action": "DENY",
      "level": "DEBUG"
    },
    {
      "name": "Always show errors",
      "enabled": true,
      "type": "LEVEL",
      "pattern": "ERROR",
      "action": "ALLOW",
      "level": null
    }
  ]
}

Rule Types

| Type |Description |
| ————- |—————————————————– |
| MESSAGE_REGEX |Match the log message content against a regex pattern |
| LOGGER_NAME |Match by exact logger name or prefix (hierarchical) |
| LOGGER_REGEX |Match logger names using a regex pattern |
| LEVEL |Match by log level (DEBUG, INFO, WARN, ERROR) |

Actions

| Action |Description |
| ——- |—————————————————- |
| DENY |Suppress the log message |
| ALLOW |Force the message through, regardless of other rules |
| NEUTRAL |No effect, pass through to the next rule |

Optional Level Restriction

Any rule can include a level field to restrict it to a specific log level. For example, a LOGGER_NAME rule with "level": "DEBUG" will only match debug messages from that logger.

Default Rules

LogFilter ships with several pre-configured rules (disabled by default) to get you started:

• Suppress OpenAL/LWJGL info spam
• Suppress advancement loading messages
• Suppress debug logs from net.minecraft.server.level
• Suppress recipe loading messages
• Always allow ERROR-level messages

Enable them by setting "enabled": true in the config file.