Guardian is a high-performance, highly configurable chat moderation plugin for Hytale servers. It’s built to keep chat clean, reduce abuse fast, and give staff real control tools, without slowing the server down or turning moderation into constant babysitting.
This isn’t a basic word filter. Guardian is meant for real servers, spam waves, bypass attempts, link floods, repeat offenders, and staff who need clear answers instead of guesswork.
Why Guardian
Core Features
Reputation System
Guardian tracks a lightweight reputation score per user based on chat behavior. This score is not visible to players. It is used internally to reduce false positives for trusted users and tighten restrictions for repeated offenders. Reputation decays over time, so players can recover.
Mute System (because Hytale didn't ship with it)
Guardian adds server-level mutes with:
Commands
Configuration
Everything is driven by config, so server owners can tune behavior to their community:
Storage
Guardian uses SQLite for durable state:
At the end of the day, Guardian is just here to keep chat from turning into a dumpster fire. Spam gets shut down fast, slurs and links don’t slip through, and staff can actually see what happened without guessing. You set the rules for your server, Guardian enforces them consistently, and your chat stays readable.
This isn’t a basic word filter. Guardian is meant for real servers, spam waves, bypass attempts, link floods, repeat offenders, and staff who need clear answers instead of guesswork.
Why Guardian
- Deep configuration for spam, links, word filtering, reputation, retention, and mutes.
- Fast per-message checks with small in-memory history and SQLite persistence.
- Clear staff tooling and audit trails.
- Deterministic, explainable moderation decisions.
Core Features
- Anti-spam: rate limits, duplicate detection, repeated messages.
- Word filtering: case-insensitive, whole-word or partial match, spacing and punctuation normalization.
- Link control: allow all, block all, or allowlist domains.
- Reputation system: invisible to players, used to tune moderation strictness and reduce false positives.
- Mute system: permanent or timed mutes with reasons.
- Audit logging: staff-focused action records.
- SQLite persistence: survives server restarts.
Reputation System
Guardian tracks a lightweight reputation score per user based on chat behavior. This score is not visible to players. It is used internally to reduce false positives for trusted users and tighten restrictions for repeated offenders. Reputation decays over time, so players can recover.
Mute System (because Hytale didn't ship with it)
Guardian adds server-level mutes with:
- /mute and /unmute commands
- Optional durations and reasons
- Automatic expiration for timed mutes
Commands
Command | Parameters | Description | Permission |
|---|---|---|---|
| /mute | <player> [duration] [reason] | Mute a player, optionally timed with a reason. | guardian.moderation.mute |
| /unmute | <player> | Remove an active mute. | guardian.moderation.unmute |
| /guardian status | none | Show plugin and licensing status. | guardian.moderation.status |
| /guardian reload | none | Reload config from disk. | guardian.moderation.reload |
| /guardian rep | <player> | Show a player's reputation snapshot. | guardian.moderation.rep |
| /guardian audit | <player> | Show recent audit actions. | guardian.moderation.audit |
Configuration
Everything is driven by config, so server owners can tune behavior to their community:
- Spam thresholds and cooldown windows
- Word filter lists and match modes
- Link rules and allowlists
- Reputation scoring and decay
- Retention cleanup intervals
- Staff-only permissions for commands
Storage
Guardian uses SQLite for durable state:
- Mute state and reasons
- Reputation score and timestamps
- Message history snapshots for spam checks
- Audit log entries
At the end of the day, Guardian is just here to keep chat from turning into a dumpster fire. Spam gets shut down fast, slurs and links don’t slip through, and staff can actually see what happened without guessing. You set the rules for your server, Guardian enforces them consistently, and your chat stays readable.
