feat: FTB Quests guidance book (hybrid - advancements remain primary)
All checks were successful
Build & Release Pack / build (push) Successful in 1m41s

Add an FTB Quests 'The Dark Photon Protocol' chapter that guides players
while the KubeJS advancement tree stays the primary progression.

Design (per user): FTB provides guidance/onboarding; advancements own the
actual progression. Quests auto-complete on the same triggers as the
advancements (item obtained / dimension entered) so there's no double
friction.

Chapter 'chapter_dark_photon_protocol.snbt' - 10 quests mirroring the phase
tree:
  First Steps (Corruption Tide onboarding) -> The Signal -> The Core ->
  The Seal -> The Lattice -> The Legacy, then branches: Through the Doors /
  The Wound / The Answer / Per Spatium.

Tasks: item tasks (scicraft items) + dimension tasks (Limbo, Void, Othersides,
Stellaris moon). Rewards: XP + 2 starting Photon Fragments on First Steps.

Titles/descriptions stored in lang/en_us/ translation file using FTB's
<objectType>.<id>.<subkey> key format (chapter.<id>.title, quest.<id>.quest_desc).

Format: FTB Quests 1.21 uses the marhali JSON5 format (comma-separated
properties) - validated with the json5 parser. Files ship in both client and
server packs (FTB quest progress is server-authoritative).

data.snbt + chapter_groups.snbt are auto-generated by FTB Quests on first
load if absent.
This commit is contained in:
MiTHRAL 2026-08-20 01:28:28 -04:00
parent 3d76c0e059
commit 68b3bc302c
4 changed files with 682 additions and 0 deletions

View file

@ -0,0 +1,253 @@
{
id: "e7311a3c8487ccee",
group: "",
order_index: 0,
quests: [
{
id: "af426aae065d8b5d",
x: 0.0,
y: 0.0,
shape: "circle",
tasks: [
{
id: "af426aae065d8b5e",
type: "ftbquests:checkmark"
}
],
rewards: [
{
id: "af426aae065d8b5f",
type: "ftbquests:item",
item: {
item: "scicraft:photon_fragment",
count: 2
}
}
]
},
{
id: "2008fe12b4d41b0d",
x: 2.0,
y: 0.0,
shape: "circle",
dependencies: [
"af426aae065d8b5d"
],
tasks: [
{
id: "2008fe12b4d41b0e",
type: "ftbquests:item",
item: {
item: "scicraft:photon_fragment",
count: 1
}
}
],
rewards: [
{
id: "2008fe12b4d41b0f",
type: "ftbquests:xp",
xp: 100
}
]
},
{
id: "43538030951a509c",
x: 4.0,
y: 0.0,
shape: "circle",
dependencies: [
"2008fe12b4d41b0d"
],
tasks: [
{
id: "43538030951a509e",
type: "ftbquests:item",
item: {
item: "scicraft:photon_core",
count: 1
}
}
],
rewards: [
{
id: "43538030951a509f",
type: "ftbquests:xp",
xp: 250
}
]
},
{
id: "0b79d27becaeafc6",
x: 6.0,
y: 0.0,
shape: "circle",
dependencies: [
"43538030951a509c"
],
tasks: [
{
id: "0b79d27becaeafce",
type: "ftbquests:item",
item: {
item: "scicraft:void_stabilizer",
count: 1
}
}
],
rewards: [
{
id: "0b79d27becaeafcf",
type: "ftbquests:xp",
xp: 500
}
]
},
{
id: "334f7c4987263954",
x: 8.0,
y: 0.0,
shape: "circle",
dependencies: [
"0b79d27becaeafc6"
],
tasks: [
{
id: "334f7c498726395e",
type: "ftbquests:item",
item: {
item: "scicraft:quantum_lattice",
count: 1
}
}
],
rewards: [
{
id: "334f7c498726395f",
type: "ftbquests:xp",
xp: 1000
}
]
},
{
id: "122450d405e7ce56",
x: 10.0,
y: 0.0,
shape: "circle",
dependencies: [
"334f7c4987263954"
],
tasks: [
{
id: "122450d405e7ce5e",
type: "ftbquests:item",
item: {
item: "scicraft:renegade_glass",
count: 1
}
}
],
rewards: [
{
id: "122450d405e7ce5f",
type: "ftbquests:xp",
xp: 300
}
]
},
{
id: "fb564dcc8844cdd6",
x: 12.0,
y: 0.0,
shape: "circle",
dependencies: [
"0b79d27becaeafc6"
],
tasks: [
{
id: "fb564dcc8844cdde",
type: "ftbquests:dimension",
dimension: "dimensionaldoors:limbo"
}
],
rewards: [
{
id: "fb564dcc8844cddf",
type: "ftbquests:xp",
xp: 400
}
]
},
{
id: "c71b96a9869a6607",
x: 14.0,
y: -1.0,
shape: "circle",
dependencies: [
"334f7c4987263954"
],
tasks: [
{
id: "c71b96a9869a660e",
type: "ftbquests:dimension",
dimension: "thevoiddimension:overworld"
}
],
rewards: [
{
id: "c71b96a9869a660f",
type: "ftbquests:xp",
xp: 750
}
]
},
{
id: "85e6fcba2ecb28a6",
x: 14.0,
y: 1.0,
shape: "circle",
dependencies: [
"334f7c4987263954"
],
tasks: [
{
id: "85e6fcba2ecb28ae",
type: "ftbquests:dimension",
dimension: "deeperdarker:otherside"
}
],
rewards: [
{
id: "85e6fcba2ecb28af",
type: "ftbquests:xp",
xp: 750
}
]
},
{
id: "7ad80334ef67b3db",
x: 14.0,
y: -3.0,
shape: "circle",
dependencies: [
"334f7c4987263954"
],
tasks: [
{
id: "7ad80334ef67b3de",
type: "ftbquests:dimension",
dimension: "stellaris:moon"
}
],
rewards: [
{
id: "7ad80334ef67b3df",
type: "ftbquests:xp",
xp: 600
}
]
}
],
quest_links: [],
images: []
}

