random-mirrors/pokerogue
1
0
Fork 0
mirror of https://github.com/pagefaultgames/pokerogue.git synced 2024-11-29 02:06:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #4236 from ben-lear/mystery-encounters

Browse Source 
update ME tsdocs with links
This commit is contained in:
ImperialSympathizer 2024-09-13 21:45:18 -04:00 committed by GitHub
commit 6159d938b6
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 31 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
src/phases/mystery-encounter-phases.ts
View File

@ -30,19 +30,18 @@ import { SeenEncounterData } from "#app/data/mystery-encounters/mystery-encounte
* - Clearing of phase queues to enter the Mystery Encounter game state * - Clearing of phase queues to enter the Mystery Encounter game state
* - Management of session data related to MEs * - Management of session data related to MEs
* - Initialization of ME option select menu and UI * - Initialization of ME option select menu and UI
* - Execute onPreOptionPhase() logic if it exists for the selected option * - Execute {@linkcode MysteryEncounter.onPreOptionPhase} logic if it exists for the selected option
* - Display any OptionTextDisplay.selected type dialogue that is set in the MysteryEncounterDialogue dialogue tree for selected option * - Display any `OptionTextDisplay.selected` type dialogue that is set in the {@linkcode MysteryEncounterDialogue} dialogue tree for selected option
* - Queuing of the MysteryEncounterOptionSelectedPhase * - Queuing of the {@linkcode MysteryEncounterOptionSelectedPhase}
*/ */
export class MysteryEncounterPhase extends Phase { export class MysteryEncounterPhase extends Phase {
private readonly FIRST_DIALOGUE_PROMPT_DELAY = 300; private readonly FIRST_DIALOGUE_PROMPT_DELAY = 300;
optionSelectSettings?: OptionSelectSettings; optionSelectSettings?: OptionSelectSettings;
/** /**
*
* @param scene
* @param optionSelectSettings - allows overriding the typical options of an encounter with new ones
* Mostly useful for having repeated queries during a single encounter, where the queries and options may differ each time * Mostly useful for having repeated queries during a single encounter, where the queries and options may differ each time
* @param scene
* @param optionSelectSettings allows overriding the typical options of an encounter with new ones
*/ */
constructor(scene: BattleScene, optionSelectSettings?: OptionSelectSettings) { constructor(scene: BattleScene, optionSelectSettings?: OptionSelectSettings) {
super(scene); super(scene);
@ -114,7 +113,7 @@ export class MysteryEncounterPhase extends Phase {
} }
/** /**
* Queues MysteryEncounterOptionSelectedPhase, displays option.selected dialogue and ends phase * Queues {@linkcode MysteryEncounterOptionSelectedPhase}, displays option.selected dialogue and ends phase
*/ */
continueEncounter() { continueEncounter() {
const endDialogueAndContinueEncounter = () => { const endDialogueAndContinueEncounter = () => {
@ -161,7 +160,7 @@ export class MysteryEncounterPhase extends Phase {
/** /**
* Will handle (in order): * Will handle (in order):
* - Execute onOptionSelect() logic if it exists for the selected option * - Execute {@linkcode MysteryEncounter.onOptionSelect} logic if it exists for the selected option
* *
* It is important to point out that no phases are directly queued by any logic within this phase * It is important to point out that no phases are directly queued by any logic within this phase
* Any phase that is meant to follow this one MUST be queued via the onOptionSelect() logic of the selected option * Any phase that is meant to follow this one MUST be queued via the onOptionSelect() logic of the selected option
@ -176,10 +175,10 @@ export class MysteryEncounterOptionSelectedPhase extends Phase {
/** /**
* Will handle (in order): * Will handle (in order):
* - Execute onOptionSelect() logic if it exists for the selected option * - Execute {@linkcode MysteryEncounter.onOptionSelect} logic if it exists for the selected option
* *
* It is important to point out that no phases are directly queued by any logic within this phase * It is important to point out that no phases are directly queued by any logic within this phase.
* Any phase that is meant to follow this one MUST be queued via the onOptionSelect() logic of the selected option * Any phase that is meant to follow this one MUST be queued via the {@linkcode MysteryEncounter.onOptionSelect} logic of the selected option.
*/ */
start() { start() {
super.start(); super.start();
@ -203,9 +202,9 @@ export class MysteryEncounterOptionSelectedPhase extends Phase {
/** /**
* Runs at the beginning of an Encounter's battle * Runs at the beginning of an Encounter's battle
* Will clean up any residual flinches, Endure, etc. that are left over from startOfBattleEffects * Will clean up any residual flinches, Endure, etc. that are left over from {@linkcode MysteryEncounter.startOfBattleEffects}
* Will also handle Game Overs, switches, etc. that could happen from handleMysteryEncounterBattleStartEffects * Will also handle Game Overs, switches, etc. that could happen from {@linkcode handleMysteryEncounterBattleStartEffects}
* See [TurnEndPhase](../phases.ts) for more details * See {@linkcode TurnEndPhase} for more details
*/ */
export class MysteryEncounterBattleStartCleanupPhase extends Phase { export class MysteryEncounterBattleStartCleanupPhase extends Phase {
constructor(scene: BattleScene) { constructor(scene: BattleScene) {
@ -213,7 +212,7 @@ export class MysteryEncounterBattleStartCleanupPhase extends Phase {
} }
/** /**
* Cleans up TURN_END tags, any PostTurnEffectPhases, checks for Pokemon switches, then continues * Cleans up `TURN_END` tags, any {@linkcode PostTurnStatusEffectPhase}s, checks for Pokemon switches, then continues
*/ */
start() { start() {
super.start(); super.start();
@ -260,7 +259,7 @@ export class MysteryEncounterBattleStartCleanupPhase extends Phase {
* - Setting BGM * - Setting BGM
* - Showing intro dialogue for an enemy trainer or wild Pokemon * - Showing intro dialogue for an enemy trainer or wild Pokemon
* - Sliding in the visuals for enemy trainer or wild Pokemon, as well as handling summoning animations * - Sliding in the visuals for enemy trainer or wild Pokemon, as well as handling summoning animations
* - Queue the SummonPhases, PostSummonPhases, etc., required to initialize the phase queue for a battle * - Queue the {@linkcode SummonPhase}s, {@linkcode PostSummonPhase}s, etc., required to initialize the phase queue for a battle
*/ */
export class MysteryEncounterBattlePhase extends Phase { export class MysteryEncounterBattlePhase extends Phase {
disableSwitch: boolean; disableSwitch: boolean;
@ -307,7 +306,7 @@ export class MysteryEncounterBattlePhase extends Phase {
} }
/** /**
* Queues SummonPhases for the new battle, and handles trainer animations/dialogue if Trainer battle * Queues {@linkcode SummonPhase}s for the new battle, and handles trainer animations/dialogue if it's a Trainer battle
* @param scene * @param scene
* @private * @private
*/ */
@ -376,7 +375,7 @@ export class MysteryEncounterBattlePhase extends Phase {
} }
/** /**
* Initiate SummonPhases, scanner phases, PostSummon phases, etc. * Initiate {@linkcode SummonPhase}s, {@linkcode ScanIvsPhase}, {@linkcode PostSummonPhase}s, etc.
* @param scene * @param scene
* @private * @private
*/ */
@ -472,10 +471,10 @@ export class MysteryEncounterBattlePhase extends Phase {
* *
* OR * OR
* *
* - Any encounter reward logic that is set within MysteryEncounter doEncounterExp * - Any encounter reward logic that is set within {@linkcode MysteryEncounter.doEncounterExp}
* - Any encounter reward logic that is set within MysteryEncounter doEncounterRewards * - Any encounter reward logic that is set within {@linkcode MysteryEncounter.doEncounterRewards}
* - Otherwise, can add a no-reward-item shop with only Potions, etc. if addHealPhase is true * - Otherwise, can add a no-reward-item shop with only Potions, etc. if addHealPhase is true
* - Queuing of the PostMysteryEncounterPhase * - Queuing of the {@linkcode PostMysteryEncounterPhase}
*/ */
export class MysteryEncounterRewardsPhase extends Phase { export class MysteryEncounterRewardsPhase extends Phase {
addHealPhase: boolean; addHealPhase: boolean;
@ -486,7 +485,7 @@ export class MysteryEncounterRewardsPhase extends Phase {
} }
/** /**
* Runs {@link MysteryEncounter.doContinueEncounter} and ends phase, OR {@link MysteryEncounter.onRewards} then continues encounter * Runs {@linkcode MysteryEncounter.doContinueEncounter} and ends phase, OR {@linkcode MysteryEncounter.onRewards} then continues encounter
*/ */
start() { start() {
super.start(); super.start();
@ -511,7 +510,7 @@ export class MysteryEncounterRewardsPhase extends Phase {
} }
/** /**
* Queues encounter EXP and rewards phases, PostMysteryEncounterPhase, and ends phase * Queues encounter EXP and rewards phases, {@linkcode PostMysteryEncounterPhase}, and ends phase
*/ */
doEncounterRewardsAndContinue() { doEncounterRewardsAndContinue() {
const encounter = this.scene.currentBattle.mysteryEncounter!; const encounter = this.scene.currentBattle.mysteryEncounter!;
@ -534,7 +533,7 @@ export class MysteryEncounterRewardsPhase extends Phase {
/** /**
* Will handle (in order): * Will handle (in order):
* - onPostOptionSelect logic (based on an option that was selected) * - {@linkcode MysteryEncounter.onPostOptionSelect} logic (based on an option that was selected)
* - Showing any outro dialogue messages * - Showing any outro dialogue messages
* - Cleanup of any leftover intro visuals * - Cleanup of any leftover intro visuals
* - Queuing of the next wave * - Queuing of the next wave
@ -549,7 +548,7 @@ export class PostMysteryEncounterPhase extends Phase {
} }
/** /**
* Runs {@link MysteryEncounter.onPostOptionSelect} then continues encounter * Runs {@linkcode MysteryEncounter.onPostOptionSelect} then continues encounter
*/ */
start() { start() {
super.start(); super.start();
@ -569,7 +568,7 @@ export class PostMysteryEncounterPhase extends Phase {
} }
/** /**
* Queues NewBattlePhase, plays outro dialogue and ends phase * Queues {@linkcode NewBattlePhase}, plays outro dialogue and ends phase
*/ */
continueEncounter() { continueEncounter() {
const endPhase = () => { const endPhase = () => {

4
src/phases/select-modifier-phase.ts
View File

@ -14,14 +14,14 @@ import { isNullOrUndefined } from "#app/utils";
export class SelectModifierPhase extends BattlePhase { export class SelectModifierPhase extends BattlePhase {
private rerollCount: integer; private rerollCount: integer;
private modifierTiers: ModifierTier[]; private modifierTiers?: ModifierTier[];
private customModifierSettings?: CustomModifierSettings; private customModifierSettings?: CustomModifierSettings;
constructor(scene: BattleScene, rerollCount: integer = 0, modifierTiers?: ModifierTier[], customModifierSettings?: CustomModifierSettings) { constructor(scene: BattleScene, rerollCount: integer = 0, modifierTiers?: ModifierTier[], customModifierSettings?: CustomModifierSettings) {
super(scene); super(scene);
this.rerollCount = rerollCount; this.rerollCount = rerollCount;
this.modifierTiers = modifierTiers!; // TODO: is this bang correct? this.modifierTiers = modifierTiers;
this.customModifierSettings = customModifierSettings; this.customModifierSettings = customModifierSettings;
} }

8
src/system/game-data.ts
View File

@ -1561,7 +1561,7 @@ export class GameData {
* @param incrementCount * @param incrementCount
* @param fromEgg * @param fromEgg
* @param showMessage * @param showMessage
* @returns - true if Pokemon catch unlocked a new starter, false if Pokemon catch did not unlock a starter * @returns `true` if Pokemon catch unlocked a new starter, `false` if Pokemon catch did not unlock a starter
*/ */
setPokemonCaught(pokemon: Pokemon, incrementCount: boolean = true, fromEgg: boolean = false, showMessage: boolean = true): Promise<boolean> { setPokemonCaught(pokemon: Pokemon, incrementCount: boolean = true, fromEgg: boolean = false, showMessage: boolean = true): Promise<boolean> {
return this.setPokemonSpeciesCaught(pokemon, pokemon.species, incrementCount, fromEgg, showMessage); return this.setPokemonSpeciesCaught(pokemon, pokemon.species, incrementCount, fromEgg, showMessage);
@ -1573,7 +1573,7 @@ export class GameData {
* @param incrementCount * @param incrementCount
* @param fromEgg * @param fromEgg
* @param showMessage * @param showMessage
* @returns - true if Pokemon catch unlocked a new starter, false if Pokemon catch did not unlock a starter * @returns `true` if Pokemon catch unlocked a new starter, `false` if Pokemon catch did not unlock a starter
*/ */
setPokemonSpeciesCaught(pokemon: Pokemon, species: PokemonSpecies, incrementCount: boolean = true, fromEgg: boolean = false, showMessage: boolean = true): Promise<boolean> { setPokemonSpeciesCaught(pokemon: Pokemon, species: PokemonSpecies, incrementCount: boolean = true, fromEgg: boolean = false, showMessage: boolean = true): Promise<boolean> {
return new Promise<boolean>(resolve => { return new Promise<boolean>(resolve => {
@ -1694,8 +1694,8 @@ export class GameData {
* *
* @param species * @param species
* @param eggMoveIndex * @param eggMoveIndex
* @param showMessage - Default true. If true, will display message for unlocked egg move * @param showMessage Default true. If true, will display message for unlocked egg move
* @param prependSpeciesToMessage - Default false. If true, will change message from "X Egg Move Unlocked!" to "Bulbasaur X Egg Move Unlocked!" * @param prependSpeciesToMessage Default false. If true, will change message from "X Egg Move Unlocked!" to "Bulbasaur X Egg Move Unlocked!"
*/ */
setEggMoveUnlocked(species: PokemonSpecies, eggMoveIndex: integer, showMessage: boolean = true, prependSpeciesToMessage: boolean = false): Promise<boolean> { setEggMoveUnlocked(species: PokemonSpecies, eggMoveIndex: integer, showMessage: boolean = true, prependSpeciesToMessage: boolean = false): Promise<boolean> {
return new Promise<boolean>(resolve => { return new Promise<boolean>(resolve => {