ModsJava
NexusAI
Java mod listed for Minecraft 1.20–26.x. Downloads from the MC Java Mods app on Android.
⬇ Download on SpigotAsynchronous AI bridge for Paper via PlaceholderAPI: unique answer pools, TTL cache, prewarm.
For server admins and plugin developers. Menus, chat and hologram plugins get AI text through NexusAI placeholders. It is not a chat bot for players.
How it works
![[IMG]](//proxy.spigotmc.org/7a83c375161234f14abdca037d24b19e4939ec4f/68747470733a2f2f63646e2e6d6f6472696e74682e636f6d2f646174612f364f4c38495358652f696d616765732f666139313164393962616235386435356139353066326433303861663166373333393163613835662e706e67)
Features
- %ainexus_generate_<prompt>%: unique answer pool. Each read takes one stored answer, and the pool refills in the background.
- %ainexus_cached_<prompt>%: shared TTL cache, useful for holograms.
- Named prompts in prompts.yml: keep long prompts under a short id, e.g. %ainexus_cached_survival_tips%.
- Prewarm and pool vars, for example {player_name} becomes %player_name% per player.
- Built-in variables {player}, {world}, {biome}, {time}, {weather} work without PlaceholderAPI.
- Format presets per prompt: chat, gui, name, hologram, actionbar, bossbar, with length limits and markdown stripping.
- OpenAI-compatible providers: openai, groq, cerebras, gemini, deepseek, openrouter, ollama, or any custom URL. Several keys per provider, ${ENV_VAR} in keys or a key file (api-key-file), keys masked in logs. Local endpoints need no API key.
- Model queue (failover or round-robin): switches to the next provider or model on 429, errors, low rate-limit budget or a daily cap, and comes back after the cooldown.
- Rate limits per server and per player, per-prompt backoff, provider pause on HTTP 401/402/429.
- Prompt-injection protection: player values are sanitized and fenced, and replies that leak or follow them are discarded.
- Reply cleaning: replies lose colour codes, hex colours, MiniMessage tags and JSON click or hover components before menus, scoreboards or chat plugins show them. sanitize.allow-markup (default false) keeps hex and tags for placeholders; enable it only if you understand the risk.
- Dialogues: /nai talk <id> talks to a character from prompts.yml, with memory, optional summaries of older lines and per-player limits. NPC plugins can run it from the console.
- Context providers: other plugins can add player context (balance, rank, quest) to prompts that list context:. Providers never run on the main thread.
- Actions: a character can trigger only commands you define, with cooldowns, daily limits and permissions.
- Fallback model when the whole queue is unavailable, and a knowledge folder (knowledge/*.md) for lore and rules.
- Chat moderation (opt-in, off by default): flags reach staff, nobody is punished automatically.
- 15 locales • /nai help / version / reload / status / test / prompts / talk
Setup
- Paper or Purpur 1.20.6–26.2 (Java 21+) + PlaceholderAPI 2.11.6+. Folia is not supported.
- Drop the jar into plugins/
- Set NEXUSAI_API_KEY, providers.<id>.api-key (supports ${ENV_VAR}) or providers.<id>.api-key-file. Not needed for Ollama or other local endpoints. An older config (0.6.0 or newer) is updated automatically: missing keys are added, with a .bak backup.
- Restart the server, or run /nai reload after editing the config
License: MIT — Copyright (c) 2026 mo00Wy
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
NexusAI is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.2. Downloaded 44 times (via Spigot). Download it and open it directly in the game.