GINCS Help Page

Scripting Commands

Command
Description
Example
FLxxxx switch, xxxx could be from 0001 to 0999
only used with #if, #if not, #set and #clear
 
' commentary ' New Episode
:<label> label :Quit
#SEND <label>
#GOTO <label>
jump to label #GoTo Quit
#CALL <label> jump to label with return #Call Quit
#PROGCALL <script> go to another script with return #ProgCall intro
#PROGGOTO <script> go to another script w/o return #ProgGoTo intro
#LOADBKG <image> load background image #LoadBKG Title
#CLEARBKG remove background #ClearBKG
#PLAYMUSIC <music> play music file #PlayMusic GameOver
#STOPMUSIC stop music #StopMusic
#LOOPMUSIC <music> play music file continuously #LoopMusic GameOver
#SET FL<switch> set switch to ON #Set FL0001
#CLEAR FL<switch> clear switch to OFF #Clear FL0001
#IF FLxxxx check the state of the switch to be ON

' Display "Hello, world!" if FL0001 is set to ON
#if FL0001 Hello, world!

' Conditions could be combined in chain
' Text will be shown only if FL0001
' and FL0002 are set to ON

#if  FL0001 #if FL0002 Hello, world!

#IF NOT FLxxxx check the state of the switch to be OFF

' Display menu item "Quit" if FL0001 is set to OFF
#if not FL0001 !Quit:Quit game?

' Conditions could be combined in chain
' Item will be shown only if FL0001 is set to ON

' and FL0002 is OFF
#if  FL0001 #if not FL0002 Hello, world!

#RETURN return from script or label #Return
#END end of program #End
#INCLUDE <script>

include <script> in the current script

Maximum inclusion depth = 8

#include ShowName
!<label>;<text> menu item with text <text> and jump to label <label> after selection

Do you want to leave?
!Leave;Yes
!Stay;No
/i
:Stay
Please, stay...
#Return
:Leave
Goodbye
#GoTo GameOver

/I wait for input: player should press any key (A, B or C) or select item from the menu  
     
 

Keyboard shortcuts

Ctrl + i inserts "/i" command
Ctrl + t inserts "#SET FL" command
Ctrl + g inserts "#GOTO" command
Ctrl + s save script
F5 run project
 
 

Notes

To prevent crackling during music or sound playback it is recommended to rename the sound files starting with the letter "z". In this case, they will be placed at the end of the GINCS file system.
For example: zmusic1.wav, z_sound1.wav etc.