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.

Permission Node	Default	Description
massistant.chat	True (Everyone)	Allows the player to chat with the AI using ?. If they ask for a command without the command permission, the AI will politely refuse.
massistant.command	OP (Admins)	Allows the AI to actually execute Minecraft commands on behalf of this player.
massistant.admin	OP (Admins)	Allows access to administrative commands like /aireload.

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.