Sampler

Sampler is a Mudlet package for the game Achaea that builds a persistent database of sampling locations for the Furniture tradeskill and adds convenient commands for finding and traveling to known sample rooms.

Features

• Automatically records rooms where samples are collected.
• Lists known rooms for a material/sample query, grouped by area.
• Optional guided travel through known rooms with auto-pause for sampling.
• Shows sampleables in the current room after a room inventory update.
• Enhances "Furnishing Materials" lists by annotating where materials are found.

Requirements

• Mudlet with GMCP enabled.
• Mapper support for travel links (uses mmp.gotoRoom/mmp.gotoArea when available).
• Built-in yajl and getNewIDManager() (present in standard Mudlet installs).

Install

1. Import the package file from build/Sampler.mpackage.
2. Ensure GMCP is enabled in Mudlet.

Usage

Commands

• sample or sample help — show help.
• sample now — queue sampling of any known sampleable in the current room.
• sample rooms <query> — list known rooms for a material or sample name.
• sample travel start <query> — travel through known rooms, pausing when samples are found.
• sample travel resume — continue travel after sampling.
• sample travel cancel — stop travel and clear the queue.

Room discovery

Sampler listens for sampling messages and records the current room number against the sample name. This database grows over time and is used by sample rooms and travel.

Travel behavior

sample travel start <query> builds an ordered list of matching rooms, moves to each room, and pauses if a matching sample is present. Use sample travel resume after sampling or sample travel cancel to stop.

Materials list enhancement

When a "Furnishing Materials" list is shown, Sampler matches each material line to known samples and prints the areas where those samples were collected.

Data storage

Sampler stores its database as JSON at:

<Mudlet home>/@PKGNAME@/sampling.config

The file is saved on shutdown and updated as samples are collected.

Development

• Source files live in src.
• Build metadata is in mfile.
• Specs are in spec.

Troubleshooting

• If sample rooms shows no results, collect at least one sample first.
• If travel links do nothing, ensure the Mudlet mapper is enabled and mmp is available.