Thanks to visit codestin.com
Credit goes to github.com

Skip to content
/ PMMP-AI Public

Powerful ai assistant for pocketmine server with rich features and multi provider

License

RenzMc/PMMP-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

12 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

PMMP-AI Assistant

PMMP-AI Logo

๐Ÿค– Advanced AI Assistant for Minecraft Pocket Edition Servers

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.

Latest Release PocketMine-MP API License

โœจ Features

  • 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.

๐Ÿ“‹ Requirements

  • PocketMine-MP 5.15.0+
  • FormAPI plugin
  • Economy plugin (optional, for token system): EconomyAPI, BedrockEconomy

๐Ÿ“ฅ Installation

  1. Download the latest release from the releases page
  2. Place the .phar file in your server's plugins folder
  3. Install the required FormAPI plugin
  4. Restart your server
  5. Configure the plugin by editing the configuration files in the plugins/PMMP-AI folder

โš™๏ธ Configuration

PMMP-AI offers extensive configuration options through multiple YAML files:

config.yml

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

forms.yml

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

fiturserver.yml

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

๐ŸŽฎ Usage

Player Commands

  • /ai - Open the main AI Assistant interface

Admin Commands

  • /ai <question> - direct ai response in chat
  • /ai setup <provider> <apikey> <models> - quick settings ai in-game
  • /ai help - see all available command

๐ŸŽจ Customization

Form Customization

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"

Button Textures

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"

Text Formatting

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

๐Ÿ”ง API Integration

OpenAI Setup

  1. Get an API key from OpenAI
  2. Add your API key to the config.yml file:
api_providers:
  default_provider: "openai"
  openai:
    enabled: true
    api_key: "YOUR_OPENAI_API_KEY"
    model: "gpt-3.5-turbo"

Other Providers

The plugin also supports:

๐Ÿ“Š Token System

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

๐Ÿ“ License

This project is licensed under the MIT License.

๐Ÿ‘จโ€๐Ÿ’ป Author

๐Ÿ™ Acknowledgements

  • 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