View file

@ -0,0 +1,88 @@
{
"chapter.e7311a3c8487ccee.title": "The Dark Photon Protocol",
"quest.af426aae065d8b5d.title": "First Steps",
"quest.af426aae065d8b5d.quest_desc": [
"You are the last engineer of the Second Renegade Flight.",
"",
"A fifth force — dark photons — holds a collapsed star-empire sealed behind a Dimensional Door. The seal is failing.",
"",
"The Corruption Tide is a global pressure that rises while Doors go unsealed. It climbs every 60 seconds. Re-seal Doors at a powered Quantum Lattice with a Void Stabilizer to push it back. There is no fail state — just a world that grows darker.",
"",
"Your first step: recover Photon Fragments from the Darker's creatures — Wardens, Mutant Monsters, and Born in Chaos mobs."
],
"quest.2008fe12b4d41b0d.title": "The Signal",
"quest.2008fe12b4d41b0d.quest_desc": [
"Recover a Photon Fragment from a creature of the Dark.",
"",
"Sources:",
"- Warden: 1-3",
"- Mutant Zombie / Skeleton: 1-2",
"- Mutant Enderman: 2-4",
"- Born in Chaos Dark Vortex / Dread Hound: 1",
"- Nightmare Stalker: 2-3",
"",
"You can also extract one from an Echo Shard and Glowstone Dust."
],
"quest.43538030951a509c.title": "The Core",
"quest.43538030951a509c.quest_desc": [
"Press three Photon Fragments into a Photon Core.",
"",
"Use a Create Mechanical Press on 3x Photon Fragments, or smelt an Ender Pearl in the heart of the wound.",
"",
"Holding a Photon Core grants Night Vision."
],
"quest.0b79d27becaeafc6.title": "The Seal",
"quest.0b79d27becaeafc6.quest_desc": [
"Craft the Void Stabilizer — the renegades' tool for closing wounds.",
"",
"Recipe: a column of Photon Cores with an Ender Eye at the heart.",
"",
"It never breaks. The work will. Holding it grants Speed and Regeneration."
],
"quest.334f7c4987263954.title": "The Lattice",
"quest.334f7c4987263954.quest_desc": [
"Assemble the Quantum Lattice — the Protocol's emitter — and keep it powered.",
"",
"Recipe: steel ingots, circuits, and a Photon Core.",
"",
"Place it, power it, then right-click it with a Void Stabilizer to re-seal a Door and push back the Corruption Tide by 15."
],
"quest.122450d405e7ce56.title": "The Legacy",
"quest.122450d405e7ce56.quest_desc": [
"Craft Renegade Glass — the TARDIS-blue glass of the Flight.",
"",
"Purely decorative. Some say it hums near Doors.",
"",
"Recipe: glass blocks around a Photon Fragment."
],
"quest.fb564dcc8844cdd6.title": "Through the Doors",
"quest.fb564dcc8844cdd6.quest_desc": [
"Enter a Dimensional Door.",
"",
"Limbo is the scar-tissue of the Flight's prison — the space between the doors.",
"",
"The first test of your nerve."
],
"quest.c71b96a9869a6607.title": "The Wound",
"quest.c71b96a9869a6607.quest_desc": [
"Descend into the Void Dimension — the raw leak of the collapsing empire.",
"",
"Danger: the wound drains 1 HP every 5 seconds. Carry the Void Stabilizer to hold on."
],
"quest.85e6fcba2ecb28a6.title": "The Answer",
"quest.85e6fcba2ecb28a6.quest_desc": [
"Reach the Othersides of the Deeper and Darker.",
"",
"What answers from inside the prison. The richest harvest of Photon Fragments.",
"",
"Danger: the Wither takes hold here."
],
"quest.7ad80334ef67b3db.title": "Per Spatium",
"quest.7ad80334ef67b3db.quest_desc": [
"Launch a rocket.",
"",
"The Flight scattered its data across the worlds of this system — the moon, Mars, Venus, Mercury.",
"",
"Each holds a piece of the Protocol's history. Per Spatium."
]
}

