PaperChat v1.0.0-beta - Release Notes

First Beta Release

This is the initial beta release of PaperChat, an AI-powered Minecraft communication plugin that enables players to interact through intelligent AI assistants.

What does Beta 1.0.0 Offer

Core Features

• Multi-Provider AI Integration: Support for Google Gemini and OpenAI GPT models
• Conversation History: Per-player chat sessions with configurable history limits
• Command Interface: Simple /paperchat <player> <message> command structure
• Async Processing: Non-blocking AI requests to maintain server performance
• Docker Deployment: Complete containerized setup with Minecraft server

AI Provider System

• Automatic Provider Registration: Service Provider Interface (SPI) for seamless provider discovery
• Abstract Provider Architecture: Clean, extensible system for adding new AI providers
• Graceful Error Handling: User-friendly error messages instead of technical details
• Smart Response Recovery: Automatic content extraction from malformed JSON responses

Configuration & Security

• Environment-Based Configuration: All settings configurable via environment variables
• API Key Security: Headers-based authentication for secure API communication
• Input Validation: Character limits
• System Prompt Customization: Configurable AI behavior and response formatting

Development Features

• Clean Architecture: Domain-driven design with clear separation of concerns
• Build Automation: Gradle build system with shadow plugin for dependency management
• CI/CD Pipeline: GitHub Actions for automated building and Docker image publishing
• Comprehensive Documentation: Full README with setup, usage, and development guides

Manual Installation

1. Download the JAR from releases
2. Place in your server's plugins/ directory
3. Set environment variables:

   export PAPERCHAT_API_KEY="your-api-key"
   export PAPERCHAT_PROVIDER="google"  # or "openai"
   

4. Start your server

Usage

Send an AI-powered message to another player:

/paperchat Steve "How do I build a redstone contraption?"
/paperchat Alex What are the best mining strategies?

Technical Requirements

Server Requirements

• PaperMC 1.21 or higher
• Java 21 or higher
• Minimum 1GB RAM (2GB+ recommended)

API Requirements

• Google AI Studio API key (recommended) OR OpenAI API key
• Internet connectivity for API requests

Known Issues & Limitations

Beta Limitations

• Memory Storage Only: Conversation history is lost on server restart
• Single Server Support: No cross-server communication
• Basic Permission System: Only paperchat.use permission implemented
• Limited Provider Testing: Primarily tested with Google Gemini

Known Issues

• Very long AI responses may occasionally be truncated
• Provider switching requires server restart
• No built-in rate limiting (relies on API provider limits)

License

Licensed under Apache 2.0 License - see LICENSE file for details.

---

Note: This is a beta release intended for testing and feedback. While stable for basic usage, some features may change or new ones be implemented in future releases.