Text RPG Engine (rpg-text) for Openclaw

A sophisticated, data-driven text RPG engine that enables AI agents to function as professional Dungeon Masters using classic D&D rules.

beancookie
v1.0.4
Mar 12, 2026
0
995
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install rpg-text

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install rpg-text using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Text RPG Engine (rpg-text)?

The rpg-text skill is a comprehensive, object-oriented framework designed for building text-based role-playing games. Based on the original Dungeons & Dragons ruleset, it provides a robust architecture for turn-based adventures, complex combat systems, and deep character progression. This skill allows an AI to take on the role of a Dungeon Master (DM), dynamically narrating world events while managing background logic.

By leveraging Openclaw Skills, developers can deploy a fully realized game world where every entity, from players to monsters, is managed through a structured data-driven system. The engine handles everything from attribute modifiers and saving throws to inventory management and quest tracking, ensuring a professional and consistent gaming experience.

Text RPG Engine (rpg-text) Use Cases

  • Creating interactive, AI-led tabletop gaming experiences for solo or group play.
  • Prototyping complex game mechanics and status effect interactions in a CLI environment.
  • Building narrative-driven educational tools using role-playing elements.
  • Developing persistent virtual worlds where Openclaw Skills manage character state and world progression.

How Text RPG Engine (rpg-text) Works

  1. The AI initializes by loading the core game data from JSON files located in the data directory, defining the bestiary, item catalog, and world maps.
  2. Players begin by selecting their character name, race (such as Elf or Dwarf), and job (such as Fighter or Wizard).
  3. The engine generates ability scores using a 4d6 dice roll system and calculates modifiers based on standard D&D formulas.
  4. During gameplay, the AI DM describes the current location and available interactions based on the MapSystem and NPC data.
  5. When a player inputs an action command like attack or look, the engine processes the logic through specialized modules like the CombatSystem or InventorySystem.
  6. Combat outcomes are determined by calculating hit formulas against target AC and rolling virtual dice for damage.
  7. The SaveLoadSystem automatically persists the game state every 10 turns to ensure data integrity.

Text RPG Engine (rpg-text) Setup

To integrate this skill into your environment, ensure your data directory is properly structured with the required JSON definitions.

# Create the data directory structure
mkdir -p data/maps

# Initialize the engine with core data files
# Ensure characters.json, items.json, and monsters.json are present

# Launch the AI agent to begin the DM session

Text RPG Engine (rpg-text) Data Schema & Taxonomy

The skill utilizes a structured JSON-based data schema to maintain game consistency and allow for easy expansion.

Data File Content Description
characters.json Definitions for all non-player characters and their behaviors.
items.json Full catalog of weapons, armor, potions, and artifacts.
monsters.json A complete bestiary including AC, HP, attack patterns, and XP values.
jobs.json Class specifications including hit dice, mana dice, and saving throws.
loot_tables.json Logic for randomized rewards and treasure distribution.
maps/ Location-specific data including descriptions and connected paths.

Text RPG Engine (rpg-text) Advanced Features

  • Comprehensive Status Effect System: Manages over 18 different conditions including Poison, Bleeding, Haste, and Invisibility.
  • Multi-Tier Currency Economy: Supports copper, silver, gold, and platinum coins with dynamic shop price multipliers.
  • Dynamic Time Cycle: Tracks game rounds and hours, where nighttime increases monster difficulty.
  • Branching Quest System: Features primary story arcs, side quests, and special rescue missions.
  • Advanced Racial Traits: Includes unique attribute bonuses and special abilities like Darkvision for specific races.
  • Robust Save Management: Supports up to 10 distinct save slots for persistent world states using Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*