Description
# 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.
## 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
## Supported Platforms
| Loader | Minecraft Version |
|--------|-------------------|
| Forge | 1.20.1 |
| NeoForge | 1.21.1 |
| Fabric | 1.20.1 |
| Fabric | 1.21.1 |
## 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
```json
{
"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.
