FALLOUT 2 EDITOR INTRODUCTION

Here is the Fallout 2 editor, the scripts, and the script compiler. We were able to take some time and
put together some documentation for it (and an installer), but a lot of it will require some trial and
error. If you want to hammer away at it, well, here it is.
Some things to keep in mind:
This editor is not the holy grail. It was never meant to be released to the public. As a result, you may
boot the editor up and realize that it doesn't match your expectations for a commercially-released RPG
editor. You may suffer some retina burn. Perhaps a strange itching sensation. Constipation. So be
prepared - you are about to experience a game editor, intended only for developers.
You use the Fallout 2 editors at your own risk. A poll was posted some time ago
(http://feedback.blackisle.com/forums/showthread.php?s=&threadid=51095) asking if fans interested
in the editors would prefer to have the editors sooner with no documentation, and the answer was an
overwhelming yes, so here it is. We ended up including some documentation, anyway, so hopefully
that should help the pains of easing into the editor.
You need to have Fallout 2 installed for these editors to work.
Be sure to check out the readme.txt in the Scripts folder that will be installed with the editor. It
explains compiling the scripts, and some examples of how to build them using different C compilers
for the preprocessor. There is also information on the Open Watcom compiler and a link for where to
get it.
Page 1

This is not the Fallout 2 source code. There are no plans to release the Fallout 2 source code at this
time.
Be warned - various issues with the editor are listed in the "Known Problems" section of this
document. Check it out before using the editors.
The Fallout 2 editors are not supported by Interplay. If you have a problem with them, do not contact
customer support because they'll have no idea what you're talking about.
If you have any questions about usage of the editors, post them up on the Fallout 1 and 2 forum
(www.interplay.com), and if we can answer them, we will. Keep in mind it has been many years since
these editors have been used, and a lot of the know-how is either rusty or has been forgotten, but we'll
see what we can do.
There are a number of people you should thank for the editors.
Josh Sawyer. Without Josh, you would not have the F2 editor. He brought up the idea in a meeting,
and everybody nodded their head because it seemed like a good idea before we realized what a pain in
the ass it would be.
Darren Monahan and Feargus Urquhart. Without Darren and Ferg, you would not have the F2 editor.
Chris Heidari. Chris Heidari took a good chunk of his time to test the editor and, as an added bonus, set
up the installer to make it easier for you to use.
Scotty Everts, who put the lion's share of work in setting up the editor doc summary.
...and most of all, Chris Jones. Chris worked on getting the F2 editors together during his free time.
Without Chris, you would not have the F2 editor.
Thanks and enjoy,
Chris Avellone

Page 2

FALLOUT EDITOR MAP BUILDING NOTES

Introduction
The Fallout editor was originally written over six years ago. While it was updated and enhanced during
Fallout 1 & 2 development, it's archaic by todays standards, and it will take a lot of patience to make
maps. (Your first few will be a challenge, but it'll get a little easier with practice.) The main problem
with map-building will be finding all the art pieces you want.
There are 6 different art categories; unfortunately, there are no sub-categories for each - the engine
didnt support it; as new art was made, it just got added to the end of the list. So you might find a set of
wall sections with pieces spread all over the art list. Fortunately there is a Bookmark command which
will make it a little easier (explained below).
Also, this version includes art for Fallout 2 and reused art from Fallout 1. Any of the custom art from
Fallout 1 is not included as it was originally deleted to save disc space. For those enterprising
individuals that have extracted the original Fallout 1 art, you might be able to re-insert it with some
work.

Initial Concepts
There are 6 basic art objects (categories) that make up a map.

Tiles - These are the floor and roof tiles; the basic pieces you build all your maps on. Tiles get
put down as floors when Roof is off. Roof on will place tiles at the roof elevation. So any
tile can be used either way.

Walls - Building wall sections. They come in N/S & E/W directions. All external & internal
buildings are built from these.

Scenery - The detail pieces such as chairs, tables, trash, cars, etc, used to decorate and flesh out
an area. Doors are in the scenery list.

Items - Inventory items for guns, stimpaks, etc. For placing on critters, containers, or ground.
Containers are also listed under items.

Critters - Your people and monsters. Place them and attach scripts to make them interact in
your environment.

Misc - All the odd stuff like projectile graphics and such. Exit Grid sections are part of the
Misc list.

Place an object by Right-Clicking on art object bar (see screenshot below for reference in the following
directions). Then Left-Click where you want it on the map.
To select a placed object, Left-Click on it. There is no highlight but the selected objects name will
appear in the Lower right info screen. Sometimes you might have to click it a few times to get it to
Page 3

select. You can also move the object around. Hold down the left mouse button while selecting and you
can drag to a new location.
Menu Bar - The menu bar is hidden until you move the cursor to the top of the screen.
Bookmarks - You can set a bookmark in each art object category. The 1-9 keys can be assigned to any
location on the art list, and each category can have its own set. To do this, move to a location on the art
object bar. Select the Menu Tools/Set Bookmark. Then just press the number key you want that
location to be assigned to.
Each map can have 3 map levels. Use the Up/Down arrows on the lower left side of the edit screen to
switch levels. This is used for similar levels like dungeons so you dont have to wait for a new map to
load when switching levels.
The H key will toggle hexes on and off. A Hex filled in red is blocked and no PC or NPC can enter
it. Most walls and scenery are set to Blocking on. Sometimes when laying out walls or scenery, there
will be holes, which can result in embarrassing firefights in towns with enemies shooting you through
these holes in the walls without you realizing it. Blocking hexes are explained in more detail below.
The F8 key will switch the editor into Game mode. You can walk your character around the map
and check holes in walls, or how scroll blocking is working, etc. This is the best key in the universe.
The F12 key will take a screenshot. You do not have to be in game mode - you can take screenshots
at any time while you are in the editor, compiling information on weapons, ammo, critter stats, and so
on.

Page 4

Basic Editor Functions

11. Hidden
Menu Bar
1. Art
Categories
10. Cursor

2. Hex Number
3. Art Object
Number

4. Art
Object Bar

5. Map
Level

6. Art Object
Toggles

7. Critter Object
Rotation

8. Object
Functions

9. Info
Screen

1. Art Categories - You can use F1-F6 to jump between them instead of using the menu.
2. Hex Number - The number of the map hex you are placing an art object. This is helpful for
telling a scripter which of the 34+ hookers on a map you need a special script attached to, as
well as laying boundaries for certain scripts.
3. Art Object Number - The number of the art object in position one of the Art Object Bar.
4. Art Object Bar - Shows the art objects of the selected category. Double Arrows scroll by page,
single arrow one at a time. Right-Click to select one. Left-Click to place on map. Plus and
Minus keys scroll through the list. Shift scrolls by page.
5. Map Level - You can have up to three maps in one file. Helps save on load times for dungeons
or building interiors.
6. Art Object Toggles - Toggles the different categories of art objects on and off. Roofs are
default to "off." To lay roof tiles you need toggle on. Remember to Toggle roof tiles off to lay
Page 5

ground tiles again. R key is a quick key for doing this. Top Down button is non-functional
- it was a feature that was never implemented.
7. Critter Object Rotation - To select which way a critter is facing when placed. If your super
mutants are always getting placed down with their asses facing you, check the critter object
rotation and change it until they're facing the right direction.
8. Object Functions Copy will copy selected elements of the art object group you are currently in. If you are
in the Tiles category, only tiles will be copied, etc. Drag the box to select the copied
elements. You can stamp the selected group anywhere you like. Right click to clear.
Copy All functions like Copy but will copy everything selected including tiles, critters,
scenery, etc. Great fun at parties.
Edit is for changing attributes of the selected object.
Delete will permanently remove the selected object.
9. Info Screen- Lists art object names and other status info.
10. Cursor - Changes based on mode or function.
11. Hidden Menu Bar - Appears when cursor is moved to top of screen.

Menu Bar
FileStandard Load, Save, Quit menu. You know the deal.
Tools

Create Pattern / Use Pattern - Allows you to set Tile patterns and place them. Making
new patterns doesnt seem to work. Use Pattern has a list of various pre-made patterns to
make it easier to layout ground and floors. Select one off the list. You can now stamp that
pattern down. The Plus & Minus keys change the size of the stamp. Right-Click to exit
Pattern mode.

Move Map - Allows you to shift the map. In case you run out of space on an edge, this
allows you to move the whole map around to re-center it. The arrow keys should shift it but
there was some trouble getting this function to work.

Move Map Elevation - Moves the whole map to another map level.

Copy Map Elevation - Copies the whole map to another map level. If you are building two
similar levels, this will save time from having to recreate most of the previous level.
Page 6

Note: There seems to be a problem when using the Copy Map Elevation
function. Trying to copy a level to another map/elevation level, the editor will crash to
the desktop with a generic Program error message. Hell, it may work for you, but it
wasn't working for us.

Toggle Block Object View - There are various invisible blocker objects used to block or
restrict movement and screen scrolling. This menu option toggles them visible in the editor so
you can edit and move them - they are never visible in-game, otherwise you would have one
surreal Fallout game on your hands. Many times when placing art, there will be holes in walls
or scenery. These blockers are used to fill in those holes so the PC or NPCs dont walk (or
shoot) through areas of the map that they arent supposed to. Check out some of the Fallout 2
maps for examples of where they are used, and you'll see what we mean.
Wall Blocker - Dark Green W. Blocks movement. Shows up as Wall (Light Green) on
in-game Map. Comes in two versions, but it appears only the one labeled Wall S.T. is
used. (Walls category, tile#621)
Secret Blocking Hex - Light Green S. Blocks movement. Shows up as Scenery (Dark
Green) on in-game Map. (Scenery category, tile#66)
Block Hex Auto Inviso - Yellow SAI. Blocks movement. Invisible on in-game Map.
Used to block out areas of a map that you dont want to show up on the in-game map.
(Scenery category, tile#343)
Light Source - Green Yellow Sun symbol. Does not block movement. Places light
source in hex. Light can be adjusted by using Edit. (Scenery category, tile#140)
Exit Grid Map Marker - Blue EG. Special markers that display in Tan on the in-game
map. Used to indicate where Exit Grids are. (Scenery category, tile#48)
Scroll Blocker - White S. A special marker that restricts screen scrolling. When the
center of the screen hits a row or column of these, the screen will no longer scroll any
farther. Used to define the edge of a map. Please note the scroll blocking works both ways.
If your character somehow gets outside the edge, you will not be able to scroll inside the
map area. (Misc. category, tile#11)
Many of these blockers were designed to work with the in-game map. The in-game map shows
objects in the Wall category in bright green. Scenery objects in dark green. To keep the ingame map useful the different shades were used to make buildings stand out from the scenery.
So when placing blocking hexes, use wall blockers for filling in holes in walls, and scenery
blockers to fill in holes in scenery. The inviso blockers work well for blocking large areas like
lakes, rad goo, etc. that you dont want to show up on the in-game map.

Exit Grid Options - Exit Grids are the brown and green dithered areas that are used to warp
the player to a new map. The art for the dithered pattern is in the Misc. category. Green is used
for transitions between maps or map levels, and brown is used for transitions to the World Map.
(There is also a black grid, but it's unused in the game.) You will notice that when placing grid
pieces, there is a hotpoint for each that shows up light blue when Hexes are visible. That blue
hex is important - for exit grids to work, the player must move across that hex. So when laying
Page 7

down a series of Exit Grids, make sure the grid hotpoint is facing towards where the player is
entering from. And make sure an uninterrupted line of them is placed so a character always has
to cross one to reach the Exit Grid.
Set Exit Grid Data - Sets the Exit grid data. After setting the data, you will mark the Exit
Grid objects with the other two options. Entering -1 in Exit Grid Dest Map option will
send the player to the World Map.
Mark Exit Grids - This will put you into a mode where you can mark exit grids to what
you entered in the above command. Clicking each Exit Grid piece will mark it. Press
ESC to exit this mode. Please note there is no indication you are in this mode. Other
functions may not work until you exit this mode.
Mark All Exit Grids - This will mark ALL exit grids on the map to what was set in Set
Exit Grid Data. It will override whatever you previously set.

Clear Map Level - Erases all objects from the map.

The remaining options are script related and are not covered in this document.

Known Problems with the Editor

The following problems exist with the editor:

Mapper will crash if the user tries to show map script after having canceled out of setting a map
script. To repeat, go to Scripts -> Set Map Script. Press ESC twice to cancel out of menu. Now
try to show the map script by going to Scripts -> Show Map Script. At this point the mapper
will crash to the desktop.

You may encounter sporadic problems while going through and loading up all the maps - after
awhile, maps may load in being completely engulfed in blackness. Moving the screen or cursor
around would eventually make the blackness go away.

Occasionally if you Alt-Tab out of the editor, the taskbar entry for the editor will disappear
even though the Alt-Tab list still shows the program as running. As a warning, Alt-Tab seems
to screw with the editor a bit.

There is a problem when using the Copy Map Elevation function. Trying to copy a level to
another map/elevation level, the editor will crash to the desktop with a generic Program error
message.

Page 8

Script Commands for the Editor

The following was a list of potential script commands that may prove useful for programmers and
scripters out there in the fan community who are trying to decipher what does what. I do not know
what the gray-shaded definition blocks mean, but it could be significant as you're tearing through the
guts of these commands. Maybe gray-shaded means these commands are diseased. Or don't work. Or
got cut. Explore and find out, or wait for Red! and some crazy Team X Russians to figure it out.
action_being_used
int Script
add_obj_to_inven
void Inven
who (ObjectPtr)
item (ObjectPtr)
add_mult_objs_to_inv
en
void Inven
who (ObjectPtr)
item (ObjectPtr)
count (int)
add_timer_event
void Meta(Time)
obj (ObjectPtr)
time (int)
info (int)
anim
void Anim
who (ObjectPtr)
anim (int)
direction (int)
anim_action_frame
int Anim
who (ObjectPtr)
frame (int)
anim_busy
int (boolean) Anim
who (ObjectPtr)
animate_move_obj_to
_tile
void Anim
who (ObjectPtr)
tile (int)
speed (int)
animate_rotation
void Anim
direction (0-5)
animate_run_to_tile
void Anim
tile (int)

Returns the current skill () being used on a script object.

Adds an object (item) to another objects (whos) inventory. Note that
this only works with objects of type Item.
Adds (count) instances of an object (item) to another objects (whos)
inventory. Note that this only works with objects of type Item.

Adds a timed event call to the queue, at a given time offset, to call an
objects (obj) script. Info is used to let scripts differentiate between
timed event calls so that they can be hooked in multiple times. Info is
read back by the script using the fixed_param operator. Note that time is
in ticks (you can use game_ticks(seconds_num) to get the time in ticks
from time in seconds).
Sets up a single-frame animation (anim) for the object (who) that runs in
the given direction.

Returns the action frame of the given art frame on a given object (who).
This can be used as the delay in an animation registration sequence.
Returns True if object (who) is currently animating, otherwise False.
This can be used to determine if a given object has completed an
animation.
Sets up an animation for a critter (who) to walk to a given tile (hex) at a
given speed (speed). Speed (walk/run) can also have a flag attached (see
define.h) to force the object (who) to stop its current animation (for
instance, if it was already walking somewhere) and then walk/run to the
new location (tile).
Changes the orientation (facing) of the self-object to the given direction.
Sets up an animation for the self-object to RUN to a given tile (hex).
Page 9

animate_set_frame
void Anim
newFrame (int)
animate_stand
void Anim
animate_stand_obj
void Anim
obj (ObjectPtr)
animate_stand_revers
e
void Anim
animate_stand_revers
e_obj
void Anim
obj (ObjectPtr)
art_anim
void Anim
fid (int)
attack
void Combat
who (ObjectPtr)
attack_complex
void Combat
who (ObjectPtr)
called_shot (int)
num_attacks (int)
bonus (int)
min_damage (int)
max_damage (int)
attacker_results (int)
target_results (int)
attack_setup
void Combat
who (ObjectPtr)
victim (ObjectPtr)
car_current_town
int Map
car_give_to_party
int Map
car_give_gas
int Map
amount (int)
combat_difficulty
int
combat_is_initialized
int

Changes the current animation frame of the self-object to the given

frame # (newFrame). This can be used to make lights go to broken
lights or to alarm/siren lights, for example. Should be used in place of
animate_stand for 2-frame anims.
Sets up an animation for the currently focused object (self) to run its
stand animation.
This can be used to open doors, open container items (Refridgerator, for
example) or to run a critters fidget animation.
Sets up an animation for an object (obj) to run its stand animation.
This can be used to open doors, open container items (Refridgerator, for
example) or to run a critters fidget animation.
Sets up an animation for the currently focused object (self) to run its
stand animation in reverse. This is used only for non-critters, to cause
them to close (close doors, open containers, etc.)
Sets up an animation for an object (obj) to run its stand animation in
reverse. This is used only for non-critters, to cause them to close (close
doors, open containers, etc.)
Returns the animation that this fid represents (ANIM_stand,
ANIM_pickup, etc.).
Causes the focused object (self) to attempt to attack an object (who).
Note that this is a macro to attack_complex() below.
Causes the current object (self must be a critter) to attempt to attack a
critter (who) with various parameters modifying the combat:
called_shot 0/1/specific means none/random/specific (head, torso,
etc.)
num_attacks the # of extra attacks the self object gets before the
target
bonus the bonus to hit the target on the first turn only
min_damage the minimum damage that will be done the first attack
max_damage the maximum damage that will be done the first attack
attacker_results what state the attacker ends in after the first attack
target_results what state the target ends in after the first attack
Sets up an attack from who on victim, without expecting this script to
be involved. Can be used to setup attacks on critters from the map
script.
Returns the current town area the car can be found at. Area #s can be
found in scripts\headers\maps.h
Gives the car to the party, and takes them to the worldmap.
Gives the car a given amount (amount) of gas.
Returns the current Combat difficulty level of the game (defined in the
options screen).
Returns True if the system is currently in combat mode, False otherwise.
Page 10

create_object
int (?) Object
pid (int)
tile_num (int)
elev (0-2)
create_object_sid
int (?) Object
pid (int)
tile_num (int)
elev (0-2)
sid (int)
critter_add_trait
int Critter
who (ObjectPtr)
trait_type (int)
trait (int)
amount (int)
critter_attempt_place
ment
int Map
who (ObjectPtr)
hex (int)
elev (0-2)
critter_damage
void Critter
who (ObjectPtr)
dmg_amount (int)
critter_heal
void Critter
who (ObjectPtr)
amount (int)
critter_injure
int Critter
who (ObjectPtr)
how (int)
critter_inven_obj
(ObjectPtr)
Critter/Inven
who (ObjectPtr)
where (int)
critter_is_fleeing
int Critter
who (ObjectPtr)
critter_mod_skill
int Critter
who (ObjectPtr)
skill (int)
amount (int)

Creates a new object of prototype (pid), placing it at a given tile # and at

a given elevation. If the prototype indicates a script should be attached,
then it will be.
Creates a new object of prototype (pid), placing it at a given tile # and at
a given elevation. If sid is not -1, then it indicates that the default script
should be overriden by this new script #.

Adds a particular trait (trait) of a given type (trait_type) to a particular

critter (who). Possible traits under the SPECIAL system are limited to:
Perks
Traits
Object-instance information (such as team #s, ai-packet #s, etc.)
Attempts to place a critter at a given destination hex & elevation, if it
fails, then it tries to find a nearby hex that is that is as near as possible to
the start hex. No LONGER checks to see if the hex is visible on-screen.

Inflicts damage on a critter (who) of a given amount, killing it if

necessary.
Heals a critter for a given amount up to maximum.

Injures a given critter (who) by crippling given limbs/body parts

(defined by DAM_CRIP_ARM_LEFT, DAM_BLIND, etc. in define.h)
Returns a pointer to an object that is in a given spot (NULL if none).
The appropriate values for where are: INVEN_TYPE_WORN,
INVEN_TYPE_RIGHT_HAND, and INVEN_TYPE_LEFT_HAND.
Returns True if the critter object (who) has its FLEE flag set.
Modifies a given skill in a given critter object (who) by a given amount.
Note: this currently is only valid on the player (obj_dude) object.

Page 11

critter_rm_trait
int Critter
who (ObjectPtr)
trait_type (int)
trait (int)
amount (int)
critter_set_flee_state
int Critter
who (ObjectPtr)
flee_on (Boolean)
critter_skill_level
int Critter
who (ObjectPtr)
skillNum (int)
critter_state
int Critter
who (ObjectPtr)
critter_stop_attacking
int Critter
who (ObjectPtr)
cur_map_index
int Map
cur_town
int Map
days_since_visited
int Map
debug_msg
void Debug
text (string)
destroy_object
int Object
obj (ObjectPtr)
destroy_mult_objs
int Object
item (ObjectPtr)
count (int)
dialogue_reaction
void Dialog
mood (int)
dialogue_system_ente
r
void Dialog
difficulty_level
int
display_msg
void
message (string)

Removes a particular trait (trait) of a given type (trait_type) from a

particular critter (who). (See critter_add_trait.)

Sets the FLEE flag on or off. This controls whether the critter flees
during combat.
Returns the current skill level of a particular objects (who) skill
(skillNum).
Returns the state of a given critter object (from combat data), used to
determine if a critter is dead, unconscious, etc..
Flags the critter object (who) as no longer wishing to be active in
combat.
Returns the index # of the current map, to be matched with the defineconstant in define.h.
Returns the index # of the current town, to be matched with the defineconstant in define.h.
Returns the number of days since this map was last visited, or (-1) if it
has never been visited before.
Prints a string to the debug monitor. Should be used exclusively for
debug information, instead of display_msg()!
Destroys an object (obj), which will cause its script to be called in the
destroy_proc section if the object is *NOT* the calling object.
Destroys count number of instances of an item object. This function will
figure out which inventory this item is in (if it isnt on the ground). If it
is on the ground, of course, there is only one instance of this object, so
only one will be destroyed.
Set up a reaction animation in the dialogue system.
Tells the dialog system that this object is requesting the talk system.
This is used when the script wants to start dialog instead of waiting for
the player to initiate it. The script will be called back in its talk_proc
section.
Returns the current Game difficulty level of the game (defined in the
options screen).
Displays a string on the in-game PDA display (lower-left hand corner).

Page 12

do_check
int (roll_result) Skill
who (ObjectPtr)
check (int)
modifier (int)
drop_obj
void Inven
obj (ObjectPtr)
drug_influence
int Critter
who (ObjectPtr)
dude_obj
(ObjectOtr)
elevation
int Map
obj (ObjectPtr)
end_dialogue
void Dialog
endgame_movie
void Meta
endgame_slideshow
void Meta
explosion
int Anim
where (int)
elevation (0-2)
damage (int)
fixed_param
int
float_msg
void
who (ObjectPtr)
msg (str)
type (int)
game_ticks
int Time
seconds (int)
game_time
int Time
game_time_advance
void Time
amount (int)
game_time_hour
int Time

Do a check/test-roll versus one of the various basic traits (strength,

perception, etc.).

Causes the critter self-object to remove a given object (obj) from its
inventory and place it on the ground at its hex. This animates the
self_obj.
Returns True if a given critter object (who) is currently under any drug
influences, False otherwise.
Returns a pointer to the dude object (the player).
Returns the current elevation being displayed.
Terminates the dialogue system.
Plays the endgame movie.
Plays the endgame slideshow. The slideshow will fade in to its palette,
so it is proper to call gfade_out(1) and then expect this command to fix
the palette for you.
Sets up an explosion at a given tile number (where) on a given
elevation, that will cause damage in a radius.

Returns the value of the scripts fixed parameter. This is used with
add_timer_event, for instance, to pass the info parameter back to the
script.
Attempts to create a floating-text message (str) attached to an object
(who) using colors dictated by type. There are two special types,
WARNING and SEQUENTIAL. WARNING is used to print a message
centered on the screen (such as for end-of-quest notifications), and
SEQUENTIAL will cycle through the colors, in an attempt to give
critters different-colored messages to differentiate them.
Returns the number of game ticks equal to a given # of seconds.
Returns the current game time in ticks.
Advances the current game time by (amount) ticks.
Returns the current hour of the day in a normal format, but without the
colon. For example, the current starting game time is 721 (which is 7:21
am).
Page 13

game_ui_disable
void Meta
game_ui_enable
void Meta
game_ui_is_disabled
int Meta
gdialog_barter
int Dialog
get_critter_stat
int Critter
who (ObjectPtr)
stat (int)
get_day
int Time
gdialog_mod_barter
int Dialog
modifier (+/- percent)
get_month
int Time
get_pc_stat
int Critter
pcStat (int)
get_poison
Critter
who (ObjectPtr)
gdialog_set_barter_m
od
void Dialog
mod (int)
gfade_in
void Meta
time (int)
gfade_out
void Meta
time (int)
giQ_Option
void Dialog
iq_test (int)
msg_list (int)
msg_num (int)
target (procedure)
reaction (int)
give_exp_points
void
points (int)

Disables game user-interface input from the player (to lock-out the
player). You *MUST* make sure to re-enable the UI at some point
afterwords.
Re-enables game user-interface input from the player. This *MUST* be
called relatively soon after disabling the UI or the player will be stuck,
unable to do anything.
Returns True if the game UI is currently disabled (the player is currently
locked-out), and False otherwise.
Tells the dialog system to switch to the barter screen. (Sets the barter
modifier to 0).
Returns the value of a desired attribute/stat in a critter object (who).

Returns the current day of the month.

Tells the dialog system to switch to the barter screen, using a given
modifier.
Returns the current month of the year.
Returns the value of a desired pc-only stat of the obj_dude. These are
found in define.h all starting with PCSTAT_.
Returns the value of a given critters (who) poison level.
Sets the current modifier for barter to a given percentage (mod). Used to
make barter easier/harder, even if the player initiates barter (as opposed
to the script starting it.)
Does a palette fade to black. The Time parameter is currently not
actually used.
Does a palette fade from black to the game palette. The Time parameter
is currently not actually used.
Sets up an option-choice for a reply block if the players IQ statistic is
equal to or greater than a given value (iq_test), getting the string from
the message file (msg_list) and message number (msg_num), which will
cause a given reaction (reaction), and if chosen will jump to the given
(target) procedure.
Adds experience points (points) to the players total. These points may
then be used by the player to enhance skills, etc.

Page 14

global_var
int Map
var_index (unsigned
int)
goto_xy
Map
gSay_End
void Dialog
var_index (unsigned
int)
gSay_Message
void Dialog
msg_list (int)
msg_num (int)
reaction (int)
gSay_Option
void Dialog
msg_list (int)
msg_num (int)
target (procedure)
reaction (int)
gSay_Reply
void Dialog
msg_list (int)
msg_num (int)
gSay_Start
void Dialog
has_skill
int Skill
who (ObjectPtr)
skill (int)
has_trait
int Critter
trait_type (int)
who (ObjectPtr)
trait (int)
how_much
int Skill
val (int)
inven_count
int Critter
what (ObjectPtr)
inven_ptr
(ObjectPtr) Critter
what (ObjectPtr)
slotNum (int)
inven_unwield
void Critter

Returns the value of a global variable # (var_index).

Ends a dialog sequence, which will bring up the sequence (actually

display it).
Sets up a sayMessage, which is a reply with just a [Done] option. The
msg_list determines which message file to look in, and the msg_num
determines which line to use from the file.
Sets up an option-choice for a reply block, getting the string from the
message file (msg_list) and message number (msg_num), which will
cause a given reaction (reaction), and if chosen will jump to the given
(target) procedure.
Sets up a reply block (what the *CRITTER* says).

Starts a new dialog sequence.

Determines if a critter (who) knows a particular skill. Actually, this
currently returns the level of the skill, which will include defaults.
Returns the value of a given critter objects (who) trait of a given
Trait_type (see define.h). This can be used to determine if the player has
a particular Perk, AI Packet, team num, current rotation, or Trait
(finesse, bruiser, etc.).
Returns the value of a completed skill vs. skill contest (how much the
rolls differed by). This requires that you first call one of the contest roll
commands, such as roll_vs_skill, skill_contest, etc..
Returns the count of how many inventory slots are filled on a given
object (what).
Returns a pointer to the object in slot # (slotNum) in a given object
(what).
Attempts to cause a critter to unwield any wielded weapons/items. If
animations are currently disabled, it will just instantly change the art.

Page 15

is_critical
int Skill
val (int)
is_loading_game
boolean Map
is_skill_tagged
int Skill
skillNum (int)
is_success
int Skill
val (int)
item_caps_adjust
int Inven
obj (ObjectPtr)
amount (int)
item_caps_total
int Inven
obj (ObjectPtr)
jam_lock
int Object
lockableObj
(ObjectPtr)
kill_critter
void
obj (ObjectPtr)
death_frame (int)
kill_critter_type
void Map
pid (int)
language_filter_is_on
int (boolean) Meta
load_map
void Map
map_name (string)
start_location (int)
local_var
int Map
var_index (unsigned
int)
map_first_run
int Map
map_is_known
int Meta
mapNum (int)
map_known
int Meta
mapNum (int)

Returns True if a given contest roll result is a critical result, otherwise

False.
Returns True if the game is currently loading, False otherwise. This is
used so that bad things dont happen on game load because a script is
doing map_enter setup stuff.
Returns True if a given skill is tagged.
Returns True if a given contest roll result value is a success, otherwise
False.
Modifies the current caps count in an object (obj) by a given amount
(amount).
Returns the current caps total in a given objects (obj) inventory.
Jams a lock, which prevents the player from picking the lock for
approximately 24 hours. Meant to be used when a player critically fails
to pick a lock.
Kills a critter (obj) outright, placing it in the chosen death frame. Note:
this does NOT animate the critter, and does NOT refresh the screen! It
is meant to be used in scripts run when entering/exiting a map
(map_init/map_exit).
Kills all critters of a given type (pid) outright. See kill_critter above.
Returns True if the language filter is currently filtering harsh language,
False otherwise.
Loads a new map (map_name), removing all scripts currently running
and passing on the entrance location (start_location) to the new maps
map_init script.
Returns the value of a local variable of given index # (var_index).

Returns True if the current map is being run for the first time (in other
words, this map was not loaded from a save-game).
Returns True if a given map index (mapNum) is known, False
otherwise.
Returns True if a given map # (mapNum) is known, False otherwise.

Page 16

map_var
int Map
var_index (unsigned
int)
message_str
char *
list (int)
msg_num (int)
move_to
int Map
obj (ObjectPtr)
tile_num (int)
elev (0-2)
move_obj_inven_to_o
bj
int Inven
srcObj (ObjectPtr)
destObj (ObjectPtr)
obj_art_fid
(ObjectPtr) Object
obj (ObjectPtr)
obj_being_used_with
(ObjectPtr) Object
obj_can_hear_obj
boolean Map
src_obj (ObjectPtr)
dst_obj (ObjectPtr)
obj_can_see_obj
boolean Map
src_obj (ObjectPtr)
dst_obj (ObjectPtr)
obj_carrying_pid_obj
(ObjectPtr) Object
who (ObjectPtr)
pid (int)
obj_close
void Object
what (ObjectPtr)
obj_drop_everything
void Inven
who (ObjectPtr)
obj_is_carrying_obj_p
id
boolean Object
obj (ObjectPtr)
pid (int)
obj_is_locked
int Object
what (ObjectPtr)

Returns the value of a map-global variable of a given index #

(var_index).
Returns a string from the message module for a given list and a given #
(msg_num).
Immediately moves an object (obj) to the given tile number and
elevation on the current map.

Moves an objects (srcObj) inventory into another objects (destObj)

inventory.

Returns the fid # (used to index art) of a given object (obj).

Returns a pointer to the object being used on another object.
Returns True if the source object (src_obj) is capable of hearing the
destination object (dst_obj). This includes distance factors, current
activity (standing/walking/running), and skill use (stealth/etc.).
Returns True if the source object (src_obj) has line-of-sight (LOS) with
the destination object (dst_obj). This also takes into account perception
& stealth rolls of the objects are critters.
Returns an Object pointer to an instance of an object of type pid if an
object (who) is carrying an object of that type.
Attempts to close a given object (what) if it is of an openable type.
Causes a critter object (who) to drop all objects in its inventory and
drop it on the ground at its feet.
Returns the quantity of objects with matching prototype index #s (pid)
carried in the inventory of another object (obj).

Returns True if a given object (what) is a locked object, False if it is

unlocked or not a lockable object.

Page 17

obj_is_visible_flag
int Object
who (ObjectPtr)
obj_is_open
int Object
what (ObjectPtr)
obj_item_subtype
int Object
obj (ObjectPtr)
obj_lock
void Object
what (ObjectPtr)
obj_name
void Object
what (ObjectPtr)
obj_on_screen
int Object
what (ObjectPtr)
obj_open
void Object
what (ObjectPtr)
obj_pid
int Object
obj (ObjectPtr)
obj_set_light_level
void Object
obj (ObjectPtr)
intensity (1-100)
distance (0 - 8)
obj_type
int Object
obj (ObjectPtr)
obj_unlock
void Object
what (ObjectPtr)
override_map_start
void Map
x (int)
y (int)
elev (0-2)
rot (0-5)
party_add
void Party
who (ObjectPtr)
party_member_obj
ObjectPtr Party
pid (int)
party_member_count
ObjectPtr Party
countHidden (int)

Returns True if a given object (who) is turned on (visible), False

otherwise.
Returns True if a given object (what) is an open object, False if it is
closed or not an openable object.
Returns the subtype of an object of type 'item'. Examples would be food,
armor, weapons, etc.
Attempts to lock a given object (what) if it is of a lockable type.
Returns a string representing the name of the given object (what).
Returns True if a given object (what) is currently being drawn onscreen, False if it is not.
Attempts to open a given object (what) if it is of an openable type.
Returns the prototype id # (pid) of an object (obj).
Set the light level for an object to a given intensity (percentage of
possible maximum intensity), and distance of light in hexes.

Returns the type of an object (obj). This would be Item, Wall,

Scenery, etc.
Attempts to unlock a given object (what) if it is of a lockable type.
Used when loading a new map, this forces the player (obj_dude) to start
at a particular location and rotation when first coming up.

Adds a given critter (who) into the list of party members. This will also
setup those objects so that they will not be saved in maps, and certain
other things.
Returns an ObjectPtr to a party member that matches a given pid. If that
critter isnt currently a member of the party, then it will return NULL.
Returns the count of the currently in-party party members.
(countHidden) determines whether or not to count the hidden members
(hangers-on).
Page 18

party_remove
void Party
who (ObjectPtr)
pickup_obj
void Inven
obj (ObjectPtr)
play_gmovie
Meta
play_sfx
Sound
poison
Critter
who (ObjectPtr)
amount (int)
proto_data
int OR string Object
pid (int)
data_member (int)
radiation_dec
Critter
who (ObjectPtr)
amount (int)
radiation_inc
Critter
who (ObjectPtr)
amount (int)
random
int Script
min (int)
max (int)
reg_anim_animate
void Anim
what (ObjectPtr)
anim (int)
delay (int)
reg_anim_animate_fo
rever
void Anim
what (ObjectPtr)
anim (int)
delay (int)
reg_anim_animate_re
verse
void Anim
what (ObjectPtr)
anim (int)
delay (int)
reg_anim_begin
void Anim

Removes a given critter (who) from the list of party members. This will
also change those objects so that certain object- and map-level things
will respond differently to them.
Causes the critter self-object to animate and attempt to pick up a given
object (obj).
Plays one of the Fallout movies (full-screen, compressed, etc.).
Starts a new sound effect to be played on the queue.
Increases the a critters poison level by a given amount.

Returns the value of a data-member of a given prototype (pid).

Decrements a critters radiation counter by a given amount. NOTE: This

should only be done to the player (obj_dude) in Fallout due to design
restrictions!
Increments a critters radiation counter by a given amount. NOTE: This
should only be done to the player (obj_dude) in Fallout due to design
restrictions!
Returns a random value between (min) and (max), inclusive.

Adds a single, in-place animation on an object (what) to an animation

sequence-list, at a given delay from the previous animation (delay
should always be -1)!
Adds a single, in-place animation on an object (what) to an animation
sequence-list, at a given delay from the previous animation (delay
should always be -1)! This animation will animate continuously until
something in the system interrupts it. To be used *very* sparingly, for
instance Gizmos sign and the pray signs in the children of the
cathedral (which will have to be toned down).
Adds a single, in-place reversed animation on an object (what) to an
animation sequence-list, at a given delay from the previous animation
(delay should always be -1)!

Tells the system to start an animation sequence-list.

Page 19

reg_anim_clear
void Anim
object (ObjectPtr)
reg_anim_end
void Anim
reg_anim_obj_move_t
o_obj
void Anim
who (ObjectPtr)
dest_obj (ObjectPtr)
delay (int)
reg_anim_obj_run_to
_obj
void Anim
who (ObjectPtr)
dest_obj (ObjectPtr)
delay (int)
reg_anim_obj_move_t
o_tile
void Anim
who (ObjectPtr)
dest_tile (int)
delay (int)
reg_anim_obj_run_to
_tile
void Anim
who (ObjectPtr)
dest_tile (int)
delay (int)
reg_anim_play_sfx
void Anim
who (ObjectPtr)
sfx_name (string)
delay (int)
rm_fixed_timer_event
void Meta(Time)
who (ObjectPtr)
fixed_val (int)
rm_obj_from_inven
void Inven
who (ObjectPtr)
obj (ObjectPtr)

Terminates all animations that are currently registered for a given

object.
Activates the animation sequence-list. Without this call the animation
will never occur. Note: All animation sequences must be registered at
ONCE! In other words, you cannot let the script end and finish
registering the animations later.
Adds an animation to cause a critter object (who) to attempt to walk to
another object (dest_obj) at a given delay from the previous animation
(delay should always be -1)!

Adds an animation to cause a critter object (who) to attempt to run to

another object (dest_obj) at a given delay from the previous animation
(delay should always be -1)!

Adds an animation to cause a critter object (who) to attempt to walk to a

given destination tile number (dest_tile) at a given delay from the
previous animation (delay should always be -1)!

Adds an animation to cause a critter object (who) to attempt to run to a

given destination tile number (dest_tile) at a given delay from the
previous animation (delay should always be -1)!

Adds an animation to cause an object (who) to attempt to play a given

sound effect (sfx_name) at a given delay from the previous animation!

Removes (clears) all timer events hooked to a given objects (obj) script
that have a given fixed_value (fixed_val).
Removes an object (obj) from another objects (whos) inventory. Note:
this leaves the removed object in at location (0,1) on the map! You must
call move_to() to place it back on the map.

Page 20

rm_mult_objs_from_i
nven
int Inven
who (ObjectPtr)
obj (ObjectPtr)
count (int)
rm_timer_event
void Meta(Time)
obj (ObjectPtr)
roll_dice
Skill
roll_vs_skill
int (roll_result) Skill
who (ObjectPtr)
skill (int)
modifier (int)
rotation_to_tile
int (15) Map
srcTile (int)
destTile (int)
running_burning_guy
int
scr_return
void Script
script_action
int Script

script_overrides
void Script

self_obj
(ObjectPtr) Script
set_critter_stat
int Critter
who (ObjectPtr)
stat (int)
val (int)

Removes (count) instances of an object (obj) from another objects

(whos) inventory. Note: this leaves the removed object in at location
(0,1) on the map! You must call move_to() to place it back on the
map.
NOTE: This function returns the actual count that was removed (if you
attempted to remove more instances than existed). You *MUST* store
this value in a variable (though you dont have to actually do anything
with it).
Removes (clears) all timer events hooked to a given objects (obj)
script.
Returns the value of the completed dice roll. UNIMPED!
Returns the value of a completed skill roll made upon an objects
(whos) skill level with a given skill, and modified by a given amount
(may be zero). This value may then be passed to is_success and
is_critical to determine the appropriate states, and the how_much call
can be used to determine the difference succeeded or failed by.
Returns the rotation (05) to face a particular tile (destTile) from a
particular tile (srcTile).
Returns the setting for the running-burning-guy in the game (defined in
the options screen).
Sets the return value for a scripts C-engine node, to be used by C code.
Returns the action that has activated this script. Examples include
requests for the description of an object (description_proc), notifications
of a spatial script being activated by something hitting its boundary
(spatial_proc), or a critter being given its heartbeat (critter_proc, in other
words being told to move).
Tells the C-engine that the script will override default behavior for the
object. What this means is that the C-engine will not attempt to do
things that it would normally do, in expectation that the script will
handle those things itself. This is an IMPORTANT command! It is
commonly used for the general player actions upon objects, such as
looking at them (requesting a description), using them (opening doors,
for example), or using items ON them (using a picklock or a key on a
door lock).
Returns a pointer to the object connected to this script.
Sets the value of a desired attribute/stat in a critter (who) to a given
value (val).

Page 21

set_exit_grids
void Map
markElev (elevation)
mapID (int)
elevation (int)
tileNum (int)
rotation (int)
set_global_var
void Map
var_index (unsigned
int)
value (int)
set_light_level
void Map
level (int: 1-100)
set_local_var
void Map
var_index (unsigned
int)
value (int)
set_map_var
void Map
var_index (unsigned
int)
value (int)
set_map_start
void Map
x (int)
y (int)
elev (0-2)
rot (0-5)
set_obj_visibility
void Object
obj (ObjectPtr)
visibility (boolean)
signal_end_game
void
skill_contest
Skill
source_obj
(ObjectPtr) Script
start_dialogue
void Dialog
who (ObjectPtr)
mood (int)

Sets all exit grids on a given elevation (markElev) to point to a

destination mapID (may be -1 which means stay on this map), elevation,
tileNum, and rotation.

Sets the value of a global variable (var_index) to a given (value).

Sets the ambient light level. The range is Full Darkness to Full Daylight.
Sets the value of a local variable (var_index) to a given (value).

Sets the value of a map-global variable (var_index) to a given (value).

Sets the start location & rotation for the next time this map is entered
(loaded & run).

Sets the OBJ_OFF flag for an object (makes it not drawn).

Tells the system that a script is indicating the game should be ended.
This will return the player to the main-menu.
Returns the value of a completed skill vs skill contest (to run through
is_success & is_critical).
Returns a pointer to the source object (activator) for this action. The
source object for a pickup_proc (pickup an object script_action) would
be the critter picking the object up, for instance.
Start the dialogue system focusing on a critter (who) and starting in a
given (mood). This call sets up the appropriate dialog windows, head
art, etc. If this call is not made before the normal dialog calls (sayReply,
sayMessage, sayOption, etc.) then the dialog windows will not come up,
and only grey boxes will appear with the text.

Page 22

start_gialog
void Dialog
msgFileNum (int)
who (ObjectPtr)
mood (int)
headNum (int)
backgroundIdx (int)
target_obj
(ObjectPtr) Script
terminate_combat
void Combat
tile_contains_obj_pid
boolean Map
tile (int)
elev (0-2)
pid (int)
tile_contains_pid_obj
boolean Map
tile (int)
elev (0-2)
pid (int)
tile_distance
int Map
tile1 (int)
tile2 (int)
tile_distance_objs
int Map
obj1 (ObjectPtr)
obj2 (ObjectPtr)
tile_is_visible
boolean Map
tile (int)
tile_num
int Map
obj (ObjectPtr)
tile_num_in_direction
int Map
start_tile (int)
dir (0-5)
distance (int)
town_known
int Meta
townArea (int)
town_map
void

Start the dialogue system focusing on a critter (who) and starting in a

given (mood). This call sets up the appropriate dialog windows, head
art, etc. If this call is not made before the normal dialog calls (sayReply,
sayMessage, sayOption, etc.) then the dialog windows will not come up,
and only grey boxes will appear with the text.
Returns a pointer to the target object for this action. The target object is
what is being acted upon.
Tells the combat system to terminate prematurely. USE WITH
CAUTION. This doesnt prevent another (or even the SAME) script
from re-starting combat, so make sure you turn off any hostile flags, etc.
Returns True if a particular tile contains an object with a matching
prototype index # (obj pid).

Returns a pointer to the first object that matches a particular pid # that is
on a particular tile and elevation.

Returns the tile distance between two tile #'s.

Returns the tile distance between two objects (between their tile #s).

Returns True if a given hex (tile) is currently visible, i.e. an object on it

could conceivably be displayed on-screen. This includes hexes that may
technically have bases that are off-screen, but on whom objects could
exist that would bound into the actual display area.
Returns the tile number of object (obj).
Returns the tile number of a tile offset from a starting tile in a given
direction (the next tile in that direction).

Returns True if a given town area (townArea) is known, False

otherwise.
Sends a request for the game engine to bring up the Town Map screen,
for the player to go to different locations in an area (different areas in
Vault13, for example).

Page 23

use_obj
(ObjectPtr) Script
obj (ObjectPtr)
use_obj_on_obj
(ObjectPtr) Script
item (ObjectPtr)
targetObj (ObjectPtr)
using_skill
boolean Skill
who (ObjectPtr)
skill (int)
violence_level_setting
int (boolean) Meta
wield_obj
void Inven
obj (ObjectPtr)
wield_obj_critter
void Inven
who (ObjectPtr)
obj (ObjectPtr)
wm_area_set_pos
void
areaIdx (int)
xPos (int)
yPos (int)
world_map
void
world_map_x_pos
int
world_map_y_pos
int

Attempt to use an item object on a target object (targetObj). This could

be used to have a critter use a Stimpack on the player, for instance, or to
use a key on a door.
Returns True if an active skill is being used, False otherwise. Examples
of active skills are Stealth and First Aid.
Returns the current setting of the violence level. See define.h for values.
Sets up an animation causing a critter (self_obj) to wield an object (obj)
in that critters inventory. This puts that object in the critters hand.
Sets up an animation causing a critter (who) to wield an object (obj) in
that critters inventory. This puts that object in the critters hand.
Sets the World Map coordinates for a given area/town (areaIdx) to a
given x and y position.

Sends a request for the game engine to bring up the World Map screen,
for the player to move around to different locations.
Returns the current X Position of the party on the World Map.
Returns the current Y Position of the party on the World Map.

Page 24

Script Actions Summary

Description
Combat
Create
Critter
Damage
Destroy
Drop

Object
Critter
Script
Critter
Object
Script
Item

Look At
Map Enter
Map Exit
Map Update

Object
Map
Map
Map

None
Pickup

Script
Item

Spatial
Start
Talk
Timed Event
Use
Use Object On
Use Skill On

Script
Script
Critter
Script
Object
Object
Object

A request to examine (extended-look) an object.

A combat action is occurring.
This script-object is being created. (UNIMPED).
A critter script is getting its heartbeat.
This object is taking damage.
This script-object is being destroyed.
An object is being removed from another objects
inventory and is being dropped on the ground.
(UNIMPED).
A brief look at an object is being requested.
This map is being entered (was just loaded).
This map is being left (is being saved as a savegame).
This map is being updated (changing levels, lighting,
etc.)
No action.
An attempt is being made to pickup an object and
place it in an objects inventory. Or, could be
looting/stealing.
This scripts spatial radius has been entered.
Starting up script for first time.
A script dialogue is being requested.
A timed event has just reached activation.
Attempt to use an object.
Use an object on another object.
Use a skill on an object.

Page 25

Script Action Groups

Object:
Object actions are generic actions that can be done on any game object. For instance, if
something requests to look at an object in the game, this would be valid on any of the normal (noninterface) objects. Individual prototypes of objects determine whether or not that object has certain
actions available to it. So, for example, unless the prototype of the object is set to allow you to USE it,
the player will never be given the option to do so.
Item:
Item actions are actions specific to those objects that the player can pick up, drop, and wear. In
other words, inventory items.
Critter:
Critter actions are called on objects that represent active beings in the game. In a sense, these
actions only occur with intelligent objects, which in nearly all cases are capable of movement and
entering combat, dialog, etc.
Map:
Map actions are specific to special map occurrences, such as when a map is loaded, saved, or
updated. Originally map actions were only available to the map script itself, but it became clear that
they could potentially be needed for any script. They are extremely helpful for setting up variables at
the start of a map. When a map is first entered, the map script gets run first, and then every other
script which is flagged as needing to be called on enter gets called. This can be used to store mapspecific variables in the map script and to export them from there. Then any other scripts that need
to use these variables just need to import them, since they are guaranteed to exist.
Script:
Script actions relate to script-specific calls, such as when a script is being destroyed, activated
by spatial movement, or previously setup timed events. These actions are not directly activated by the
player (unlike object actions), but by the script system itself.

Page 26

Script Action Descriptions

Description:
The player is trying to examine this scripts object. The default behavior is to print the long
description of the object from its prototype in the small display window.
Combat:
Combat is occurring, and one of the combat sub-actions has occurred. These actions allow the
script to react to combat (even though combat attack/etc. choices are actually handled in the engine).
They are:
HIT_SUCCEEDED -- The scripts object successfully hit its target. This can be used to do
extra damage (radiation, for example), or to count the attacks that succeed.
SEQUENCING Combat sequencing is being checked (to see if critters want to enter/exit
combat).
TURN A combat turn is just about to start. You can override the default turn behavior here
to prevent a critter from reacting to combat (or to cause them to do something special).
NONCOM_TURN (UNUSED).
Create:
(UNUSED).
Critter:
The critters heartbeat is occurring. Basically, each script gets hit every so often (should be
several times a second) so that it can react to its environment or to changes in flag variables, etc. This
is where the code can be put to have the critter walk, etc. on its own.
Damage:
Something has occurred to damage this scripts object. This will almost always mean that a
critter has been hit in combat. Here they could set hostile flags (that might affect dialog or quest
statuses later), or they could heal themselves to prevent death (this isnt good practice, but may be
useful in one or two cases where you want to make sure the critter says something, does something,
etc. before they actually die).
Destroy:
This script is being destroyed, and it and all related events (timed events, for instance) are about
to be removed from the system. This most likely means it is either a critter that has just been killed in
combat, or that it is an inventory item that was just used up. Useful things to do when this action is
called are to give the player experience points (for killing creatures or fulfilling quest objectives) and
to update counts, such as the kill-counts (number of critters of a given type killed), or local counts
(how many radscorpions are left in the cave, or how many gang members are left still in town).
Drop:
An inventory item is being dropped from a critters inventory.
Look At:
The player is trying to look at the scripts object. The default behavior is to print the short
description, in other words the prototype name in the small display window.
Map Enter:
Page 27

The map has just been entered, and this script is flagged as needing to be run before the normal
game processing starts up. Here, initialization code can setup variables for the map.
Map Exit:
The map is about to be left. This occurs when the player goes to the town/world maps.
Map Update:
The map is getting a heartbeat to let it update the map. Here ambient light levels can be
changed, such as when it becomes nighttime or the player changes levels to an underground/aboveground area.
None:
Nothing is happening. This should never be called, but is there for the default case.
Pickup:
This procedure means different things for different types of scripts:
Item Scripts A critter is attempting to pickup an inventory item. For containers, however, this
means that a critter is trying to *open* it/loot it.
Critter Scripts A critter is attempting to steal from this scripts critter object.
Spatial:
An object has just moved in this scripts spatial sphere of detection. The script may need to
double-check that this object is of a particular type (a critter, the players object, etc.).
Start:
A script is being run for the very first time.
Talk:
A critter object is starting to talk, either because the player requested it, or because the critters
script requested that it occur. Here the dialog system needs to be setup, and the actual script-language
dialog system calls will be placed.
Timed Event:
A timed-event has just gone off for this script. Usually, this event was setup earlier by this
script itself. It lets the script delay events or in effect give itself a heartbeat.
Use:
Something (usually a critter) is attempting to use this object. The command source_obj will
return who it is. Nearly always this will mean a critter (most likely the player) is attempting to use it,
but occasionally another script will make the call, which can be used to differentiate its behavior. For
instance, this allows the vault door scripts to open the vault door when the player uses the vault door
computer, but not when the player attempts to open the door directly.
Use Object On:
A critter is attempting to use an inventory item on this scripts object. This could be lockpicks
on a door, a medical kit on a critter, the iquana-on-a-stick on a dog, etc.
Use Skill On:
A critter is attempting to use a skill on this scripts object. The default behavior is dependent on
the specific skill itself.
Page 28