[Bug] The character generator doesn't show any background #92

Closed
opened 2026-08-23 09:51:00 +00:00 by nasandre · 1 comment
Owner
No description provided.
Owner

Automated triage (openclaw monitor):

Diagnosis

Backgrounds are served via /api/dnd/backgrounds (proxy) or /api/mcp/sources (MCP). The empty body suggests the reporter didn’t load a character or inspect the network tab. Likely causes:

  • Frontend component (CharacterSheet/BackgroundSection.tsx) not mounted or hidden
  • API route /api/characters/{id}/background returns empty/null due to:
    • Missing background field in character document
    • MCP fallback disabled (MCP_FALLBACK_TO_DIRECT=false) and MCP service down
    • Character created before backgrounds were added to schema

Possible fix

  1. Verify data flow: Check /api/characters/{id} returns background field
  2. Check MCP: GET /api/mcp/status → ensure healthy=true
  3. Inspect frontend: Confirm CharacterSheet renders <BackgroundSection />
  4. Schema migration: If character documents predate backgrounds, run a migration to populate background from backgroundId

Notes / Questions

  • Ask reporter to:
    • Open browser dev tools → Network tab → load the character → check /api/characters/{id} response
    • Confirm MCP is enabled (MCP_DATA_ENABLED=true in env)
    • Share screenshot of the character sheet UI (is the Background section present but empty, or missing entirely?)
Automated triage (openclaw monitor): <!-- triage: nasandre/dnd-character-generator#92 --> ## Diagnosis Backgrounds are served via `/api/dnd/backgrounds` (proxy) or `/api/mcp/sources` (MCP). The empty body suggests the reporter didn’t load a character or inspect the network tab. Likely causes: - Frontend component (`CharacterSheet/BackgroundSection.tsx`) not mounted or hidden - API route `/api/characters/{id}/background` returns empty/null due to: - Missing `background` field in character document - MCP fallback disabled (`MCP_FALLBACK_TO_DIRECT=false`) and MCP service down - Character created before backgrounds were added to schema ## Possible fix 1. **Verify data flow**: Check `/api/characters/{id}` returns `background` field 2. **Check MCP**: `GET /api/mcp/status` → ensure `healthy=true` 3. **Inspect frontend**: Confirm `CharacterSheet` renders `<BackgroundSection />` 4. **Schema migration**: If character documents predate backgrounds, run a migration to populate `background` from `backgroundId` ## Notes / Questions - Ask reporter to: - Open browser dev tools → Network tab → load the character → check `/api/characters/{id}` response - Confirm MCP is enabled (`MCP_DATA_ENABLED=true` in env) - Share screenshot of the character sheet UI (is the Background section present but empty, or missing entirely?)
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
nasandre/dnd-character-generator#92
No description provided.