# Nexa AI (Minecraft Mod + Paper Plugin)<\/p>\n
> Note: This page includes detailed information about the mod\/plugin. If it feels too much, you can skip straight to using it. Just install the mod\/plugin and run the command \/nexa Nexa AI adds an ai agent into Minecraft.<\/p>\n – Works as a **Fabric \/ Forge mod** (clients + servers) Players can talk to Nexa in chat and (with the right permissions) let it run server tools like teleporting, locating structures, changing weather\/time, and more.<\/p>\n ## Features<\/p>\n * Chat with Nexa directly: `\/nexa ## Supported Targets<\/p>\n * **Fabric**: Minecraft `1.21.11` and `1.20.1` ## Commands<\/p>\n ### Chat<\/p>\n * `\/nexa ### Configuration<\/p>\n * `\/nex-config clearchat` \u2014 clear your chat history ### BYOK (Bring Your Own Key)<\/p>\n BYOK is **per-player** and bypasses the default proxy for chat calls.<\/p>\n * `\/nex-byok status` \u2014 show BYOK status ## Modes<\/p>\n ### **Ask-before-act**<\/p>\n Nexa proposes an action preview and waits for confirmation before running any privileged tool.<\/p>\n Approve via the clickable buttons in chat, or with `\/nexa confirm` (deny with `\/nexa cancel`).<\/p>\n privileged tools are queued for approval (30s) and can be approved via `\/nexa confirm`.<\/p>\n ### **Autonomous**<\/p>\n Nexa can execute allowed tools without an explicit prompt. Guardrails still apply (cooldowns, limits, and required privileges).<\/p>\n ## AI Provider<\/p>\n ### **Default AI Service**<\/p>\n By default, Nexa uses the default services that are setup by me. It is free but you could expearence issue like rate limiting, overload, etc. So it is recommened to BYOK.<\/p>\n ### **BYOK Mode**<\/p>\n BYOK (Bring Your Own Key) lets each player use their own provider + key.<\/p>\n * Providers: **Google**, **OpenAI**, **OpenAI-compatible (custom endpoint)**, **Ollama**, **LM Studio** Note: BYOK settings (including API keys) are stored on the server in the world data file.<\/p>\n ## Permissions & Privileges<\/p>\n Nexa uses two permission nodes across all platforms:<\/p>\n * `nexa.use` \u2014 access to `\/nexa`, `\/nex-config`, and `\/nex-byok` ## Requirements & Installation<\/p>\n ### Java<\/p>\n * Minecraft **1.20.1**: typically runs on **Java 17** ### Install<\/p>\n * **Fabric**: install Fabric Loader + **Fabric API**, then drop the `nexa-fabric*.jar` into `.minecraft\/mods\/` Tip: the server-side commands work with just the server install; the Fabric\/Forge **GUI** is available when installed on the client.<\/p>\n ## Guardrails (Server)<\/p>\n * Agent mode: `ASK_BEFORE_ACT` or `AUTONOMOUS` ## Fair Use, Safety, and Privacy<\/p>\n * Community built: please don\u2019t abuse the service (rate limits\/guardrails exist for a reason). ### Logging & Data<\/p>\n * **Server\/world file:** Nexa stores persistent settings per-world in `chatmc_locations.json` (saved locations, mode\/guardrails, BYOK config, etc.). ## Support & Contributions<\/p>\n 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<\/span><\/p>\n","protected":false},"excerpt":{"rendered":" The Mod\/Plugin Introduces Nexa Ai Agent into the Minecraft. Your sidekick in minecraft! Accessible from the chat. You can talk to it anytime, even ask it to do actions. it has all context of you and environment so when it talks, you better listen.<\/p>\n","protected":false},"featured_media":110567,"template":"","meta":{"_minecraft_slug":"nexa-ai","_minecraft_project_id":"eFhkNO4w","_minecraft_author":"Mod_MC","_minecraft_license":"MIT","_minecraft_downloads":574,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nexa-ai.zip","_minecraft_size_bytes":1140613,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T10:25:17.305579Z","_minecraft_date_created":"2026-01-31T04:30:22.426752Z","_minecraft_date_modified":"2026-01-30T03:09:30.450733Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nexa-ai","_minecraft_icon_attachment_id":110567,"_minecraft_imported_at":"2026-06-06T11:59:55+00:00","_minecraft_import_hash":"00b777311aae318b6f741c4224ce2ce1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,97,104,127,128,867,129,123,92],"mod_loader":[99],"minecraft_version":[36,60,93,94,101,102,41],"class_list":["post-110566","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-fabric","mod_category-forge","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-fabric","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21-11"],"yoast_head":"\n
\n– Also available as a **Paper plugin**<\/p>\n
\n* Agent modes:
\n * **Ask-before-act** (default): privileged actions are previewed and require confirmation
\n * **Autonomous**: Nexa can execute allowed steps automatically (guardrails still apply)
\n* Per-player request limits + global cooldown (server guardrails)
\n* Custom assistant name + personality prompt
\n* Fabric\/Forge client UI (press **`N`** to open Nexa chat\/config)
\n* Built-in tools (\u201cfunction calling\u201d) for server-aware actions and lookups
\n* Optional join\/idle **auto messages** (can be turned off)
\n* Update notifications + feedback sending (via the proxy)<\/p>\n
\n* **Forge**: Minecraft `1.21.11` and `1.20.1`
\n* **Paper**: Minecraft `1.21.11`<\/p>\n
\n* `\/nexa confirm` \u2014 approve queued actions (ask before act)
\n* `\/nexa cancel` \u2014 cancel queued actions<\/p>\n
\n* `\/nex-config feedback
\n* `\/nex-config mode show` \u2014 show your current mode
\n* `\/nex-config mode
\n* `\/nex-config limits status` \u2014 show limits and cooldown
\n* `\/nex-config limits maxrequests <1..15>` \u2014 set max requests (**requires privileges**)
\n* `\/nex-config limits cooldown
\n* `\/nex-config custom name
\n* `\/nex-config custom prompt
\n* `\/nex-config custom reset` \u2014 reset name\/prompt to defaults (**server: requires privileges**)
\n* `\/nex-config custom show` \u2014 view your current custom settings
\n* `\/nex-config automessages enable|disable|status` \u2014 toggle join\/idle auto messages (server wide)<\/p>\n
\n* `\/nex-byok toggle enable|disable` \u2014 enable\/disable BYOK
\n* `\/nex-byok provider
\n* `\/nex-byok apikey
\n* `\/nex-byok endpoint
\n* `\/nex-byok model
\n* `\/nex-byok tools enable|disable` \u2014 enable\/disable tool calling (useful for local endpoints)
\n* `\/nex-byok test` \u2014 test current BYOK config<\/p>\n
\n* Configure via `\/nex-byok …` (or the Fabric\/Forge GUI)
\n* For best results, choose a model that supports **tool calling \/ function calling**<\/p>\n
\n* `nexa.admin` \u2014 administrative actions (guardrails + privileged tools)<\/p>\n
\n* Minecraft **1.21.11**: typically runs on **Java 21**<\/p>\n
\n* **Forge**: drop the `nexa-forge*.jar` into `.minecraft\/mods\/`
\n* **Paper**: drop `nexa-paper-
\n* Per-prompt request budget (`maxrequests`) and a global cooldown (`cooldown`)
\n* Privileged actions are previewed (and can be denied) in ask-before-act mode<\/p>\n
\n* AI provider terms: when using the default service, prompts\/responses are sent to Google Gemini. When using BYOK, your chosen provider\u2019s terms\/policies apply.
\n* Nexa can be wrong. Treat outputs as suggestions, especially for commands\/actions.
\n* Harmful, abusive, illegal, or exploitative use is not tolerated. Repeated abuse may lead to denial of service.<\/p>\n
\n * BYOK API keys are stored here (server-side). Only grant server file access to people you trust.
\n* **Feedback:** `\/nex-config feedback