Make players experience better with ChatGPT included into your server !

Overview

MyGPT is a paper plugin that seamlessly integrates OpenAI's GPT models into your Minecraft server. This plugin enables players to interact with any OpenAI model through simple in-game commands, creating unprecedented opportunities for enhanced gameplay, community engagement, and server innovation.

Key Features and Advantages

Performance Optimized

• Asynchronous Processing: All API calls are handled asynchronously to ensure zero server performance impact
• Lightweight Architecture: Minimal memory footprint with clean, efficient code structure

Advanced Configuration System

• Flexible Model Selection: Support for multiple OpenAI models including GPT-3.5-turbo, GPT-4, GPT-5... You can find theme here: https://platform.openai.com/docs/models
• Contextual AI Behavior: Customizable context settings allow you to define AI personality and response style
• Response Control: Configurable token limits and temperature settings for precise response management
• Live Configuration Reload: Update settings without server restarts using admin commands

Security and Access Control

• Permission-Based System: Granular control over who can access AI features

Why would you use it ?

• Player Support: Instant help and guidance for game mechanics and server rules
• Creative Assistance: Building ideas, design inspiration, and architectural guidance
• Educational Content: Learning assistance for redstone, farming, and advanced gameplay
• Community Engagement: Interactive conversations and entertainment for players
• Administrative Support: Quick answers to common player questions

Installation and Configuration Guide
Prerequisites

• Minecraft Server 1.21 or higher
• Java 21 or higher
• Paper, Spigot, or Bukkit server software
• OpenAI API account and key

Step 1: Plugin Installation

1. Download the latest MyGPT JAR file from the releases section
2. Place the JAR file in your server's plugins directory
3. Restart your server to generate configuration files

Step 2: OpenAI API Setup

1. Navigate to the OpenAI Platform at https://platform.openai.com/api-keys
2. Create an account or log into your existing account
3. Generate a new API key for your application
4. Securely store your API key for configuration (you can see it only once so be careful !)

Step 3: Plugin Configuration
Navigate to plugins/MyGPT/config.yml and configure the following parameters:

Step 4: Permission Configuration
Add the following permissions to your permission management system:

Step 5: Testing and Validation

1. Execute /mygptadmin reload to load your configuration
2. Test the plugin with /mygpt How can you help me in Minecraft?
3. Verify responses are generated correctly and performance remains stable

Usage Instructions
Player Commands
/mygpt <prompt>

Examples of effective usage:

• /mygpt Explain how redstone repeaters work
• /mygpt What are the best strategies for finding ancient debris?
• /mygpt Give me creative ideas for a fantasy castle design

Administrative Commands
/mygptadmin reload

Reloads plugin configuration without requiring a server restart.

Advanced Configuration Options
Model Optimization

• GPT-3.5-turbo: Optimal for general usage with excellent cost-performance ratio
• GPT-4: Superior reasoning and complex problem-solving capabilities
• GPT-4-turbo: Latest model with enhanced performance and reduced latency

Temperature Settings Guide

• 0.0-0.3: Factual, consistent responses ideal for help documentation
• 0.4-0.7: Balanced creativity suitable for general server interaction
• 0.8-1.2: Creative responses perfect for building inspiration and roleplay
• 1.3-2.0: Highly creative, unpredictable responses for entertainment

Context Configuration Examples
Technical Support Server:

context: "You are a technical Minecraft expert. Provide accurate, detailed explanations for game mechanics and server features."

Creative Building Server:

context: "You are an architectural consultant for Minecraft builders. Inspire creativity while providing practical building advice."

Roleplay Server:

context: "You are a wise scholar in a fantasy realm. Respond in character with medieval speech patterns and mystical knowledge."


Technical Specifications
System Requirements

• Server Software: Paper 1.21+, Spigot 1.21+, or Bukkit 1.21+
• Java Version: Java 21 or higher
• Memory Usage: Minimal impact (under 50MB additional RAM)
• Network: Stable internet connection for OpenAI API communication

Dependencies

• No external plugin dependencies required

Performance Characteristics

• Asynchronous Operations: Zero main thread blocking
• Connection Pooling: Efficient HTTP connection management
• Error Resilience: Graceful degradation during API outages
• Resource Optimization: Minimal CPU and memory overhead

Cost Considerations
MyGPT is completely free to download and use. The only costs involved are the OpenAI API usage fees, which are extremely affordable:

• GPT-3.5-turbo: Approximately $0.002 per 1,000 tokens
• GPT-4: Approximately $0.06 per 1,000 tokens
• Typical Usage: 1,000 player interactions cost between $2-10 depending on model choice

Example: A medium-sized server with 100 daily AI interactions would incur monthly costs of $5-15.

Support and Community
For technical support, feature requests, or bug reports, please create a ticket.