enter-world

Launch the Adventure Engine application for an adventure project. Use when the user wants to "enter" a world, "start" or "launch" an adventure session, or begin interactive gameplay. Fires off the application in the background using the current working directory as the adventure project root.

Enter World

Launch the Adventure Engine application to begin an interactive adventure session.

Usage

Ensure the current working directory contains a valid adventure project
Run the launcher script which will boot the Adventure Engine application in fire-and-forget mode:

bash "${CLAUDE_PLUGIN_ROOT}/skills/enter-world/scripts/launch-world.sh" "$PWD"

To skip opening a browser (useful for remote/headless servers):

bash "${CLAUDE_PLUGIN_ROOT}/skills/enter-world/scripts/launch-world.sh" --no-browser "$PWD"

The script launches the application asynchronously - control returns immediately to Claude Code while the adventure application runs independently. Output is written to .adventure-engine.log in the project directory.

Script Location

The launcher script is at: skills/enter-world/scripts/launch-world.sh

What the Script Does

Validates the adventure project directory
Starts the backend server using bun run start
Waits for server health check (up to 30 seconds)
Opens the default browser to http://localhost:3000 (unless --no-browser is specified)
Logs server PID for later shutdown
Detaches from the terminal (fire and forget)
All output is logged to .adventure-engine.log in the project directory