MCAIA 1.3.0

MCAIA 1.3.0

This release makes MCAIA safer, more responsive, and more compatible with modern Paper server setups.

Highlights

• Added Folia support with shared async, global, and entity scheduling.
• Added local Ollama support for running AI models without a hosted API key.
• Added configurable provider priority and improved smart provider/model fallback.
• Strengthened command safety with expanded blocked-command coverage.
• Added safer MiniMessage rendering that restricts unsafe interactive tags.
• Improved conversation history, follow-up replies, player lifecycle cleanup, and history summaries.
• Improved asynchronous file and Discord webhook logging.
• Added dynamic rate-limit configuration and clearer admin status information.
• Improved GitHub and Hangar update checks and admin notifications.
• Expanded documentation and configuration guidance.

Upgrade notes

• Requires Java 25.
• Supports Paper 26.2–26.3 and Folia.
• Review the new Ollama and provider-order settings if you want to use local or prioritized models.
• Review banned-commands.yml before enabling AI command execution on a live server.
• Always keep backups and review AI-issued commands carefully.

MCAIA 1.2.0

MCAIA 1.2.0

Added

• Multi-provider AI support for Gemini, Groq, OpenRouter, OpenAI, Anthropic Claude, and xAI Grok, with configurable provider priority and per-provider model fallback lists.
• Optional mcaia.player access mode. When enabled, player requests are limited to commands the player is permitted to run; mcaia.use retains administrator-level AI access.
• Live player command-permission context for the AI, with plugin-side permission enforcement before dispatch.
• Command-output feedback capture for AI-driven vanilla console commands, enabling multi-step tasks such as reading a seed or locating a structure before acting on the result.
• AI guidance for Minecraft structure syntax, including #minecraft:village for a structure tag and minecraft:stronghold for an individual structure.
• /aiadmin status reports configured providers and the active provider/model.

Improved

• Command safety checks now cover dangerous administrative commands, configured bans, namespaced labels, nested execute commands, and command chaining.
• The AI is instructed to treat command output as untrusted, verify actual results, and avoid inventing seed values or coordinates.
• Added Gemini and OpenRouter free-tier model candidates to the default model catalog. Availability and quotas depend on provider/account and may change.
• Removed bundled owner-webhook telemetry; admin webhook logging remains configurable.

Configuration

• Configure at least one provider API key under ai.providers.<provider>.api-key and choose model/provider order in models.yml.
• Player-scoped command mode is disabled by default. Set permissions.player-command-mode.enabled: true and grant mcaia.player to enable it.
• Review the updated config.yml, models.yml, and banned-commands.yml before upgrading.

Full Changelog: v1.1.0...v1.2.0

MCAIA 1.1.0

MCAIA 1.1.0

Stable release of MCAIA, the AI-powered Paper server administration plugin that connects Minecraft chat to Google Gemini.

Highlights

• Notifies users with the mcaia.admin permission when an update is available.
• Checks GitHub Releases (including pre-releases) and Hangar on startup and every 24 hours.
• Update notices link directly to the version on the publishing platform.

Install

1. Download MCAIA-1.1.0.jar and place it in the server plugins/ directory.
2. Start the server, configure plugins/MCAIA/config.yml with a Gemini API key, and set tos-accepted: true after reviewing the terms and privacy notices.
3. Restart the server.

Downloads

• MCAIA-1.1.0.jar — shaded Paper plugin.
• MCAIA-1.1.0.jar.sha256 — SHA-256 checksum.

Review the README safety and privacy notes before use.

MCAIA 1.0.5

MCAIA 1.0.5 — Development preview

MCAIA is an AI-powered Paper server administration plugin that connects Minecraft chat to Google Gemini.

Highlights

• Gemini can execute server console commands and inspect messages returned by the command sender in its next decision.
• Captured output is capped at 8,000 characters and explicitly marks truncation.
• AI instructions require it to inspect command output, avoid assuming success from dispatch status alone, and treat output as untrusted data.
• Includes refreshed project documentation and server metrics through bStats.

Install

1. Download MCAIA-1.0.5.jar and place it in the server plugins/ directory.
2. Start the server, configure plugins/MCAIA/config.yml with a Gemini API key, and set tos-accepted: true after reviewing the terms and privacy notices.
3. Restart the server.

Downloads

• MCAIA-1.0.5.jar — shaded Paper plugin.
• MCAIA-1.0.5.jar.sha256 — SHA-256 checksum.

This is a development pre-release. Test on a non-production server, keep backups, and carefully review the README safety and privacy notes. The command blocklist is not a complete security boundary.

MCAIA 1.0.0

MCAIA 1.0.0 — Development preview

MCAIA is an AI-powered Paper server administration plugin that connects Minecraft chat to Google Gemini.

Highlights

• Natural-language server questions and administration requests through /ai.
• Multi-step AI interactions with live server data, follow-up questions, and console command execution.
• Configurable command blocklist, permissions, rate limiting, conversation history, and model fallback.
• Optional LuckPerms/Vault and Geyser/Floodgate integrations.

Important

This is an early development preview. Expect changes and bugs; test on a non-production server and keep backups. Review the README safety and privacy notes before installing. A Gemini API key and explicit Terms of Service acceptance are required.

Downloads

• MCAIA-1.0.0.jar — Paper plugin (built from source at this release tag).
• MCAIA-1.0.0.jar.sha256 — SHA-256 checksum for verifying the JAR.

See the repository README for installation, configuration, permissions, privacy/telemetry details, and contribution guidance.