Home :: Updates :: Player Screenshots :: Editor Screenshots :: Documentation

Trigger Reference

This page lists all of the triggers that are supported by the player. Each trigger is extensively documented, and examples of scripts using said triggers are also included.

Unless you are a wayward connoisseur, there is really no need to memorize any of these triggers, since the editor already has plenty of user-friendly dialogs that can be used to automatically insert the following triggers into your script.

Triggers

add_evidence_animated
add_evidence_silent
add_location
add_presentable
add_profile
add_talk_option
change_character_caption
change_character_desc
change_character_gender
change_character_name
change_evidence_caption
change_evidence_desc
change_evidence_name
clear_location_music
clear_presentables
clear_talk_options
direct_goto
display_testimony
fade_out
flash
goto
halt_music
hide_evidence
hide_temp_image
move_court_camera
play_music
put_character
remove_presentable
remove_talk_option
request_answer
request_evidence
set_animation
set_bad_presentable_block
set_court_overview_image
set_location
set_location_music
set_location_trigger
set_temp_image
sfx
show_evidence
speaker
special_effect
timed_goto

add_evidence_animated

Syntax: add_evidence_animated(evidence_id)

Parameters:

evidence_id: the internal ID of the evidence to add

This trigger adds the provided evidence to the Court Record, and it also shows the animation along with a custom message in the textbox.

Example:

{*add_evidence_animated:lawyers_badge;*}
\cLawyer's Badge added\n
to the Court Record.

add_evidence_silent

Syntax: add_evidence_silent(evidence_id)

Parameters:

evidence_id: the internal ID of the evidence to add

Unlike add_evidence_animated, this trigger adds the given evidence to the Court Record without the animation that you're used to seeing. It's useful to add default evidence before starting a case.

Example:

{*add_evidence_silent:lawyers_badge;*}

add_location

Syntax: add_location(new_location,target_location)

Parameters:

new_location: the location to be added
target_location: the location where the new one should be added to

In order for the user to be able to move from place to place, you need to call this trigger. Here, new_location is added to target_location's list of places that can be navigated to. Basically, if the user is at target_location, and if he or she clicks the Move button in the player, new_location will then be listed on that screen.

Example:

{*add_location:detention_cell,wright_law_office;*}

add_presentable

Syntax: add_presentable(character_id,court_rec_id,target_block)

Parameters:

character_id: the internal name of the character to whom this Court Record item can be presented
court_rec_id: the internal ID of either a piece of evidence or character that can be presented
target_block: the block to execute if the user does present this item to the character

This trigger will add either a piece of evidence, or a character profile to a character's list of Court Record items that the user can present. Initially, all characters start off with an empty list. Each call to this trigger will include that Court Record item to the character's list of presentables. If the user does in fact present this item, then the player will execute target_block.

Example:

{*add_presentable:dick_gumshoe,crime_photo,dick_gumshoe_1;*}

{*add_presentable:dick_gumshoe,maya_fey,dick_gumshoe_1;*}