Quest Assignment
Links QuestExtension quests to a category defined by Quest Category. Multiple assignment entries can reference the same category to add more quests.
Fields
| Field | Type | Default | Description |
|---|---|---|---|
category | String | "" | Category to assign quests to (must match a quest_category entry). |
questRefs | List<Ref<QuestEntry>> | [] | Quest entries to assign. Reference QuestExtension quests. |
orders | List<Int> | [] | Display order for each quest (aligned with questRefs). Lower = first. |
Per-Status Overrides
Each quest can have custom display fields per status:
| Field | Type | Description |
|---|---|---|
notStartedItem | Item @ContentEditor | Custom item when the quest has not started. |
inProgressItem | Item @ContentEditor | Custom item when the quest is in progress. |
completedItem | Item @ContentEditor | Custom item when the quest is completed. |
notStartedName | String @Placeholder @Colored | Custom name when not started. |
inProgressName | String @Placeholder @Colored | Custom name when in progress. |
completedName | String @Placeholder @Colored | Custom name when completed. |
notStartedLore | String @Placeholder @Colored @MultiLine | Additional lore when not started. |
inProgressLore | String @Placeholder @Colored @MultiLine | Additional lore when in progress. |
completedLore | String @Placeholder @Colored @MultiLine | Additional lore when completed. |
Visibility
| Field | Type | Default | Description |
|---|---|---|---|
hideWhenNotStarted | Boolean | false | Hide this quest while not started. |
hideWhenInProgress | Boolean | false | Hide this quest while in progress. |
hideWhenCompleted | Boolean | false | Hide this quest when completed. |
hideObjectivesWhenInProgress | Boolean | false | Hide objective progress while in progress. |
hideObjectivesWhenCompleted | Boolean | false | Hide objective progress when completed. |
Example
{
"type": "quest_assignment",
"id": "assign_main",
"name": "Main Story Quests",
"category": "main_quests",
"questRefs": ["quest:quest_main_1", "quest:quest_main_2"],
"orders": [0, 1],
"notStartedName": "",
"inProgressName": "",
"completedName": "",
"hideWhenNotStarted": false,
"hideWhenInProgress": false,
"hideWhenCompleted": false
}
Quest Ref Format
questRefs uses Typewriter's ref system. Reference quests from QuestExtension:
questRefs: ["quest:quest_main_1", "quest:quest_main_2"]
Each ref points to a QuestEntry defined via QuestExtension. The quest must exist in a compiled page for the assignment to work.