WebGAL Script Writing Assistant

Problem

WebGAL visual novel scripts compress background changes, character placements, branches, variables, and audio fades into semicolon-delimited inline commands. Hand-writing these scripts often creates mistakes around parameter order, -next / -concat / -notend, conditional choices (visible condition)[enabled condition], and the difference between global and runtime variables, causing skipped transitions, missing audio fades, or branches that do not return. For example, changeScene does not automatically clear the stage, while callScene returns after execution; mixing them can leave stale stage state. A fade-out command such as bgm:none -enter=3000; also needs to be placed at the correct dialogue or transition point.

How It Works

The skill breaks WebGAL commands into reference modules for basics, dialogue, backgrounds and figures, scenes and branches, variables, audio, video, animation, and effects:

• Syntax checks: prioritize validating that commands end with ;, use ASCII colons and semicolons, and follow the command:value -param=value; structure.
• Transition flow: structure shots, backgrounds, and character entrances/exits using changeBg, changeFigure, setTextbox, setAnimation, and setTransition.
• Branch logic: handle choices, jumps, and state checks with choose, label / jumpLabel, setVar, and -when.
• Media handling: define playback, fade-in/fade-out, and stop behavior for bgm, -V, playEffect, and playVideo using the documented asset parameters.
• Output format: return ws code blocks and explain parameter behavior, optimization points, and possible side effects outside the code.

Boundaries

It is intended for projects that already have image, audio, and video assets and mainly use built-in WebGAL commands for script orchestration. It does not create art assets or replace the engine runtime; custom JSON animations, stacked Pixi effects, and save-file variables such as $userData require existing project configuration or file structure.