CloudChat.ai

CloudChat.ai is an open source AI assistant mod for Minecraft servers.

It allows players to chat with an AI directly in game using simple commands. Server owners can customize the AI’s name, personality, behavior, and backend settings through an automatically generated configuration file.

CloudChat is designed to be lightweight, easy to set up, and fully server side, meaning players do not need to install the mod on dedicated servers.

Features

• AI chat directly inside Minecraft
• Custom AI names and personalities
• Configurable commands
• Cloudflare Workers AI support
• Configurable AI model selection
• Automatic config generation
• Server awareness support
• Server-side support
• Singleplayer and LAN support
• Open-source

Server Owner Customization

Server owners can customize:

• AI name
• Command name
• AI personality/system prompt
• API endpoint
• AI model
• Cooldowns
• Message limits
• Server awareness settings

Quick Setup

1. Install the mod into your server's mods folder.

2. Start the server once.

3. CloudChat will automatically generate a config file at:

   config/cloudchat/cloudchat.properties
   

4. Configure:

   • Worker URL
   • API secret
   • AI model

• Restart the server.

• Use the command in-game:

  /cloudchat Hello!
  

Cloudflare Workers AI Setup

CloudChat uses Cloudflare Workers AI as the backend.

Server owners can:

• Host their own Worker
• Choose their own AI model
• Customize AI behavior and personality

The full setup guide, Worker backend template, configuration guide, and troubleshooting steps are available on the GitHub Wiki.

The Wiki includes:

• Creating a Cloudflare Worker
• Deploying the Worker backend
• Setting up the API secret
• Connecting CloudChat to your Worker
• Configuring AI models
• Advanced configuration options

Planned Features

CloudChat currently supports the Fabric mod loader and is planned to expand with future features such as:

• NeoForge support
• Discord integration
• Dashboard configuration
• Multi-model support
• Local AI model support
• Moderation tools
• Mod-aware interactions
• Optional inventory and server data awareness

Environment

• Works on dedicated servers
• Works in singleplayer
• Works in LAN worlds
• Players do not need the mod installed on dedicated servers

Development Notes

Some parts of the project were developed with AI-assisted tooling for implementation, debugging, and boilerplate generation. Project architecture, infrastructure design, and feature direction are maintained by the contributors.