Opening chapter data
Bind the garden's personal introduction to its reviewed structure, scenes, dialogue routes and quests.
The opening descriptor binds one complete chapter. It does not execute arbitrary actions or create another chapter system. Coordinates refer to the garden’s shared local frame.
Where the files live
The fixed resource is data/isekaiexpansion/story_chapters/remote_sky_garden.json. Resource-pack priority selects one complete file; fields are not merged. Scene and quest IDs refer to their respective data resources. Dialogue IDs refer to registered Blabber graphs.
Minimal example
All role maps are required. This is the shipped descriptor; its fingerprint is valid only for the corresponding native bundle composition:
{
"schema": 4,
"bundle_digest": "32ee8e6e7871709822683e1602d2976398b0ac959d98e269927f94c754c38618",
"anchors": {
"reveal": {
"position": [
-0.5,
0,
159.5
],
"yaw": 180,
"radius": 16
},
"selene": {
"position": [
13.5,
24,
22.5
],
"yaw": 39.093859,
"radius": 10
},
"construction": {
"position": [
-0.5,
26,
-12.5
],
"yaw": 0,
"radius": 3
},
"portal": {
"position": [
37.5,
24,
37.5
],
"yaw": 83.659808,
"radius": 4
}
},
"guidance": {
"reveal": {
"enabled": true,
"color": "#B7E8E3",
"beam_height": 18,
"beam_radius": 0.85,
"visible_distance": 256,
"through_wall_distance": 128,
"billboard_height": 3.2
},
"selene": {
"enabled": true,
"color": "#B7E8E3",
"beam_height": 14,
"beam_radius": 0.7,
"visible_distance": 256,
"through_wall_distance": 128,
"billboard_height": 3.0
},
"construction": {
"enabled": true,
"color": "#D6C4FF",
"beam_height": 12,
"beam_radius": 0.8,
"visible_distance": 192,
"through_wall_distance": 96,
"billboard_height": 2.8
},
"portal": {
"enabled": true,
"color": "#B7E8E3",
"beam_height": 16,
"beam_radius": 1.0,
"visible_distance": 256,
"through_wall_distance": 128,
"billboard_height": 4.5
}
},
"scenes": {
"reveal": "isekaiexpansion:chapter_01/reveal",
"contact": "isekaiexpansion:chapter_01/contact",
"construction": "isekaiexpansion:chapter_01/construction",
"portal": "isekaiexpansion:chapter_01/portal",
"portal_return": "isekaiexpansion:chapter_01/portal_return"
},
"dialogues": {
"body_invitation": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/body_invitation",
"construction_approach": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/construction_approach",
"creation_resume": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/creation_resume",
"departure": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/departure",
"first_contact": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/first_contact",
"first_steps": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/first_steps",
"portal_delayed": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/portal_delayed",
"portal_ready": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/portal_ready",
"summoning": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/summoning",
"supplies_delayed": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/supplies_delayed",
"supplies_received": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/supplies_received",
"construction_wait": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/construction_wait",
"team_creation_wait": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/team_creation_wait",
"return_request": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/return_request",
"return_preparing": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/return_preparing",
"return_ready": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/return_ready",
"first_contact_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/first_contact_team",
"summoning_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/summoning_team",
"construction_approach_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/construction_approach_team",
"departure_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/departure_team",
"portal_ready_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/portal_ready_team",
"body_invitation_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/body_invitation_team",
"creation_choice": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/creation_choice",
"first_steps_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/first_steps_team",
"supplies_received_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/supplies_received_team"
},
"quests": [
"isekaiexpansion:chapter_01/look_around",
"isekaiexpansion:chapter_01/meet_selene",
"isekaiexpansion:chapter_01/construction_circle",
"isekaiexpansion:chapter_01/take_shape",
"isekaiexpansion:chapter_01/first_belongings",
"isekaiexpansion:chapter_01/way_down",
"isekaiexpansion:chapter_01/first_step"
]
}
Fields
| Field | Type | Default | Contract |
|---|---|---|---|
schema | number | Required | Exactly 4. Unsupported values reject the descriptor. |
bundle_digest | string | Required | Exactly 64 lowercase hexadecimal characters, matching the placed garden’s combined resource digest. |
anchors | object | Required | Exactly reveal, selene, construction and portal. |
anchors.<role>.position | number array | Required | Exactly 3 finite local coordinates, in blocks. Add the placed garden origin; every anchor must lie within its bounds. |
anchors.<role>.yaw | number | Required | Finite degrees. This is actor/portal orientation, separate from the scene trigger’s facing. |
anchors.<role>.radius | number | Required | Finite radius, 0.25–64 blocks. |
guidance | object | required | Exactly reveal, selene, construction and portal; each role configures its destination presentation. |
guidance.<role>.enabled | boolean | required | Show guidance for this role. false disables both beam and marker without changing story progress. |
guidance.<role>.color | string | required | RGB colour in #RRGGBB form; exactly 6 hexadecimal digits. |
guidance.<role>.beam_height | number | required | Finite height, 2–64 blocks. |
guidance.<role>.beam_radius | number | required | Finite beam half-width, 0.15–4 blocks. |
guidance.<role>.visible_distance | number | required | Finite maximum player-to-destination distance, 8–512 blocks, for beam and marker. Both fade near the limit. |
guidance.<role>.through_wall_distance | number | required | Finite maximum distance for the marker and distance text through walls, 0–visible_distance blocks. 0 disables through-wall visibility. The beam always tests world depth. |
guidance.<role>.billboard_height | number | required | Finite marker height above the destination, 0.5–16 blocks. |
scenes | object | Required | Exactly reveal, contact, construction, portal and portal_return; 5 distinct scene IDs. |
dialogues | object | Required | Exactly the 25 route keys in the example; all dialogue IDs must be distinct. |
quests | identifier array | Required | 1–32 unique existing personal mainstory quests. |
Every scene, dialogue and quest ID must explicitly include its namespace and use at most 256 characters. Missing or unknown root or anchor fields reject. Missing or extra role-map keys reject. An empty descriptor is invalid.
Destination guidance
After awakening, the admitted party follows reveal, selene and construction in order. The construction marker remains through body creation and the supply conversation. The portal marker appears only after the ritual is complete and a usable entrance exists. Returning parties receive it when their entrance is available. Waiting parties receive no destination from another party’s session.
The distance label measures from your player to the destination and displays rounded metres as X m; one block is one metre. Portal guidance stands 2 blocks in front of the live entrance along its facing direction, at the same elevation. Only the marker and text can appear through walls within through_wall_distance. Beyond that range, a visual-shape raycast decides visibility and ignores fluids. The light beam remains occluded by world depth and has no ground sigil. Screens, cinematics, a hidden HUD, debug display, death, creative mode and spectator mode hide guidance.
Every guidance field is required, including for a disabled role. Missing or unknown fields, malformed colours, nonnumeric sizes, nonfinite values and values outside their ranges reject the whole descriptor. Schema 4 is the only accepted format; no old-schema reader or migration remains.
Scene and dialogue contracts
Scenes must use the trigger pivot in local_yaw, lock input and movement, and disable Escape skipping. The player is triggering_player; all scenes except reveal require Selene selected by nearest_type with entity type isekaiexpansion:goddess_selene. Each scene has one isekaiexpansion:chapter_01/complete signal before its end. The portal and portal_return scenes each have one isekaiexpansion:chapter_01/open_portal signal, at tick 92 (4.6 seconds).
The portal role handles first departure; portal_return handles later reopening from Selene’s idle position. Both use the portal anchor and require a forced npc_body_emote cue for isekaiexpansion:story_portal at tick 0. The first portal_return camera node must be at tick 0 with its look-at actor set to selene. The bundled return scene lasts 192 ticks (9.6 seconds), cuts to the entrance at tick 96 (4.8 seconds) and keeps Selene in place while casting.
Dialogue routes use their terminal keys as decisions. Changing a line does not change these gates:
| Route | Progress terminal |
|---|---|
first_contact, summoning, construction_approach, supplies_received, and their _team variants | end; the party speaker credits the admitted listeners after a shared route |
body_invitation, creation_resume | end_ready; only this player’s creation is allowed at the circle; end_wait remembers the invitation |
body_invitation_team | end; explains creation to the party and opens separate personal decisions |
creation_choice | end_ready allows only this player’s creation at the circle; end_wait postpones it |
first_steps, first_steps_team | end_receive acknowledges the offer. Each character receives the kit independently after creation. |
departure, departure_team, return_request | end_open; return_request acquires a new return session after departure |
portal_ready, portal_ready_team, supplies_delayed, portal_delayed, construction_wait, team_creation_wait, return_preparing, return_ready | None; information or retry dialogue |
end_wait on a body invitation records creation_offered only, so the next interaction resumes without repeating the approach. Other waiting terminals give no progression. Forced closure does not complete a route. The active opening permits only its current story route for Selene; ordinary social content is not a fallback. Chinese and English keys are authored together in the dialogue and cinematic language categories.
Developer block data
The shipped isekaiexpansion:scene_trigger blocks keep audience_mode / AudienceMode as triggering_player for their personal replay records. The opening chapter coordinator supplies the fixed party audience for its five bound scenes and can recover a missed checkpoint without replay-memory resets. Reopening starts through dialogue; it needs no additional trigger block. Do not change the blocks to team_nearby to grant personal facts. The shipped triggers face north; actor and portal yaw comes from the descriptor.
isekaiexpansion:story_barrier is invisible and evaluates collision separately for each moving player. Creative, spectator and nonplayer entities pass. Its block entity has no ticker. Author this NBT through native typed block-entity data:
| NBT field | Type | Default | Contract |
|---|---|---|---|
BlockedWhen | compound | Absent | Absent or a noncompound gives no blocking predicate. A valid compound blocks matching survival players. |
BlockedWhen.requires | string list | Required in compound | All facts required. At most 64 unique namespaced IDs, each at most 256 characters. Empty accepts any facts. |
BlockedWhen.excludes | string list | Required in compound | None may be recorded. Same limits; overlap with requires rejects. |
Wrong list types, duplicate IDs or invalid identifiers reject the predicate. The shipped barrier requires enrollment and excludes reveal completion and bypass, so each player passes after their own panorama. Falling from the opening area returns the active player to the authored birth plane without resetting completed facts.
Validation
Admission also checks scene definitions, registered dialogues, personal mainstory quest scope, anchor bounds and the placed bundle digest. Rejected or unavailable resources disable chapter enrollment and leave ordinary creation and starter grants available. A saved prototype with a different bundle is not migrated; use a fresh matching world.
Reloading
The descriptor reload clears the previous definition before reading the current resource. Invalid replacement data therefore disables availability instead of retaining a stale definition. Active unfinished players reconcile on the server; fallback removes their active chapter journal entries. Live scene and entity presentation still needs an in-game interruption/reconnection check after content changes.