View file

@ -0,0 +1,253 @@
{
id: "e7311a3c8487ccee",
group: "",
order_index: 0,
quests: [
{
id: "af426aae065d8b5d",
x: 0.0,
y: 0.0,
shape: "circle",
tasks: [
{
id: "af426aae065d8b5e",
type: "ftbquests:checkmark"
}
],
rewards: [
{
id: "af426aae065d8b5f",
type: "ftbquests:item",
item: {
item: "scicraft:photon_fragment",
count: 2
}
}
]
},
{
id: "2008fe12b4d41b0d",
x: 2.0,
y: 0.0,
shape: "circle",
dependencies: [
"af426aae065d8b5d"
],
tasks: [
{
id: "2008fe12b4d41b0e",
type: "ftbquests:item",
item: {
item: "scicraft:photon_fragment",
count: 1
}
}
],
rewards: [
{
id: "2008fe12b4d41b0f",
type: "ftbquests:xp",
xp: 100
}
]
},
{
id: "43538030951a509c",
x: 4.0,
y: 0.0,
shape: "circle",
dependencies: [
"2008fe12b4d41b0d"
],
tasks: [
{
id: "43538030951a509e",
type: "ftbquests:item",
item: {
item: "scicraft:photon_core",
count: 1
}
}
],
rewards: [
{
id: "43538030951a509f",
type: "ftbquests:xp",
xp: 250
}
]
},
{
id: "0b79d27becaeafc6",
x: 6.0,
y: 0.0,
shape: "circle",
dependencies: [
"43538030951a509c"
],
tasks: [
{
id: "0b79d27becaeafce",
type: "ftbquests:item",
item: {
item: "scicraft:void_stabilizer",
count: 1
}
}
],
rewards: [
{
id: "0b79d27becaeafcf",
type: "ftbquests:xp",
xp: 500
}
]
},
{
id: "334f7c4987263954",
x: 8.0,
y: 0.0,
shape: "circle",
dependencies: [
"0b79d27becaeafc6"
],
tasks: [
{
id: "334f7c498726395e",
type: "ftbquests:item",
item: {
item: "scicraft:quantum_lattice",
count: 1
}
}
],
rewards: [
{
id: "334f7c498726395f",
type: "ftbquests:xp",
xp: 1000
}
]
},
{
id: "122450d405e7ce56",
x: 10.0,
y: 0.0,
shape: "circle",
dependencies: [
"334f7c4987263954"
],
tasks: [
{
id: "122450d405e7ce5e",
type: "ftbquests:item",
item: {
item: "scicraft:renegade_glass",
count: 1
}
}
],
rewards: [
{
id: "122450d405e7ce5f",
type: "ftbquests:xp",
xp: 300
}
]
},
{
id: "fb564dcc8844cdd6",
x: 12.0,
y: 0.0,
shape: "circle",
dependencies: [
"0b79d27becaeafc6"
],
tasks: [
{
id: "fb564dcc8844cdde",
type: "ftbquests:dimension",
dimension: "dimensionaldoors:limbo"
}
],
rewards: [
{
id: "fb564dcc8844cddf",
type: "ftbquests:xp",
xp: 400
}
]
},
{
id: "c71b96a9869a6607",
x: 14.0,
y: -1.0,
shape: "circle",
dependencies: [
"334f7c4987263954"
],
tasks: [
{
id: "c71b96a9869a660e",
type: "ftbquests:dimension",
dimension: "thevoiddimension:overworld"
}
],
rewards: [
{
id: "c71b96a9869a660f",
type: "ftbquests:xp",
xp: 750
}
]
},
{
id: "85e6fcba2ecb28a6",
x: 14.0,
y: 1.0,
shape: "circle",
dependencies: [
"334f7c4987263954"
],
tasks: [
{
id: "85e6fcba2ecb28ae",
type: "ftbquests:dimension",
dimension: "deeperdarker:otherside"
}
],
rewards: [
{
id: "85e6fcba2ecb28af",
type: "ftbquests:xp",
xp: 750
}
]
},
{
id: "7ad80334ef67b3db",
x: 14.0,
y: -3.0,
shape: "circle",
dependencies: [
"334f7c4987263954"
],
tasks: [
{
id: "7ad80334ef67b3de",
type: "ftbquests:dimension",
dimension: "stellaris:moon"
}
],
rewards: [
{
id: "7ad80334ef67b3df",
type: "ftbquests:xp",
xp: 600
}
]
}
],
quest_links: [],
images: []
}

