Actionparts Documentation

From The Official Visionaire Studio: Adventure Game Engine Wiki

All available actionparts are listed here. Each actionpart is stored as one object in the ActionPart table of the Data Structure. The 'constant number' is the number which is stored in the field ActionPartCommand and defines the actionpart. Each actionpart can have a maximum of two links, three numbers and one file path. This document shows which fields are used for which actionpart. If there is a link to a scene or a character (in ActionPartLink or ActionPartAltLink) and the link is empty then the current scene/character is used.

Constant number/name
ActionPartLink
ActionPartAltLink
ActionPartPath
ActionPartInt
ActionPartAltInt
ActionPartAltInt2
ActionPartString
'5': Actionparts#Else ELSE - - - - - -
'6': Actionparts#End_if ENDIF - - - - - -
'10': Actionparts#Change_scene CHANGE_SCENE object character -

'1': fade into new scene
'0' no fade effect

direction (degrees) the character is looking on the new scene
'-1': character is looking in opposite direction of object

'12': Actionparts#Change_character CHANGE_CHARACTER character - - '1': fade into new scene, '0' no fade effect (if character is on another scene) - -
'13': Actionparts#Start_dialog START_DIALOG dialog - - - - -
'14': Actionparts#Stop_current_dialog STOP_DIALOG - - - - - -
'16': Actionparts#Quit_current_action EXIT_ACTION action - - - - - -
'19': Actionparts#Show_hide_animation SHOW_HIDE_ANIMATION animation - -

'0': show animation
'1': hide animation

'1': play animation in reverse direction
else play in normal direction

'0': proceed immediately with next action part.
'1': wait until animation is finished before processing next action part.

