alchemy-docs/vale__eruption_8c_source.html

/// @file

/// Vale's square during the eruption, where the villagers wait for Isaac and

/// Garet to come down the mountain. The erupting mountain is Mt. Aleph.


#include "game_state.h"

#include "unit/scene/vale_eruption.h"

#include "unit/object/object.h"

#include "unit/object/psynergy_effects.h"

#include "battle.h"

#include "debug.h"

#include "field.h"

#include "game.h"

#include "graphics.h"

#include "menu.h"

#include "minigame.h"

#include "sound.h"

#include "system.h"

#include "types.h"

#include "field_event.h"

#include "field_scene.h"

#include "text/msg_ids.h"

#include "objcmd.h"

#include "flags.h"

#include "songs.h"

#include "fixed_math.h"


/// The placed actors, numbered in the order of gValeEruption_Placements;

/// Garet's row places the party's Garet and takes no number.

enum ValeEruptionActor {

  /// The Great Healer (sprite 0x79, the healer of sanctum.c), who leads the

  /// villagers into the sanctum. "Come into the sanctum, both of you."

  ACTOR_GREAT_HEALER = ACTOR_FIRST_PLACED,

  /// Garet's grandfather, the mayor (sprite 0x75, whom the Great Healer calls

  /// Mayor in sanctum.c). "Oooh, my grandson! Will Garet be safe in this

  /// eruption?!?"

  ACTOR_GARETS_GRANDFATHER = ACTOR_FIRST_PLACED + 1,

  /// Isaac's mother (sprite 0x1f, Dora in sanctum.c). "Isaac and Garet went

  /// to Mr. Kraden's house."

  ACTOR_DORA = ACTOR_FIRST_PLACED + 2,

  /// She calls the mayor Grandpa, and actor 12 calls her Sis. "Grandpa, we

  /// don't even know if he's up there!"

  ACTOR_GARETS_SISTER = ACTOR_FIRST_PLACED + 3,

  /// The guard. "They were hanging around here while I was on guard duty."

  ACTOR_GUARD = ACTOR_FIRST_PLACED + 5

};


static void Event_ReturnFromMtAleph(void);


/// Returns where the party appears: entrance 15 is the path down from the

/// mountain, Mt. Aleph.

const struct SceneEntrance *ValeEruption_GetEntrances(void) {

  return gValeEruption_Entrances;

}


const struct SceneRegion *ValeEruption_GetRegions(void) { return NULL; }


/// Returns the one exit, into the sanctum (Sanctum's entrance 20), which

/// Event_ReturnFromMtAleph takes.

const u32 *ValeEruption_GetExits(void) { return gValeEruption_Exits; }


/// Returns Garet and the villagers gathered before the sanctum.

const struct ScenePlacement *ValeEruption_GetPlacements(void) {

  return gValeEruption_Placements;

}


/// The square has no events of its own: everything happens on arrival.

const struct SceneEvent *ValeEruption_GetEvents(void) {

  return gValeEruption_Events;

}


/// Plays the return from the mountain when the party arrives by entrance 15.

/// Called by Field_RunScene once the actors are placed; entrance 15 is where

/// Sol Sanctum's approach leads after the eruption and before the party

/// leaves Vale (its exit 1).

s32 ValeEruption_Initialize(void) {

  if (gGameState.entrance == 15) {

    Event_ReturnFromMtAleph();

  }

  return 0;

}


/// The volcano shakes the square while the villagers wonder where Isaac and

/// Garet are; the two come down the mountain, tell that Jenna and Kraden were

/// taken away, and follow the elders into the sanctum.

/// Called by ValeEruption_Initialize on arrival by entrance 15. Clears

/// FLAG_SHOW_LOCATION_NAME, sets FLAG_VALE_RETURNED_FROM_MT_ALEPH and takes

/// exit 1 into the sanctum, where Sanctum_RequestQuestAcceptance follows.

