mud-onchain-dev

What problem does it solve?

This Skill provides comprehensive support for developing full-stack MUD (Multi-User Dungeon) games or applications on the blockchain. It helps with requirements gathering, ECS schema design, world/system implementation, client synchronization, testing, deployment, and operational troubleshooting, making it suitable for consistent progress from new project setup to modification, performance/gas optimization, and establishing a repeatable development workflow.

Core Features & Use Cases

• Requirements Gathering: Document "who", "when", "which system to call", and "how the tables change" in writing.
• ECS Schema Design: Normalize around Entity, plan for future expansion, and optimize read/write access.
• World/System Implementation: Assign single responsibilities to each system, ensure failure conditions are verifiable, and handle external calls.
• Client Synchronization: Design clients based on state transitions, use optimistic UI with rollback conditions, and provide fallbacks for delayed events.
• Verification and Quality Assurance: Confirm schema integrity, major system paths, gas increase, and client display consistency.
• Deployment and Operations: Deploy with confirmed chain settings, permissions, and environment variables, perform smoke tests, and investigate issues with separated state checks.

Quick Start

Ensure the project targets MUD v2 or later. Separate the change targets into contracts (World/System/Schema) and client (synchronization/UI). Decide on the data model (tables, primary keys, integrity) before writing systems. Perform system-level tests and scenario tests, verify client synchronization, and reconfirm chain settings, permissions, and environment variables during deployment.