Master Background and Screen Control in GOKI2 ADV Development

Starting GOKI2 ADV: Defining Backgrounds, Time Zones, and Screen Update Control Tags [Mod ADV Introduction]

The GOKI2 ADV system utilizes the Avalanches engine to manage visual assets through declarative storage tags. Developers can implement dynamic time-of-day variations by mapping suffixes to background assets like whiteev.png for evening settings.

Why This Matters

While ideal game engines might automate asset transitions, GOKI2 ADV requires explicit timing management during text processing to ensure visual consistency. Understanding the discrepancy between automatic text-based updates and manual triggers like the run_reserved_transition tag is critical for preventing jarring visual artifacts in complex scenes where background and character transitions must occur separately.

Key Insights

• Asset definition in ModADV is achieved via the @make_stage tag, which maps logical names to specific storage filenames such as white.png.
• The @make_time_zone tag enables automated asset switching by appending suffixes like ‘ev’ or ‘ng’ to base file names based on active tags.
• Visual transitions are synchronized with text processing by default, occurring immediately before dialogue display.
• The run_reserved_transition tag provides manual control to force screen updates independently of dialogue flow.
• The latest development environment is distributed via Avalanches-Release2.x.y.y.zip on GitHub.

Working Examples

Defining background stages and their corresponding storage files.

@make_stage name=white storage=white.png
@make_stage name=black storage=black.png

Configuring time zones with specific file suffixes.

@make_time_zone name=morning suffix=''
@make_time_zone name=evening suffix=ev
@make_time_zone name=night suffix=ng

Example of loading a time-specific asset (whiteev.png) using tags.

@evening
@white
[halo] Loaded the white background for the evening.

Practical Applications

• Use case: Mapping ‘morning’, ‘evening’, and ‘night’ tags to a single asset name to handle lighting variations automatically. Pitfall: Forgetting to include the suffix in the actual filename causes asset loading to fail.
• Use case: Using run_reserved_transition to trigger character sprite changes before a specific line of dialogue is reached. Pitfall: Misplacing control tags can lead to unintended screen transitions before the text is processed.

References:

• https://github.com/halo1234/Avalanches/releases