static void Event_ReturnFromMtAleph(void) {

  struct EventWork *work;

  const s32 *actionScript;


  Engine_EventBegin();

  Engine_ActorSetAnimation(14, 0);

  Engine_ActorSetAnimation(15, 0);

  Engine_ActorSetAnimation(16, 0);

  Engine_ActorSetAnimation(17, 0);

  Engine_ActorSetAnimation(18, 0);

  Engine_ActorSetAnimation(19, 0);

  Actor_WalkToAndWait(ACTOR_GARETS_SISTER, 265, 487);

  Actor_FaceDirection(ACTOR_GARETS_SISTER, FACING_NORTHWEST, 0);

  Actor_WalkToAndWait(12, 256, 500);

  Actor_FaceDirection(12, FACING_NORTHWEST, 0);

  // A lightning flash, then the screen opens on the square below.

  BattleFx_StartBufferBlend(0x10003, 0x10006);

  FieldFx_LastLightning();

  Engine_TaskWait(60);

  Camera_MoveTo(PIXELS(256), -1, PIXELS(612), 0);

  Engine_CameraWaitForMove();

  Engine_MapRedraw();

  work = gEventWork;

  work->startTransition = 0;

  work->transitionFrames = 32;

  Engine_EventOpenScreen();


  // The camera pans up to the villagers as the ground shakes.

  Camera_SetSpeed(0xcccc, 0x1999);

  Camera_MoveTo(PIXELS(256), -1, PIXELS(500), 1);

  Engine_EventWait(20);

  Map_SetShake(PIXELS(1), PIXELS(2), Q16_ONE);

  FieldFx_LastLightning();

  Event_PlayCue(SE_145);

  Engine_EventWait(30);

  FieldFx_LastLightning();

  Event_PlayCue(SE_145);

  Engine_CameraWaitForMove();

  Map_SetShake(PIXELS(2), PIXELS(3), Q16_ONE);

  FieldFx_LastLightning();

  Event_PlayCue(SE_145);

  Map_SetShake(-1, -1, 0xe666);

  Engine_MapRenderWaitForValues();

  Engine_EventWait(60);


  // "I thought Mt. Aleph was inactive..." The villagers worry about Isaac and

  // Garet, last seen going to Kraden's house.

  Engine_EventSetMessage(MsgValeMtAlephWasInactive);

  Actor_ShowEmote(ACTOR_GREAT_HEALER, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(60);

  Event_ShowMessage(ACTOR_GREAT_HEALER, 0);

  Actor_FaceDirection(ACTOR_GARETS_GRANDFATHER, FACING_SOUTH + FACING_STEP, 0);

  Engine_EventWait(30);

  // The mayor: "Oooh, my grandson!"

  Event_ShowMessage(ACTOR_GARETS_GRANDFATHER, 0);

  Engine_EventWait(30);

  // Garet's sister doubts he is up there; actor 12 says someone saw him climb.

  Engine_ActorSetAnimationAndWait(ACTOR_GARETS_SISTER, ANIM_SHAKE_HEAD);

  Event_ShowMessage(ACTOR_GARETS_SISTER, 0);

  Actor_FaceDirection(ACTOR_GARETS_GRANDFATHER, FACING_SOUTHEAST + FACING_STEP,

                      0);

  Actor_FaceActor(12, ACTOR_GARETS_SISTER, 0);

  Engine_EventWait(30);

  Engine_ActorSetAnimationAndWait(12, ANIM_SHAKE_HEAD);

  Event_ShowMessage(12, 0);

  // The guard saw them hanging around; Dora says they went to Kraden's house,

  // and the mayor and Dora wonder what Alchemy has to do with the eruption.

  Engine_ActorRunRepeatedMotion(ACTOR_GUARD, 1);

  Event_ShowMessage(ACTOR_GUARD, 0);

  Actor_FaceActor(ACTOR_DORA, ACTOR_GUARD, 0);

  Engine_EventWait(30);

  Engine_ActorRunRepeatedMotion(ACTOR_DORA, 1);

  Event_ShowMessage(ACTOR_DORA, 0);

  Actor_FaceActor(ACTOR_GARETS_GRANDFATHER, ACTOR_DORA, 0);

  Engine_EventWait(30);

  Engine_ActorRunRepeatedMotion(ACTOR_GARETS_GRANDFATHER, 1);

  Event_ShowMessage(ACTOR_GARETS_GRANDFATHER, 0);

  Actor_FaceActor(ACTOR_DORA, ACTOR_GARETS_GRANDFATHER, 0);

  Engine_EventWait(30);

  Engine_ActorSetAnimationAndWait(ACTOR_DORA, ANIM_SHAKE_HEAD);

  Event_ShowMessage(ACTOR_DORA, 0);

  Engine_EventWait(60);

  Map_SetShake(PIXELS(2), PIXELS(3), Q16_ONE);

  FieldFx_LastLightning();

  Event_PlayCue(SE_145);

  Engine_EventWait(60);

  Engine_ActorFaceEachOther(ACTOR_GREAT_HEALER, ACTOR_GARETS_GRANDFATHER, 0);

  Engine_ActorFaceEachOther(ACTOR_DORA, ACTOR_GARETS_SISTER, 0);

  Engine_ActorFaceEachOther(12, ACTOR_GUARD, 0);

  Engine_ActorStartRepeatedMotion(ACTOR_GREAT_HEALER, 2);

  Engine_ActorStartRepeatedMotion(ACTOR_GARETS_GRANDFATHER, 2);

  Engine_ActorStartRepeatedMotion(ACTOR_DORA, 2);

  Engine_ActorStartRepeatedMotion(ACTOR_GARETS_SISTER, 2);

  Engine_ActorStartRepeatedMotion(12, 2);

  Engine_ActorStartRepeatedMotion(ACTOR_GUARD, 2);

  Map_SetShake(-1, -1, 0xe666);

  Engine_MapRenderWaitForValues();


  // Isaac and Garet come down the path, and Garet sees the villagers: "Uh-oh.

  // It's Grandpa and the others."

  Actor_SetSpeed(ACTOR_PARTY_LEADER, 0x8000, 0x4000);

  Actor_SetSpeed(GARET, 0x8000, 0x4000);

  Actor_SetPosition(ACTOR_PARTY_LEADER, PIXELS(120), PIXELS(258));

  Camera_SetSpeed(0x18000, 0x3000);

  Camera_MoveTo(PIXELS(112), -1, PIXELS(320), 1);

  Engine_EventWait(40);

  Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_WALK);

  Engine_ActorSetAnimation(GARET, ANIM_WALK);

  Actor_SetDestination(ACTOR_PARTY_LEADER, 120, 320);

  Actor_MoveToAndWait(GARET, 104, 320);

  Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_STAND);

  Engine_ActorSetAnimation(GARET, ANIM_STAND);

  Engine_CameraWaitForMove();

  Engine_EventWait(30);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT, 0);

  Engine_EventWait(50);

  Actor_SetSpeed(GARET, 0x18000, 0xc000);

  Engine_ActorSetAnimation(GARET, ANIM_WALK);

  Actor_MoveToAndWait(GARET, 105, 342);

  Engine_ActorSetAnimation(GARET, ANIM_STAND);

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Event_ShowMessage(GARET, 0);

  Engine_EventWait(10);

  Engine_ActorStartRepeatedMotion(ACTOR_PARTY_LEADER, 1);

  Engine_ActorFaceEachOther(ACTOR_PARTY_LEADER, GARET, 0);

  Engine_EventWait(20);


  // "What should we do, Isaac? Should we go back up?" Either way, the two stay.

  Event_OpenMessage(GARET, 0);

  if (Engine_EventChooseYesNo(0, 0) == 0) {

    Engine_EventWait(60);

    Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_NOD);

    Engine_ActorSetAnimation(GARET, ANIM_NOD);

    Engine_EventWait(50);

    Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_NORTH, 0);

    Engine_ActorSetAnimation(GARET, ANIM_WALK);

    Actor_SetSpeed(GARET, Q16_ONE, 0x8000);

    Actor_MoveToAndWait(GARET, 103, 320);

    Engine_ActorSetAnimation(GARET, ANIM_STAND);

  } else {

    Engine_EventWait(60);

    Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_NOD);

    Engine_ActorSetAnimation(GARET, ANIM_NOD);

    Engine_EventWait(50);

    Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

    Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_WALK);

    Actor_MoveToAndWait(ACTOR_PARTY_LEADER, 120, 340);

    Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_STAND);

  }


  // The villagers spot them: "Garet!" "Isaac!"

  // Actor 12 cries "Garet!" and the villagers turn to the path.

  Event_ShowMessage(12, 0);

  Actor_SetAttachedEffect(GARET, 0x102);

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Engine_EventWait(40);

  Actor_FaceDirection(ACTOR_GARETS_GRANDFATHER, FACING_NORTHWEST, 0);

  Actor_FaceDirection(ACTOR_GARETS_SISTER, FACING_NORTHWEST, 0);

  Actor_FaceDirection(ACTOR_DORA, FACING_NORTHWEST, 0);

  Actor_FaceDirection(12, FACING_NORTHWEST, 0);

  Actor_FaceDirection(ACTOR_GUARD, FACING_NORTHWEST, 0);

  // The camera flies to Dora: "Isaac!" The Great Healer: "You're safe!"

  Camera_SetSpeed(0x30000, 0x6000);

  Engine_CameraMoveToActor(ACTOR_DORA, 1);

  Engine_CameraWaitForMove();

  Engine_EventWait(50);

  Engine_ActorRunRepeatedMotion(ACTOR_DORA, 2);

  Event_ShowMessage(ACTOR_DORA, 0);

  Engine_EventWait(30);

  Engine_ActorRunRepeatedMotion(ACTOR_GREAT_HEALER, 1);

  Event_ShowMessage(ACTOR_GREAT_HEALER, 0);

  Engine_EventWait(40);

  // The mayor: "Come over here, both of you!"

  Engine_ActorRunRepeatedMotion(ACTOR_GARETS_GRANDFATHER, 1);

  Event_ShowMessage(ACTOR_GARETS_GRANDFATHER, 0);

  Engine_EventWait(40);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

  Camera_MoveTo(PIXELS(112), -1, PIXELS(320), 1);

  Engine_CameraWaitForMove();

  Engine_ActorStartRepeatedMotion(ACTOR_PARTY_LEADER, 2);

  Engine_ActorStartRepeatedMotion(GARET, 2);

  Object_RefreshSelectorById(1);

  Engine_EventWait(50);

  Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_NOD);

  Engine_ActorSetAnimation(GARET, ANIM_NOD);

  Object_RefreshSelectorById(1);

  Engine_EventWait(60);


  // "Come over here, both of you!" The two walk down to the villagers.

  Camera_SetSpeed(Q16_ONE, 0x2000);

  Camera_MoveTo(PIXELS(214), -1, PIXELS(472), 1);

  Actor_SetSpeed(ACTOR_PARTY_LEADER, Q16_ONE, 0x8000);

  Actor_SetSpeed(GARET, Q16_ONE, 0x8000);

  Actor_SetActionScript(ACTOR_PARTY_LEADER, gValeEruption_LeaderWalksDown);

  Engine_EventWait(30);

  Actor_SetActionScript(GARET, gValeEruption_GaretWalksDown);

  Object_RefreshSelectorById(1);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_EAST, 0);

  Actor_FaceDirection(GARET, FACING_EAST, 0);

  Engine_CameraWaitForMove();

  Actor_FaceDirection(ACTOR_GARETS_GRANDFATHER, FACING_WEST, 0);

  Actor_SetSpeed(ACTOR_GREAT_HEALER, 0xcccc, 0x6666);

  Engine_ActorSetAnimation(ACTOR_GREAT_HEALER, ANIM_WALK);

  Actor_MoveToAndWait(ACTOR_GREAT_HEALER, 265, 455);

  Actor_MoveToAndWait(ACTOR_GREAT_HEALER, 246, 455);

  Engine_ActorSetAnimation(ACTOR_GREAT_HEALER, ANIM_STAND);

  Engine_EventWait(30);


  // "Where have you been?" "What happened?"

  Engine_ActorRunRepeatedMotion(ACTOR_GARETS_GRANDFATHER, 1);

  Event_ShowMessage(ACTOR_GARETS_GRANDFATHER, 0);

  Actor_ShowEmote(ACTOR_PARTY_LEADER, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(50);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(50);

  // The Great Healer: "What happened?" The two look at each other and shake

  // their heads.

  Engine_ActorRunRepeatedMotion(ACTOR_GREAT_HEALER, 1);

  Event_ShowMessage(ACTOR_GREAT_HEALER, 0);

  Engine_EventWait(40);

  Engine_ActorFaceEachOther(ACTOR_PARTY_LEADER, GARET, 0);

  Engine_EventWait(50);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_EAST, 0);

  Actor_FaceDirection(GARET, FACING_EAST, 0);

  Engine_EventWait(20);

  Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_SHAKE_HEAD);

  Engine_ActorSetAnimationAndWait(GARET, ANIM_SHAKE_HEAD);

  Engine_EventWait(40);

  // Dora notices who is missing.

  Actor_ShowEmote(ACTOR_DORA, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(50);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

  Engine_EventWait(10);


  // "Weren't Jenna and Kraden with you?" Yes: "They were taken away? By

  // whom?"; no: "What do you mean, they were taken away?"

  Event_OpenMessage(ACTOR_DORA, 0);

  if (Engine_EventChooseYesNo(0, 0) == 0) {

    // The mayor answers either reply; the other reply is skipped.

    Engine_EventWait(40);

    Engine_ActorFaceEachOther(ACTOR_GREAT_HEALER, ACTOR_GARETS_GRANDFATHER, 0);

    Engine_EventWait(50);

    Actor_FaceDirection(ACTOR_GREAT_HEALER, FACING_WEST, 0);

    Actor_FaceDirection(ACTOR_GARETS_GRANDFATHER, FACING_WEST, 0);

    Engine_EventWait(40);

    Engine_ActorRunRepeatedMotion(ACTOR_GARETS_GRANDFATHER, 1);

    Event_ShowMessage(ACTOR_GARETS_GRANDFATHER, 0);

    Event_SkipMessages(1);

  } else {

    Engine_EventWait(40);

    Engine_ActorFaceEachOther(ACTOR_GREAT_HEALER, ACTOR_GARETS_GRANDFATHER, 0);

    Engine_EventWait(50);

    Actor_FaceDirection(ACTOR_GREAT_HEALER, FACING_WEST, 0);

    Actor_FaceDirection(ACTOR_GARETS_GRANDFATHER, FACING_WEST, 0);

    Engine_EventWait(40);

    Engine_ActorRunRepeatedMotion(ACTOR_GARETS_GRANDFATHER, 1);

    Event_SkipMessages(1);

    Event_ShowMessage(ACTOR_GARETS_GRANDFATHER, 0);

  }

  Engine_EventWait(30);

  // Garet starts to tell, and both shake their heads again.

  Actor_FaceDirection(GARET, FACING_EAST, 0);

  Engine_EventWait(30);

  Engine_ActorStartRepeatedMotion(ACTOR_PARTY_LEADER, 2);

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Engine_EventWait(40);

  Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_SHAKE_HEAD);

  Engine_ActorSetAnimationAndWait(GARET, ANIM_SHAKE_HEAD);

  Engine_EventWait(60);


  // "This is all very complicated... Come into the sanctum, both of you."

  Engine_ActorRunRepeatedMotion(ACTOR_GREAT_HEALER, 1);

  Event_ShowMessage(ACTOR_GREAT_HEALER, 0);

  Actor_FaceActor(ACTOR_GREAT_HEALER, ACTOR_GARETS_GRANDFATHER, 0);

  Engine_EventWait(30);

  Engine_ActorRunRepeatedMotion(ACTOR_GREAT_HEALER, 1);

  Engine_EventWait(30);

  Engine_ActorSetAnimationAndWait(ACTOR_GREAT_HEALER, ANIM_NOD);

  Engine_EventWait(30);

  Event_ShowMessage(ACTOR_GREAT_HEALER, 0);

  Engine_EventWait(20);

  // The mayor agrees with a nod; the Great Healer sends them inside.

  Engine_ActorRunRepeatedMotion(ACTOR_GARETS_GRANDFATHER, 1);

  Actor_FaceDirection(ACTOR_GARETS_GRANDFATHER, FACING_NORTHWEST + FACING_STEP,

                      0);

  Engine_EventWait(30);

  Engine_ActorSetAnimationAndWait(ACTOR_GARETS_GRANDFATHER, ANIM_NOD);

  Engine_EventWait(50);

  Actor_FaceDirection(ACTOR_GREAT_HEALER, FACING_WEST, 0);

  Engine_EventWait(20);

  Engine_ActorRunRepeatedMotion(ACTOR_GREAT_HEALER, 1);

  Event_ShowMessage(ACTOR_GREAT_HEALER, 0);

  Engine_EventWait(40);

  Engine_ActorFaceEachOther(ACTOR_GREAT_HEALER, ACTOR_GARETS_GRANDFATHER, 0);

  Engine_EventWait(40);

  Engine_ActorSetAnimation(ACTOR_GREAT_HEALER, ANIM_NOD);

  Engine_ActorSetAnimationAndWait(ACTOR_GARETS_GRANDFATHER, ANIM_NOD);

  Engine_EventWait(30);


  // The sanctum's door opens and everyone files inside.

  Actor_WalkToAndWait(ACTOR_GREAT_HEALER, 255, 445);

  Engine_EventWait(40);

  Map_AnimateCells(gValeEruption_SanctumDoorOpens, 45, 11);

  Event_PlayCue(SE_188);

  Engine_EventWait(30);

  Actor_WalkTo(ACTOR_GREAT_HEALER, 255, 390);

  Engine_EventWait(20);

  Actor_SetSpeed(ACTOR_GARETS_GRANDFATHER, 0xcccc, 0x6666);

  Actor_SetSpeed(ACTOR_DORA, 0xcccc, 0x6666);

  Actor_WalkTo(ACTOR_GARETS_GRANDFATHER, 255, 390);

  Actor_WalkToAndWait(ACTOR_DORA, 255, 460);

  Actor_FaceDirection(ACTOR_DORA, FACING_WEST, 0);

  Engine_EventWait(40);

  Engine_ActorSetAnimationAndWait(ACTOR_DORA, ANIM_NOD);

  Engine_EventWait(30);

  Engine_ActorStartRepeatedMotion(ACTOR_PARTY_LEADER, 1);

  Engine_ActorRunRepeatedMotion(GARET, 1);

  Engine_EventWait(40);

  Actor_WalkTo(ACTOR_DORA, 255, 390);

  actionScript = gValeEruption_EnterSanctum;

  Actor_SetActionScript(ACTOR_PARTY_LEADER, actionScript);

  Engine_EventWait(40);

  Actor_SetActionScript(GARET, actionScript);

  Object_RefreshSelectorById(1);

  Actor_ShowEmote(ACTOR_GARETS_SISTER, EMOTE_IN_FRONT | 2, 0);

  Actor_ShowEmote(12, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(40);

  Map_SetShake(PIXELS(2), PIXELS(3), Q16_ONE);

  FieldFx_LastLightning();

  Event_PlayCue(SE_145);

  Engine_EventWait(30);

  work = gEventWork;

  work->startTransition = 0;

  work->transitionFrames = 64;

  Engine_EventCloseScreen();

  Map_SetShake(-1, -1, 0xe666);

  Engine_MapRenderWaitForValues();

  GameFlag_Clear(FLAG_SHOW_LOCATION_NAME);

  GameFlag_Set(FLAG_VALE_RETURNED_FROM_MT_ALEPH);

  Engine_EventRequestExit(1);

  Engine_EventEnd();

}


