AlexAI

AlexAI adds a talking AI character to your Minecraft server.

Spawn an NPC, walk up to it, and chat. It knows your position, inventory, biome, weather, and nearby players.

Works with Groq (free), OpenAI, OpenRouter, or local Ollama.

Features
- In-game NPC you can talk to in chat
- English or Italian (/ai language or config)
- Custom NPC skin (Minecraft username or UUID)
- Conversation memory saved to disk
- Looks at nearby players
- Optional world actions for ops: heal, give items, time, weather, teleport

Requirements
- Spigot 26.2 (Java 25)
- An API key, unless you use Ollama locally

Installation
1. Put AlexAI.jar in your plugins folder
2. Start the server once
3. Get a free Groq key: https://console.groq.com/keys
4. In-game (op): /ai setkey gsk_your_key
5. /ai npc spawn
6. Stand next to the NPC and talk

Commands
/ai help
/ai <message>
/ai npc spawn | remove | look | skin <player>
/ai clear
/ai language english|italian
/ai reload

Aliases: /ask, /alex

Permissions
alexai.use — everyone
alexai.npc, alexai.reload, alexai.actions — op

Config
plugins/AlexAI/config.yml
language: english or italian
npc.skin: Minecraft username
ai.save-memory: true

if you have some bugs feel free to contact me on discord: nonkyro