Player Character Management
manage_characterCreate, import, stage, activate, edit, signal, remove, or list player characters to keep a Novel's roster and active playable entity current.
Instructions
Manage player characters: create, import, stage, activate, edit, signal, remove, or list roster characters. stage adds an existing entity to the roster; set_active chooses which Novel entity play acts through and optionally sets pov; import requires roster_id and copies that roster character into the Novel. sheet and roster_list are read-only; Novel mutations persist, are audited, and are undoable via manage_history (action: undo). update merges provided fields (stats shallow-merge; omitted fields preserved), personality{} aliases description/voice/background/goals, and details{} aliases ability_scores/skills/feats/talents/equipment; a top-level value overrides its grouped alias. stage and roster_remove are exact inverses on the roster; remove deletes the Novel entity and is undoable. Use when: creating or importing a PC, staging or activating one for play, editing its sheet or voice, or handling player feedback. Do NOT use when: managing an NPC — use manage_npc.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "manage_character"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pov | No | Point-of-view mode (set_active). | |
| name | No | Character name; omit (create) to begin step-by-step. | |
| seed | No | Deterministic seed (create). | |
| feats | No | Feats (create). | |
| goals | No | Character goals (create/personality). | |
| stats | No | Mechanical stat keys to shallow-merge into the entity's stats (update). | |
| value | No | Feedback text (signal). | |
| voice | No | Voice and speech pattern (create/personality). | |
| action | Yes | create, stage, import, sheet, set_active, personality, voice, signal, update, remove, roster_remove, or roster_list. | |
| format | No | Output format (sheet). | |
| signal | No | Feedback category (signal). | |
| skills | No | Trained skills (create). | |
| classes | No | Class levels (create). | |
| details | No | Grouped mechanical details (create). | |
| species | No | Species (create). | |
| talents | No | Talents (create). | |
| examples | No | Voice examples (voice). | |
| entity_id | No | Entity identifier (stage/sheet/set_active/personality/voice/remove). | |
| equipment | No | Starting equipment (create). | |
| inventory | No | Replace the entity's inventory (update). | |
| roster_id | No | Roster identifier (import/roster_remove). | |
| background | No | Backstory (create/personality). | |
| description | No | Narrative description (create/personality). | |
| personality | No | Grouped personality fields (create). | |
| stat_method | No | Stat-generation method (create). | |
| ability_scores | No | Ability scores (create). | |
| stage_to_roster | No | Also stage into the roster (create). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Human-readable text envelope mirroring the structured result (REQ-001, REQ-548a). | |
| status | Yes | Machine-readable result status: OK, NEED_INPUT, WARNING, PARTIAL, or an error category (REQ-002, REQ-548c). |