/// Isaac walks down from the path to the villagers before the sanctum.

s32 gValeEruption_LeaderWalksDown[] = {

    SC_ARG(2), SC_MOVE(PIXELS(128), 0, PIXELS(378)),

    SC_SYNC,   SC_MOVE(PIXELS(203), 0, PIXELS(378)),

    SC_SYNC,   SC_MOVE(PIXELS(212), 0, PIXELS(472)),

    SC_SYNC,   SC_MOVE(PIXELS(214), 0, PIXELS(472)),

    SC_SYNC,   SC_ARG(1),

    SC_END,

};


/// Garet follows him, stopping a little above.

s32 gValeEruption_GaretWalksDown[] = {

    SC_ARG(2), SC_MOVE(PIXELS(128), 0, PIXELS(378)),

    SC_SYNC,   SC_MOVE(PIXELS(203), 0, PIXELS(378)),

    SC_SYNC,   SC_MOVE(PIXELS(214), 0, PIXELS(455)),

    SC_SYNC,   SC_ARG(1),

    SC_END,

};


/// Isaac, then Garet, walk through the sanctum's door.

s32 gValeEruption_EnterSanctum[] = {

    SC_ARG(2), SC_MOVE(PIXELS(255), 0, PIXELS(452)),

    SC_SYNC,   SC_MOVE(PIXELS(255), 0, PIXELS(390)),

    SC_SYNC,   SC_ARG(1),

    SC_END,

};


