Worker Backend Template

export default { async fetch(request, env) { if (request.method !== "POST") { return Response.json( { error: "Method not allowed" }, { status: 405 } ); }

const authHeader = request.headers.get("Authorization");
const expectedSecret = `Bearer ${env.API_SECRET}`;

if (authHeader !== expectedSecret) {
  return Response.json(
    { error: "Unauthorized" },
    { status: 401 }
  );
}

let data;

try {
  data = await request.json();
} catch {
  return Response.json(
    { error: "Invalid JSON body" },
    { status: 400 }
  );
}

const {
  player,
  message,
  system_prompt,
  model,

  safe_mode,
  online_players,
  max_players,
  dimension,
  world_time,

  can_access_online_player_count,
  can_access_dimension,
  can_access_world_time,
  can_access_player_coordinates
} = data;

const selectedModel =
  model || "@cf/meta/llama-3.1-8b-instruct";

let serverContext = "";

if (can_access_online_player_count) {
  serverContext +=
    `Online players: ${online_players}/${max_players}\n`;
}

if (can_access_dimension) {
  serverContext +=
    `Player dimension: ${dimension}\n`;
}

if (can_access_world_time) {
  serverContext +=
    `World time: ${world_time}\n`;
}

serverContext += `

Capabilities:

• Can access online player count: ${can_access_online_player_count}
• Can access player coordinates: ${can_access_player_coordinates}
• Can access dimension: ${can_access_dimension}
• Can access world time: ${can_access_world_time}
• Safe mode: ${safe_mode}

Important rules:

• Do not invent player counts, coordinates, structures, inventories, commands, or admin data.

• Only use server data provided in this request.

• If the requested data is not provided, say you do not have access to it. `;

  const aiResponse = await env.AI.run(selectedModel, { messages: [ { role: "system", content: ${system_prompt}\n\n${serverContext} }, { role: "user", content: ${player}: ${message} } ] });

  return Response.json({ reply: aiResponse.response || "No response from AI." }); } };

---

CloudChat Worker Backend

CloudChat requires a Cloudflare Worker backend to connect Minecraft chat to Cloudflare Workers AI.

This backend handles:

• AI requests
• API authentication
• Model selection
• Server awareness context
• AI responses

---

Setup

1. Create a Cloudflare Worker

2. Delete the default Worker code

3. Copy and paste the CloudChat Worker template below

4. Deploy the Worker

5. Copy your Worker URL

Example:

https://cloudchat.yourname.workers.dev

6. Put the Worker URL into your CloudChat config:

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

---

Worker Template

Paste this code into your Cloudflare Worker: