Releases: GoMudEngine/GoMud-Module-Playtest-Harness
v0.1.2
GoMud Playtest Harness v0.1.2
Adds admin web pages for the playtest module. Runtime behavior is otherwise
unchanged from v0.1.1.
What's new
- Admin web pages (Modules → Playtest in the admin UI), per the maintainer's
v0.1.1 review suggestion:/admin/playtest-config— edit the module's keys (Enabled,SafeMode,
SandboxZoneTag,DeathProtection,Beacons) in the web UI instead of
hand-editing the overlay file. Changes apply on the next server restart./admin/playtest-about— what the module does, its configuration, and
room-tag usage.
- Docs: an agent-side quickstart ("run your first playtest with Claude Code"),
and the goals file is now a first-class input in the driver
(/playtest <target> <personality> <goals>= where / role / what-to-test).
Install / upgrade
go run . module install playtest # then:
go generate ./... && go build -o go-mud-serverRequirements unchanged: a GoMud with the AI port (in master) + the bundled
gmcp module for beacons.
playtest.tar.gz sha256:
8b9502da19221ff8365bd86c6efc0f90547ba8bd08f8a19a4ad3d3d13141ee12
v0.1.1
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.Roundbeacons go to live AI-port
sessions, not to anIsAI-flagged account. Verified deterministic. - Adapter:
--user/--passwordare 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
playtestmodule (playtest.tar.gz) — per-round beacons, structural safe
mode, and death protection for any client on the AI port. Compiles into your
GoMud server.mudagentadapter (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;
enableNetwork.AI.Port. - The bundled
gmcpmodule 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-serverThen 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