# OpenRouter Chatbot – Minecraft Plugin<\/p>\n
## Overview<\/p>\n
OpenRouter Chatbot is a powerful and highly configurable Spigot plugin that integrates the OpenRouter AI API into your Minecraft server. It allows players and server administrators to interact with a variety of AI models directly in-game, with support for web search, dynamic model switching, and extensive customization. This plugin is designed to be a seamless and immersive addition to any server, providing both utility and entertainment.<\/p>\n
## Core Features<\/p>\n
– **In-Game AI Chat**: Access a powerful AI chatbot from both the server console and in-game chat.
\n– **Dynamic Model Switching**: Change the active AI model on the fly with a simple command. The plugin supports tab-completion for model names, making it easy to find and select the perfect model for your needs.
\n– **Universal Web Search**: By appending `:online` to the model name, you can enable web search for any query, allowing the AI to provide up-to-date information on any topic.
\n– **Intelligent Context Extension**: The plugin can automatically detect and use a model’s extended context version (e.g., `:extended`), providing a larger context window for more complex conversations.
\n– **Highly Configurable**: Nearly every aspect of the plugin is customizable via a detailed `config.yml` file. You can control everything from message formats and colors to advanced API parameters like temperature and token limits.
\n– **Fine-Grained Permission Control**: You have complete control over who can use the plugin’s commands. Each command can be configured to require operator (OP) status or a specific permission node.
\n– **Public or Private Messaging**: Configure the plugin to broadcast AI interactions to the entire server or keep them private to the user who initiated the prompt.<\/p>\n
## Commands and Permissions<\/p>\n
The plugin’s commands are simple and intuitive:<\/p>\n
| Command | Description | Permission Node | Default | You can change the default permission requirements in the `config.yml` file.<\/p>\n ## Installation and Setup<\/p>\n 1. **Download**: Get the latest release of `OpenRouterChatbot.jar` from the project’s releases page. ## How It Works<\/p>\n The plugin operates by making asynchronous calls to the OpenRouter API. This means that the server’s main thread is never blocked, preventing any lag or performance issues. When a user issues a command, the plugin immediately sends a “Thinking…” message (if enabled) and then sends the request to the API in the background. Once the API responds, the plugin schedules a task to send the AI’s response back to the user in the main server thread, ensuring thread safety.<\/p>\n On startup, the plugin also fetches and caches a list of all available models from the OpenRouter API. This allows for fast tab-completion of model names and enables the intelligent extended context feature without making an API call for every command.<\/p>\n ## Configuration File (`config.yml`) Explained<\/p>\n This section provides a detailed, toggle-by-toggle explanation of every setting available in the `config.yml` file.<\/p>\n ### `Primary Settings`<\/p>\n – `openrouter-api-key`: This is where you must paste your unique API key from OpenRouter. The plugin will not work without it. ### `command-permissions`<\/p>\n This section allows you to control who can use the plugin’s commands.<\/p>\n – `require-op-for-ai`: If set to `true`, only server operators (OPs) or players with the `openrouterchatbot.use` permission can use the `\/ai ### `features`<\/p>\n This section contains toggles for various plugin behaviors.<\/p>\n – `send-thinking-message`: If `true`, a “Thinking…” message will be sent to the user after they submit a prompt, providing feedback that the request is being processed. ### `message-visibility`<\/p>\n – `broadcast-to-server`: If `true`, all messages related to AI interactions (prompts, “Thinking…” messages, and responses) will be broadcast to all players on the server. If `false`, these messages will only be visible to the player who used the command.<\/p>\n ### `message-formatting`<\/p>\n This section allows you to customize the appearance of all plugin messages. You can use standard Minecraft color codes (e.g., `&a` for green) and the following placeholders: ### `api-settings`<\/p>\n This section gives you direct control over the parameters sent to the OpenRouter API. It is recommended for advanced users.<\/p>\n – `instructions`: A system prompt that guides the AI’s personality and behavior. OpenRouter Chatbot is a powerful and highly configurable Spigot plugin that integrates the OpenRouter AI API into your Minecraft server.<\/p>\n","protected":false},"featured_media":116451,"template":"","meta":{"_minecraft_slug":"openrouter-chatbot","_minecraft_project_id":"50Lnnql8","_minecraft_author":"nickkostik","_minecraft_license":"Apache-2.0","_minecraft_downloads":36,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"openrouter-chatbot.zip","_minecraft_size_bytes":83475,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:53:00.054308Z","_minecraft_date_created":"2025-08-07T02:19:03.398740Z","_minecraft_date_modified":"2025-07-31T13:53:54.516922Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/openrouter-chatbot","_minecraft_icon_attachment_id":116451,"_minecraft_imported_at":"2026-06-06T20:29:36+00:00","_minecraft_import_hash":"36d521efb2d7a2e82fae4971d82c9d42","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,873,122,126,127,128,867,129,91,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[81],"class_list":["post-116450","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-library","mod_category-magic","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-8"],"yoast_head":"\n
\n| — | — | — | — |
\n| `\/ai
\n| `\/ai set
\n| `\/ai reloadmodels` | Refreshes the cached list of available models from the OpenRouter API. | `openrouterchatbot.reload` | Operators |<\/p>\n
\n2. **Install**: Place the `OpenRouterChatbot.jar` file into your server’s `plugins` directory.
\n3. **First Run**: Start your server. The plugin will generate its default configuration file at `plugins\/OpenRouterChatbot\/config.yml`.
\n4. **Configure**: Stop the server and open the `config.yml` file with a text editor.
\n – **API Key**: The most important step is to add your OpenRouter API key to the `openrouter-api-key` field. You can obtain a key from https:\/\/openrouter.ai\/keys.
\n – **Customize**: Review the rest of the `config.yml` file and customize it to your liking. The file is extensively commented to explain every option.
\n5. **Restart**: Start your server again. The plugin is now configured and ready to use.<\/p>\n
\n– `model`: This setting determines the default AI model that the plugin will use. You can find a list of available models on the OpenRouter website. This can be changed in-game with `\/ai set`.<\/p>\n
\n– `require-op-for-set`: If set to `true`, only OPs or players with the `openrouterchatbot.set` permission can use the `\/ai set` command. If `false`, anyone can change the model.
\n– `require-op-for-reload`: If set to `true`, only OPs or players with the `openrouterchatbot.reload` permission can use the `\/ai reloadmodels` command. If `false`, anyone can reload the model cache.<\/p>\n
\n– `enable-web-search`: If `true`, the plugin will automatically add the `:online` suffix to the model name, enabling the AI to search the web for up-to-date information.
\n– `enable-extended-context`: If `true`, the plugin will check if the selected model has an `:extended` version and use it if available. This provides the AI with a larger memory for longer conversations.
\n– `display-user-prompt`: If `true`, the user’s original prompt will be displayed in the chat before the AI’s response. This is useful for context in public conversations.
\n– `include-player-name-in-prompt`: If `true`, the name of the player who sent the prompt will be prepended to the message sent to the AI (e.g., “Notch: What is a creeper?”). This can help the AI tailor its response.<\/p>\n
\n– `%player%`: The name of the player who used the command.
\n– `%prompt%`: The prompt that the player sent.
\n– `%model%`: The AI model that was used.<\/p>\n
\n– `temperature`: Controls the randomness of the AI’s responses. Higher values (e.g., 1.2) will result in more creative but less predictable responses, while lower values (e.g., 0.5) will make the responses more focused and deterministic.
\n– `max_tokens`: The maximum length, in tokens (roughly words), of the AI’s response.
\n– `top_p`: An alternative to temperature for controlling randomness. It’s recommended to only use one of `temperature` or `top_p`.
\n– `frequency_penalty` and `presence_penalty`: These settings can be used to discourage the AI from repeating itself.
\n– `stop`: A list of words or phrases that will cause the AI to immediately stop generating text.
\n– `seed`: If you provide an integer seed, the AI will produce the same output for the same prompt every time. This is useful for testing.
\n– `transforms`: A list of transformations to apply to the model’s output.
\n– `route`: The routing strategy for the API call.<\/p>\n","protected":false},"excerpt":{"rendered":"