Skip to main content

DSPACE

democratized.space

🌙 Dark mode

Quest Contribution Guidelines

Docs
→ Quest Contribution Guidelines

Quest Contribution Guidelines

These guidelines outline the process for contributing your custom quests to the official DSPACE repository.

Prerequisites

• Quest Development Guidelines
• Familiarity with Quest Trees
• Node.js environment with this repository cloned
• Review the Quest Template Example

Workflow

1. Generate a template

   npm run generate-quest --template basic
   

   Use branching instead of basic for multi-path quests.
2. Build your quest following the Quest Schema. Include at least one item or process reference.
3. Run validations

   node scripts/validate-quest.js path/to/quest.json
   

   This checks schema compliance, hardening metadata, and quest/process references. Maintainers also run npm run hardening:validate against the full catalog.
4. Bundle related content

   node scripts/create-content-bundle.js
   

   This creates a JSON bundle in submissions/bundles.
5. Submit via the in-game form at /quests/submit (single quest JSON) or /bundles/submit (bundle JSON). See the Quest Submission Guide for details on exporting JSON from the in-game editor.
6. Authorize GitHub with a personal access token in the submission form and create a pull request.
7. Respond to feedback until the quest meets project standards.

Tips

• Keep dialogue concise and educational.
• Include safety notes where appropriate.
• Run npm test before opening a pull request (use SKIP_E2E=1 npm test only if browsers are unavailable).

Happy quest building!