View file

@ -0,0 +1,88 @@
{
"chapter.e7311a3c8487ccee.title": "The Dark Photon Protocol",
"quest.af426aae065d8b5d.title": "First Steps",
"quest.af426aae065d8b5d.quest_desc": [
"You are the last engineer of the Second Renegade Flight.",
"",
"A fifth force — dark photons — holds a collapsed star-empire sealed behind a Dimensional Door. The seal is failing.",
"",
"The Corruption Tide is a global pressure that rises while Doors go unsealed. It climbs every 60 seconds. Re-seal Doors at a powered Quantum Lattice with a Void Stabilizer to push it back. There is no fail state — just a world that grows darker.",
"",
"Your first step: recover Photon Fragments from the Darker's creatures — Wardens, Mutant Monsters, and Born in Chaos mobs."
],
"quest.2008fe12b4d41b0d.title": "The Signal",
"quest.2008fe12b4d41b0d.quest_desc": [
"Recover a Photon Fragment from a creature of the Dark.",
"",
"Sources:",
"- Warden: 1-3",
"- Mutant Zombie / Skeleton: 1-2",
"- Mutant Enderman: 2-4",
"- Born in Chaos Dark Vortex / Dread Hound: 1",
"- Nightmare Stalker: 2-3",
"",
"You can also extract one from an Echo Shard and Glowstone Dust."
],
"quest.43538030951a509c.title": "The Core",
"quest.43538030951a509c.quest_desc": [
"Press three Photon Fragments into a Photon Core.",
"",
"Use a Create Mechanical Press on 3x Photon Fragments, or smelt an Ender Pearl in the heart of the wound.",
"",
"Holding a Photon Core grants Night Vision."
],
"quest.0b79d27becaeafc6.title": "The Seal",
"quest.0b79d27becaeafc6.quest_desc": [
"Craft the Void Stabilizer — the renegades' tool for closing wounds.",
"",
"Recipe: a column of Photon Cores with an Ender Eye at the heart.",
"",
"It never breaks. The work will. Holding it grants Speed and Regeneration."
],
"quest.334f7c4987263954.title": "The Lattice",
"quest.334f7c4987263954.quest_desc": [
"Assemble the Quantum Lattice — the Protocol's emitter — and keep it powered.",
"",
"Recipe: steel ingots, circuits, and a Photon Core.",
"",
"Place it, power it, then right-click it with a Void Stabilizer to re-seal a Door and push back the Corruption Tide by 15."
],
"quest.122450d405e7ce56.title": "The Legacy",
"quest.122450d405e7ce56.quest_desc": [
"Craft Renegade Glass — the TARDIS-blue glass of the Flight.",
"",
"Purely decorative. Some say it hums near Doors.",
"",
"Recipe: glass blocks around a Photon Fragment."
],
"quest.fb564dcc8844cdd6.title": "Through the Doors",
"quest.fb564dcc8844cdd6.quest_desc": [
"Enter a Dimensional Door.",
"",
"Limbo is the scar-tissue of the Flight's prison — the space between the doors.",
"",
"The first test of your nerve."
],
"quest.c71b96a9869a6607.title": "The Wound",
"quest.c71b96a9869a6607.quest_desc": [
"Descend into the Void Dimension — the raw leak of the collapsing empire.",
"",
"Danger: the wound drains 1 HP every 5 seconds. Carry the Void Stabilizer to hold on."
],
"quest.85e6fcba2ecb28a6.title": "The Answer",
"quest.85e6fcba2ecb28a6.quest_desc": [
"Reach the Othersides of the Deeper and Darker.",
"",
"What answers from inside the prison. The richest harvest of Photon Fragments.",
"",
"Danger: the Wither takes hold here."
],
"quest.7ad80334ef67b3db.title": "Per Spatium",
"quest.7ad80334ef67b3db.quest_desc": [
"Launch a rocket.",
"",
"The Flight scattered its data across the worlds of this system — the moon, Mars, Venus, Mercury.",
"",
"Each holds a piece of the Protocol's history. Per Spatium."
]
}