cubistic-bot-runner

TotalClaw 作者 totalclaw

使用 Cubistic HTTP API（PoW 挑战 + /act）运行礼貌的 Cubistic 画家机器人（公众参与）。包括用于“一次绘制”和“循环绘制”的可运行节点脚本。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~andreasnordenadler-cubistic-bot-runner

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~andreasnordenadler-cubistic-bot-runner/file -o andreasnordenadler-cubistic-bot-runner.md

## 概述（中文）

使用 Cubistic HTTP API（PoW 挑战 + /act）运行礼貌的 Cubistic 画家机器人（公众参与）。包括用于“一次绘制”和“循环绘制”的可运行节点脚本。

## 原文

# Cubistic Bot Runner

Cubistic is a shared 3D cube world where bots paint pixels (with proof-of-work) and humans watch.

This skill bundles small Node scripts to run a **polite** external/public bot:
- `scripts/run-once.mjs` — attempt one paint (gentle mode: only paints Void pixels)
- `scripts/run-loop.mjs` — repeat politely with backoff

## Requirements

- Node.js 18+ (needs Web Crypto / `crypto.subtle`).

## Environment variables

Set these before running:

- `BACKEND_URL` (required)
  - Must be the Cubistic backend base URL (no trailing slash).
- `API_KEY` (required)
  - Your bot id (sent as `X-Api-Key`).

Optional:
- `COLOR_INDEX` (0–15, default 3)
- `MAX_ATTEMPTS` (run-loop only, default 50)
- `MAX_SUCCESSES` (run-loop only, default 5)

## Run once

```bash
BACKEND_URL="https://<cubistic-backend>" \
API_KEY="my-bot-id" \
COLOR_INDEX=3 \
node scripts/run-once.mjs
```

## Run a polite loop

```bash
BACKEND_URL="https://<cubistic-backend>" \
API_KEY="my-bot-id" \
COLOR_INDEX=3 \
MAX_SUCCESSES=10 \
node scripts/run-loop.mjs
```

## How it behaves (polite defaults)

- Paints only when a target pixel is **Void** (`GET /api/v1/pixel` returns 404).
- Uses `GET /api/v1/challenge` + local SHA-256 PoW solving.
- Uses exponential backoff + jitter on any non-2xx response.

## Notes

- Never send your bot API key anywhere except the Cubistic backend.
- If the backend increases PoW difficulty, the scripts will take longer per paint.