Skip to content

v0.1.1

Choose a tag to compare

View all tags
@pruuk pruuk released this 06 Jun 20:23
· 38 commits to main since this release
v0.1.1
7703343

GoMud Playtest Harness v0.1.1

Supersedes v0.1.0. AI playtest harness for GoMud:
point an AI agent at your MUD, have it play goals you define using standard
tester personalities, and get back a structured report.

What changed since v0.1.0 (important)

v0.1.0 fabricated a test account at boot (users.CreateUser). That was the root
of two real problems — a "phantom" live session that swallowed the per-round
beacons and blocked the real client's login, and a useless pre-tutorial "ghost"
character. v0.1.1 deletes the account fabrication entirely and keys
everything off the AI-port connection instead:

  • No provisioning. The module creates nothing at boot. Your agent logs into a
    character — or creates one via the normal new-player flow if none exists —
    exactly like a real player. (Creating + onboarding is part of what a tester
    should exercise.)
  • Beacons by connection. Playtest.Round beacons go to live AI-port
    sessions, not to an IsAI-flagged account. Verified deterministic.
  • Adapter: --user/--password are now optional — with them the adapter
    auto-logs-in; without them the agent drives login + character creation.
  • Config drops AccountName/AccountPassword; safe mode + death protection key
    off the AI-port connection.

Upgrade note: if you installed v0.1.0, re-run module install playtest to get
v0.1.1, rebuild, and have your agent log in / create a character (no
AccountPassword to set anymore).

What's included

  • playtest module (playtest.tar.gz) — per-round beacons, structural safe
    mode, and death protection for any client on the AI port. Compiles into your
    GoMud server.
  • mudagent adapter (mudagent-<os>-<arch>) — telnet/GMCP client exposing a
    line-in / JSON-out protocol. Download the one for your OS/arch.
  • Framework content (framework.tar.gz, also in the repo) — personalities,
    goals/report schemas, engine-profile template, worked examples, reference driver.

Requirements

  • A GoMud build with the AI port (merged into master). It ships disabled;
    enable Network.AI.Port.
  • The bundled gmcp module for the per-round beacons.
  • Go to compile the module in.

Install

go run . module install playtest          # fetches + sha256-verifies this release
go generate ./... && go build -o go-mud-server

Then enable the AI port and drive a run — see the
Quick Start,
the full usage guide,
and the worked examples.

Trust & integrity

module install downloads Go source (not a binary) and you compile it
yourself; the archive's sha256 is pinned in the GoMud module registry. See the
security & trust model.

playtest.tar.gz sha256:
ddd5c625f06b044ed802f17cf87f73e3ff7621b8e60362a2d47dbaabf9b4153a

Assets 9
Loading