alchemy-docs/battle_8c_source.html

/// @file

/// The battle object: a battle from its opening transition to its spoils.

/// battle_internal.h holds what the parts share (the includes and the names

/// two or more of them use); the code is in the files under battle/, included

/// here in the order it has in the ROM. Camelot's own files are not

/// recoverable: the ROM shows one object, and these parts are ours, cut where

/// one family ends and the next begins.

///

/// A battle runs from Battle_RunEncounter (encounter.c). Each round the

/// actions are gathered and put in turn order (round.c, or auto_battle.c under

/// auto battle), and each action is announced and planned

/// (BattleCommand_BuildPlan, plan.c), staged

/// (BattlePresentation_DispatchAction, staging.c) and applied to each target

/// (BattleTargetExec, target_exec.c), which queues the battle events

/// BattleEvent_Playback plays (playback.c). README.md in this folder gives the

/// words, prefixes and spellings the parts use.


#include "battle_internal.h"


// The battle object's code, in ROM order. Each part is compiled here, as

// part of this one object, never on its own: the order of these includes is

// the order of the code in the ROM.

#include "battle/debug.c"

#include "battle/setup.c"

#include "battle/link.c"

#include "battle/encounter.c"

#include "battle/sprites.c"

#include "battle/placement.c"

#include "battle/objects.c"

#include "battle/motion.c"

#include "battle/auto_battle.c"

#include "battle/round.c"

#include "battle/staging.c"

#include "battle/targeting.c"

#include "battle/events.c"

#include "battle/target_exec.c"

#include "battle/enemy_ai.c"

#include "battle/playback.c"

#include "battle/plan.c"

#include "battle/turn_end.c"

#include "battle/transition.c"

#include "battle/background.c"

#include "battle/star_field.c"

#include "battle/formation.c"

#include "battle/classes.c"

#include "battle/spoils.c"

auto_battle.c
Auto battle: the actions it builds and plays, without the command menu.

background.c
The battle background, its palette and perspective, the camera's zoom and the units' highlights.

classes.c
The enemy classes' battle sprite table, gSummon_EntryTable.

debug.c
Debug: the party presets, the message viewer and the battle test menu.

encounter.c
A whole battle, Battle_RunEncounter, and the lists of the units in it.

events.c
Battle events: a downed unit's reset, waiting for the player, and the event queue,...

objects.c
Each frame's sprite priorities, the status icons, the poses and the sprites of the battle objects.

setup.c
The battle camera each frame, the opening announcement, the unit lists, and the party's battle state ...

sprites.c
Battle sprites: enemy sprite slots and the party's weapon sprites.

transition.c
The opening transition: the curtain, or the Venus Lighthouse storm.

battle_internal.h
What every part of the battle object shares: its includes, in their original order,...

enemy_ai.c
An enemy's choice of action, BattleCommand_SelectAutomatic.

formation.c
Enemy formations: the enemies chosen, levelled and lettered.

link.c
Link battles: the parties and Djinn exchanged, and the turn handshake.

motion.c
The units' movements: returning, running, leaping and knocked back, and their positions on the screen...

placement.c
Battle objects made and placed on the battlefield.

plan.c
An action announced and planned, BattleCommand_BuildPlan.

playback.c
Battle events played over frames, BattleEvent_Playback.

round.c
A round's actions: the party's commands, the enemies' or the link opponent's, and their turn order.

spoils.c
The spoils: coins, experience, items and level ups.

staging.c
An action played: its targets, and how an attack, a cast, an item, a summon or an escape is staged.

star_field.c
A unit's elemental glow: the star field and the other glows.

target_exec.c
An ability applied to one target, BattleTargetExec: damage, healing and its added effect.

targeting.c
The targets an enemy's or a confused unit's ability picks.

turn_end.c
The end of a turn and of a round: counters, Djinn recovery, poison and the Grim Reaper.