Nexa AI — Forge, Fabric & Quilt

Nexa AI is a chat assistant AI agent added into Minecraft through modding. It's a server-side mod that lets players interact with the AI directly through Minecraft chat. It knows everything about you (in Minecraft) and can retrieve detailed information about the game world and environment. It can also perform actions like teleporting you or spawning mobs, if you have the required privileges.

Available as: Fabric & Forge mod | Paper plugin (To get the Paper plugin, visit the Curseforge, Modrinth or SpigotMC page of this project.) Curseforge link: Paper Plugin

Features

• Chat with Nexa directly: /nexa <message>
• Ask-before-act and Autonomous modes
• Per-player request limits and global cooldown.
• Give Custom name and Personality To your Ai agent.
• Dedicated custom UI to chat and adjust configs in forge and fabric modules. press `N` keybind to open the UI.
• Privileged tools with clear previews and confirmations
• Tooling examples: teleport, locate, set time, change weather, save/remove/list locations, player state, inventory summary, environment info, game rules, nearby entities, spawn entity, give effect

Commands

• /nexa <message> — chat with Nexa
• /nex-config clearchat — clear your chat history
• /nex-config feedback <message> — send feedback
• /nex-config mode show — show your current mode
• /nex-config mode <ask|autonomous> — set your mode
• /nex-config limits status — show limits and cooldown
• /nex-config limits maxrequests <1..15> — set max requests
• /nex-config limits cooldown <seconds> — set global cooldown
• /nex-config custom name <your-custom-name>: Change the name the AI uses.
• /nex-config custom prompt <personality-description>: Configure a custom personality prompt.
• /nex-config custom reset: Resets the name and personality to default "Nexa".
• /nex-config custom show: View your current custom settings.

Modes

Ask-before-act

Nexa proposes an action preview and waits for confirmation before running any privileged tool.

Autonomous

Nexa can execute allowed tools without an explicit prompt. Guardrails still apply (cooldowns, limits, and required privileges).

AI Provider

Default AI Service

• Get started by using Nexa ai chat at free of cost.
• Uses Google as provider for the ai models.

BYOK Mode

• Use Your own provider and key for the ai usage.
• Available provider options: Open AI, OpenAI compatible (custom providers), Google, Ollama and Lm studio.
• Ensure The model is decent quality and supports tool calling (function calling) for good quality responses.
• Use /nex-byok command to set up BYOK mode. you can also setup byok from GUI on forge and fabric.
• Ensure You correctly configure everything that is required for byok mode to work.

Player Capabilities

• Survival Players
  • Always allowed: chat (/nexa) and read-only info tools.
  • Privileged tools: require a privileged actor to run.
  • Fabric: on dedicated servers, an OP with permission level ≥ 2 must approve; on single-player servers, Creative players count as privileged.
• Creative Players
  • Fabric: Creative grants privileges only on non-dedicated (single-player) servers. On dedicated Fabric servers, use OP (permission level ≥ 2).

Admin Permissions (server)

• nexa.use — allows players to talk to the assistant.
• nexa.admin — allows staff to configure Nexa and perform privileged actions.

Requirements & Installation

• Java 21
• For fabric: Fabric Loader + Fabric API (Fabric)

Fabric: drop the mod jar into your .minecraft/mods/ folder along with the Fabric API.

Forge: drop the mod jar into your .minecraft/mods/ folder.

Configuration & Permissions

• Modes: ASK_BEFORE_ACT or AUTONOMOUS
• Global cooldown and per-player limits adjustable via /nex-config
• Fabric:
  • Dedicated: OPs with permission level ≥ 2 are privileged.
  • Single-player: Creative players are privileged.

Fair Use, Safety, and Privacy

• Community-built and free: This project is built and maintained by me. Please don’t abuse the service. I can’t afford misuse at scale.
• Gemini API usage: Nexa Uses Google’s Gemini API. Google’s services have their own data and privacy policies; your interactions with Gemini are subject to Google’s terms.
• Key protection via Cloudflare Worker: The Worker keeps the actual Gemini API key server-side and never ships it to clients. This ensures the keys are never exposed to the public.
• Safety and moderation: Harmful, abusive, illegal, or exploitative use of Nexa is not tolerated. If Nexa is used to generate or facilitate harmful content, the player may be banned.
• Abuse monitoring: The Cloudflare Worker tracks request metadata (e.g., counts and timestamps) and may store minimal logs only to detect abuse, rate limit, and maintain service continuity. No gameplay chat logs are sold or shared for advertising.
• Consequences: Repeated harmful usage or evasion of rate limits may result in denial of service for the origin or blacklisting.

Support & Contributions

If you encounter issues, have feedback, or wish to contribute to Nexa AI, please join my Discord server and report there. Discord: https://discord.gg/Wvst4znsgk