← QuestforgeCONTENT HISTORY

Update to Questforge

Snapshot Sep 30, 2026 · 23:13 UTC · version 1.3.1

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "name": "questforge-setup",
  "description": "Prepare Questforge for first play with an offline rules primer, optional full-SRD indexing, language selection, and licensing boundaries.",
  "included_files": [],
  "skill_md_contents": "---\nname: questforge-setup\ndescription: Prepare Questforge for first play with an offline rules primer, optional full-SRD indexing, language selection, and licensing boundaries.\n---\n\n# Questforge Setup\n\nUse this skill when the user installs Questforge, starts it in a new repo, asks\nabout SRD resources, or when `.questforge/questforge-setup.json` is missing.\n\n## Default Offline Setup\n\nRun setup without asking for language. The default builds searchable Markdown, JSONL, and SQLite indexes from the bundled core-rules primer. It does not use the network or install packages:\n\n```powershell\npython ../../scripts/questforge_setup.py --data-dir .questforge\n```\n\nSetup detects language in this order:\n\n1. `QUESTFORGE_LANGUAGE`\n2. `LANGUAGE`\n3. `LC_ALL`\n4. `LC_MESSAGES`\n5. `LANG`\n6. system locale\n7. English fallback\n\nConversation language takes priority over machine locale. Pass `--language en` or `--language es` when the user's language is clear from the request. For other languages, use the English rules index and keep narration in the user's language.\n\n## Optional Complete SRD\n\nOnly download the complete official SRD when the user asks for detailed rules coverage or accepts the optional setup. Explain that the command contacts `media.dndbeyond.com` and writes a local cache before running it:\n\n```powershell\npython ../../scripts/questforge_setup.py --data-dir .questforge --full-srd\n```\n\nWhen `pypdf` is already available, the full setup creates:\n\n- Markdown rules text.\n- JSONL rules chunks.\n- SQLite rules index with FTS when available.\n- Structured Markdown resources under `.questforge/resources/srd/<language>/`.\n- `.questforge/questforge-setup.json` with resolved language and paths.\n\nIf full setup returns `pdf_downloaded_index_pending`, say exactly what happened and continue playing with the ready bundled core index. Questforge never installs packages. If the user wants complete indexing, explain that `pypdf` must already be installed in their active Python environment, then rerun:\n\n```powershell\npython ../../scripts/questforge_setup.py --data-dir .questforge --full-srd\n```\n\nor:\n\n```powershell\npython ../../scripts/questforge_setup.py --data-dir .questforge --rules-text <path-to-srd-markdown>\n```\n\nIf shell or filesystem access is unavailable, use `../../resources/core-rules/<language>.md` directly and run a chat-only campaign. Do not claim that local indexes were created.\n\n## Copyright Boundary\n\n- Use SRD 5.2.1 sources only.\n- Do not bundle commercial manuals, adventures, settings, official art, logos,\n  or non-SRD product identity.\n- Include CC-BY-4.0 attribution when storing or redistributing SRD-derived\n  materials.\n- Prefer local caches and generated indexes in `.questforge/`.\n"
}

SHA-256: 2a180205679ecbeb06d07a2b92c24e41f78e83fd9def2dffac2b6b8ccf553259