Skip to content

Releases: GoMudEngine/GoMud-Module-Playtest-Harness

v0.1.2

06 Jun 23:43

Choose a tag to compare

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-server

Requirements unchanged: a GoMud with the AI port (in master) + the bundled
gmcp module for beacons.


playtest.tar.gz sha256:
8b9502da19221ff8365bd86c6efc0f90547ba8bd08f8a19a4ad3d3d13141ee12

v0.1.1

06 Jun 20:23

Choose a tag to compare

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