<\/p>\n
> ### The AI agent built for Minecraft.<\/p>\n
\n
\n
\n
\n
\n
\n<\/p>\n
Comparator brings a fully conversational AI agent to your Paper server; with multi-turn memory, built-in tools, and an API to extend it on your own.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### \ud83e\udd16 Conversational AI Agent
\nEmbed a fully conversational AI agent directly into your Minecraft server. Comparator maintains context across messages for natural, coherent dialogue; not just one-shot responses.<\/p>\n
### \ud83d\udd27 Built-In Tools
\nThe agent can to more than just chat. Comparator ships with several built-in tools the AI can invoke to give accurate, grounded answers:<\/p>\n
| Tool | Description |
\n|——————|————————————————————————————————————————————————————|
\n| **Web Search** | Searches the web for up-to-date information, so the agent isn’t limited to its training data |
\n| **Current Date** | Retrieves the current date, helping the agent reason about how recent its knowledge is |
\n| **Game Version** | Fetches the server’s running Minecraft version so answers are version-accurate |
\n| **Player Info** | Retrieves the player’s surroundings, inventory, nearby entities, biome, game mode, and what they’re looking at. This enables contextual in-game assistance |<\/p>\n
### \ud83c\udf10 Embedded Web Panel
\nComparator includes a built-in web panel served directly from the plugin via an embedded server. It gives server admins a live view into conversations, tool runs, and registered tools with real-time updates. No separate deployment needed; just configure the host and port in `comparator.conf` and run `\/comparator panel start` to launch it.<\/p>\n
### \ud83e\udde9 Extensible Tool API
\nThird-party plugins can register their own tools using the Comparator API. Defining a tool is as simple as annotating a function:<\/p>\n
“`kotlin
\n@ToolFunction(“give_item”, “Gives an item to the requesting player”)
\nsuspend fun giveItem(
\n @ToolParameter(“The item to give”) item: String,
\n context: ToolContext
\n): GiveResult {
\n val player = context.bukkitPlayer ?: throw ToolException(“No player context”, null)
\n \/\/ …
\n}<\/p>\n
\/\/ Register during ToolRegistrationEvent
\nevent.registry.register(tool(::giveItem))
\n“`<\/p>\n
The API handles parameter validation, type checking, serialization, and error reporting automatically. See the API docs for full details.<\/p>\n
### \ud83d\udd12 Designed for Responsible AI Use
\nComparator was built with safety and transparency in mind. This sets it apart from plugins that simply wrap an AI API with no guardrails:<\/p>\n
– **Permission-gated access** \u2014 All commands and public chat interactions respect Bukkit permissions, giving server admins fine-grained control over who can use the agent and who can manage it.
\n– **Configurable system prompt** \u2014 The agent’s behavior, persona, and constraints are fully configurable. The default prompt explicitly instructs the agent to stay on-topic, avoid fabricating information, and flag when its knowledge may be outdated.
\n– **Context scoping** \u2014 Conversations are isolated per-player, per-console, and for public chat. A player cannot read or pollute another player’s conversation history.
\n– **Automatic context expiry** \u2014 Conversation history expires after a configurable period of inactivity, limiting unintended data retention.
\n– **Tool result and parameter validation** \u2014 Tool inputs are validated against declared parameter types and constraints before execution. The agent cannot invoke a tool with malformed arguments.
\n– **Queue-based message handling** \u2014 Each conversation runs through a bounded channel. If a player floods the agent with messages, excess requests are rejected gracefully rather than queued unboundedly.
\n– **Structured error handling** \u2014 Tool failures are surfaced to the model as descriptive errors, not raw stack traces or internal state.<\/p>\n
### \u26a1 High-Performance, Non-Blocking Architecture
\nBuilt on Kotlin coroutines for fully non-blocking execution. AI requests, tool calls, and context operations never block the server thread, so the agent has no impact on server tick performance.<\/p>\n
### \u2728 Flexible AI Provider Support
\nIntegrates with Ollama, supporting both cloud-hosted and self-hosted models. Configure your model, base URL, and optional API key in `comparator.conf`.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download the plugin `.jar` from Modrinth or GitHub Releases
\n2. Place the `.jar` in your server’s `plugins\/` folder
\n3. Restart your server
\n4. Follow the quickstart guide to complete setup<\/p>\n
—<\/p>\n
## Usage<\/p>\n
**Ask in private (DM-style):** **Mention in public chat:** For full usage information, see the documentation.<\/p>\n —<\/p>\n ## Support<\/p>\n – Plugin Documentation —<\/p>\n ## Contributing<\/p>\n Contributions are welcome!<\/p>\n 1. Fork the repository Please follow the existing code style and include tests where applicable. For more details, see CONTRIBUTING.md.<\/p>\n —<\/p>\n ## Credits<\/p>\n – Main icon: *circuit* by Skena Grafis from The Noun Project (CC BY 3.0)<\/p>\n","protected":false},"excerpt":{"rendered":" The AI agent built for Minecraft<\/p>\n","protected":false},"featured_media":44772,"template":"","meta":{"_minecraft_slug":"comparator","_minecraft_project_id":"MQoLAFN8","_minecraft_author":"fletchly","_minecraft_license":"Apache-2.0","_minecraft_downloads":55,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"comparator.zip","_minecraft_size_bytes":156978941,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-15T20:55:28.907851Z","_minecraft_date_created":"2026-03-04T22:48:43.650803Z","_minecraft_date_modified":"2026-04-30T18:05:32.858678Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/comparator","_minecraft_icon_attachment_id":44772,"_minecraft_imported_at":"2026-06-02T03:26:22+00:00","_minecraft_import_hash":"66259821adf146651644803878bed9e9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,127,867,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-44771","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n“`
\n\/ask
\n“`
\n@bot
\n– API Documentation
\n– Discord
\n– GitHub Issues<\/p>\n
\n2. Create a feature branch: `git checkout -b feature\/my-feature`
\n3. Commit your changes: `git commit -m “Add my feature”`
\n4. Push and open a Pull Request<\/p>\n