CoreAI

CoreAI is a powerful, extensible plugin that integrates OpenAI directly into your Minecraft server — now with support for image generation!

• Per-player secure API keys (AES-GCM encrypted on disk)
• Full conversation memory with ChatGPT-style context
• Dynamic model picker GUI with support for any available model
• AI image generation and map tiling with `/imagegenmap`
• ️ Render images from URLs directly to maps with `/imagemap`
• Auto-cleanup system for unused generated image maps
• ⚡ Async calls for maximum performance and stability
• Beautiful Adventure-style messages with clickable components

✨ Commands

/chat <message> — Talk with ChatGPT directly in-game
/setapikey — Store your personal OpenAI API key securely
/models — Browse and pick from your key’s supported models
/modelinfo — View metadata about your selected model
/imagemap <url> — Render any image to a map (supports tiling with `WxH`)
/imagegenmap <prompt> — Generate an image from a prompt (AI DALL·E)
/cleanup — Manually remove old, unused map image files

API Key Security

- Keys are stored using AES-GCM encryption on disk
- No keys are ever printed to console or chat logs
- Not even server owners can read stored player keys

Map Image Cleanup System

Generated map tiles are stored on disk and reloaded after restarts. CoreAI tracks "last seen" usage of every map (inventory, item frames, ground items).
You can configure:

- cleanup.auto-enabled = true/false
- cleanup.max-age-days = Days until image is considered unused
Manual cleanup is possible via `/cleanup`.

⚙️ Setup Instructions

1. Drop CoreAI.jar into your `/plugins/` folder
2. Restart your server
3. (Optional) Set a default API key in `config.yml`
4. (Optional) Players can use /setapikey to store a personal key
5. Start chatting or generating maps!

Requirements
- Minecraft 1.21.4+
- Java 21+
- Paper / Spigot / Purpur compatible