MAssistant

MAssistant brings the power of Artificial Intelligence directly into your Spigot or Paper server. Stop remembering complex command syntax or browsing wikis-just ask your assistant to do it for you!

Whether you need a chat companion to liven up the server, a lore generator, or a powerful administrative tool, MAssistant understands natural language and the context of your game (your location, world, and username).

Why MAssistant?

• 🗣️ Natural Language Commands: Don't type /time set day or /weather clear. Just type ?Make it sunny or ?It's too dark here.
• 🌍 Context Awareness: The AI knows who you are, which world you are in, and your current coordinates. You can say ?Spawn a zombie right here and it will know exactly where "here" is.
• 🛡️ Secure by Design:
  • Double-Layer Security: Command execution requires both a configuration toggle AND a specific permission node (massistant.command).
  • Smart Selectors: The AI is trained to use safe selectors like @p instead of hard-coding player names.
• ⚡ Zero Lag: All AI processing happens asynchronously, ensuring your server TPS never drops while the assistant is thinking.

How to Use

1. Install: Drop the MAssistant.jar into your plugins folder and restart.
2. Chat: Start any message with ? (configurable) to talk to the AI.
   • Player: ?How do I craft a shield?
   • Admin: ?Give me a diamond sword with sharpness 5.
   • Admin: ?Teleport me to the surface.

Permissions

MAssistant features a granular permission system to keep your server safe.

Configuration

You can customize the plugin behavior in plugins/MAssistant/config.yml.

# ==========================================
# MAssistant Configuration
# ==========================================

# The character used to trigger the AI (Default: ?)
trigger-prefix: "?"

# Security: Allow the AI to execute commands globally?
# Even if set to 'true', the player MUST also have the permission 'massistant.command'.
# Set to 'false' to force a chat-only mode for everyone.
allow-commands: true

Commands

/aireload

• Description: Reloads the configuration file instantly.
• Permission: massistant.admin

Technical & Privacy Note ⚠️

External Service: This plugin communicates with the ninario.fr AI Proxy to process natural language. This is required for the AI functionality to work.

Data Transmission: Only the player's name, current world, coordinates, and the text of the prompt are sent to the API. No other server data is shared.