PMMP-AI is a powerful AI assistant plugin for PocketMine-MP servers that integrates multiple AI providers to enhance your Minecraft server experience. The plugin offers a wide range of features including AI chat, crafting help, building calculations, server information, and more.
- Multi-Provider AI Integration: Support for OpenAI, Anthropic, Google AI, OpenRouter, and local AI models
- Interactive Chat: Talk directly with AI to get help with Minecraft-related questions
- Crafting Helper: Get crafting recipes for any item in the game
- Building Calculator: Calculate required materials for your building projects
- Server Information: Access server stats, rules, and features
- Token System: Optional economy integration with configurable token packages
- Chat History: Save and review past conversations with the AI
- Fully Customizable: Extensive configuration options for all aspects of the plugin
- Broadcast System: Configurable AI tips broadcast to players
- HTTPS REQUEST Asynchronous HTTPS requests with secure header masking, retries, and use PocketMine BulkCurlTask.
- PocketMine-MP 5.15.0+
- FormAPI plugin
- Economy plugin (optional, for token system): EconomyAPI, BedrockEconomy
- Download the latest release from the releases page
- Place the
.pharfile in your server'spluginsfolder - Install the required FormAPI plugin
- Restart your server
- Configure the plugin by editing the configuration files in the
plugins/PMMP-AIfolder
PMMP-AI offers extensive configuration options through multiple YAML files:
The main configuration file contains settings for:
- API providers (OpenAI, Anthropic, Google AI, OpenRouter, Local AI)
- AI prompt settings
- Message settings
- Server information
- Token system
- Chat history
- Advanced settings
The forms configuration file allows you to customize all UI elements:
- Form titles and content
- Button texts and colors
- Button textures
- Form layouts
- Text formatting
This file contains information about your server's features that the AI can use to help players:
- Economy features
- Land protection systems
- Teleportation commands
- Custom enchantments
- Minigames
- Voting systems
- Ranks and more
/ai- Open the main AI Assistant interface
/ai <question>- direct ai response in chat/ai setup <provider> <apikey> <models>- quick settings ai in-game/ai help- see all available command
All forms can be fully customized through the forms.yml file:
# Example: Customizing the main form
main_form:
title: "My Custom AI"
content: "Welcome to my custom AI assistant!"
buttons:
chat:
text: "Talk to AI"
color: "{primary}"
texture: "textures/ui/chat_icon"You can customize button textures using Minecraft's built-in textures or your own resource pack:
button_textures:
chat: "textures/ui/chat_icon"
crafting: "textures/ui/crafting_icon"
building: "textures/ui/building_icon"Customize text colors and formatting throughout the plugin:
text_formatting:
title: "&l&b" # Bold Aqua
subtitle: "&l&e" # Bold Yellow
heading: "&l&6" # Bold Gold
content: "&7" # Gray- Get an API key from OpenAI
- Add your API key to the
config.ymlfile:
api_providers:
default_provider: "openai"
openai:
enabled: true
api_key: "YOUR_OPENAI_API_KEY"
model: "gpt-3.5-turbo"The plugin also supports:
- Anthropic Claude
- Google AI (Gemini)
- OpenRouter
- Local AI models (self-hosted)
The plugin includes an optional token system that integrates with economy plugins:
- Players receive free daily tokens
- Additional tokens can be purchased with in-game currency
- Configurable token packages and prices
- Support for multiple economy plugins
This project is licensed under the MIT License.
- Renz - GitHub
- PocketMine-MP team for the amazing server software
- jojoe77777 for the FormAPI plugin
- All contributors and testers who helped improve this plugin
- This work builds upon the concept introduced in the ChatPM-GPT project. I am grateful to the author for sharing their innovation and making this development possible. https://github.com/HBIDamian/ChatPM_GPT