Introduction

Dandelion is a project aimed at creating a standardized & stable Session Saver for ZOMBS.io.

Installation

For macOS / Linux

Install with one command:

curl -fsSL https://raw.githubusercontent.com/AyuBloom/Dandelion/main/install.sh | bash

If you already have the repository checked out, run the installer from the project root:

./install.sh

Use ./install.sh --verify to install dependencies, run TypeScript checking, and run the root tests/ suite.

For Windows

Install with one command from PowerShell:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/AyuBloom/Dandelion/main/install.ps1 | iex"

If you already have the repository checked out, run the installer from the project root:

.\install.ps1

Use .\install.ps1 -Verify to install dependencies, run TypeScript checking, and run the root tests/ suite.

Tools

Rescue CLI

Inspect or control a running session without restarting it:

bun run rescue

Use bun run rescue list to list sessions. See guide.md for interactive commands, targeting, authentication, and fallback behavior.

Swap solver WASM

Download the latest solver WebAssembly binary from ZOMBS.io and replace src/solver/zombs_wasm.wasm:

bun run swap-wasm

The tool validates the download as WebAssembly and keeps the current file intact if the download or replacement fails.

Mock session

Connect directly to a game server to exercise the solver and log the session handshake:

bun run tools/mock-session.ts --id <server-id> --hostname <hostname> --ip-address <ip-address>

Use --event-password <password>, --name <display-name>, or --timeout-ms <milliseconds> when needed.

API

• POST /create-session returns 202 with { ok: true, sessionId }.
• POST /sessions/:id/auth exchanges a password for a one-time, 60-second token.
• GET /sessions/:id/automations?token=... reads per-session automation state.
• PATCH /sessions/:id/automations/:automationId?token=... updates it in flight.
• DELETE /sessions/:id?token=... gracefully stops a session. Protected sessions require a token.
• WS /sessions/:id?token=... attaches a listener. Protected sessions require a token.