struct SceneEntrance gValeEruption_Entrances[] = {

    {0, CONDITION_ALWAYS, 110, 0, 270, FACING_SOUTH, 0, -1, -1, -1, -1, 0},

    {15, CONDITION_ALWAYS, 103, 0, 284, FACING_SOUTH, 0, -1, -1, -1, -1, 0},

    {SCENE_TABLE_END},

};


u32 gValeEruption_Exits[] = {

    SCENE_EXITS(10),

    SCENE_EXIT(1, 9, 20),

    SCENE_EXITS_END,

};


// clang-format off

struct ScenePlacement gValeEruption_Placements[] = {

    { GARET, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(104), 0, PIXELS(258), FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { 0x79, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(265), 0, PIXELS(468), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x75, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(246), 0, PIXELS(468), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x1f, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(246), 0, PIXELS(487), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x2a, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(265), 0, PIXELS(477), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x25, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(256), 0, PIXELS(490), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x7a, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(265), 0, PIXELS(523), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x65, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(245), 0, PIXELS(532), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x72, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(256), 0, PIXELS(543), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x73, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(283), 0, PIXELS(536), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x66, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(235), 0, PIXELS(552), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x6c, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(265), 0, PIXELS(561), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { 0x74, CONDITION_ALWAYS, ACTOR_STAND,

        PIXELS(247), 0, PIXELS(573), FACING_NORTHWEST, TALK_FACE_PARTY, 0 },

    { SCENE_TABLE_END },

};

// clang-format on


struct SceneEvent gValeEruption_Events[] = {

