Setup Guide

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. Open the config file.

5. Replace the Worker URL and API secret with your own Cloudflare Worker AI endpoint.

   Example:

   worker_url=https://your-worker.workers.dev
   api_secret=your_api_secret

   api_secret is your API password/token ( And yes, you can name it anything like banana123 or whatever you want, don't need to generate from CloudFlare ), not the Worker URL.

6. (Optional) Change the AI model in the config.

   Example:

   model=@cf/meta/llama-3.1-8b-instruct

   Default model:

   @cf/meta/llama-3.1-8b-instruct

7. Restart the server.

8. Use the command in-game:

   /cloudchat Hello!

Configuring Worker URL

1. Create a Cloudflare account.

2. Go to:

   https://dash.cloudflare.com/

3. Open:

   Workers & Pages

4. Create a new Worker.

5. Replace the default Worker code with the CloudChat Worker template.

6. Deploy the Worker.

7. Copy the Worker URL.

   Example:

   https://cloudchat.yourname.workers.dev

8. Put the Worker URL into your CloudChat config:

   worker_url=https://cloudchat.yourname.workers.dev

9. Restart the server.

CloudChat Worker Backend

The CloudChat Worker Backend is the Cloudflare Worker that connects the Minecraft mod to Cloudflare Workers AI.

The Minecraft mod sends player messages to this Worker.
The Worker checks the API secret, sends the message to the selected AI model, then returns the AI reply back to Minecraft.

What This Worker Handles

• API secret authentication
• AI model selection
• Server context handling
• Online player count context
• Dimension/world time context
• Anti-hallucination rules
• Returning AI replies to Minecraft

Worker Code

Paste the CloudChat Worker template into your Cloudflare Worker editor.

API Secret

The API_SECRET is a password shared between your Minecraft config and your Worker.

Example:

Minecraft config:

api_secret=my_secret_password