adventure

Manage Old-School Essentials adventures with PDF and Markdown module files.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/mmacy/osr-plugins --skill adventure-mmacy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adventure
Source: https://github.com/mmacy/osr-plugins/tree/main/plugins/bx-referee/skills/adventure
Command: npx skills add https://github.com/mmacy/osr-plugins --skill adventure-mmacy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the management of Old-School Essentials adventures, eliminating the need for manual setup, session tracking, and state preservation.

Core Features & Use Cases

  • Adventure Setup: Automatically sets up new adventures from module files, builds party rosters, and initializes session state.
  • Session Tracking: Manages ongoing session state, including party status, location, and current situation.
  • State Preservation: Saves and loads session state for easy resumption of play.
  • Use Case: Imagine you're a referee running a campaign. Use this Skill to quickly set up new adventures, manage session state, and preserve progress for later.

Quick Start

Start a new adventure by running the command '/bx-referee:adventure new' and provide the path to the adventure module file.

Frequently Asked Questions about adventure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Old-School Essentials adventure state across multiple sessions?

Setting up a new OSE adventure requires providing a path to your adventure module file in PDF or Markdown format. The system reads the module file, automatically builds the party roster, and initializes the session state for your campaign.

Does this adventure management system support both PDF and Markdown module files?

Session tracking in OSE adventure management works by continuously recording party status, location, and the current situation during gameplay, then preserving this state to file so progress is never lost between sessions.

Do I need Python installed to run Old-School Essentials adventure tracking scripts?

Yes, you need Python installed because the adventure tracking system relies on Python scripts for execution and file I/O operations to read module files and preserve session state.

Can I preserve party roster and location data when resuming an OSE campaign?

Yes, you can preserve party roster and location data when resuming an OSE campaign. The state preservation feature saves character status and session details, allowing you to load the exact state for easy resumption of play.