-
'22': [[Actionparts#Wait_until_animation_is_finished WAITON_ANIMATION] animation - - - - -
'23': Actionparts#Display_text SHOW_TEXT text character -

'0': foreground text
'1': background text

- - -
'24': Actionparts#Play_sound PLAY_SOUND - - sound file volume (between '0' and '100') balance (between '-100' and '100')

'0': sound must be stopped manually
'1': sound will be stopped automatically if scene is changed

-
'30': Actionparts#Pause MAKE_PAUSE value - - delay (msec) unit:

'0': milliseconds
'1': seconds
'2': minutes

-
'31': Actionparts#Send_character_to_object CHARACTER_GOTO character object - '0': proceed immediately with next action part.

'1': wait until character reaches object before processing next action part.

- -
'32': Actionparts#Wait_until_character_stops WAITON_CHARACTER character - - - - -
'45': Actionparts#Set_command SET_COMMAND button (command) - - - - -
'46': Actionparts#Show_scene SHOW_SCENE scene - -

'1': fade into new scene
'0' no fade effect

- -
'47': Actionparts#Send_character_to_position CHARACTER_GOTO_XY character - - x-coordinate of point y-coordinate of point '0': proceed immediately with next action part.

'1': wait until character reaches position before processing next action part.

'48': Actionparts#Scroll_scene_to_object SCROLL_SCENE object - - - - - -
'49': Actionparts#Scroll_scene_to_position SCROLL_SCENE_XY - - - x-coordinate of point y-coordinate of point - -
'50': [[Actionparts#Set_character_to_an_object SET_CHARACTER_TO_OBJECT] character object - direction (degrees) the character is looking

'-1': character looks in direction of object

- -
'51': Actionparts#Change_outfit_of_a_character CHANGE_OUTFIT outfit - - '0': unload animations of old outfit

'1': do not unload animations of old outfit

- -
'52': Actionparts#Change_comment-set_of_a_character CHANGE_COMMENTSET commentset - - - - -
'53': Actionparts#Change_language CHANGE_LANGUAGE language - - - - -
'54': Actionparts#Show.2FHide_person SHOW_CHARACTER character - -

'1': fade into new scene
'0' no fade effect

- -
'55': Actionparts#Quit_game QUIT_GAME - - - - - -
'56': Actionparts#Show.2FHide_Interface SHOW_HIDE_INTERFACE interfaceclass - -

'0': show
'1': hide
'2': change

- - -
DEPRECATED - '56': Actionparts#Show.2FHide_Interface SHOW_HIDE_INTERFACE interface - - number of active interface of current character which is shown/hidden (only used if ActionPartLink is not set)

'0': show
'1': hide
'2': change

- -
'58': Actionparts#Align_character ALIGN_CHARACTER character - - direction (degrees) - -
'59': Actionparts#Change_background_music SET_MUSIC scene - music file volume (between '0' and '100') balance (between '-100' and '100') -
'60': Actionparts#Center_scene_on_character_permanently SET_SCROLLCHARCTER character - -

'0': center character
'1': do not center character

- -
'66': Actionparts#Play_video PLAY_VIDEO - - movie file

'0': play movie centered
'1': scale movie to fullscreen

'0': all sounds are paused and only continued after the action which started the video is interupted (finished or paused, etc.) -> if a new scene is shown immediately after the video the active sounds started before the video are removed.
'1': pause all active sounds and continue them after video
'2': stop all active sounds

-
'69': Actionparts#If_value_then IF_VALUE value value (optional) -

'0': ==
'1': !=
'2': <=
'3': <
'4': >=
'5': >

number (only used if ActionPartAltLink is empty) -
'70': Actionparts#Set_value SET_VALUE value value (optional) -

'0': =
'1': +=
'2': -=
'3': *=
'4': /=

number (only used if ActionPartAltLink is empty) -
'71': Actionparts#Show_speaker_text SHOW_TEXT_XY text font - x-coordinate y-coordinate

'0': foreground text
'1': background text

-
'72': Actionparts#Play_and_loop_sound_infinitely PLAY_LOOPED_SOUND - - sound file volume (between '0' and '100') balance (between '-100' and '100')

'0': sound must be stopped manually
'1': sound will be stopped automatically if scene is changed

-
'73': Actionparts#Stop_currently_playing_sound STOP_SOUND - - sound file - - -
'77': Actionparts#Change_settings_of_a_currently_playing_sound CHANGE_SOUND_SETTINGS - - sound file volume (between '0' and '100') balance (between '-100' and '100') -
'78': Actionparts#Jump_to_action_part GOTO - - -

'0': jump relative
else jump absolute

jump to -
'79': Actionparts#If_character_is_current_character_then IF_CHARACTER character - - - - -
'80': Actionparts#Remove_all_items_from_inventory REMOVE_ALL_ITEMS_FROM_CHARACTER character - - - - -
'81': Actionparts#Transfer_all_items_to_other_character GIVE_ALL_ITEMS_TO character (from) character (to) - - - -
'82': Actionparts#Change_character_speed SET_CHARACTERSPEED character - - speed - -
'83': Actionparts#Set_random_value SET_RANDOM_VALUE value - - from to -
'84': Actionparts#If_character_is_on_scene_then IF_CHARACTER_ON_SCENE character scene - - - -
'85': Actionparts#Chase_character FOLLOW_CHARACTER character action -

'0': chase current character
'1': current character is chasing

reach distance -
'86': Actionparts#Stop_chase STOP_FOLLOW character - - - - -
'87': Actionparts#Stop_character STOP_CHARACTER character - - - - -
'88': Actionparts#Change_walking_sound CHANGE_WALKINGSOUND character - sound file - - -
'89': Actionparts#Change_font_of_a_character CHANGE_FONT font character - - - -
'90': Actionparts#Change_the_interface_of_a_Character CHANGE_INTERFACE interface to set - - - - -
DEPRECATED - '90': Actionparts#Change_the_interface_of_a_Character CHANGE_INTERFACE interface to set interface to replace - number of active interface of current character which is replaced (only used if ActionPartAltLink is not set) - -
'92': Actionparts#If_language_is_current_language_then IF_LANGUAGE language - - - - -
'94': Actionparts#Set_cursor SET_CURSOR cursor - - - - -
'95': Actionparts#If_command_is_current_command_then IF_COMMAND button (command) - - - - -
'98': Actionparts#Show.2FHide_person HIDE_CHARACTER character - -

'1': hide
'0': show

- -
'99': Actionparts#Save_object SAVE_OBJECT - - - - - -
'100': Actionparts#Execute_command_on_saved_object EXEC_SAVEDOBJECT - - - - - -
'103': Actionparts#If_current_object..._then IF_CURRENT_OBJECT - - -

'0': exists
'1': not exists
'2': scene object
'3': item
'4': character

- -
'105': Actionparts#Set_active.2Finactive_sprite SET_ACTIVE_SPRITE button - -

'0': inactive sprite
'1': active sprite

- -
'106': Actionparts#Clear_saved_object CLEAR_SAVEDOBJECT - - - - - -
'107': Actionparts#Skip_current_text SKIP_CURRENT_TEXT - - - - - -
'110': Actionparts#Set_fade_effect_to_new_scene SET_FADE_EFFECT - - -

'0': no effect
'1': fade in
'2': fade out
'3': fade in/out
'4': fade to new
'5': shift left
'6': shift right
'7': tunnel effect

delay (in msec) -
'111': Actionparts#Set_object_visibility FADE_OBJECT object value - visibility: must be between '0' and '100' (only used if value is empty) delay (in msec) -
'112': Actionparts#Set_interface_visibility FADE_INTERFACE interfaceclass - - visibility: must be between '0' and '100' delay (in msec) - -
DEPRECATED - '112': Actionparts#Set_interface_visibility FADE_INTERFACE interface - - number of active interface of current character (only used if ActionPartLink is not set) visibility: must be between '0' and '100' delay (in msec) -
'114': Actionparts#Set_light_map SET_LIGHTMAP scene - image file - - - -
'115': Actionparts#Set_brightness SET_BRIGHTNESS scene - - brightness: must be between '0' and '100' - - -
'116': Actionparts#Set_character_visibility FADE_CHARACTER character value - visibility: must be between '0' and '100' (only used if value is empty) delay (in msec) - -
'117': Actionparts#Set_item SET_PICKUP_ITEM object (item) - -

'1': picked up item
'0': item for combined command

- - -
'121': Actionparts#Delete_savegame.2Fautosave DELETE_SAVEGAME - - -

'0': delete savegame
'1': delete autosave

number of autosave (only used if ActionPartInt = 1) - -
'123': Actionparts#If_Savegame.2FAutosave_exists_then IF_SAVEGAME_EXISTS - - - -

'0': test selected savegame
'1': test any savegame
'2': test autosave

number of autosave (only used if ActionPartInt = 2) - -
'124': Actionparts#Change_character_animation_index SET_CHARACTERANIM_INDEX character - - index - - -
'125': Actionparts#Wait_until_sound_is_finished WAITON_SOUND - - sound file - - - -
'126': Actionparts#Wait_until_sound_is_finished SET_HORIZONTAL_SCROLLABLE_AREA scene - - left border right border - -
'127': Actionparts#Wait_until_sound_is_finished SET_VERTICAL_SCROLLABLE_AREA scene - - upper border lower border - -
'130': Actionparts#Keep_scene_in_memory KEEP_SCENE_IN_MEM - - -

'0': keep scene objects and characters
'1': keep scene objects
'2': keep characters

max. number of scene changes to keep sprites - -
'131': Actionparts#Set_text_and_speech_output SET_TEXT_OUTPUT - - -

'0': text and speech output
'1': only speech output
'2': only text output

- - -
'132': Actionparts#Set_character_to_position SET_CHARACTER_TO_POSITION character scene - x-coordinate of point y-coordinate of point - -
'133': Actionparts#Change_way_system CHANGE_WAYSYSTEM way system - - - - - -
'134': Actionparts#Set_first_animation_frame SET_FIRST_ANIMATION_FRAME animation - - first animation frame - - -
'135': Actionparts#Set_last_animation_frame SET_LAST_ANIMATION_FRAME animation - - last animation frame - - -
'136': Actionparts#Set_text_speed SET_TEXT_SPEED value - - speed in % - - -
'137': Actionparts#Call_script CALL_SCRIPT script - - - - - function name to call
'138': Actionparts#Execute_script EXECUTE_SCRIPT - - - - - - script content
'139': Actionparts#Set_condition SET_CONDITION condition - -

'0': true
'1': false

- - -
'140': Actionparts#If_condition IF_CONDITION condition - -

'0': true
'1': false

- - -
'141': Actionparts#Show_hide_cursor SHOW_HIDE_CURSOR cursor - -

'0': show
'1': hide

- - -
'142': Actionparts#Show_hide_interfaces SHOW_HIDE_INTERFACES - - -

'0': show
'1': hide

- - -
'143': Actionparts#Start_stop_earthquake START_STOP_EARTHQUAKE - - -

'0': start earthquake
'1': stop earthquake

force (in pixel) speed -
'144': Actionparts#Begin_end_cutscene BEGIN_END_CUTSCENE - - - '0': start earthquake

'1': stop earthquake

- - -
'145': Actionparts#Load_save_bookmark LOAD_SAVE_BOOKMARK - - -

'0': load bookmark
'1': save bookmark

number of savegame: '0' - '99'

'0': do not save action where this action part is defined.
'1': also save action where this action part is defined.

-
'146': Actionparts#Load_save_game LOAD_SAVE_GAME - - -

'0': load game
'1': save game

'0': do not save action where this action part is defined.
'1': also save action where this action part is defined.

- -
'147': Actionparts#Change_general_volume SET_VOLUME - - -

'0': sound volume
'1': music volume
'2': speech volume
'3': movie volume
'4': global volume

'0': =
'1': +=
'2': -=

volume (between '0' and '100') -
'148': Actionparts#Call_exit_action CALL_EXIT_ACTION action - -

'0': call action
'1': exit action

- - -
'149': Actionparts#Preload_animation PRELOAD_UNLOAD_ANIMATION animation - -

'0': preload animation
'1': unload animation

- - -
'150': Actionparts#Add_remove_item ADD_REMOVE_ITEM object (item) character -

'0': add item
'1': remove item

'0': do not scroll items
'1': scroll items so that added item is visible (i.e. scroll to end of items because added item is at the end of item list)

- -
'151': Actionparts#Show_next_previous_savegames SCROLL_SAVEGAMES - - -

'0': next savegames
'1': previous savegames

- - -
'152': Actionparts#Set_animation_position SET_ANIMATION_POSITION animation - - x-coordinate y-coordinate

'0': =
'1': +=
'2': -=

-
'153': Actionparts#Show_hide_snoop_animations SHOW_HIDE_SNOOP_ANIMATIONS - - -

'0': show
'1': hide

- - -
'154': Actionparts#Preload_unload_character PRELOAD_UNLOAD_CHARACTER character - -

'0': preload character
'1': unload character

- - -
'155': Actionparts#Show_object_text SHOW_OBJECT_TEXT text object - x-coordinate y-coordinate

'0': align text left
'1': align text centered
'2': align text right

-
'156': Actionparts#Hide_object_text HIDE_OBJECT_TEXT object - - - - - -