    {SCENE_EVENTS_END},

};


/// The sanctum's door, two cells wide, opening in two steps.

u16 gValeEruption_SanctumDoorOpens[] = {

    MAP_CELL_STEP(0, 98, 2, 2, 2),

    MAP_CELL_STEP(2, 98, 2, 2, 2),

    MAP_CELL_STEPS_END,

};

Object_RefreshSelectorById
void Object_RefreshSelectorById(u32 objectId)
Waits, at most 300 frames, for an actor's script to reach its end (command 0x10).
Definition actor_commands.c:77

GARET
#define GARET
Jerald.
Definition character_ids.h:8

debug.h
The engine calls the debug menus import, and their palette swatch tiles.

field_event.h
The scene script layer: the engine services a scene's events call, declared once (Engine_EventBegin,...

ANIM_WALK
@ ANIM_WALK
Definition field_event.h:44

ANIM_STAND
@ ANIM_STAND
Definition field_event.h:43

ANIM_NOD
@ ANIM_NOD
Definition field_event.h:45

ANIM_SHAKE_HEAD
@ ANIM_SHAKE_HEAD
Definition field_event.h:46

Event_OpenMessage
static s32 Event_OpenMessage(s32 speaker, s32 flags)
Definition field_event.h:217

Actor_SetDestination
static void Actor_SetDestination(s32 actor, s32 x, s32 z)
Definition field_event.h:237

Actor_FaceDirection
static void Actor_FaceDirection(s32 actor, s32 facing, s32 frames)
Definition field_event.h:255

Engine_ActorSetAnimationAndWait
void Engine_ActorSetAnimationAndWait(s32 actor, s32 animation)

Map_AnimateCells
static void Map_AnimateCells(const u16 *steps, s32 destX, s32 destY)
Definition field_event.h:334

Engine_EventChooseYesNo
s32 Engine_EventChooseYesNo(s32 actor, s32 flags)

Actor_WalkToAndWait
static void Actor_WalkToAndWait(s32 actor, s32 x, s32 z)
Definition field_event.h:383

Camera_SetSpeed
static void Camera_SetSpeed(s32 speed, s32 acceleration)
Definition field_event.h:271

Engine_CameraMoveToActor
void Engine_CameraMoveToActor(s32 actor, s32 pan)

EMOTE_IN_FRONT
#define EMOTE_IN_FRONT
Definition field_event.h:49

Actor_MoveToAndWait
static void Actor_MoveToAndWait(s32 actor, s32 x, s32 z)
Definition field_event.h:379

MAP_CELL_STEP
#define MAP_CELL_STEP(srcX, srcY, width, height, frames)
Definition field_event.h:59

Engine_EventCloseScreen
void Engine_EventCloseScreen(void)

Event_SkipMessages
static void Event_SkipMessages(s32 count)
Definition field_event.h:207

Actor_FaceActor
static void Actor_FaceActor(s32 actor, s32 target, s32 frames)
Definition field_event.h:259

Actor_WalkTo
static void Actor_WalkTo(s32 actor, s32 x, s32 z)
Definition field_event.h:247

GameFlag_Clear
#define GameFlag_Clear
Definition field_event.h:299

GameFlag_Set
#define GameFlag_Set
Definition field_event.h:297

Actor_ShowEmote
static void Actor_ShowEmote(s32 actor, s32 emote, s32 frames)
Definition field_event.h:263

Engine_EventOpenScreen
void Engine_EventOpenScreen(void)

Engine_MapRenderWaitForValues
void Engine_MapRenderWaitForValues(void)

Engine_CameraWaitForMove
void Engine_CameraWaitForMove(void)

Actor_SetActionScript
static void Actor_SetActionScript(s32 actor, const s32 *script)
The engine encodes either a built-in action or an action-script address.
Definition field_event.h:166

Engine_ActorRunRepeatedMotion
void Engine_ActorRunRepeatedMotion(s32 actor, s32 repeats)

Event_ShowMessage
static void Event_ShowMessage(s32 speaker, s32 flags)
Definition field_event.h:213

Event_PlayCue
static void Event_PlayCue(s32 cue)
Definition field_event.h:313

Map_SetShake
static void Map_SetShake(s32 horizontal, s32 vertical, s32 decay)
Sets shake amplitudes in fixed-point pixels and the per-frame decay factor.
Definition field_event.h:292

MAP_CELL_STEPS_END
#define MAP_CELL_STEPS_END
Definition field_event.h:61

Engine_ActorStartRepeatedMotion
void Engine_ActorStartRepeatedMotion(s32 actor, s32 repeats)

Actor_SetSpeed
static void Actor_SetSpeed(s32 actor, s32 speed, s32 acceleration)
Definition field_event.h:233

Engine_MapRedraw
void Engine_MapRedraw(void)

Camera_MoveTo
static void Camera_MoveTo(s32 fixed_x, s32 fixed_y, s32 fixed_z, s32 pan)
Definition field_event.h:275

Actor_SetPosition
static void Actor_SetPosition(s32 actor, s32 fixed_x, s32 fixed_z)
Definition field_event.h:229

Engine_ActorFaceEachOther
void Engine_ActorFaceEachOther(s32 actor, s32 other, s32 frames)

Engine_EventWait
void Engine_EventWait(s32 frames)

Actor_SetAttachedEffect
static void Actor_SetAttachedEffect(s32 actor, s32 effect)
Definition field_event.h:267

field_scene.h
The scene table formats: entrances, exits, placements and events, and the macros that write them.

SCENE_EVENTS_END
#define SCENE_EVENTS_END
Definition field_scene.h:217

FACING_STEP
@ FACING_STEP
Definition field_scene.h:36

SCENE_EXITS
#define SCENE_EXITS(scene)
Definition field_scene.h:72

SCENE_EXIT
#define SCENE_EXIT(exit, scene, entrance)
Definition field_scene.h:73

ACTOR_FIRST_PLACED
@ ACTOR_FIRST_PLACED
Definition field_scene.h:112

ACTOR_PARTY_LEADER
@ ACTOR_PARTY_LEADER
Definition field_scene.h:112

SCENE_TABLE_END
@ SCENE_TABLE_END
Definition field_scene.h:43

CONDITION_ALWAYS
@ CONDITION_ALWAYS
Definition field_scene.h:44

TALK_FACE_PARTY
@ TALK_FACE_PARTY
Definition field_scene.h:105

ACTOR_STAND
@ ACTOR_STAND
Definition field_scene.h:102

SCENE_EXITS_END
#define SCENE_EXITS_END
Definition field_scene.h:77

FACING_EAST
@ FACING_EAST
Definition field_scene.h:26

FACING_SOUTHEAST
@ FACING_SOUTHEAST
Definition field_scene.h:27

FACING_NORTH
@ FACING_NORTH
Definition field_scene.h:32

FACING_NORTHWEST
@ FACING_NORTHWEST
Definition field_scene.h:31

FACING_SOUTH
@ FACING_SOUTH
Definition field_scene.h:28

FACING_WEST
@ FACING_WEST
Definition field_scene.h:30

PIXELS
#define PIXELS(value)
Definition field_scene.h:114

fixed_math.h
16.16 fixed-point constants, sine and cosine, and the library division.

Q16_ONE
#define Q16_ONE
One in the engine's signed 16.16 fixed-point format.
Definition fixed_math.h:10

flags.h
Game flags, named where their meaning is shown.

FLAG_SHOW_LOCATION_NAME
#define FLAG_SHOW_LOCATION_NAME
Definition flags.h:94

FLAG_VALE_RETURNED_FROM_MT_ALEPH
#define FLAG_VALE_RETURNED_FROM_MT_ALEPH
Isaac and Garet followed the elders into the sanctum.
Definition flags.h:535

game_state.h
GameState, the game's state: play time, coins, the scene and the leader's position,...

gGameState
struct GameState gGameState

graphics.h
The screen blend's globals and the graphics routines.

minigame.h
The reel game's title lettering.

objcmd.h
Field object scripts: one s32 command word, then its operands, as gScriptObject_CommandTable runs the...

SC_SYNC
#define SC_SYNC
Wait for arrival.
Definition objcmd.h:17

SC_ARG
#define SC_ARG(v)
Definition objcmd.h:44

SC_MOVE
#define SC_MOVE(x, y, z)
Move toward the target.
Definition objcmd.h:19

SC_END
#define SC_END
Return to the main script.
Definition objcmd.h:32

psynergy_effects.h

ACTOR_DORA
@ ACTOR_DORA
Definition sanctum.c:58

songs.h
Song and sound effect ids, indices into gSound_SongTable.

SE_188
#define SE_188
Definition songs.h:183

SE_145
#define SE_145
Definition songs.h:138

Engine_ActorSetAnimation
void Engine_ActorSetAnimation()

gEventWork
struct EventWork * gEventWork

Engine_EventRequestExit
void Engine_EventRequestExit()

Engine_EventEnd
void Engine_EventEnd(void)

Engine_EventBegin
void Engine_EventBegin(void)

Engine_TaskWait
void Engine_TaskWait()

Engine_EventSetMessage
void Engine_EventSetMessage()

NULL
#define NULL
Definition bilibin.h:6

EventWork
The running scene's event work: its placement and event tables, its actors, the triggers and exit it ...
Definition event_work.h:20

EventWork::startTransition
s32 startTransition
SCENE_TRANSITION(style, variant).
Definition event_work.h:43

EventWork::transitionFrames
s32 transitionFrames
frames
Definition event_work.h:45

GameState::entrance
s16 entrance
Definition game_state.h:37

SceneEntrance
A scene entrance: where and facing which way the party arrives, and the camera's bounds there (-1 for...
Definition field_scene.h:54

SceneEvent
A scene event: its kind and detail, the trigger it answers, its condition and its value (a message or...
Definition field_scene.h:118

ScenePlacement
An actor a scene places: its sprite, the condition for placing it, how it behaves,...
Definition field_scene.h:81

SceneRegion
A scene's exit region: the box that, while its condition holds, takes the party leader out through it...
Definition field_runtime.h:30

system.h
The system's routines and globals: interrupts, BIOS sound bias, random numbers and sleep.

types.h
The integer types, TRUE, UNUSED and the fixed-address macros.

s32
signed int s32
Definition types.h:14

u32
unsigned int u32
Definition types.h:15

u16
unsigned short u16
Definition types.h:13

object.h

ValeEruption_GetEntrances
const struct SceneEntrance * ValeEruption_GetEntrances(void)
Returns where the party appears: entrance 15 is the path down from the mountain, Mt.
Definition vale_eruption.c:51

ValeEruption_Initialize
s32 ValeEruption_Initialize(void)
Plays the return from the mountain when the party arrives by entrance 15.
Definition vale_eruption.c:75

ValeEruption_GetRegions
const struct SceneRegion * ValeEruption_GetRegions(void)
Definition vale_eruption.c:55

gValeEruption_SanctumDoorOpens
u16 gValeEruption_SanctumDoorOpens[]
The sanctum's door, two cells wide, opening in two steps.
Definition vale_eruption.c:509

gValeEruption_Exits
u32 gValeEruption_Exits[]
Definition vale_eruption.c:466

ValeEruption_GetPlacements
const struct ScenePlacement * ValeEruption_GetPlacements(void)
Returns Garet and the villagers gathered before the sanctum.
Definition vale_eruption.c:62

Event_ReturnFromMtAleph
static void Event_ReturnFromMtAleph(void)
The volcano shakes the square while the villagers wonder where Isaac and Garet are; the two come down...
Definition vale_eruption.c:88

ValeEruptionActor
ValeEruptionActor
The placed actors, numbered in the order of gValeEruption_Placements; Garet's row places the party's ...
Definition vale_eruption.c:29

ACTOR_GUARD
@ ACTOR_GUARD
The guard. "They were hanging around here while I was on guard duty.".
Definition vale_eruption.c:44

ACTOR_GARETS_SISTER
@ ACTOR_GARETS_SISTER
She calls the mayor Grandpa, and actor 12 calls her Sis.
Definition vale_eruption.c:42

ACTOR_GREAT_HEALER
@ ACTOR_GREAT_HEALER
The Great Healer (sprite 0x79, the healer of sanctum.c), who leads the villagers into the sanctum.
Definition vale_eruption.c:32

ACTOR_GARETS_GRANDFATHER
@ ACTOR_GARETS_GRANDFATHER
Garet's grandfather, the mayor (sprite 0x75, whom the Great Healer calls Mayor in sanctum....
Definition vale_eruption.c:36

gValeEruption_Placements
struct ScenePlacement gValeEruption_Placements[]
Definition vale_eruption.c:473

gValeEruption_LeaderWalksDown
s32 gValeEruption_LeaderWalksDown[]
Isaac walks down from the path to the villagers before the sanctum.
Definition vale_eruption.c:434

gValeEruption_Entrances
struct SceneEntrance gValeEruption_Entrances[]
Definition vale_eruption.c:460

gValeEruption_GaretWalksDown
s32 gValeEruption_GaretWalksDown[]
Garet follows him, stopping a little above.
Definition vale_eruption.c:444

gValeEruption_Events
struct SceneEvent gValeEruption_Events[]
Definition vale_eruption.c:504

ValeEruption_GetEvents
const struct SceneEvent * ValeEruption_GetEvents(void)
The square has no events of its own: everything happens on arrival.
Definition vale_eruption.c:67

gValeEruption_EnterSanctum
s32 gValeEruption_EnterSanctum[]
Isaac, then Garet, walk through the sanctum's door.
Definition vale_eruption.c:453

ValeEruption_GetExits
const u32 * ValeEruption_GetExits(void)
Returns the one exit, into the sanctum (Sanctum's entrance 20), which Event_ReturnFromMtAleph takes.
Definition vale_eruption.c:59

vale_eruption.h

BattleFx_StartBufferBlend
void BattleFx_StartBufferBlend(s32 from, s32 to)
Flashes the palette once, 120 frames from now, from palette from to palette to (BattleFx_BuildBuffer ...
Definition weather.c:467

FieldFx_LastLightning
void FieldFx_LastLightning(void)
One last flash of lightning in 12 frames, then no more.
Definition weather.c:450