[![FyrxLab Server Invite](https://cdn.modrinth.com/data/cached_images/cd3eae1430f55ea04e42988f9745069cb32bcc33.png)](https://discord.gg/EdcYuBAdFB)

Solver

Your AI-Powered Server Assistant

![Intro](https://cdn.modrinth.com/data/cached_images/45617eb59d3b01f43640cad0b944c8411abbc531.png) **Solver** is the AI-powered Minecraft server admin and moderation plugin for Paper/Folia, built around **Fyrx**, your built-in AI assistant. It started as a crash-report translator — say goodbye to scrolling through hundreds of lines of cryptic Java stack traces — and has grown into a full moderation/staff alternative: contextual AI chat moderation, a complete sanctions system with alt-account detection and in-game appeals, a staff reports queue, and a deep Staff Mode Toolkit (vanish, freeze, inventory inspection, and more). Everything runs on the AI provider of your choice: **Anthropic Claude, Google Gemini, or any OpenAI-compatible endpoint** (including local/self-hosted models). Whenever your server hits an error, a crash, a lag spike, or a chat incident, Fyrx analyzes it in the background and gives you a human-readable explanation and actionable next steps directly in your console or in-game. ### Key Features **Diagnostics** * **AI Crash Analysis:** Automatically intercepts native JVM crashes and standard Minecraft crash reports, explaining exactly which plugin, memory issue, or broken chunk caused the disaster. * **Early Startup Error Detection:** Captures plugin incompatibility errors that happen before the server even fully starts, alerting you immediately upon boot. * **Lag & Freeze Detection (TickMonitor):** Continuously monitors your server's TPS. If the main thread freezes for more than a few seconds (deadlocks), Fyrx analyzes the thread dump and tells you which plugin is choking the server. Runs natively on Folia, which handles its own watchdog. **AI Chat Moderation** * **Reads the whole conversation, not a word blacklist:** Fyrx evaluates the real CONTEXT of a chat exchange to tell insistent harassment apart from harmless banter between friends. * **Categories you define:** verdicts come back tagged with whatever categories you configure in `tags.yml` (ships with `TOXIC`, `HARASSMENT`, `THREAT`, `HATE_SPEECH`, `SCAM`, `SPAM`) — one entry per player actually misbehaving, not a single guessed word for the whole scan. * **Confidence meter + multi-signal corroboration:** every verdict shows how *sure* Fyrx is (0-100%), separate from severity — and a real automatic sanction requires either high confidence *and* severity, or an independent corroborating signal, so a single shaky AI call can't get someone punished alone. * **Configurable response:** alert-only, private warning, or full auto mute/kick/ban by severity or by category — map any tag straight to a sanction type with `tag-overrides`, including the only path to an automatic ban from chat moderation. * **Already-reviewed text never gets re-judged from scratch** — once a message is cleared, it's only used as background context for spotting an escalating pattern, never re-flagged out of nowhere. **Sanctions System** *(BETA)* * `/solver warn|mute|tempmute|kick|ban|tempban [duration] ` — every sanction gets a real ID and a persistent history (`/solver history`, `/solver check `, `/solver sanctions ` GUI). * Bans are actually enforced on reconnect, not just a one-time kick. Mutes work even with AI chat moderation turned off. * **Real alt-account/IP cross-referencing:** `/solver checkuser ` shows every account that ever shared an IP with it. A ban instantly kicks an alt that's already online, not just future logins. * **In-game sanction appeals:** `/solver appeal ` — no Discord webhook needed. Staff get notified immediately and review with `/solver appeal list|accept|reject`. * **Reason templates & automatic warn escalation:** shortcut a common reason with `#name`, and auto-kick/tempban/run a command after a player's Nth warning. * **SQLite by default, MySQL when you need it:** zero-config local storage, or point `punishments.storage` at a shared MySQL database for multi-server networks. **Staff Reports System** * `/solver report ` lets any player flag something for staff attention — open to everyone, entirely separate from sanctions. * `/solver reports [claim|close|reopen|gui]` manages the queue with its own GUI; the reporter is notified directly when their report is claimed or closed. **Staff Mode Toolkit** *(BETA)* * **Vanish, freeze, and staff chat:** two-tier vanish (a `strict` level invisible even to most staff), optional damage immunity while vanished, and a private freeze chat channel to actually talk to someone during a screenshare instead of just silencing them. * **CommandSpy:** a live relay of other players' commands into your chat, not just after-the-fact logging. * **Named combined profiles:** `/solver staffmode ` bundles vanish + freeze-immunity + flight + god-mode + inventory-clear (auto saved/restored) into one toggle. * **`/solver fly`/`god`/`rtp`:** independent flight and invulnerability (real PvP-proof invulnerability, not just a flag), plus a random teleport to a non-staff player for supervision rounds. * **`/solver inspect`/`enderchest`:** view *and confiscate* a player's inventory or ender chest without ever opening it. * Every command above also works without the `/solver` prefix (`/vanish`, `/freeze`, `/report`, etc.) — toggle any category off in `config.yml` if another plugin already claims that name. **Fully Customizable Messages** * Every message the plugin sends (help, errors, sanctions, moderation alerts) lives in `messages.yml` with full **MiniMessage** support — colors, gradients, hover text, whatever you want. * Multi-language out of the box across 9 locales: `en_US`, `es_ES`, `pt_BR`, `ru_RU`, `de_DE`, `fr_FR`, `ja_JP`, `ko_KR`, `eo_EO`. **Optional Integrations** *(BETA)* * PlaceholderAPI support — `%solver_muted%`, `%solver_warns%`, `%solver_active_sanctions%`, and more for your scoreboard/tab-list/chat plugins. Does nothing if you don't have PlaceholderAPI installed. * **Clean & Beautiful UI:** AI responses and every in-game menu are formatted using native Minecraft color codes / MiniMessage directly in your console and in-game. * **100% Asynchronous & Zero-Lag:** All AI processing, file reading, database access, and network requests run off the main thread. Your server's TPS won't drop while Fyrx is thinking. ![installation](https://cdn.modrinth.com/data/cached_images/426b0763c4487a7f27a7991fe6c4dedea43e835e.png) ### How to use 1. Drop `Solver-0.8.0.jar` into your `plugins` folder. 2. Start the server once to generate `config.yml`. 3. Open `plugins/Solver/config.yml`, pick a provider (`anthropic`, `google`, or `other`), and paste its API key. 4. Restart the server. Fyrx is now monitoring! Run `/solver help` in-game or console for the full command list. *(Want to test it safely? Use `/solver crashme dry-run` for a synthetic crash analysis, or `/solver moderation test ` to try the moderation AI — neither one touches your real server.)* ### Requirements * **Server Type:** Paper, Folia, Purpur, or forks. (Chat moderation needs Paper's `AsyncChatEvent` — Spigot isn't supported yet, it's on the roadmap). * **Minecraft Version:** 1.18.x — 1.21.x. * **Java:** Java 17 or higher. * **API Key:** From your chosen provider — Anthropic, Google Gemini (has a free tier), or any OpenAI-compatible endpoint. * **Optional:** EssentialsX is auto-detected — `/enderchest` won't register standalone if it's installed, so the two plugins never fight over the same command name. ![config](https://cdn.modrinth.com/data/cached_images/97e5aed6a9ed1c3e8f20ffc538658332d1cab8c0.png)

config.yml

```yaml # ███████╗ ██████╗ ██╗ ██╗ ██╗███████╗██████╗ # ██╔════╝██╔═══██╗██║ ██║ ██║██╔════╝██╔══██╗ # ███████╗██║ ██║██║ ██║ ██║█████╗ ██████╔╝ # ╚════██║██║ ██║██║ ██║ ██║██╔══╝ ██╔══██╗ # ███████║╚██████╔╝███████╗╚██████╔╝███████╗██║ ██║ # ╚══════╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝ # Solver Configuration # Language (en_US, es_ES, pt_BR, ru_RU, de_DE, fr_FR, ja_JP, ko_KR, eo_EO) localization: en_US # Automatically analyze whether there was a crash when the server starts up check-crash-on-startup: true # Monitor the entire console for errors (red text) monitor-console: true # Avoid analyzing the same error multiple times (minutes to wait) error-cooldown-minutes: 10 # Solver Main Configuration # Show the giant ASCII art banner in the console on startup? show-banner: true # AI Provider Configuration ai-provider: # Provider: 'anthropic', 'google' or 'other' provider: "anthropic" # Model to use # Anthropic: Sonnet, Haiku, Opus # Google: Pro, Flash # Other: Model name (e.g: gpt-4o, mistral-large) model: "Sonnet" # API Keys anthropic-key: "" google-key: "" # Configuration for the 'other' provider (OpenAI-compatible) other-key: "" other-url: "https://api.openai.com/v1/chat/completions" # Analysis configuration analysis: # Automatically analyze exceptions auto-analyze: true # Timeout for analysis (seconds) timeout: 60 # Save analysis to file save-to-file: true # Reports directory reports-directory: "crash-reports" # How many days to keep analyses saved in analysis-logs/ before deleting them. # 0 = keep forever. reports-retention-days: 0 # Notifications notifications: # Notify admins in-game when there's an error notify-admins: true # Send analysis to chat (in addition to console) send-to-chat: false # AI Chat Moderation (Fyrx reads chat and evaluates the CONTEXT of the conversation, # not a word blacklist. Enabling this sends chat content to the AI provider configured # above in 'ai-provider'. Disabled by default for privacy. chat-moderation: enabled: false # If true (default), OPs are automatically exempt from chat moderation. # Set to false so OPs are also examined like any other player. The # solver.moderation.bypass permission still works independently to exempt a specific # player (OP or not), regardless of this value. exempt-ops: true # Maximum recent messages to remember per player / globally buffer-size: 50 # Time window of context sent to the AI (minutes) context-window-minutes: 5 # How often (seconds) to check whether there's new chat to analyze (unconditional # sweep, never depends on the pre-filter: nothing can be hidden from the AI this way) analysis-interval-seconds: 45 # How to scan chat each cycle: # bulk: 1 single AI call with the whole mixed conversation. Cheap, but with many # players talking at once the AI can confuse who said what. # individual: 1 AI call PER player with new activity. The offender is already known # beforehand (the AI doesn't have to guess), so this eliminates that confusion # risk, but the cost scales with how many players are active per cycle - on a # busy server this can burn through the provider's rate limit fast. scan-mode: "bulk" # How often the AI actually gets called to check chat (0-3). scan-mode above decides HOW # the AI is called; this decides WHEN. # 0 = never call the AI - the pre-filter above decides entirely on its own (cheaper/faster, # less accurate; works with no AI provider configured at all). # 1 = only call the AI once the pre-filter already flagged something suspicious (balanced). # 2 = default/classic behavior: the AI reviews all new chat every cycle, regardless of # whether the pre-filter flagged anything. # 3 = real-time: every message is sent to the AI immediately as it arrives, instead of # waiting for analysis-interval-seconds (much faster reaction, at the cost of many more calls). llm-analysis-level: 2 # Lightweight pre-filter: computes an urgency score (0.0-1.0) combining several signals. # NEVER decides whether something is harassment nor blocks the analysis - the sweep # above still reads all the chat regardless. It only decides whether it's worth WAKING # Fyrx up early instead of waiting for the full interval, to react faster in obvious cases. pre-filter: # Raises the urgency score if the same player receives several messages in a row from # others (possible insistent harassment toward a fixed target). trigger-on-repeated-target: true # Fraction (0.0-1.0) of a message in UPPERCASE from which it's considered "shouted" # and adds urgency score (0.6 = 60% or more of the message in caps). trigger-on-caps-ratio: 0.6 # How many messages from a player need to build up before the pre-filter starts # evaluating the "repeated target" pattern described above. min-messages-before-trigger: 3 # Minimum score (0.0-1.0) to trigger an immediate analysis instead of waiting urgent-score-threshold: 0.65 # What to do when the AI reports a toxic/harassment verdict action: # alert-only: only notifies players with the solver.notify permission # warn-player: alert-only + a private notice to the flagged player # auto-action: warn-player + automatic mute/kick based on severity (1-5) mode: "alert-only" # Severity (1-5, set by the AI on each verdict) at which "auto-action" automatically # mutes the player instead of just warning them. severity-threshold-mute: 4 # Severity at which "auto-action" automatically kicks the player instead of muting them. # Should be >= severity-threshold-mute for the escalation to make sense. severity-threshold-kick: 5 # Duration in minutes of the automatic mute applied by "auto-action" when crossing # severity-threshold-mute (does not affect the manual /solver mute|tempmute). mute-duration-minutes: 10 # Optional: force a specific sanction type for specific "situations" (AI tags), regardless of # severity-threshold-mute/kick above - only used when mode is "auto-action". Valid tags: # TOXIC, HARASSMENT, THREAT, HATE_SPEECH, SCAM, SPAM. Valid types: warn, mute, tempmute, kick, # ban, tempban ('duration' required for tempmute/tempban, same s/m/h/d/w format as elsewhere). # If a verdict matches more than one configured tag, the harshest configured type wins. This # is also the only way to reach an automatic ban/tempban from chat moderation - the severity # thresholds above never go past kick on their own. tag-overrides: {} # THREAT: # type: tempban # duration: 7d # HATE_SPEECH: # type: tempban # duration: 3d # SCAM: # type: ban # Multi-signal corroboration: the AI verdict alone can only trigger a real warn/mute/kick # when it's at least this confident AND this severe. Below that, it also needs at least one # corroborating pre-filter signal (caps/insult/repeated-target/burst - see pre-filter above); # without one it stays as a staff-only alert for manual review via /solver check, never an # automatic sanction. Confidence 0-100, severity 1-5. min-confidence-to-act-alone: 85 min-severity-to-act-alone: 4 # Save every detected incident to moderation-reports/ log-incidents-to-file: true # Also show in console the result of /solver moderation test when a player # runs it (the console always sees it already if it's the one running the command). log-test-results-to-console: true # How many days to keep incidents saved in moderation-reports/ before deleting them. # 0 = keep forever. reports-retention-days: 0 # Whether these command groups can also be run directly without the /solver prefix (e.g. /vanish # instead of /solver vanish). /solver always keeps working either way regardless of # these settings. Turn a category off if another plugin you have installed already claims one of # its command names (e.g. EssentialsX also has /mute, /kick, /ban, /warn, /tempban, /tempmute, # /unmute, /unban) - Bukkit will otherwise let whichever plugin registers first keep the bare name. # /enderchest is the one exception handled automatically: if EssentialsX is detected, its # standalone form is skipped on its own (no need to toggle this whole category off for it) - # EssentialsX's /enderchest means "show MY OWN enderchest", a different meaning from ours. standalone-commands: staff-mode: true # /vanish, /freeze, /staffchat, /commandspy, /enderchest (unless EssentialsX is installed) sanctions: true # /warn, /mute, /tempmute, /kick, /ban, /tempban, /unban, /unmute, /unwarn, /history, /check, /note, /checkuser, /appeal, /sanctions moderation: true # /moderation reports: true # /report # Live relay of executed commands to whoever has toggled it on with /solver commandspy - not just # retrospective logging. commandspy: enabled: true # "*" watches every command. Otherwise list specific command names (without the leading /) to # watch only those, e.g. ["op", "gamemode", "give"]. watch-patterns: ["*"] # Player names (case-insensitive) never relayed, regardless of who's watching. exempt-players: [] # Anyone holding one of these permissions is never relayed either. exempt-permissions: [] # ⚠ BETA: Sanctions System (warn/mute/kick/ban via /solver, persistent history in # sanctions.db). Double-check /solver history after any sanction until you're fully # comfortable with how it behaves on your server. punishments: # Where sanction history is stored: sqlite (default, zero config, local file) or mysql # (for multi-server setups sharing one sanctions database). storage: sqlite # Only read when storage is mysql. mysql: host: localhost port: 3306 database: solver user: solver password: "" # Shortcut reason templates: "/solver ban Player #griefing" expands to the configured text # (and duration, if the sanction type needs one and none was given explicitly). Unmatched # #names are left as a literal reason, so this never breaks a reason that legitimately starts # with "#". reason-templates: {} # griefing: # text: "Griefing / destroying other players' builds" # duration: "1d" # Auto-escalation on warn count: after a WARN is recorded, if the player's total warn count # matches a key here, the configured action fires automatically. "action: sanction" applies # another sanction (type/reason/duration, same as a manual one); "action: command" runs a # console command instead ({player} is replaced with the player's name). warn-escalation: {} # "3": # action: sanction # type: kick # reason: "Auto: 3 warnings" # "5": # action: sanction # type: tempban # duration: "1d" # reason: "Auto: 5 warnings" appeals: # Show a line pointing to /solver appeal in warn/mute/kick/ban messages. show-in-sanction-message: true # ⚠ BETA: Staff Mode Toolkit (vanish/freeze/staff chat via /solver). staff-mode: vanish: # Also subtract vanished players from the online-player count shown in the server list (MOTD) hide-from-server-list: true # Also make a vanished player immune to damage while vanished. invulnerable-while-vanished: false freeze: # Commands allowed while a player is frozen (without the leading /) allowed-commands: ["msg", "tell", "r", "helpop"] # Named combined profiles for /solver staffmode - each toggles a bundle of the # individual staff tools at once instead of turning them on one by one. Every field is optional # and defaults to off. clear-inventory always saves your items first and restores them when you # leave the profile. profiles: {} # moderator: # vanish: true # freeze-immunity: true # flight: true # god-mode: true # clear-inventory: true # builder: # flight: true # /solver inspect - view a player's inventory without physically opening it. inspect: # Keep refreshing the opened inventory every few ticks instead of a one-time snapshot. This is # polling, not a real push update (Bukkit has no "inventory changed" event to react to). live-refresh: false live-refresh-interval-ticks: 10 ```

Commands

Base command: `/solver` (alias: `/as`). Most subcommands also work without the `/solver` prefix — see `standalone-commands` in `config.yml`. ## Commands /solver help: Displays the list of available commands. /solver reload: Reloads the plugin's configuration and messages. /solver analyze-last: Re-analyzes the last detected crash/error. /solver crashme : Triggers a synthetic error for testing the AI analysis pipeline. /solver moderation status: Shows the current chat moderation diagnostics (buffer, last verdict, action mode, scan mode, AI analysis level, etc). /solver moderation test : Runs a message through the AI moderation prompt without it being a real chat message. /solver warn : Issues a warning. Reason accepts a #template from reason-templates. /solver mute : Mutes a player indefinitely. /solver tempmute : Mutes a player for a set duration. /solver kick : Kicks a player. /solver ban : Bans a player indefinitely. Also instantly kicks any known alt already online. /solver tempban : Bans a player for a set duration. /solver unban : Lifts an active ban/tempban. /solver unmute : Lifts an active mute/tempmute. /solver unwarn : Revokes the player's most recent active warning. /solver history : Shows a player's full sanction history. /solver check : Shows the details of a single sanction by its ID. /solver note : Attaches a staff-only note to a player, without issuing a sanction. /solver checkuser : Cross-references IP history - shows every known alt account and any active sanction across that whole network. /solver appeal : Lets a sanctioned player appeal their own sanction in-game. Open to everyone by default. /solver appeal list|accept|reject : Staff review pending appeals. /solver sanctions : Opens a GUI browsing a player's full sanction history; click an active one for the exact revoke command. /solver report : Files a report against a player for staff attention. Open to everyone by default. /solver reports: Lists open reports. /solver reports claim|close|reopen [reason]: Manages the reports queue. Notifies the original reporter. /solver reports gui: Opens a GUI of open reports (left-click claims, right-click closes). /solver vanish [strict]: Toggles your own vanish (hidden from other players, mob targeting, join/quit messages, tab-complete, and the server list count). "strict" is a second tier invisible to most staff too. /solver freeze : Toggles a freeze on a player (can't move, can't run most commands, can't break/place blocks, can't deal or take combat damage). Always toggleable even by the frozen player themselves. /solver freeze : Sends a message in that player's private freeze chat channel instead of toggling. /solver staffchat: Toggles staff-chat mode (your normal chat messages go to staff only instead of public chat). /solver staffchat : Sends a one-off message to staff chat without toggling the mode. /solver commandspy: Toggles a live relay of other players' executed commands into your chat. /solver staffmode : Toggles a named combined profile (vanish/freeze-immunity/flight/god-mode/inventory-clear) defined in config.yml. /solver fly: Toggles flight, independent of any profile. /solver god: Toggles invulnerability, including PvP damage. /solver rtp: Teleports you to a random online non-staff player. /solver inspect : Opens a view of a player's inventory/armor/offhand without opening it; click an item to confiscate it. /solver enderchest : Same view/confiscate treatment for a player's ender chest.

Permissions

## Permissions solver.admin: Full access to every command below. Default: op. solver.notify: Receive error and chat-moderation staff alerts. Default: op. solver.moderation.bypass: Exempts this specific player from chat moderation, regardless of OP status. Default: false. solver.diagnostics.*: All diagnostics commands (reload/analyze-last/crashme/moderation). Default: false. solver.diagnostics.reload: Allows /solver reload. solver.diagnostics.analyzelast: Allows /solver analyze-last. solver.diagnostics.crashme: Allows /solver crashme. solver.diagnostics.moderation: Allows /solver moderation status|test. solver.sanctions.*: All sanctions commands. Default: false. solver.sanctions.warn: Allows /solver warn. solver.sanctions.mute: Allows /solver mute. solver.sanctions.tempmute: Allows /solver tempmute. solver.sanctions.kick: Allows /solver kick. solver.sanctions.ban: Allows /solver ban. solver.sanctions.tempban: Allows /solver tempban. solver.sanctions.unban: Allows /solver unban. solver.sanctions.unmute: Allows /solver unmute. solver.sanctions.unwarn: Allows /solver unwarn. solver.sanctions.history: Allows /solver history. solver.sanctions.check: Allows /solver check. solver.sanctions.note: Allows /solver note. solver.sanctions.checkuser: Allows /solver checkuser. solver.sanctions.appeal: Allows /solver appeal (submit your own). Default: true. solver.sanctions.appeal.manage: Allows /solver appeal list|accept|reject. solver.sanctions.gui: Allows /solver sanctions (history GUI). solver.reports.*: All staff reports commands. Default: false. solver.report: Allows /solver report (submit one). Default: true. solver.reports.manage: Allows /solver reports listing/claim/close/reopen. solver.reports.gui: Allows the reports GUI. solver.staffmode.*: All Staff Mode Toolkit commands. Default: false. solver.staffmode.vanish: Allows /solver vanish. solver.staffmode.vanish.see-strict: See through another player's strict-tier vanish. solver.staffmode.freeze: Allows /solver freeze. solver.staffmode.staffchat: Allows /solver staffchat. solver.staffmode.commandspy: Allows /solver commandspy. solver.staffmode.profiles: Allows /solver staffmode . solver.staffmode.fly: Allows /solver fly. solver.staffmode.god: Allows /solver god. solver.staffmode.rtp: Allows /solver rtp. solver.staffmode.silentjoin: Auto-vanish on join with no join message. solver.staffmode.inspect: Allows /solver inspect. solver.staffmode.enderchest: Allows /solver enderchest.

--- *Made with ♥️ by FyrxLab*

Solver

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details