Manual PDF

Adventure Creator User Manual
User Manual
v1.38a
Copyright Chris Burton, www.iceboxstudios.co.uk
INTRODUCTION.................................................................................................................... 5
CHAPTER I: THE BASICS
1.0 - SETTIN UP.................................................................................................................... 6
1.1 - PRERE!UISITES........................................................................................................6
1." - RUNNIN THE DEMO AMES.............................................................................. 7
1.3 - THE AD#ENTURE CREATOR $INDO$............................................................. 8
1.% - PREPARIN A 3D SCENE......................................................................................... 10
1.& - PREPARIN A "D SCENE......................................................................................... 12
".0 - INPUT AND NA#IATION............................................................................................14
".1 - O#ER#IE$................................................................................................................. 14
"." - POINT AND C'IC( CONTRO'...............................................................................15
".3 - DIRECT CONTRO'................................................................................................... 16
".% - )IRST-PERSON CONTRO'......................................................................................17
".& - DRA CONTRO'....................................................................................................... 18
".* - STRAIHT-TO-CURSOR CONTRO'.....................................................................19
".+ - U'TIMATE )PS INTERATION............................................................................. 20
".8 - CONTRO''ER SETUP..............................................................................................21
"., - TOUCH-SCREEN INPUT.......................................................................................... 22
".10 - MESH CO''IDER PATH)INDIN....................................................................... 23
".11 - UNIT- NA#IATION PATH)INDIN.................................................................. 24
".1" - PO'-ON CO''IDER PATH)INDIN............................................................... 25
3.0 - CREATIN CHARACTERS..........................................................................................26
3.1 - INTRODUCTION........................................................................................................ 27
3." - THE P'A-ER.............................................................................................................. 28
3.3 - NPCS..............................................................................................................................29
3.% - CHARACTER MO#EMENT.....................................................................................30
3.& - CHARACTER ANIMATION .'EAC-/.................................................................31
3.* - CHARACTER ANIMATION .SPRITES UNIT-/................................................... 33
3.+ - CHARACTER ANIMATION .MECANIM/............................................................. 34
3.8 - CHARACTER ANIMATION .SPRITES "D TOO'(IT/........................................35
3., - CHARACTER ANIMATION .SPRITES UNIT- COMP'E0/.............................. 36
3.10 - HEAD TURNIN.......................................................................................................37
%.0 - CAMERA PERSPECTI#ES........................................................................................... 38
%.1 - INTRODUCTION........................................................................................................ 38
%." - 3D CAMERAS.............................................................................................................. 39
%.3 - ANIMATED CAMERAS............................................................................................. 40
%.% - "D CAMERAS.............................................................................................................. 41
%.& - ".&D CAMERAS........................................................................................................... 42
&.0 - INTERACTIONS............................................................................................................. 43
&.1 - INTRODUCTION........................................................................................................ 43
&." - ACTIONS AND ACTION'ISTS................................................................................ 45
&.3 - HOTSPOTS.................................................................................................................. 51
&.% - CUTSCENES................................................................................................................ 53
&.& - S(IPPIN CUTSCENES............................................................................................54
&.* - TRIERS................................................................................................................... 55
&.+ - CON#ERSATIONS..................................................................................................... 56
&.8 - ACTION'IST ASSETS............................................................................................... 57
&., - ARRO$ PROMPTS....................................................................................................58
&.10 - SOUNDS......................................................................................................................59
&.11 - CONTAINERS............................................................................................................ 60
&.1" - ACTION'IST PARAMETERS................................................................................ 61
&.13 - DRAAB'E OB1ECTS......................................................................................... 62
&.1% - PIC(UP OB1ECTS....................................................................................................63
*.0 - IN#ENTOR-....................................................................................................................64
*.1 - DEC'ARIN IN#ENTOR- ITEMS.........................................................................64
*." - SCENE-INDEPENDENT IN#ENTOR- HAND'IN............................................ 66
*.3 - MANAIN IN#ENTOR- IN-AME.....................................................................67
*.% - CRA)TIN...................................................................................................................68
+.0 - #ARIAB'ES..................................................................................................................... 69
+.1 - DEC'ARIN #ARIAB'ES........................................................................................69
+." - MANAIN #ARIAB'ES IN-AME...................................................................... 70
+.3 - 'IN(IN $ITH P'A-MA(ER #ARIAB'ES....................................................... 71
+.% - 'IN(IN $ITH OPTIONS DATA........................................................................... 72
CHAPTER II: AD#ANCED )EATURES
8.0 - SA#IN AND 'OADIN............................................................................................... 73
8.1 - O#ER#IE$................................................................................................................. 73
8." - SA#IN INDI#IDUA' OB1ECTS............................................................................ 75
8.3 - AUTOSA#IN............................................................................................................. 77
8.% - OPTIONS DATA.......................................................................................................... 78
8.& - HO$ THE DEMO DOES IT...................................................................................... 79
8.* - 'OADIN SCREENS................................................................................................. 80
,.0 - SPEECH MANAEMENT.............................................................................................81
,.1 - AUDIO )I'ES.............................................................................................................. 81
,." - MANAIN TRANS'ATIONS.................................................................................82
10.0 - MENUS............................................................................................................................83
10.1 - O#ER#IE$............................................................................................................... 83
10." - MENU E'EMENTS...................................................................................................86
10.3 - MENU SCRIPTIN...................................................................................................89
10.% - SCENE-BASED MENUS...........................................................................................90
CHAPTER III: E0TENDIN )UNCTIONA'IT-
11.0 - INTERATIN NE$ CODE.......................................................................................87
11.1 - CUSTOM SCRIPTS................................................................................................... 87
11." - CUSTOM ACTIONS..................................................................................................88
11.3 - CUSTOM PATH)INDIN........................................................................................ 89
11.% - CUSTOM ANIMATION ENINE........................................................................... 90
1".0 - HO$ IT $OR(S.......................................................................................................... 91
1".1 - O#ER#IE$............................................................................................................... 91
1"." - MANAERS...............................................................................................................92
1".3 - PATHS......................................................................................................................... 93
1".% - P'A-ER CONTRO'.................................................................................................94
INTRODUCTION
Thank you for purchasing Advenure !reaor" This is a oo#ki for $niy ha provides fu##
funciona#iy of an advenure ga%e engine & navigaion' invenory' characers' conversaions'
cuscenes' saving and #oading and %ore are a## possi(#e )ihou coding. *f you )an o
cuso%ise he inerface or inegrae he ki )ih oher syse%s' you )i## have o dive ino he
fra%e)ork' (u he code is c#ean and inuiive.
Advenure !reaor can (e used o %ake 2+' 2.5+ and 3+ advenure ga%es.
*f you supp#y he graphics and ani%aion' Advenure !reaor can (e o#d )ha o do )ih i. *f
you,re ne) o $niy' i,s advisa(#e ha you ge o grips )ih he (asics of he $niy inerface firs'
since Advenure !reaor is igh#y inegraed ino i. This %anua# assu%es a )orking kno)#edge
of $niy,s inerface and (asic conceps. The $niy )e(sie provides an e-ce##en inroducion o
he inerface a uniy3d.co%.#earn.
/nce you,ve i%pored he Advenure !reaor package' you,## find a ne) opion under $niy,s op
%enu. !hoose A2ven3ure Crea34r 5 E2634rs 5 a7e E2634r o (ring up he %ain inerface
and dock i in a verica# space. 0ou,## need i handy for %uch of your ga%e,s deve#op%en.
T)o de%o ga%es have (een creaed o de%onsrae %any of he ki,s feaures in si%p#e )ays.
They are avai#a(#e o p#ay in a (ro)ser a ice(o-sudios.co.uk.advenure1creaor.de%o and
ice(o-sudios.co.uk.advenure1creaor.2+de%o.
The package inc#udes he fu## source o his de%o ga%e. *,s a good idea o spend so%e i%e
sudying i' as his %anua# %akes a nu%(er of references o i o de%onsrae he various seps o
creaing an advenure ga%e. 2efer o secion 1.2 for insrucions in seing up he de%o.
3hen you are ready o (egin %aking your o)n ga%e' you can use he inc#uded 4e) 5a%e
3i6ard o hand#e he firs seps for you' )hich is found in A2ven3ure Crea34r 5 e336n8
s3ar3e2 5 Ne9 a7e $6:ar2.
This %anua# a#so offers an insigh ino he )ay Advenure !reaor )orks' fro% a coding
perspecive' so ha if you )an o e-end i' you,ve go a head sar.
CHAPTER I: THE BASICS
1.0 - SETTIN UP
1.1 - PRERE!UISITES
Advenure !reaor %akes use of a fe) ags and #ayers ha )i## need o (e defined (efore your
ga%e )i## run proper#y. 7efore you do anyhing e#se' creae he fo##o)ing ags in he Tags
8anager9
a7eEn86ne; Pers6s3en3En86ne' )6rs3Pers4nCa7era' Ba<=8r4un2Ca7era
And he fo##o)ing #ayers' a#so in he Tags 8anager9
NavMes>' Ba<=8r4un2I7a8e
0ou )i## hen need o assign hese )o of hese ags o he appropriae prefa(s. :ro% )ihin he
Asses ; Advenure!reaor su(direcory' ag he #ised prefa(s as fo##o)s9
<refa(s.Auo%aic.5a%e=ngine & Tag as a7eEn86ne
<refa(s.Auo%aic.7ackground!a%era & Tags as Ba<=8r4un2Ca7era
2esources.<ersisen=ngine & Tag as Pers6s3en3En86ne
+e%o.2esources.Tin <o.:irs <erson !a% & Tag as )6rs3Pers4nCa7era
4e-' he *npu 8anager )i## need o (e updaed. 3hich a-es you )i## need o define depend on
)ha conro# %ehod you decide o %ake use of & refer o secion 2.0 for a rundo)n of he
various re>uire%ens. To p#ay he de%o ga%e )ihou errors' you need o define an a-is ca##ed
Menu. This defines )hich key (rings up he in1ga%e pause %enu 1 radiiona##y he =scape key.
The ?ori6ona# and @erica# a-es are a#so re>uired' (u hese are creaed (y defau# (y $niy
)hen saring a ne) $niy proAec.
Advenure !reaor suppors (oh 3+ ani%aion via $niy,s Begacy and 8ecani% syse%s' as
)e## as 2+ ani%aion via eiher 2+ Too#ki or $niy,s o)n 2+ fra%e)ork. :or 2+ Too#ki
suppor' a preprocessor define %us (e se 1 refer o secion 3.6 on ho) o do his.
*,s a#so i%poran o keep o(Aecs on he correc #ayer. 8os o(Aecs' un#ess saed oher)ise'
shou#d (e %oved o he I8n4re Ra?<as3 #ayer' especia##y if you inend o %ake a <oin and
!#ick1sy#e ga%e' as you don, )an scene geo%ery o inerfere )ih your inerface.
0ou )i## a#so need a 2eferences fi#e and %anager asses. These asses are specific o your ga%e.
The defau# %anagers refer o he de%o ga%e,s se' so in order o creae your o)n ga%e' you )i##
a#so have o creae your o)n se of %anagers. 2efer o secion 1.3 for %ore on %anagers.
1." - RUNNIN THE DEMO AMES
Advenure !reaor co%es )ih )o si%p#e de%o ga%es & a 3+ ga%e and a 2+ ga%e & ha sho)
off he (asic )orkf#o) invo#ved.
=ach de%o ga%e has i,s o)n se of 8anagers Csee secion 1.3D' )hich %us (e #oaded ino he
syse% (efore he ga%e can (e p#ayed. 0ou can #oad hese 8anagers easi#y (y going o
A2ven3ure Crea34r 5 e336n8 s3ar3e2 fro% he op oo#(ar' and se#ecing he de%o ga%e you
)an o se up.
/nce he correc 8anagers are #oaded in' i is hen safe o #oad ha de%o,s scene fi#e. The
scenes for he 3+ and 2+ +e%o ga%es are found in Asse3s 5 A2ven3ureCrea34r 5 De74 5
S<enes' and Asse3s 5 A2ven3ureCrea34r 5 "DDe74 5 S<enes respecive#y.
*f you have no %ade any changes o Advenure !reaor since insa##ing i' refer o he previous
secion and assign he ags' #ayers and inpu a-es as descri(ed.
*f you pro(#e%s running he de%o ga%es' check ha he %ain Advenure !reaor )indo) is
referring o he correc %anagers. 2efer o secion 1.3 for deai#s on ho) o do his.
To keep hings sraighfor)ard' (oh de%os are designed o (e p#ayed using he <oin And !#ick
%ove%en %ehod' (u i can (e updaed easi#y if you )an o p#ay i in +irec Ccursor key1
drivenD or :irs <erson %ehods C3+ +e%o on#yD. 0ou can change he ga%e,s %ove%en %ehod
easi#y enough )ihin he Eeings 8anager' hough you )i## need o do a (i %ore o %ake he
scene re#ease1ready. 2efer o secion 2.0 for a rundo)n on )ha you,## need o do.
1.3 - THE AD#ENTURE CREATOR $INDO$
Advenure !reaor %akes use of eigh F%anagersG ha each sore daa for a differen aspec.
These %anagers are creaed and accessed )ihin he %ain Advenure !reaor )indo)
CA2ven3ure Crea34r 5 a7e e2634r in he op oo#(arD. They are re>uired o proper#y run a
ga%e %ade )ih Advenure !reaor. 0ou can a( (e)een each %anager fro% he op of he
)indo). The fo##o)ing is a #is of )ha each %anager provides conro# over9
S<ene 7ana8er & ?and#es scene1specific seings' such as he p#ayer,s defau# posiion'
and a#so provides an edior for hand#ing and creaing prefa(s' #ike ?ospos and 8arkers.
Se336n8s 7ana8er & ?and#es proAec1)ide seings' such as he p#ayer,s prefa(' he ga%e,s
conro# sy#e' and cursor seings.
A<364ns 7ana8er @ +efines he #is of acions avai#a(#e o cuscenes and ineracions.
#ar6aAles 7ana8er @ 8anages a #is of user1defined inegers and (oo#eans ha can (e
used for ga%e #ogic hroughou he proAec.
Inven34r? 7ana8er @ 8anages a #is of ie%s ha he p#ayer can pick up' as )e## as he
responses for invenory ineracions.
SBee<> 7ana8er @ Biss he spoken #ines )rien in he ga%e' assigning each one a
uni>ue *+ for audio fi#es' and %anages su(i#e rans#aions.
Curs4r 7ana8er & 8anages cursor seings' and he avai#a(#e icons )hen ineracing
)ih o(Aecs and 4<!s.
Menu 7ana8er & <rovides a visua# edior for %anaging %enus' )ih opions for (oh
heir disp#ay and funciona#iy.
=ach %anager is a separae asse fi#e. 7y defau#' a se of Fde%oG %anagers are referred o (y
he %ain Advenure !reaor )indo)' as hese conain invenory ie%s' varia(#es and oher daa
re>uired (y he de%o.
To %ake a ne) ga%e' you can use he inc#uded 4e) 5a%e 3i6ard o creae a ne) se of
%anagers and >uick#y define your ga%e,s %ain seings. 0ou can (ring up he )i6ard fro%
$6n249 5 A2ven3ure Crea34r 5 Ne9 a7e $6:ar2.
A#ernaive#y' you can %anua##y creae and assign your %anager fi#es. =ach %anager asse is
referenced a he op of i,s respecive a( in he %ain Advenure !reaor. *f you re%ove he
reference C(y se#ecing he reference fie#d and pressing (ackspaceD' you )i## (e asked o creae a
ne) %anager asse.
!#ick he F!reae ne)G (uon' and Advenure !reaor )i## creae & and auo%aica##y reference
& a ne) %anager asse. * )i## ae%p o creae his asse fi#e inside Asse3s 5
A2ven3ureCrea34r 5 Mana8ers' so ensure ha his direcory e-iss. 4oe ha in order o run
he de%o' you %us firs s)ich each %anager reference (ack o i,s F+e%oG counerpar.
3hi#e you fa%i#iarise yourse#f )ih Advenure !reaor' i %ay (e he#pfu# o re#y on so%e of he
+e%o %anagers as you (ui#d your ga%e & paricu#ar#y he 8enu' Acions and !ursor 8anagers.
The %ain Advenure !reaor )indo) sores i,s #inks o hese %anager asse fi#es inside a fi#e
ca##ed ReCeren<es. This fi#e 8$ET (e p#aced in a fo#der ca##ed Res4ur<es in order o )ork
proper#y. *f such a fi#e is no presen' you )i## receive a pro%p o auo%aica##y creae one )hen
you ca## up he %ain Advenure !reaor )indo). Advenure !reaor )i## ae%p o creae he
fi#e inside Asses ; Advenure!reaor ; 2esources' so ensure ha his direcory e-iss.
1.% - PREPARIN A 3D SCENE
3ih he %angers defined Csee secion 1.3D' open he Advenure !reaor )indo) and c#ick on he
Eeings a(' and se your Ca7era BersBe<36ve Cfound underneah Ca7era se336n8sD o 3D.
Then change o he S<ene a(' fro% )here you can creae he 5a%e/(Aecs needed for an
advenure ga%e.
3ih a ne) scene' c#ick Or8an6se r447 4ADe<3s. Advenure !reaor )i## p#ace he re>uired
prefa(s ino he scene,s hierarchy. The essenia# o(Aecs are 5a%e=ngine' <#ayerEar' and
8ain!a%era' (u a nu%(er of fo#ders Cidenified )ih underscoresD )i## a#so (e creaed o he#p
keep hings organised. These fo#ders are no necessary' (u are he#pfu#. As you use he Ecene
8anager o creae ?ospos' !onversaions and oher Advenure !reaor prefa(s' i )i## p#ace
he% ino he re#evan fo#ders auo%aica##y.
0ou )i## noice a (#ue arro) has appeared a he cenre of he scene. This is our <#ayerEar
o(Aec' )hich %arks he defau# posiion and roaion of our p#ayer )hen he scene (egins. This
is our defau# <#ayerEar (ecause i has (een se auo%aica##y (y he Ecene 8anager'
underneah S<ene Se336n8s. 3e can have %u#ip#e <#ayerEar o(Aecs in a scene' so ha he
p#ayer can (egin a differen poins depending on )hich scene hey Aus ca%e fro%. The
Prev64us S<ene varia(#e in he <#ayerEar,s inspecor dicaes )hich scene he p#ayer %us have
rave##ed fro% for his <#ayerEar o (e used. *f no appropriae o(Aec is found' or if he ga%e is
sared fro% his scene' he defau# )i## (e used insead.
3e )i## )an o (ui#d he se ha )i## for% he (ackdrop o our scene. The ESe3e47e3r?
fo#der is he inended p#ace for i. 7e sure o %ove his geo%ery ono he I8n4re Ra?<as3 #ayer'
o avoid un)aned inerference )ih he inerface & he ga%e FdiscoversG hospos and oher
ineracive o(Aecs (y seeking ou o(Aecs on he DeCaul3 #ayer.
3ih he se in p#ace' )e no) need o define he space ha he p#ayer can %ove around. =ven in
a <oin And !#ick1sy#e ga%e' )e need o p#ace a f#oor do)n o sop he p#ayer fro% fa##ing
hrough he scene. !#ick C4ll6s64nCuAe' and a (#ue cu(e )i## (e creaed in he scene.
8anipu#ae he cu(e,s ransfor%s so ha he op face covers he se,s f#oor. * can e-end (eyond
he f#oor in he H and I direcions & his o(Aec is pure#y a F(arrierG o preven he p#ayer fro%
fa##ing.
4o) )e )i## )an a 4avigaion 8esh' or 4av8esh. 4av8eshes are 3+ geo%ery ha dicae
)here he p#ayer can navigae o inside he se. 0ou can eiher supp#y a cuso% %esh %ade
inside a separae 3+ app#icaion' or use $niy,s 4avigaion oo#s o (ake a 4av8esh direc#y
inside your scene. 2efer o secions 2.10 o 2.12 for %ore on (oh ypes of 4av8esh creaion.
*f )e )an o p#ay a cuscene or run so%e kind of #ogic )hen he scene (egins' )e creae a
!uscene prefa( and refer o i in he Cu3s<ene 4n s3ar3 fie#d' Aus under he +efau# 4av8esh
fie#d. Eee secion 5.4 for %ore on !uscenes.
3e a#so need o define our iniia# ca%era' or 5a%e!a%era. 5a%e!a%eras are separae fro% our
8ain!a%era' in ha hey dicae he avai#a(#e posiions ha our 8ain!a%era can ake. /n#y he
8ain!a%era is acive hroughou he scene' (u i )i## copy i,s associaed 5a%e!a%era,s
posiion' roaion and fie#d of vie). !hoose a7eCa7era in he Ecene 8anager and hen A22
ne9' and posiion he ne)#y1creaed ca%era o a poin you,re happy )ih. 4e-' find your
defau# <#ayerEar o(Aec 1 you can do so >uick#y (y c#icking on he DeCaul3 Pla?erS3ar3 fie#d o
high#igh i. *n he <#ayerEar inspecor' c#ick he Ca7era On S3ar3 fie#d and se#ec your ne)
5a%e!a%era. 3hen he scene (egins' he p#ayer )i## appear a his <#ayerEar' and he
8ain!a%era )i## appear a his 5a%e!a%era.
3hen %aking a 3+ scene' )e a#so have he opion of using a radiiona# hird1person ca%era'
)hich fo##o)s and roaes around he <#ayer dyna%ica##y. :ro% he Ecene 8anager' c#ick
a7eCa7eraT>6r2Pers4n' fo##o)ed (y A22 ne9' o creae one and se i up in he *nspecor.
7ased on your seings' addiiona# inpu a-es %ay (e re>uired & hese )i## (e #ised in he
*nspecor for you.
Bas#y' )e need o define our p#ayer prefa(' and se our conro# opions. 0ou can define hese
hings in he Eeings 8anager. !#ick he Se336n8s a( and change he opions o your #iking. :or
deai#s on ho) o se up a <#ayer prefa(' see secions 3.0. +o no p#ace he <#ayer prefa( ino he
scene & Advenure !reaor )i## do his for you )hen he ga%e sars.
1.& - PREPARIN A "D SCENE
This secion on#y dea#s )ih he )orkf#o) specific o a ga%e in 2+' so (e sure o read he
previous secion (eforehand & even if you are no %aking a 3+ ga%e.
To (egin %aking a 2+ ga%e' firs go o he Eeings 8anager and se he Ca7era BersBe<36ve o
"D. A ne) pop1up )i## appear ca##ed M4v6n8 an2 Turn6n8. This fie#d deer%ines ho) he
ca%eras' spries' ?ospos and 4avigaion 8eshes re#ae o one anoher' and is very i%poran. *
can ake he fo##o)ing va#ues9
Un63? "D & The ga%e is p#ayed in $niy,s o)n F2+G vie) )ih orhographic ca%eras' and
!haracers %ove pure#y in he H.0 p#ane & and sca#ed auo%aica##y o creae a deph effec. The
ga%e %akes use of 2+ physics co%ponens #ike 7o-2+ and <o#ygon !o##iders' raher han heir
3+ e>uiva#ens. The designer can %ake use of <o#ygon !o##ider pahfinding.
T4B D49n & The ga%e is p#ayed in he H.I p#ane' and he ca%era #ooks do)n Ffro% a(oveG.
!haracers %ove pure#y in he H.I p#ane & and sca#ed auo%aica##y o creae a deph effec. 3+
physics co%ponens are re>uired' (u he designer can %ake use of $niy,s (ui#1in 4avigaion
pahfinding.
$4rl2 SBa<e & The ga%e is p#ayed )ih perspecive ca%eras' )ih he %ain F(ackground sprieG
(ehind a## !haracers. !haracers %ove in 3+ space' )ih no need for FcheaingG a deph effec.
'4<al SBa<e & Ei%i#ar o 3or#d Epace' on#y !haracers )i## %ove and urn according o a
8arker,s posiion on1screen' raher han i,s posiion in 3+ space.
The defau# seing of his fie#d is Un63? "D' )hich %eans you )ork )ih $niy,s o)n F2+G vie)
in he H and 0 co1ordinaes' and his is he reco%%ended )ay of )orking.
Advenure !reaor,s 2+ scene Cfound in Asse3s 5 A2ven3ureCrea34r 5 "D De74 5 S<enes
5 Par=D re#ies on a $niy 2+ )orkf#o).
*n (oh $niy 2+ and Top +o)n %odes' !haracers do no %ove c#oser o or furher a)ay fro%
he ca%era. To creae a sense of deph' and o posiion !haracers in fron of and (ehind scene
o(Aecs appropriae#y' a S4r36n8 MaB is used o dra) o(Aecs in he correc order' regard#ess of
heir disance fro% he ca%era. A Eoring 8ap can cause !haracers o shrink )hen %oving
up)ards Cin screen1spaceD' and (e disp#ayed (ehind o(Aecs (eneah he%.
A Eoring 8ap auo%aes he soring order of any 5a%e/(Aec,s 2enderer co%ponen )hen he
)4ll49S4r36n8MaB scrip is aached o i. !heck he 2+ +e%o scene o see his in acion & he
Ecene Eeings C)ihin he Ecene 8anagerD has a Eoring8ap o(Aec defined' and his o(Aec
C)hich can a#so (e creaed fro% he 4avigaion pane# (e#o)D defines ho) posiion affecs a
2enderer,s soring. This paricu#ar soring %ap is se o affec a sprie,s Or2er 6n la?er' (u i
cou#d (e used o affec S4r36n8 la?er insead. :or he <#ayer !haracer o hen (e affeced (y he
soring %ap' he :o##o)Eoring8ap co%ponen is added o he <#ayer prefa(,s Eprie !hi#d
Cfound )ihin Asse3s 5 A2ven3ureCrea34r 5 "D De74 5 Res4ur<es 5 Bra6n"D 5 SBr63eD.
A Eoring 8ap can a#so (e used o adAus a !haracer sprie,s sca#e and %ove%en' (y checking
he appropriae (o-es in i,s *nspecor. :or s%ooh sca#ing' you can si%p#y se he sar and end
sca#es' and c#ick In3erB4la3e 6n-Ae39een s<ales o auo%aica##y se he iner%ediae sca#es
according o heir re#aive posiion.
Eince $niy 2+ and Top +o)n %odes effecive#y FfakeG perspecive his )ay' you %ay )ish for
your !haracers o %ove verica##y %ore s#o)#y han hori6ona##y Cin screen1spaceD. 3ihin he
Eeings 8anager' you can adAus he #er36<al 74ve7en3 Ca<34r s#ider o do Aus his.
0our choice of 8oving And Turning )i## affec )hich pahfinding %ehods are avai#a(#e o you.
$niy 2+ can %ake use of 8esh !o##ider and <o#ygon !o##ider' )hi#e he ohers can %ake use of
8esh !o##ider and $niy 4avigaion. The 2+ +e%o,s <ark scene %akes use of <o#ygon
!o##ider1(ased pahfinding' )hich a##o)s you o define an ar(irary shape using he <o#ygon
!o##ider 2+ co%ponen. 0ou can #earn %ore a(ou %anipu#aing <o#ygon !o##iders on he $niy
)e(sie here.
3hi#e $niy 2+ and Top +o)n fake perspecive' you can a#so op o have your !haracers %ove
in 3+ space insead' Aus as hey )ou#d in a regu#ard 3+ scene' )ih 3or#d Epace and Ecreen
Epace.
*n (oh of hese %odes' he ca%era assu%es ha i is )orking in he H.0 p#ane Che sa%e ha he
Ecene )indo),s F2+G (uon s)iches oD. !haracers do no share he sa%e deph as he
geo%ery' (u insead %ove around he scene in 3+ space. :or his reason' 4av8eshes %us a#so
(e #aid ou in 3+ space.
As )ih a regu#ar 3+ scene' 3or#d Epace %ode causes !haracers o refer o he e-ac 3+
posiion of 8arkers and ?ospos )hen %oving and urning. Ecreen Epace %ode' ho)ever'
causes !haracers o refer o heir posiion on1screen insead. :or e-a%p#e' if a ?ospo is c#oser
o he ca%era han he <#ayer' (u raised such ha i is verica##y a(ove he <#ayer on1screen' he
p#ayer )i## #ook F(ehindG hi%se#f )hen se o urn o)ards i. And )hen he <#ayer is o#d o
)a#k o a 8arker' he )i## insead #ook o he 8arker,s appraran posiion on he 4av8esh as
FseenG (y he ca%era. This a##o)s you o give a## ?ospos and 8arkers he sa%e 61deph as he
se geo%ery' a##o)ing you o )ork a#%os enire#y in he 2+ vie) once a 4av8esh has (een se
up. 4oe ha <#ayerEar o(Aecs and 8arkers used o e#epor !haracers %us si## (e p#aced in
he correc posiion in 3+ space.
".0 - INPUT AND NA#IATION
".1 - O#ER#IE$
Advenure !reaor co%es )ih four avai#a(#e %ove%en %ehods9 <oin And !#ick' +irec' :irs
<erson' and +rag. 0ou can choose (e)een he% in he Eeings 8anager. 4oe ha he
%ove%en %ehod on#y affecs ho) he p#ayer can navigae he scene & ineracing )ih hospos
and characers is si## dependen on your ga%e,s *neracion %ehod & see secion 5.1.
Three inpu %ehods are a#so avai#a(#e9 8ouse And Jey(oard' Jey(oard /r !onro##er' and
Touch Ecreen. The a-es ha you %us define in he *npu 8anager are very specific. The
fo##o)ing secions deai# )hich a-es are needed for each seing. Addiiona##y' he Eeings
8anager )i## #is your ga%e,s re>uired *npu A-es (ased on he seings chosen.
<ahfinding is an essenia# par of any advenure ga%e. 3hen he <#ayer characer %oves around
a scene during a <oin And !#ick ga%e' or )hen characers are %oving as par of a !uscene'
pahfinding a#gorih%s are used o deer%ine a pah fro% one poin o anoher. Advenure
!reaor provides )o %ehods of pahfinding9 Un63? Nav68a364n' and Mes> C4ll62er. The
pahfinding %ehod can (e se on a per1scene (asis )ihin he Ecene 8anager' under he Ecene
Eeings pane#. These %ehods are e-p#ained in secions 2.10 o 2.12.
"." - POINT AND C'IC( CONTRO'
<oin And !#ick conro# is he defau# %ove%en %ehod. 8os advenure ga%es' #ike 8onkey
*s#and and The Bonges Kourney are conro##ed in his )ay. *f you #ef1c#ick your cursor in he
scene (u no over an ineracive o(Aec' he p#ayer )i## %ake heir )ay here. +ou(#e1c#icking
)i## %ake he p#ayer run' if hey are a(#e o.
To %ake a radiiona# %ouse1driven poin and c#ick ga%e' you do no need o define any a-es
(eyond he 8enu key descri(ed in secion 1.1.
This sy#e %akes heavy use of pahfinding o %ove he p#ayer around he scene' so i,s essenia#
ha your <#ayer prefa( has he Pa3>s co%ponen aached. 0ou )i## need o define a 4av8esh
for every scene & see secions 2.10 o 2.12 for %ore infor%aion.
0ou )i## a#so need o creae a #eas one C4ll6s64nCuAe in every scene o ac as a f#oor Csee
secion 1.4D.
0ou can opiona##y supp#y a F!#ick %arkerG prefa( via he Eeings 8anager' )hich appears in
he scene )hen you c#ick' a he p#ayer characer,s inended desinaion. The de%o ga%e %akes
use of he defau# !#ick8arker prefa(' found in Advenure!reaor ; <refa(s ; 4avigaion.
".3 - DIRECT CONTRO'
+irec conro# a##o)s you o conro# he p#ayer,s %ove%en direc#y' )ih eiher he key(oard or a
conro##er. Te##a#e,s The 3a#king +ead is a recen e-a%p#e of a ga%e ha e%p#oys his
%ove%en %ehod.
:or non1Touch Ecreen inpu' he H4r6:4n3al' #er36<al and Run a-es %us (e defined in he *npu
8anager for +irec conro# o )ork. T488leRun and 1u7B are a#so va#id' hough Ku%p is on#y
avai#a(#e for 3+ !haracers. $niy shou#d have a#ready defined he firs )o (y defau# upon
saring a ne) proAec. *f no' refer o $niy,s docu%enaion on ho) o se he% up. The 2un
a-is shou#d (e a keysroke' such as #ef shif' ha you can ho#d do)n o %ake he p#ayer run.
A#so for non1Touch Ecreen inpu' you can choose if %ove%en keys direc he p#ayer re#aive o
he ca%era' or re#aive o he characer Ca#so kno)n as FTank conro#sGD.
:or Touch Ecreen inpu' +irec conro# )orks (y ouching on he screen and dragging )ihou
#eing go' si%i#ar o ho) Te##a#e,s Ta#es /f 8onkey *s#and p#ays. The drag disances re>uired o
%ake he <#ayer characer )a#k and run can (e se in he Eeing 8anager.
3hen creaing ineracions and %oving he p#ayer in cuscenes' you )i## pro(a(#y need o %ake
use of pahfinding' even if you are no %aking a <oin And !#ick ga%e' so fo##o) he sa%e seps
o creae a 4av8esh' assign a <ahs co%ponen o he <#ayer prefa(' and add a !o##ision!u(e
f#oor as ou#ined in he previous secion.
3hen under +irec conro#' he p#ayer does no ake noice of he 4av8esh. *nsead' he p#ayer
is (ounded (y C4ll6s64nCuAe and C4ll6s64nC?l6n2er o(Aecs' )hich ac as invisi(#e )a##s o
preven he p#ayer fro% c#ipping hrough he se. $se he Ecene 8anager o popu#ae he scene
)ih hese co##iders. To avoid c#uer' you can a#so use he Ecene 8anager o hide hese o(Aecs
once you,ve finished p#acing he%. !#ick OCC ne- o !o##ision under he @isi(i#iy secion o
hide he%. The sa%e can (e done )ih ?ospo and Trigger o(Aecs.
Try adding !o##ision!u(es o he de%o scene in such a )ay ha hey cover he )a##s and props'
and s)ich he %ove%en %ehod o +irec. 3ihou he co##ision o(Aecs' he p#ayer )i## si## (e
conro##ed (y he hori6ona# and verica# keys' (u )i## c#ip hrough he se geo%ery.
".% - )IRST-PERSON CONTRO'
:irs1<erson conro# #es you navigae your ga%e fro% he p#ayer characer,s poin of vie).
Technica##y' i is an e-ension of direc conro#' %eaning you shou#d firs fo##o) he seps
e-p#ained in he previous secion & i re>uires H4r6:4n3al' #er36<al and Run a-es o (e defined
Cif non1Touch Ecreen inpuD' !o##ision!u(e o(Aecs o (e p#aced in he scene' and & opiona##y & a
4av8esh o (e creaed' if you )ish o conro# p#ayer %ove%en during !uscenes. T488leRun
and 1u7B are a#so va#id a-es.
*f you are no using Touch Ecreen as your inpu' you a#so need o define a T488leCurs4r a-is.
This (uon )i## #e you ogg#e (e)een using he cursor o %ove around he screen' and using i
o urn he <#ayer characer,s head.
Touch Ecreen inpu )orks )ih :irs <erson conro# in he sa%e )ay as +irec conro#. The drag
disances re>uired o %ake he <#ayer characer )a#k and run can (e se in he Eeing 8anager.
0ou can a#so se ouch1dragging o affec Aus he <#ayer,s direcion' raher han posiion' in he
M4ve7en3 se336n8s pane#. ?ere' you can a#so conro# he Au%p speed.
T)o addiiona# a-es need o (e defined in your *npu 8anager9 Curs4rH4r6:4n3al and
Curs4r#er36<al. Ee he A-is fie#ds o 0 aF6s and - aF6s respecive#y' and (oh Types o M4use
M4ve7en3. 0ou )i## need o p#ay )ih he nu%erica# seings o discover )ha )orks (es for
you' (u a +ead seing of 0.001 and Eensiiviy of 0.02 have (een found o give good resu#s.
This %ove%en %ehod %akes use of (oh key(oard and %ouse & he %ouse is used o urn he
characer as )e## as #ook up and do)n' )hi#e he key(oard is used o %ove for)ard' (ack)ard
and side)ays.
A ca%era ha acs as he p#ayer,s poin of vie) %us a#so (e creaed. This %us (e a chi#d o(Aec
of he <#ayer prefa(. +rag your <#ayer prefa( ino a scene' aach a regu#ar ca%era as a chi#d
C5a%e/(Aec ; !reae /her ; !a%eraD and posiion i inside' or Aus in fron of' he p#ayer,s
head. Add a )6rs3 Pers4n Ca7era scrip' and ag he o(Aec as )6rs3Pers4nCa7era. This
ca%era )i## (e no) used during nor%a# ga%ep#ay. $pdae he prefa( Cc#ick App#y in he <refa(
seingsD' and re%ove he <#ayer fro% he scene.
The )6rs3 Pers4n Ca7era inspecor gives various opions' a##o)ing for head1(o((ing )hen
%oving' and he a(i#iy o 6oo% in and ou using he %ouse )hee#. 4oe ha for he #aer
feaure' he M4use S<r4ll$>eel a-is %us (e defined in he *npu 8anager. This a-is re>uires
va#ues of 1000' 0' 0.1 for 5raviy' +ead and Eensiiviy respecive#y' a Type of 8ouse
8ove%en' and he A-is se o 3rd.
The de%o,s p#ayer prefa(' Tin <o' co%es )ih such a ca%era a#ready aached. 4avigae o
Asses ; Advenure!reaor ; +e%o ; 2esources ; Tin <o in your <roAec )indo) o see i.
".& - DRA CONTRO'
+rag conro# acs %uch #ike +irec conro# )hen Touch Ecreen is used as an inpu' on#y i is
(eer e>uipped for %ouse and key(oard inpu. *n his %ode' he p#ayer can navigae a scene (y
c#icking and dragging )hi#e ho#ding he %ouse or (uon do)n. The drag disances re>uired o
%ake he <#ayer characer )a#k and run can (e se in he Eeing 8anager.
".* @ STRAIHT-TO-CURSOR CONTRO'
Eraigh To !ursor conro# causes he <#ayer o %ove o)ards he cursor )henever he %ouse
(uon Cor ap' for Touch EcreensD is he#d do)n.
:ro% he M4ve7en3 se336n8s in he Eeings 8anager' you can deer%ine ho) far a)ay he
<#ayer %us (e o sar running' and ho) c#ose#y he <#ayer )i## fo##o) he cursor 1 use higher
va#ues if he <#ayer sars circ#ing he cursor coninuous#y.
0ou can a#so deer%ine )heher or no a sing#e1c#ick )i## cause he <#ayer o %ove & %uch #ike
regu#ar <oin And !#ick %ove%en.
4oe' ho)ever' ha his %ode does no use pahfinding 1 he <#ayer )i## on#y ever %ove in a
sraigh #ine. Therefore' un#ess you )an pahfinding in !uscenes or for 4<!s' you do no need
o se up a 4avigaion %ehod for your scenes. 0ou si%p#y need !o##ider ha is a(#e o LreceiveL
he %ouse c#icks . (uon presses. A C4ll6s64n CuAe' ha %arks ou he f#oor and p#aced on he
+efau# #ayer' )i## suffice.
*f you re>uire he <#ayer o pahfind heir )ay o he cursor' use <oin And !#ick %ove%en
insead.
".+ - U'TIMATE )PS INTERATION
Advenure !reaor can %ake use of he $#i%ae :<E asse' )hich is a separae package avai#a(#e
on he $niy Asse Eore' and a popu#ar choice for hose %aking :irs <erson ga%es.
3hen you se your 8ove%en %ehod o $#i%ae :<E' you )i## (e pro%ped o add he
Ul367a3e)PSIsPresen3 scriping define sy%(o# o your ga%e,s <#ayer Eeings. 0ou can find
his fie#d fro% =di ; <roAec Eeings ; <#ayer.
/nce done' you can go a(ou creaing a <#ayer prefa( ha %akes use of he $#i%ae :<E asse.
3hi#e si%p#e' he seps invo#ved are >uie paricu#ar. This uoria# on#ine gives fu## insrucions.
".8 - (E-BOARD AND CONTRO''ER SETUP
A## four %ove%en %ehods can (e used )ih eiher a key(oard or a conro##er. =ach re>uires a
Menu (uon' and H4r6:4n3al and #er36<al a-es. To p#ay your ga%e using an H7o- conro##er'
se he 8enu (uon o D4?s36<= Au334n ,' and he ?ori6ona# and @erica# A-es o 0 aF6s and -
aF6s respecive#y' and heir Type o 14?s36<= AF6s. To a##o) for :irs <erson ogg#ing (e)een
cursor %odes' dec#are an a-is ca##ed T488leCurs4r Cas e-p#ained in 2.4D' and se i,s <osiive
(uon o D4?s36<= Au334n 1,.
0ou a#so need o define your cursor inpu. !reae )o %ore a-es ca##ed Curs4rH4r6:4n3al and
Curs4r#er36<al' seing he A-is o 3
r2
aF6s and %
3>
aF6s' and (oh Types o 14?s36<= AF6s.
:ina##y' you need o define your A and 7 (uons & he conro##er e>uiva#en of a %ouse,s #ef and
righ c#icks. !reae )o (uons9 In3era<364nEA and In3era<364nEB' se he <osiive 7uons o
D4?s36<= Au334n 1* and D4?s36<= Au334n 1+ Cfor an H7o- conro##erD' and he Types o (e? 4r
M4use Bu334n.
To p#ay your ga%e )ih a key(oard' define a## of he a(ove inpu a-es' (u se he ype of each o
(e? 4r M4use Bu334n' and he posiive and negaive (uons o your desired %apping.
"., - TOUCH-SCREEN INPUT
Advenure !reaor can (e used o %ake ga%es for i/E and Android p#afor%s' using a## four
%ove%en %ehods. 7y defau#' ineracing )ih ?ospos in Touch Ecreen %ode is a )o1sep
process9 ouching a ?ospo once )i## high#igh i' and ouching i again )i## inerac )ih i.
Touching a)ay fro% a high#ighed ?ospo )i## de1se#ec i. 0ou can disa(#e his feaure' and
rever (ack o one1ouch ineracions' fro% he T4u<> S<reen se336n8s secion of he Eeings
8anager.
*n !one- Eensiive ineracion %ode' o(Aecs are e-a%ining (y p#acing a second finger do)n on
he screen )hi#e he firs finger is si## ouching. 0ou can si%u#ae his effec in he $niy =dior
(y righ1c#icking on a ?ospo )hi#e he #ef %ouse (uon is he#d do)n.
7y defau#' he cursor posiion )i## a#)ays (e sa%e as he ouch posiion Cor firs ouch posiion'
if %u#ip#e ouches are %adeD. /piona##y' he cursor can (e dragged insead (y dragging )ih a
finger & i,s posiion )i## re%ain re#aive o he ouch posiion insead. To ena(#e his feaure'
check he Dra8 <urs4r 963> 34u<>G (o- )ihin he Eeings 8anager.
".10 - MESH CO''IDER PATH)INDIN
8esh !o##ider1(ased pahfinding is he defau# pahfinding %ehod' and invo#ves creaing cuso%
3+ %eshes o %ark ou he area over )hich characers can )a#k. 7ecause of he need for %esh
creaion' i is harder o se up han he $niy 4avigaion %ehod Ce-p#ained in he ne- secionD'
(u is dyna%ic & differen 4av8eshes can (e s)apped ou )hen he #ayou of he scene changes.
/nce he Pa3>C6n26n8 7e3>42 fie#d in he Ecene 8anager has (een se o Mes> C4ll62er' he
4avigaion pane# )i## a##o) you o creae a NavMes> prefa(.
3heher you have %u#ip#e 4av8eshes in your scene or Aus one' you %us a#)ays dec#are he
defau# inside he S<ene Mana8er Che firs a( in he %ain Advenure !reaor )indo)D. +oing
so )i## ensure your acive 4av8esh is on he correc #ayer' kno)n as F4av8eshG. 4oe ha
4avigaion 8eshes %ay no )ork if heir 5a%e/(Aec is se o a non16ero roaion.
0ou %us hen assign a %esh o he 4av8esh prefa( (y assigning a cuso% %esh o he 8esh
!o##ider co%ponen,s 8esh fie#d.
Euch a %esh is an invisi(#e %esh ha' #ooking op1do)n over he scene' %arks ou he f#oor
space ha can (e )a#ked on. * need no sick rigid#y o he f#oor in he 01a-is' (u i,s
reco%%ended o keep i c#ose. *,s a#so reco%%ended o reduce he %esh,s vere- coun o i,s
(are %ini%u%' since Advenure !reaor,s pahfinding a#gorih% refers o hese verices )hen
ca#cu#aing a pah.
3hi#e his a#gorih% does ake oher o(Aecs' such as !o##ision!u(es' ino accoun )hen
ca#cu#aing a pah' i %ay occasiona##y give une-peced resu#s' so i,s (es o have %u#ip#e
4av8eshes in your scene if your scene #ayou is going o change. :or e-a%p#e' if a scene
invo#ves )o roo%s separaed (y a door ha can (e (oh open and c#osed' you shou#d creae
hree 4av8eshes9 one for each roo%' and anoher ha conains (oh roo%s )ih he connecion
(e)een.
The de%o scene provides anoher e-a%p#e. *n he scene,s ?ierarchy' M4avigaion ; M4av8esh
conains )o 4av8eshes9 one for )hen he (arre# is sanding o he side' he oher for )hen he
(arre# is ipped over in he %idd#e of he roo%. !#ick on each o(Aec' )ih he 8esh !o##ider
co%ponen open o see he difference (e)een he )o.
4avigaion 8eshes can (e %ade visi(#e )hen no se#eced via he Ecene 8anager,s @isi(i#iy
pane#. <rovided your scene has an acive 4av8esh )ih a 8esh 2enderer co%ponen' i can (e
sho)n and hidden using he /n and /ff (uons.
*f you are creaing a ga%e of very #arge sca#e' you %ay find ha you need o increase he si6e of
he NavMes> ra? len83>' )hich you can adAus inside he Eeings 8anager. 0ou can a#so adAus
he NavMes> Sear<> H' o change he verica# disance Cas a percenage of he Ecreen,s heighD
ha he cursor )i## search (eneah i for a )a#ka(#e area.
".11 - UNIT- NA#IATION PATH)INDIN
$niy 4avigaion1(ased pahfinding re#ies on $niy,s (ui#1in 4av8esh oo#. * is easier o se up
han 8esh !o##ider1(ased pahfinding' (u isn, dyna%ic & he area over )hich characers in a
scene can )a#k %us (e fi-ed.
/nce he Pa3>C6n26n8 7e3>42 fie#d in he Ecene 8anager has (een se o Un63? Nav68a364n' he
4avigaion pane# )i## a##o) you o creae a NavMes>Se87en3 prefa(. 7y p#acing do)n
4av8eshEeg%ens and posiioning he% over your se,s f#oor' you can %ark ou he area in
)hich characers can %ove. The Ecene 8anager,s @isi(i#iy pane# #es you hide and sho) such
seg%ens.
3hen you have #aid ou he seg%ens' open he 4avigaion )indo) (y c#icking on 3indo) ;
4avigaion )ihin he %ain %enu' and c#ick he Ba=e (uon. The ne)#y1creaed 4av8esh )i##
(e represened (y a (#ue area. 0ou can adAus ho) rigid#y he 4av8esh fo##o)s your seg%ens
)ih he 2adius and ?eigh va#ues in he 7ake a( & Aus %ake sure ha he 4av8esh ise#f is
s#igh#y a(ove he f#oor ise#f.
+one correc#y' Advenure !reaor )i## hen %ake use of his 4av8esh )hen pahfinding is
re>uired & (u (e sure no o de#ee he origina# 4av8eshEeg%en prefa(s' as hese are a#so used
(y he engine.
he NavMes> ra? len83>' )hich you can adAus inside he Eeings 8anager. 0ou can a#so adAus
he NavMes> Sear<> H' o change he verica# disance Cas a percenage of he Ecreen,s heighD
ha he cursor )i## search (eneah i for a )a#ka(#e area.
".1" - PO'-ON CO''IDER PATH)INDIN
<o#ygon !o##er1(ased pahfinding is on#y a va#id opion )hen %aking a F$niy 2+G 2+ ga%e
Csee secion 1.5D. Bike 8esh !o##ider pahfinding' i invo#ves he creaion of a cuso% 4av8esh'
on#y i can (e creaed direc#y in he $niy edior. And a#so #ike 8esh !o##ider pahfinding' i is
dyna%ic & differen 4av8eshes can (e s)apped ou )hen he #ayou of he scene changes.
/nce he Pa3>C6n26n8 7e3>42 fie#d in he Ecene 8anager has (een se o P4l?84n C4ll62er' he
4avigaion pane# )i## a##o) you o creae a NavMes>"D prefa(.
3heher you have %u#ip#e 4av8eshes in your scene or Aus one' you %us a#)ays dec#are he
defau# inside he S<ene Mana8er Che firs a( in he %ain Advenure !reaor )indo)D. +oing
so )i## ensure your acive 4av8esh2+ is on he correc #ayer' kno)n as F4av8eshG.
0ou %us hen %odify he shape of he <o#ygon !o##ider Crepresened in he Ecene @ie) (y a
green penagonD o %ark ou he area ha !haracers can %ove. *,s reco%%ended o reduce he
nu%(er of poins o i,s (are %ini%u%' since Advenure !reaor,s pahfinding a#gorih% refers o
hese verices )hen ca#cu#aing a pah.
To creae Fho#esG in your 4av8esh' you can define addiiona# <o#ygon !o##iders in he
4avigaion8esh *nspecor ha )i## (e su(raced (y he %ain 4av8esh a runi%e. This can (e
usefu# if your scene inc#udes e.g. a ree ha he <#ayer can )a#k around.
3hi#e his a#gorih% does ake oher o(Aecs' such as !o##ision!u(es' ino accoun )hen
ca#cu#aing a pah' i %ay occasiona##y give une-peced resu#s' so i,s (es o have %u#ip#e
4av8eshes in your scene if your scene #ayou is going o change. :or e-a%p#e' if a scene
invo#ves )o roo%s separaed (y a door ha can (e (oh open and c#osed' you shou#d creae
hree 4av8eshes9 one for each roo%' and anoher ha conains (oh roo%s )ih he connecion
(e)een.
*n he Eeings 8anager' you can a#so adAus he NavMes> Sear<> H' o change he verica#
disance Cas a percenage of he Ecreen,s heighD ha he cursor )i## search (eneah i for a
)a#ka(#e area.
3.0 - CREATIN CHARACTERS
3.1 - INTRODUCTION
T)o ypes of characers are suppored in Advenure !reaor9 he <#ayer' and 4<!s. The seps
invo#ved o creae eiher ype is #arge#y si%i#ar' and he differences are deai#ed in he fo##o)ing
secion. This secion )i## cover he e#e%ens ha a## !haracers %us have.
4<!s re>uire he 4<! scrip' )hi#e he <#ayer characer re>uires he <#ayer scrip aached o i,s
5a%e/(Aec. The inspecors for (oh he <#ayer and 4<! scrips are idenica#' and have fie#ds
grouped ino hree pane#s9 S3an2ar2 an67a364ns Ceiher 2+ or 3+' depending on he chosen
ani%aion engineD' M4ve7en3 values' and D6al48ue se336n8s.
The firs fie#d you shou#d se for any ne) !haracer is i,s An67a364n en86ne. Advenure !reaor
suppors (oh 3+ ani%aion via $niy,s Begacy and 8ecani% syse%s' as )e## as 2+ ani%aion
via eiher 2+ Too#ki or $niy,s o)n 2+ fra%e)ork.
2egard#ess of ani%aion engine' %os !haracers )i## re>uire he fo##o)ing co%ponens9
Au264 S4ur<e & 4eeded for speech audioN no audio c#ip re>uired
C4ll62er & A !apsu#e )orks (es for 3+' and a !irc#e for F$niy 2+G 2+ %ode
R6862A42? & 3ih he hree roaion a-es #ocked Cor a 2igid(ody2+ for $niy 2+ ga%esD
Pa3>s & 2e>uired for pahfinding around he sceneN no addiiona# )eaking re>uired
!haracers can si## %ove )ihou a 2igid(ody' )hich can (e processor1inensive if your ga%e
feaures %any of he%. !onsider re%oving he% fro% 4<!s' and <#ayers ha do no need o
pass hrough Triggers' or %ove verica##y in he scene.
2efer o secion 3.5 for deai#s on ho) o se up a characer for 3+ ani%aion' and secions 3.6
and 3.7 for 2+ ani%aion. 8ove%en va#ues are ypica# speed facors for )a#king' running'
urning' acce#eraing and dece#eraing. The +ia#ogue seings pane# provides a fie#d for a porrai
graphic' )hich )i## (e disp#ayed )hen a characer a#ks if he defau# su(i#es %enu is urned on'
and a e- co#our' )hich )i## (e used if he ga%e,s su(i#es %enu e#e%en a##o) i.
The 2igid(ody seings pane# offers so%e handy opions regarding he !haracer,s physics. *f a
scene,s f#oor conains no variaions in heigh' he I8n4re 8rav63?G check(o- can (e used o o%i
he need for a !o##ision1(ased f#oor & he 2+ +e%o <#ayer !haracer' 7rain2+' %akes use of his
feaure. !onverse#y' if a !haracer is e-peced o %ove on paricu#ar#y seep s#opes' he )ree:e
9>en I2leG check(o- can (e used o sop he% fro% s#iding do)n)ard )hen sanding si##.
A !haracer,s inspecor a#so provides fie#ds for audio c#ips ha p#ay )hen %oving & o %ake
audi(#e fooseps' for e-a%p#e. Eo ha a !haracer can speak a#oud a he sa%e i%e' ho)ever' a
separae FEound chi#dG %us (e provided o a##o) for a second Audio Eource. Add an e%py
5a%e/(Aec o your !haracer,s prefa( C5a%e/(Aec ; !reae =%pyD' and add (oh he Audio
Eource and Eound co%ponens. Ee he Eound inspecor,s S4un2 3?Be o E:H' and fina##y drag
his chi#d o(Aec ino he !haracer,s S4un2 <>6l2 fie#d. An e-a%p#e !haracer se up in his )ay
can (e found in Asses ; Advenure !reaor ; +e%o ; 4<!s ; 7rain.
The !haracer9 Ani%ae acion can (e used o change a !haracer,s foosep sounds %id1ga%e'
ho)ever for he change o (e regisered (y he save ga%e fi#es' (e sure o p#ace he ne) sounds
in your ga%e,s 2esources fo#der.
3." - THE P'A-ER
A ga%e canno run uni# a <#ayer is defined. =ven if he ga%e is pure#y firs1person' and he
p#ayer is never seen' a prefa( si## needs o (e creaed. :o##o) he seps ou#ined in he previous
secion (efore coninuing' (eing sure o add a <#ayer scrip o he !haracer.
0our ga%e,s p#ayer characer is defined in he Eeings 8anager Cfro% he %ain Advenure
!reaor )indo)D. The <#ayer prefa( is creaed (y he 5a%e=ngine o(Aec a runi%e & i shou#d
no (e presen in he scene )hen you run he ga%e. Eo ha i can (e insaniaed' he <#ayer
prefa( is re>uired o (e p#aced in a fo#der ca##ed Res4ur<es.
The <#ayer prefa( %us (e agged as Pla?er' (u i,s na%e need no (e such. /n#y he roo o(Aec
shou#d (e given his ag' )hi#e (oh he roo o(Aec and any chi#dren shou#d (e p#aced in he
I8n4re Ra?<as3 #ayer.
0ou )i## a#so need o aend o he <#ayer,s ani%aion seings & refer o secion 3.5 for 3+
ani%aion' or secions 3.6 and 3.7 for 2+ ani%aion.
/nce your <#ayer prefa( is ready' p#ace i in he 2esources fo#der and assign i using he Eeings
8anager. The de%o,s p#ayer characer' Tin <o' is avai#a(#e for sudy in Asses ;
Advenure!reaor ; +e%o ; 2esources.
8os ga%es invo#ve on#y one <#ayer prefa(' ho)ever i is a#so possi(#e o have a ga%e ha
invo#ves severa# <#ayer characers' ha you can s)ich (e)een in1ga%e. 3ihin he Eeings
8anager' se Pla?er s963<>6n8 o All49' and you )i## (e a(#e o define %u#ip#e <#ayer prefa(s'
as )e## as he defau#. The Pla?er: S963<> Acion can hen (e ca##ed during ga%ep#ay o change
he curren acive <#ayer. 4oe' ho)ever' ha on#y one <#ayer prefa( can (e presen in he scene
a a i%e & if you )ish o have )o <#ayer characers presen ogeher' you %us use he Pla?er:
S963<> Acion,s a(i#iy o Fs)ap ouG he inacive <#ayer prefa( )ih an 4<! prefa( ha has he
sa%e %ode# and ani%aion se.
The a(i#iy o s)ich <#ayer prefa(s is a#so usefu# for giving your <#ayer characer cosu%e
changes. A differen characer %ode# can (e used (y a differen prefa(' and s)apped ou as
needed. 3hen his is he case' you )i## #ike#y )an your prefa(s o share he sa%e *nvenory. To
a##o) his' Aus c#ick he S>are sa7e Inven34r?G check(o- in he Eeings 8anager )hen Pla?er
S963<>6n8 is se o All49.
3.3 - NPCS
4<!s are co%puer1conro##ed characers ha he p#ayer can inerac )ih in he ga%e. They can
)a#k' run' speak' and (e ani%aed Aus as he p#ayer can' (u re>uire a #i#e %ore )ork o p#ace in
he ga%e.
7egin (y fo##o)ing he seps in secion 3.1' giving he !haracer an 4<! scrip' and hen %aking
sure he 4<! is unagged. * is a good idea o %ake your 4<! a prefa(' so ha i can (e re1used
in oher scenes.
*f you inend o %ake he characer ineracive' you,## need o %ove he roo o(Aec ono he
DeCaul3 #ayer. Then add on he H43sB43 scrip' and opiona##y he H68>l68>3 scrip. The
Highlight scrip )i## %ake he characer (righer )hen he cursor is over he% & find he OADe<3
34 >68>l68>3 fie#d in he ?ospo inspecor' and se#ec he 4<!. :or %ore on using he ?ospo
inspecor o creae 4<! ineracions' refer o secion 5.3.
0ou )i## a#so need o aend o he 4<!,s ani%aion seings & refer o secion 3.5 for 3+
ani%aion' or secions 3.6 and 3.7 for 2+ ani%aion.
4<!s in he scene can (e %anipu#aed in1ga%e using Acions' and )ih he ?ospo scrip' hey
can (e ineraced )ih in he sa%e )ay ?ospo prefa(s are. :or fu## insrucions' refer o secion
5.0.
3.% - CHARACTER MO#EMENT
*neracions' !uscenes' +ia#ogue /pions and Triggers can a## (e used o conro# a characer,s
%ove%en' and a#so resric a p#ayer,s %ove%en during ga%ep#ay.
!haracers can %ove in )o )ays9 (y dyna%ica##y pahfinding heir )ay (e)een )o poins' or
(y fo##o)ing a pre1deer%ined roue designed in he Ecene vie). 7oh of hese %ehods invo#ve
he Pa3>s scrip.
Any characer you )ish o pahfind o so%e)here %us have he Paths scrip aached o heir
5a%e/(Aec. A 4av8esh %us a#so (e defined in he scene9 refer o he ear#ier secions 2.10 o
2.12 for %ore. The C>ara<3er: M4ve 34 B46n3 Acion can hen (e used o %ake he characer
navigae he scene. Eee secion 5.2 for %ore on Acions. *f a !haracer )ans o pahfind (u no
4av8esh is se' hey )i## si%p#y %ove in a sraigh #ine direc#y o heir desinaion.
To %ake a characer %ove a#ong a pre1se pah' you firs need o creae ha pah as a separae
o(Aec. :ro% he Ecene 8anager' c#ick Pa3> under he 4avigaion pane#. *f you don, see ha
(uon avai#a(#e' %ake sure you have se up your scene correc#y & see secion 1.4.
/nce you have creaed a ne) <ah o(Aec' you shou#d see a (#ue circ#e appear a he origin of
your scene. The (#ue circ#e represens he saring poin of your pah. 8ove i o an appropriae
p#ace in your scene. Then use he <ahs inspecor o creae your pah9 c#icking A22 n42e )i##
%ake anoher ransfor% gi6%o appear c#ose o he (#ue circ#e' )ih he nu%(er 1 appearing
(e#o) i. This %eans i is he firs node' or pah poin' (eyond he saring poin. A (#ue #ine
connecs nodes ogeher' a##o)ing you o visua#ise he pah your characer )i## ake.
4oe ha he he e#evaion of a pah,s nodes are uni%poran un#ess you check he Overr62e
8rav63?G (o- in he <ahs inspecor. +oing so )i## cause he characer o %ove o each node,s
poin on he 01a-is' as )e## as he H and I. This is usefu# if you )an a characer o f#y' for
e-a%p#e. 0ou can a#so %ake he characer )a#king a#ong his pah )ai for a i%e a each node'
(y supp#ying a $a63 367e.
/nce you have se up your pre1deer%ined pah' you can use he C>ara<3er: M4ve al4n8 Ba3>
Acion o %ove eiher he p#ayer or an 4<! a#ong i. Again' see secion 5.2 for %ore on Acions.
<redeer%ined pahs can a#so (e used o resric p#ayer %ove%en during ga%ep#ay. 0ou can use
he Pla?er: C4ns3ra6n Acion o assign a <ahs o(Aec o he p#ayer' )hich )i## %ean he p#ayer
can on#y %ove a#ong ha pah. 4oe ha his feaure on#y )orks )ih he +irec and :irs <erson
%ove%en %ehods.
:or coders' a !haracer,s pah is deer%ined (y heir activePath varia(#e. *f a !haracer is
pahfinding' his activePath )i## refer o heir o)n <ahs co%ponen. The targetNode and
prevNode inegers are used o deer%ine )here on he pah a characer is' and in )hich direcion
hey are rave##ing. 3hen hey reach a node' a funcion in he <ahs scrip reurns he ne- node
nu%(er hey shou#d ai% for.
3.& - CHARACTER ANIMATION .'EAC-/
*f your !haracer engine is se o Begacy Csee secion 3.1D' %ake sure ha your ani%aion fi#es
have (een i%pored as such. 4e-' aach an An67a364n co%ponen o your !haracer. The
Ani%aions array ough o (e c#eared' since he !haracer scrip )i## rep#ace he% )ih i,s o)n
se a runi%e.
N43e: *f your ga%e is using Top1+o)n 2+ Csee secion 1.5D co%(ined )ih 3+ !haracers Cas in
2una)ay or The Bonges Kourney' for insanceD' your Ani%aion co%ponen needs o (e a <>6l2
4ADe<3 of he !haracer' and %us (e se as your An67a364n <>6l2 in he !haracer,s inspecor.
A#so (e a)are ha in order for 3+ %ode#s o )ork correc#y )ih spries and Eoring 8aps' hey
%ay need shaders ha have FI3rie /ffG se o he%.
3hen using Begacy ani%aion' he inspecor for (oh he <#ayer and 4<! scrips )i## conain
pane#s ca##ed S3an2ar2 3D an67a364ns and B4ne 3ransC4r7s. Eandard ani%aions C*d#e' 3a#k'
ec.D are p#ayed auo%aica##y )hen appropriae. 4oe ha he urning ani%aions are on#y
p#ayed )hen he characer is urning on he spo. *f an ani%aion is %issing' he characer )i##
si## %ove even if hey are no ani%aed.
The (one ransfor% fie#ds are re>uired for cuso% ani%aions. The firs four of hese C$pper
(ody' neck' #ef ar% and righ ar%D are used as %i-ing ransfor%s Cha is' o iso#ae ani%aions o
specific (ody parsD )hen using he C>ara<3er: An67a3e Acion. The )o hand (ones are used
as reference )hen insrucing a !haracer o ho#d an o(Aec' via he C>ara<3er: H4l2 4ADe<3
Acion.
3hen you p#ay a cuso% ani%aion on a !haracer' you can define an ani%aion #ayer for i o (e
p#ayed on' fro% he (ase #ayer a he (oo%' o he %ouh #ayer a he op. 7y keeping your
ani%aions on separae #ayers' you can %i- he% ogeher o creae ne) ani%aions. The de%o
provides a good e-a%p#e of his )hen 7rain a#ks o he p#ayer )hi#e in his chair. ?e is p#aying
his id#e ani%aion on he 7ase #ayer' urning his head #ef on he 4eck #ayer' (o((ing his head on
he ?ead #ayer' changing his e-pression on he :ace #ayer' and %oving his #ips on he 8ouh
#ayer. *,s genera##y a good idea o on#y p#ay one ani%aion per #ayer a any one i%e.
The C>ara<3er: An67a3e Acion can a#so sop ani%aions' change he sandard ani%aions' and
rese a !haracer o id#e. * a#so akes care of re%oving o#d ani%aions ha are no #onger p#aying
in he !haracer,s Ani%aion co%ponen.
3hen you se#ec a cuso% ani%aion o p#ay' you can a#so choose if ha ani%aion is (#ended
)ih or added on op of e-ising ani%aions. *f you are having rou(#e geing an addiive
ani%aion o p#ay proper#y' %ake sure ha a## keyfra%ed (ones in ha ani%aion sar fro% heir
res posiion.
The D6al48ue: Pla? SBee<> Acion a#so a##o)s for )o %ore ani%aions9 ?ead and 8ouh.
These fie#ds ac as shorcus o p#ay cuso% ani%aions in he correc )ay. The ?ead ani%aion
is used o vary a characer,s head %oion as hey say a #ine' for e-a%p#e a nod if hey are
agreeing )ih so%ehing. This is an Addiive ani%aion p#ayed once on he ?ead #ayer. The
8ouh ani%aion is used o #e he characer ani%ae heir #ips as hey a#k. 0ou can eiher supp#y
a generic Fa#kingG ani%aion' or a #ine1specific #ip1sync ani%aion. This is a 7#end ani%aion
p#ayed once on he 8ouh #ayer. 4oe ha i is a#so possi(#e o ani%ae a characer,s Aa) (one
auo%aica##y' according o he sound hey are %aking9 see secion 9.1 for %ore.
*f you have an a#ernaive so#uion for #ip1syncing' for e-a%p#e :ace:H' you can %odify he
D6al48ue: Pla? SBee<> Acion o sui your needs9 a## acions are se#f1conained scrips' iso#aed
fro% one oher.
3.* - CHARACTER ANIMATION .UNIT- SPRITES/
Advenure !reaor can re#y on $niy,s o)n 2+ fra%e)ork for characer ani%aion (y seing he
!haracer engine fie#d in he Eeings 8anager. $niy,s (ui#1in 2+ fra%e)ork uses a varian of
he 8ecani% syse%. :or ha reason' you %us (e fa%i#iar )ih using he Ani%aor co%ponen
and )indo). 0ou can read up on he 8ecani% syse% fro% he officia# $niy docu%enaion.
To creae a 2+ characer' you )i## need o %ake a LEprie chi#dL o(Aec ha ho#ds your characer
sprie. Add an Ani%aor co%ponen o an e%py 5a%e/(Aec 1 his )i## (e your Eprie chi#d.
0ou can eiher hen add a Eprie 2enderer co%ponen o his /(Aec' or aach %u#ip#e Eprie
2enderers as chi#d /(Aecs for #ayered ani%aion Csuch as he LheroL characer in $niy,s o)n 2+
e-a%p#e proAecD. Assign your Ani%aor co%ponen a !onro##er' and se up your ani%aion
c#ips using he Ani%aion and Ani%aor )indo)s.
To creae an ani%aion c#ip' se#ec your Ani%aor co%ponen' and dock he Ani%aion )indo).
!reae a ne) c#ip' rena%e i' and drag he c#ip,s individua# fra%es ono he +ope Ehee. AdAus
he sa%p#es va#ue o affec p#ay(ack speed' and hen drag he c#ip,s asse fi#e ino he Ani%aor
)indo). :or sandard ani%aions Ce-p#ained (e#o)D' you do no need o dea# )ih Transiions or
<ara%eers' as Advenure !reaor )i## p#ay he appropriae ani%aions auo%aica##y.
2+ !haracers have four sandard ani%aion ypes ha p#ay auo%aica##y9 *d#e' 3a#k' 2un' and
Ta#k. The na%es of hese ani%aions are enered %anua##y ino he inspecor. 2+ !haracers can
face eiher four or eigh direcions' depending on he inspecor,s +iagona# spriesO check(o-.
Euch direcions are deer%ined via suffi-es in your sprie,s ani%aion na%es. :or e-a%p#e' if a
!haracer,s )a#k ani%aion is F3a#kG' he )a#k1righ ani%aion shou#d (e na%ed F3a#kM2G' and
)a#k1#ef ani%aion F3a#kMBG. The fo##o)ing suffi-es o he ani%aion na%es are undersood (y
Advenure !reaor9
M2 1 2igh
MB & Bef
M$ & $p
M+ & +o)n
M$2 & $p1righ
M$B & $p1#ef
M+2 & +o)n1righ
M+B & +o)n1#ef
*f your #ef1 and righ1facing spries are %ere#y %irror i%ages of each oher' you on#y need
supp#y one or he oher. 3ihin a 2+ characer,s FEandard 2+ ani%aions pane#G' se he )ra7e
Cl6BB6n8 va#ue o Bef 8irrors 2igh o on#y re#y on righ1facing ani%aions' or 2igh 8irrors
Bef for he opposie. *f your ani%aion c#ips re#y on sprie ransfor%s' raher han s)apping ou
fra%es' you can use he Cr4ssCa2e Ae39een s3a3esG check(o- o s%ooh ransiions.
The C>ara<3er: An67a364n Acion a#ers )hen !haracers use he $niy 2+ fra%e)ork' (u noe
ha )hen p#aying non1sandard ani%aions' you %ay need o add Transiions o your Ani%aion
!onro##er o proper#y conro# ho) he ani%aion finishes p#aying. The +ia#ogue9 <#ay Epeech
Acion is given addiiona# ani%aion opions' a##o)ing p#ay(ack of ani%aions on varying #ayers.
3.+ - CHARACTER ANIMATION .MECANIM/
Euppor for 8ecani% in Advenure !reaor is inended for designers )ho )ish for greaer conro#
over heir ani%aion han ha )hich Begacy provides. 3hi#e Begacy ani%aion a##o)s designers
o si%p#y FgiveG Advenure !reaor an ani%aion and specify ho) and )hen o p#ay i' 8ecani%
#eaves he hand#ing of ani%aions up o he designer' )hi#e giving Advenure !reaor conro#
over cerain para%eers in he !haracer,s !onro##er.
<#ayers and 4<!s running )ih 8ecani% re>uire an An67a34r co%ponen. Their *nspecors
)i## have a ne) pane#9 Me<an67 Bara7e3ers. To %ove a !haracer in he scene' Advenure
!reaor re>uires ha heir Ani%aion !onro##er has a f#oa para%eer ha deer%ines heir
%ove%en speed. 7y defau#' he na%e of his para%eer is FEpeedG' (u his can (e changed in
he *nspecor,s M4ve sBee2 Cl4a3 fie#d.
N43e: *f your ga%e is using Top1+o)n 2+ Csee secion 1.5D co%(ined )ih 3+ !haracers Cas in
2una)ay or The Bonges Kourney' for insanceD' your Ani%aor co%ponen needs o (e a <>6l2
4ADe<3 of he !haracer' and %us (e se as your An67a34r <>6l2 in he !haracer,s inspecor.
A#so (e a)are ha in order for 3+ %ode#s o )ork correc#y )ih spries and Eoring 8aps' hey
%ay need shaders ha have FI3rie /ffG se o he%.
A (oo# para%eer is a#so re>uired' )hich is se o rue )hen he !haracer is speaking. 7y
defau#' he na%e of his para%eer is F*sTa#kingG' (u his can (e changed in he *nspecor,s Tal=
A44l fie#d.
3hen a !haracer is sanding si##' heir assigned M4ve sBee2 Cl4a3 para%eer is se o 6ero.
3hen hey are %ade o )a#k or run' his para%eer is se o heir $al= sBee2 s<ale and Run
sBee2 s<ale respecive#y & (oh of )hich are defined in he *nspecor,s M4ve7en3 se336n8s.
3ih his kno)#edge' a designer can se up an :E8 inside heir !onro##er o p#ay *d#e' 3a#k and
2un ani%aions according#y. Turning can a#so (e caered for' (y supp#ying a Turn Cl4a3
para%eer. This )i## (e se o 11 and P1 )hen he !haracer urns #ef and righ respecive#y.
8ecani%1(ased !haracers can a#so (e ani%aed according o heir verica# speed' o a##o) for
cuso% ani%aions )hen fa##ing' or c#i%(ing sairs. The #er36<al 74ve7en3 Cl4a3 para%eer
oupus any change in a !haracer,s posiion a#ong he 01a-is.
As )ih Begacy ani%aion' a 8ecani%1(ased !haracer can a#so (e assigned #ef and righ hand
(ones' for use )ih he C>ara<3er: H4l2 4ADe<3 Acion.
The C>ara<3er: An67a3e Acion can (e used (y 8ecani%1(ased !haracers o change he va#ue
of any para%eer in heir !onro##er. * can a#so (e used o change )hich para%eer is used as he
M4ve sBee2 Cl4a3 and Tal= A44l. 7y changing hese' i is possi(#e o FredirecG he !onro##er o
p#ay differen FsandardG ani%aions' such as 3a#king and Ta#king.
3.8 - CHARACTER ANIMATION .SPRITES "D TOO'(IT/
2+ Too#ki is a separae $niy asse ha provides sprie funciona#iy' and is avai#a(#e for
purchase a ))).unikronsof)are.co%.2doo#ki. Euppor for i can (e ena(#ed via he
C>ara<3er en86ne fie#d in he Eeings 8anager. 3hen you se#ec i for he firs i%e' a %essage
regarding a preprocessor define )i## appear. The Fk2+*s<resenG preprocessor %us (e defined
for 2+Too#ki inegraion' and his can (e done in )o )ays9
$nco%%ening he #ine #define tk2DIsPresent a he op of he
k2+*negraion.cs scrip fi#e' found in Advenure!reaor ; Ecrips ; Eaic' (y
re%oving he )o preceding s#ashes.
/pening he <#ayer Eeings' and enering 3="DIsPresen3 ino he S<r6B36n8 DeC6ne
S?7A4ls fie#d for your ga%e,s p#afor%.
To creae a 2+ characer' se up a sprie and ani%aion #i(rary using 2+ Too#ki Crefer o 2+
Too#ki,s o)n docu%enaion on ho) o do hisD' and add he ani%aed sprie as a <>6l2 of he
!haracer prefa(. Then' drag he sprie o(Aec ino he !haracer,s SBr63e <>6l2 fie#d in he <#ayer
or 4<! inspecor. 4oe ha 2+ !haracer spries shou#d have an Anchor of '49er Cen3er.
2+ !haracers have four sandard ani%aion ypes ha p#ay auo%aica##y9 *d#e' 3a#k' 2un' and
Ta#k. The na%es of hese ani%aions are enered %anua##y ino he inspecor. 2+ !haracers can
face eiher four or eigh direcions' depending on he inspecor,s D6a84nal sBr63esG check(o-.
Euch direcions are deer%ined via suffi-es in your sprie,s ani%aion na%es. :or e-a%p#e' if a
!haracer,s )a#k ani%aion is F3a#kG' he )a#k1righ ani%aion shou#d (e na%ed F3a#kM2G' and
)a#k1#ef ani%aion F3a#kMBG. The fo##o)ing suffi-es o he ani%aion na%es are undersood (y
Advenure !reaor9
M2 & 2igh
MB & Bef
M$ & $p
M+ & +o)n
M$2 & $p1righ
M$B & $p1#ef
M+2 & +o)n1righ
M+B & +o)n1#ef
*f your #ef1 and righ1facing spries are %ere#y %irror i%ages of each oher' you on#y need
supp#y one or he oher. 3ihin a 2+ characer,s FEandard 2+ ani%aions pane#G' se he )ra7e
Cl6BB6n8 va#ue o Bef 8irrors 2igh o on#y re#y on righ1facing ani%aions' or 2igh 8irrors
Bef for he opposie.
4oe ha a## ani%aions %us (e presen inside he sa%e ani%aion #i(rary.
The C>ara<3er: An67a364n Acion is a#ered )hen !haracers use he 2+Too#ki engine' (u
funciona#iy is he sa%e. 0ou can sop and sar cuso% ani%aions (y na%e' a#ering heir )rap
%ode as needed. The +ia#ogue9 <#ay Epeech Acion a#so re%oves ani%aion opions' since
a#king ani%aions are p#ayed auo%aica##y.
3., - CHARACTER ANIMATION .SPRITES UNIT- COMP'E0/
8uch #ike ho) he 8ecani% inegraion is designed o give 3+ ga%e designers greaer conro#
han Begacy' Epries $niy !o%p#e- is designed o give 2+ ga%e designers greaer conro# han
Epries $niy' a##o)ing for s%ooh ransiions (e)een ani%aions & such as 7roken E)ord1sy#e
ani%aed ransiions fro% one )a#king direcion o anoher.
2aher han re>uiring he na%es of ani%aion c#ips for Advenure !reaor o auo%aica##y ca##
upon' Epries $niy !o%p#e- #eaves he hand#ing of ani%aions up o he designer' )hi#e giving
Advenure !reaor conro# over cerain para%eers in he !haracer,s !onro##er & his a##o)s he
designer o %ake use of he% ho)ever hey #ike.
To creae a 2+ characer' you )i## need o %ake a LEprie chi#dL o(Aec ha ho#ds your characer
sprie. Add an Ani%aor co%ponen o an e%py 5a%e/(Aec 1 his )i## (e your Eprie chi#d.
0ou can eiher hen add a Eprie 2enderer co%ponen o his /(Aec' or aach %u#ip#e Eprie
2enderers as chi#d /(Aecs for #ayered ani%aion Csuch as he LheroL characer in $niy,s o)n 2+
e-a%p#e proAecD. Assign your Ani%aor co%ponen a !onro##er' and se up your ani%aion
c#ips using he Ani%aion and Ani%aor )indo)s.
To creae an ani%aion' se#ec your Ani%aor co%ponen' and dock he Ani%aion )indo). Add
a ne) c#ip' rena%e i' and drag he c#ip,s individua# fra%es ono he +ope Ehee. AdAus he
sa%p#es o affec p#ay(ack speed' and hen drag he c#ip,s asse fi#e ino he Ani%aor )indo).
!haracer )ih Epries $niy !o%p#e- have a ne) pane# in heir *nspecor9 Me<an67
Bara7e3ers. To %ove a !haracer in he scene' Advenure !reaor re>uires ha heir Ani%aion
!onro##er has a f#oa para%eer ha deer%ines heir %ove%en speed. 7y defau#' he na%e of
his para%eer is FEpeedG' (u his can (e changed in he *nspecor,s M4ve sBee2 Cl4a3 fie#d.
3hen a !haracer is sanding si##' heir assigned M4ve sBee2 Cl4a3 para%eer is se o 6ero.
3hen hey are %ade o )a#k or run' his para%eer is se o heir $al= sBee2 s<ale and Run
sBee2 s<ale respecive#y & (oh of )hich are defined in he *nspecor,s M4ve7en3 se336n8s.
The direcion ha a !haracer faces is a#so oupu in he for% of he D6re<364n 6n3e8er. The
va#ue ha i akes depends on he !haracer,s facing direcion9 Cnoe ha he fina# four are on#y
avai#a(#e if he D6a84nal sBr63es opion is checkedD
0 & +o)n
1 & Bef
2 1 2igh
3 & $p
4 & +o)n1#ef
5 & +o)n1righ
6 & $p1#ef
7 & $p1righ
3hen a !haracer a#ks' he Tal= A44l para%eer is se o rue. Turning can a#so (e caered for'
(y supp#ying a Turn Cl4a3 para%eer. This )i## (e se o 11 and P1 )hen urning #ef and righ.
3.10 - HEAD TURNIN
To increase rea#is% )hen %aking 3+ ga%es' )e %ay so%ei%es )ish for our !haracers o urn
heir heads o #ook a specific o(Aecs 1 raher han urning heir enire (odies. This is possi(#e
)hen using (oh he Begacy and 8ecani% ani%aion engines.
To se up head1urning' four ani%aion c#ips are re>uired9 one each for #ooking up' do)n' #ef and
righ. 3hen creaing hese c#ips for a Begacy1(ased !haracer' hese c#ips shou#d ani%ae Aus
he head' sar in he res posiion and end in he e-re%e posiion. These c#ips can hen (e
assigned in he !haracer,s *nspecor. A Ne<= A4ne shou#d a#so (e supp#ied' o iso#ae he
ani%aions fro% he res of he (ody 1 he de%o ga%e,s Tin <o !haracer provides an e-a%p#e of
his.
:or 8ecani%1(ased !haracers' you can updae your :E8 )ih )o f#oa para%eers ha
deer%ine he head,s 0a) C#ef1and1righD and <ich Cup1and1do)nD roaion offse. The na%es of
hese para%eers %us (e deer%ined )ihin he !haracer,s *nspecor.
!haracers )i## urn heir heads side)ays (y a %a-i%u% 60 degrees side)ays' and 30 degrees up
and do)n.
/nce he ani%aions have (een proper#y inegraed' you can %ake a !haracer face an o(Aec (y
using he C>ara<3er: )a<e 4ADe<3 Acion' and seing :ace )ih o ?ead. A !haracer )i##
coninue o face he supp#ied 5a%e/(Aec uni# he Acion is run again )ih Eop #ookingO
checked.
The <#ayer !haracer can a#so (e %ade o face he acive ?ospo 1 fro% he Eeings 8anager'
check Pla?er 3urns >ea2 34 a<36veG underneah H43sB43 se336n8s.
%.0 - CAMERA PERSPECTI#ES
%.1 - INTRODUCTION
As you creae your ga%e' you )i## p#ace %any ca%eras do)n in your scene. 8os of hese )i##
(e 5a%e!a%eras' )hich are never used direc#y o vie) your ga%e fro%' (u raher are used as
Freference poinsG for he %ain ca%era. The 8ain!a%era prefa( aaches ise#f o )hichever
5a%e!a%era is curren#y acive' and copies i,s posiion' roaion' fie#d of vie)' orhographic
ype and oher ca%era properies.
Advenure !reaor a##o)s for 2+' 2.5+ and 3+ advenure ga%es' (u a#so for co%(inaions9 for
e-a%p#e' a 3+ ga%e in )hich he characers are a## spries' or a sidescro##ing ga%e in )hich he
characers are 3+ %ode#s. The ca%era perspecive ha your ga%e akes is defined in he
Ca7era se336n8s pane# )ihin he Eeings 8anager.
This seing affecs )hich 5a%e!a%era prefa(s are avai#a(#e )ihin he Ecene 8anager.
?o)ever' you can si## use any ype of 5a%e!a%era in your ga%e' regard#ess of he perspecive
seing you,ve chosen & Aus drag he% %anua##y fro% Advenure!reaor ; <refa(s ; !a%eras
ino your scene hierarchy.
=ach ype of 5a%e!a%era co%es )ih differen seings' and hese )i## each (e e-p#ained in he
fo##o)ing secions.
:or a## ca%era and perspecive ypes' Advenure !reaor a#so provides )idescreen and
#eer(o-ing suppor. A#so in he Eeings 8anager,s Ca7era se336n8s pane# is he opion o
)4r<e asBe<3 ra364. 3hen checked' you can %anua##y se your ga%e,s aspec raio' regard#ess of
he reso#uion of your ga%e,s (ui#d. A raio of #ess han one )i## cause a Beer(o- effec' )hi#e a
raio greaer han one )i## cause a 3idescreen effec. 7#ack (orders )i## (e creaed o fi## he
screen' and he !ursor and 8enus )i## (e prevened fro% enering he%.
%." - 3D CAMERAS
3+ ca%eras' or 5a%e!a%eras' are he defau# ca%era ype in Advenure !reaor' and provide he
(igges a%oun of conro# over heir %ove%en in 3+ space. They have hree a-es ha can (e
conro##ed9 H1a-is posiion' 01a-is posiion' 01a-is roaion' and I1a-is posiion. =ach a-is can
(e #ocked or un#ocked separae#y.
3hen a #eas one a-is is un#ocked' a pane# o affec he ca%era,s arge appears in he *nspecor.
7y defau#' his is he p#ayer' (u oher 5a%e/(Aecs can (e used insead if he Tar8e3 6s Bla?erG
check(o- is unchecked. The speed a )hich he ca%era fo##o)s is arge can a#so (e conro##ed.
3hen an a-is (eco%es un#ocked' he %ehod (y )hich ha a-is is affeced can (e se. :or
e-a%p#e' he H1a-is posiion can (e se o reac o he arge,s H1a-is posiion' I1a-is posiion'
posiion across he vie)por or posiion a)ay fro% i. The )ay in )hich his FinpuG resu#s in
he a-is, fina# posiion depends on he *nf#uence and /ffse va#ues' and #i%is can (e se using he
!onsrain pane#.
The S62e s<r4ll6n8 opion a##o)s he ca%era o (ehave #ike a %ore radiiona# 2+ advenure
ga%e ca%era' in )hich he ca%era on#y %oves )hen he p#ayer nears he edge of he screen.
The 01a-is roaion pane# has an addiiona# opion9 '44= A3 Tar8e3' )ih a heigh offse' )hich
is a si%p#e )ay of ensuring he ca%era is a#)ays cenred on he arge.
To deer%ine he (es va#ues for a 5a%e!a%era,s inspecor' i is ofen easier o )eak he% )hi#e
he ga%e is running' copy heir va#ues Cvia he cog icon o he op1righ of he inspecorD' and
pase he% (ack in once he ga%e has (een sopped.
5a%e!a%eras a#so have a Curs4r 6nCluen<e pane#' )hich a##o)s he ca%era o appear o su(#y
Ffo##o)G he p#ayer,s cursor around he screen.
Though heir defau# proAecion is <erspecive' 5a%e!a%eras can a#so (e se o /hographic. *
is i%poran' ho)ever' ha he scene,s 4avigaion 8esh is a#)ays visi(#e o he ca%era if you are
%aking a <oin And !#ick ga%e & if you are %aking one )ih /rhographic ca%era' (e sure o
roae he% do)n)ard so ha hey can see he 4av8eshes.
%.3 - ANIMATED CAMERAS
The 5a%e!a%erAni%aed prefa( is an a#ernaive o he regu#ar 5a%e!a%era' and on#y #ised in
he Ecene 8anager )hen your ga%e,s perspecive is se o 3+ Cin he Eeings 8anagerD. * is a
!a%era ha can p#ay (ack a $niy1%ade ani%aion )hen %ade acive. This a##o)s for %ore
dyna%ic and ineresing ca%era)ork during !uscenes' for e-a%p#e.
Addiiona##y' a 5a%e!a%erAni%aed can (e %ade o p#ay a fi-ed fra%e fro% an ani%aion
(ased on i,s Targe,s poin a#ong a <ah. A <ah is a prefa( ha descri(es a series of nodes' and is
a#so avai#a(#e in he Ecene 8anager. 3hen he !a%era,s Targe is a he sar of he assigned
<ah' he !a%era )i## p#ay he firs fra%e of he ani%aion. 3hen he Targe is a he end of he
<ah' he !a%era )i## p#ay he #as fra%e' and in1(e)een fra%es )i## (e inerpo#aed
appropriae#y. This a##o)s for conro##ed ca%era)ork as he <#ayer %oves a#ong a specific
secion of f#oor' and )i## fa%i#iar o p#ayers of he 5od /f 3ar series of ga%es.
+o (e a)are' ho)ever' ha such <ahs %us (e kep o one side of he Targe a a## i%es' and he
nodes %us (e posiioned such ha he ref#e- ang#es CQ 180 degreesD (e)een he% %us face he
Targe. *f he <ah )ere o (e used for a corner' for e-a%p#e' he (ird,s eye vie) shou#d #ook #ike
his9
%.% - "D CAMERAS
The 2+ ca%era' or 5a%e!a%era2+' provides fe)er opions han i,s 3+ counerpar' (u
e%u#aes he (ehaviour of radiiona# 2+ advenure ga%e ca%eras' )heher he se is acua##y in
2+ or no. 4oe han in order o )ork proper#y' a 5a%e!a%era2+ %us (e facing he for)ard I
a-is & if i is no' a (uon )i## appear in i,s inspecor o correc i,s roaion.
5a%e!a%era2+,s do no physica##y %ove in he Ecene. 2aher' heir proAecion %arices change
& hey FpanG across he screen ye he perspecive re%ains he sa%e. 3+ ses )i## appear o (e in
2+' and 2+ (ackgrounds can (e used in heir p#ace. Tradiiona# 2+ advenure ga%es can (e
creaed (y co%(ining sprie1(ased characers and o(Aecs )ih 2+ ca%eras.
A 5a%e!a%era2+ can %ove hori6ona##y and verica##y' or (e #ocked in eiher direcion. 3hen
a #eas one a-is is un#ocked' opions o conro# he ca%era,s arge )i## appear' as )ih he
5a%e!a%era in he previous secion.
*n eiher direcion' he Tra<= Cree247 varia(#e deer%ines ho) far' in $niy co1ordinaes' he
arge %us %ove fro% he ca%era,s percieved cenre (efore he ca%era (egins o fo##o) & a
freedo% of 6ero )i## keep he arge in he cenre of he screen. As (efore' he ca%era,s
%ove%en can (e consrained. =ven )hen he ga%e is no running' he OCCse3 varia(#e can (e
used o posiion he ca%era,s perceived cenre' so ha appropriae consrain va#ues can (e
deer%ined.
As he 5a%e!a%era2+ pans around your scene' you %ay )an o have foreground and
(ackground e#e%ens panning a differen speeds' o achieve a deph effec. To do his' aach a
ParallaF"D scrip o any 5a%e/(Aec o %ake i %ove )ih he ca%era. The deph va#ue
conro#s i,s panning speed & (ackground o(Aecs shou#d have posiive va#ues' )hi#e foreground
o(Aecs shou#d have negaive va#ues.
%.& - ".&D CAMERAS
The 2.5+ ca%era' or 5a%e!a%era25+' faci#iaes he deve#op%en of ga%es ha use pre1
rendered (ackgrounds )ih Cradiiona##yD 3+ characers. Euch ca%eras are fi-ed' and canno
%ove' (u are usefu# (ecause hey can have (ackground i%ages assigned o he%' )hich p#ay
underneah he res of he scene,s geo%ery' and are no kep in scene space. This a##o)s a scene
o have %any ca%eras in a 2.5+ ga%e' )ihou having o keep rack of an e>ua# nu%(er of
(ackground p#anes.
Euch (ackground i%ages re>uire a #i#e %ore se1up' ho)ever. A 7ackground!a%era prefa(
%us e-is' and each (ackground i%age is sored )ihin a separae 7ackground*%age prefa(.
3hen he !a%era perspecive opion in he Eeings 8anager is se o 2.5+' he Ecene 8anager
)i## (e a#ered o a##o) for hese prefa(s. !#icking Or8an6se r447 4ADe<3s )i## no) see o i
ha he Ba<=8r4un2Ca7era prefa( is creaed auo%aica##y' and Ba<=8r4un2I7a8e appears as
an avai#a(#e prefa( in he ne) Se3 8e47e3r? pane#.
* is re>uired ha he 8ain!a%era and he 7ackground!a%era have he correc Cull6n8 Mas=s.
:irs' ensure ha he 7ackground*%age #ayer has (een defined in he Tags %anager Cas descri(ed
in secion 1.1D. Then' find he 8ain!a%era,s !u##ing 8ask' and uncheck his #ayer' causing he
popup (o- o appear as F8i-ed ...G. :ina##y' find he 7ackground!a%era' and se he !u##ing
8ask o nohing (u he 7ackground*%age #ayer.
7ackground i%ages are assigned o heir o)n 7ackground*%age prefa( via he TeF3ure fie#d in
he UITeF3ure inspecor. * is hese 7ackground*%age prefa(s ha are assigned o he
5a%e!a%era25+s. 3hen a 5a%e!a%era25+ has (een assigned a 7ackground*%age prefa(' a
(uon #a(e##ed Se3 as a<36ve appears in i,s inspecor. !#icking his a#ers he prefa(,s #ayer' as
)e## as parens he 8ain!a%era' so ha you can have a #ive previe) of he scene & )ih
(ackground & )ihin he 5a%e )indo). The 8ain!a%era )i## (e auo%aica##y un1parened
)hen he ga%e (egins.
* %ay (e necessary o on#y sho) cerain 5a%e/(Aecs )hen a paricu#ar ca%era is acive.
Ei%p#y add he '6763#6s6Al63? scrip co%ponen o an o(Aec' and you can #i%i i,s vis(i#iy (y
ca%era. This )orks for (oh %esh o(Aecs and $niy spries.
&.0 - INTERACTIONS
&.1 - INTRODUCTION
The core of any advenure ga%e invo#ves ineracing )ih he ga%e )or#d (y c#icking on o(Aecs
and characers. *n Advenure !reaor' you #ay do)n ?ospos' )hich in urn run ineracions
)hen c#icked on.
?ospos shine one a a i%e as he cursor hovers over he%' (u if you define an *npu a-is ca##ed
)las>H43sB43s' you can use i o (rief#y i##u%inae a## hospos on he screen during ga%ep#ay.
?ospos and ineracions are deai#ed in he secions ha fo##o)' (u firs i is i%poran o
choose your ga%e,s In3era<364n 7e3>42' as his )i## affec your ?ospos, inspecors and !ursor
8anager.
The *neracion %ehod is se )ihin he Eeings 8anager' underneah In3erCa<e se336n8s' and
can (e se o he fo##o)ing9 C4n3eF3 Sens636ve' C>44se In3era<364n T>en H43sB43' and C>44se
H43sB43 T>en In3era<364n
C4n3eF3 Sens636ve is he defau# *neracion %ehod' and a##o) ?ospos o have sing#e $se and
=-a%ine ineracions' as )e## as %u#ip#e *nvenory ineracions. 3hen p#aying a ga%e' you
acivae hospos (y hovering over he%' and eiher #ef1c#ick o run he $se ineracion' or righ1
c#ick o run he =-a%ine ineracion.
3hen you creae a $se ineracion' you can opiona##y supp#y an icon o disp#ay )hen he %ouse
hovers over i' o give he p#ayer a sense of )ha heir c#icking )i## resu# in & for e-a%p#e' you
can se a Fa#kG icon o disp#ay )hen he p#ayer hovers heir cursor over an 4<!. The !ursor
8anager is used o define hese icons & you can add' re%ove and se e-ures' as )e## as choose
)hich icon serves as he =-a%ine icon )hen no $se ineracion is avai#a(#e. The !ursor
8anager is a#so used o define he defau# cursor' an opiona# F3aiG cursor' as )e## as sore a
fe) oher cursor1re#aed seings.
*cons can a#so (e ani%aed' (y supp#ying a e-ure )ih %u#ip#e Ffra%esG arranged hori6ona##y.
The C>44se In3era<364n T>en H43sB43 %ehod a##o)s a hospo o have %u#ip#e $se
ineracions' (u no =-a%ine ineracions. The p#ayer firs chooses a cursor F%odeG (ased on he
icons defined in he !ursor 8anager' and hen c#icks on a ?ospo. The ?ospo )i## hen run i,s
defined $se ineracion )ih an associaed icon ha %aches he cursor. To change he cursor
%ode' he p#ayer can eiher righ1c#ick o cyc#e hrough avai#a(#e icons' or se#ec one via a #is in
a 8enu Csee secion 10.1 for %ore on 8enusD. This a##o)s for an inerface si%i#ar o hose used
in ear#y 90s Eierra ga%es' such as Jings Rues @. *f he p#ayer uses a ?ospo in a )ay ha is
no defined' a fa##(ack Funhand#edG ineracion can (e se in he !ursor 8anager.
The C>44se H43sB43 T>en In3era<364n %ehod is si%i#ar o he previous' on#y an ineracion is
chosen fro% a #is of avai#a(#e ypes once he ?ospo has firs (een se#eced. !#icking on a
?ospo causes a 8enu o appear' on )hich he avai#a(#e ineracions are avai#a(#e o choose
fro%. *nvenory ie%s can a#so (e se#eced in his )ay. Euch a 8enu %us have an Appear Type
of On In3era<364n 1 see he +e%o 8anager,s *neracion 8enu for an e-a%p#e of ho) o se his
up. 3ih his %ehod' *nvenory ie%s can a#so have %u#ip#e ineracions associaed )ih he%.
3hen he *neracion %ehod is se o C>44se H43sB43 T>en In3era<364n' you are a#so given he
opion for *nvenory ineracions o eiher (ehave in he sa%e )ay Cha is' define %u#ip#e
ineracions per ie% ha he p#ayer chooses fro%D' or o ac as hey do )hen he %ehod is se o
C4n3eF3Sens636ve. This opion is a#so given o ?ospos ha on#y have a sing#e F$seG
*neracion defined.
The )ay in )hich ?ospos are deeced can a#so (e %odified' via he H43sB43 2e3e<364n
7e3>42 fie#d in he Eeings 8anager. 7y defau#' his is se o M4use Over' )hich uses he
cursor,s posiion o high#igh ?ospos underneah i. This can (e changed o Pla?er #6<6n63?'
)hich causes a ?ospo o (e high#ighed )hen i eners a Trigger vo#u%e aached o he p#ayer.
!o%(ined )ih a 8ove%en %ehod of +irec' and an *npu %ehod of Jey(oard or !onro##er'
i is possi(#e o %ake a ga%e )ih si%i#ar conro#s o 5ri% :andango.
*f he H43sB43 2e3e<364n 7e3>42 is se o Pla?er #6<6n63? and he InBu3 7e3>42 is se o eiher
D6re<3 or )6rs3 Pers4n' hen you can addiiona##y se he H43sB43s 6n v6<6n63? seing' )hich
deer%ines if he se#eced ?ospo is si%p#y he one c#oses o he <#ayer' or if he <#ayer can
cyc#e hrough %u#ip#e ?ospos in he viciniy. *f he #aer is chosen' he *npu a-es
C?<leH43sB43s'eC3 and C?<leH43sB43sR68>3 %us a#so (e dec#ared.
To creae a <#ayer @iciniy rigger o(Aec' add an e%py 5a%e/(Aec o your <#ayer prefa( as a
chi#d o(Aec. Beave i unagged' and %ove i o he I8n4re Ra?<as3 #ayer. Then add he SB>ere
C4ll62er Cor a C6r<le C4ll62er "D if your ga%e is in $niy 2+ %odeD and De3e<3 H43sB43s
co%ponens' and posiion he sphere co##ider such ha i,s cenre is s#igh#y in fron of he p#ayer'
and radius e-ends a fe) fee ou)ard. Then check he Is Tr688erG check(o-' and re1app#y he
prefa(.
The de%o p#ayer characer' Tin <o' conains such a rigger for e-a%inaion. * can (e found in
Asses ; Advenure !reaor ; +e%o ; 2esources.
&." - ACTIONS AND ACTION'ISTS
Acions are a he core of any ineracion in Advenure !reaor. They are singu#ar evens' each
perfor%ing a specific ask' such as giving he <#ayer an *nvenory ie%' and %aking an 4<! a#k.
AcionBiss are chains of Acions. =very i%e he p#ayer c#icks on a ?ospo in he scene' )a#ks
hrough a Trigger %esh' (egins a !uscene' or c#icks on a dia#ogue opion in a !onversaion' an
AcionBis is run.
Eo%e Acions ac as #ogic gaes' a##o)ing differen Acions or AcionBiss o (e run
condiiona##y. :or e-a%p#e' )hen he p#ayer ries o (uy so%ehing fro% a shop' )e can use he
Inven34r?: C>e<= Acion o deer%ine if hey have enough %oney.
The Acions avai#a(#e o you during deve#op%en can (e %odified (y using he Acions 8anager.
The sandard acions avai#a(#e are9
Ca7era: Cr4ssCa2e
!rossfades he ca%era fro% i,s curren 5a%e!a%era o a ne) one' over a specified i%e.
Ca7era: )a2e
:ades he ca%era in or ou. The fade speed can (e adAused' and he ga%e can opiona##y
pause uni# i finishes. The fade co#our is se in he 8ain!a%era prefa(.
Ca7era: S>a=e
!auses he ca%era o shake' giving an earh>uake screen effec. The %ehod of shaking'
i.e. %oving or roaing' depends on he ype of ca%era he 8ain !a%era is #inked o.
Ca7era: SBl63-s<reen
+isp#ays )o ca%eras on he screen a once' arranged eiher hori6ona##y or verica##y.
3hich ca%era is he F%ainG Ci.e. )hich one responds o %ouse c#icksD can a#so (e se.
Ca7era: S963<>
8oves he 8ain!a%era o he posiion' roaion and fie#d of vie) of a specified
5a%e!a%era. !an (e insananeous or ransiion over i%e.
C>ara<3er: An67a3e
Affecs a !haracer,s ani%aion. !an p#ay or sop a cuso% ani%aion' change a sandard
ani%aion Cid#e' )a#k or runD' change a foosep sound' or rever he !haracer o id#e.
C>ara<3er: C>an8e ren2er6n8
/verrides a !haracer,s sca#e' soring order or sprie direcion. This is inended %ain#y
for 2+ ga%es.
C>ara<3er: )a<e 26re<364n
8akes a !haracer urn' eiher insan#y or over i%e' o face a direcion re#aive o he
ca%era & i.e. up' do)n' #ef or righ.
C>ara<3er: )a<e 4ADe<3
8akes a !haracer urn' eiher insan#y or over i%e. !an urn o face anoher o(Aec' or
copy ha o(Aec,s facing direcion.
C>ara<3er: H4l2 4ADe<3
<arens a 5a%e/(Aec o a !haracer,s hand ransfor%' as chosen in he !haracer,s
inspecor. The #oca# ransfor%s of he 5a%e/(Aec )i## (e c#eared. 4oe ha his acion
on#y )orks )ih 3+ characers.
C>ara<3er: M4ve al4n8 Ba3>
8oves he !haracer a#ong a pre1deer%ined pah. 3i## adhere o he speed seing
se#eced in he re#evan <ahs o(Aec. !an a#so (e used o sop a characer fro% %oving.
C>ara<3er: M4ve 34 B46n3
8oves a characer o a given 8arker o(Aec. 7y defau#' he characer )i## ae%p o
pahfind heir )ay o he %arker' (u can opiona##y Aus %ove in a sraigh #ine.
C>ara<3er: NPC )4ll49
8akes an 4<! fo##o) anoher !haracer' )heher i (e a fe##o) 4<! or he <#ayer. *f
hey e-ceed a %a-i%u% disance fro% heir arge' hey )i## run o)ards he%. 4oe ha
%aking an 4<! %ove via anoher Acion )i## %ake he% sop fo##o)ing anyone.
C>ara<3er: Rena7e
!hanges he disp#ay na%e of a !haracer )hen su(i#es are used.
C>ara<3er: S963<> B4r3ra63
!hanges he FspeakingG graphic used (y !haracers. To disp#ay his graphic in a 8enu'
p#ace a Ba(e# of ype +ia#ogue <orrai in a 8enu of Appear ype9 3hen Epeech <#ays. *f
he ne) graphic is p#aced in a 2esources fo#der' i )i## (e sored in saved ga%e fi#es.
C4n3a6ner: A22 4r re74ve
Adds or re%oves *nvenory ie%s fro% a !onainer.
C4n3a6ner: C>e<=
Rueries he conens of a !onainer for a sored *e%' and reacs according#y.
C4n3a6ner: OBen
/pens a chosen !onainer' causing any 8enu of Appear ype9 /n !onainer o open. To
c#ose he !onainer' si%p#y c#ose he 8enu.
D6al48ue: Pla? sBee<>
8akes a !haracer a#k' or & if no !haracer is specified & disp#ays a %essage. Eu(i#es
on#y appear if hey are ena(#ed fro% he /pions %enu.
D6al48ue: S3ar3 <4nversa364n
=ners !onversaion %ode' and disp#ays he avai#a(#e dia#ogue opions in a specified
conversaion. 3i## end he curren#y1running AcionBis.
D6al48ue: S34B sBee<>
=nds any curren#y1p#aying speech insan#y.
D6al48ue: T488le 4B364n
Ees he disp#ay of a dia#ogue opion. !an hide' sho)' and #ock opions.
En86ne: C>an8e s<ene
8oves he <#ayer o a ne) scene. The scene %us (e #ised in $niy,s 7ui#d Eeings.
En86ne: C>an8e s<ene se336n8
!hanges any of he fo##o)ing scene para%eers9 4av8esh' +efau# <#ayerEar' Eoring
8ap' !uscene /n Boad' and !uscene /n Ear. 3hen he 4av8esh is a <o#ygon
!o##ider' his Acion can a#so (e used o add or re%ove ho#es fro% i.
En86ne: C>an8e 367es<ale
!hanges he i%esca#e o a va#ue (e)een 0 and 1. This a##o)s for s#o)1%oion effecs.
En86ne: C>e<= s<ene
Rueries eiher he curren scene' or he #as one visied.
En86ne: En2 8a7e
=nds he curren ga%e' eiher (y #oading an auosave' resaring or >uiing he ga%e
e-ecua(#e.
En86ne: Mana8e s?s3e7s
=na(#es and disa(#es individua# syse%s )ihin Advenure !reaor' such as *neracions.
!an a#so (e used o change he F8ove%en %ehodG' as se in he Eeings 8anager' (u
noe ha his change )i## no (e recorded in save ga%es.
En86ne: Pause 8a7e
3ais a se i%e (efore coninuing.
En86ne: Pla? S4un2
Triggers a Eound o(Aec o sar p#aying. !an (e used o fade sounds in or ou.
En86ne: Run A<364n'6s3
2uns any AcionBis Ceiher scene1(ased #ike !uscenes' Triggers and *neracions' or
AcionBis assesD. !an opiona##y run he ne) #is concurren#y.
H43sB43: C>an8e 6n3era<364n
=na(#es and disa(#es individua# *neracions on a ?ospo.
H43sB43: Rena7e
2ena%es a ?ospo' or an 4<! )ih a ?ospo co%ponen.
InBu3: C>e<=
!hecks o see if he <#ayer is pressing a (uon or a-is as defined in $niy,s *npu
8anager a he i%e i is run. 2un his coninuous#y (y #ooping i ono ise#f o creae
RT=s and oher se>uences ha re>uire a specific key o (e pressed o coninue ga%ep#ay.
Inven34r?: A22 4r re74ve
Adds or re%oves an ie% fro% he <#ayer,s invenory. *e%s are defined in he *nvenory
8anager. *f he p#ayer can carry %u#ip#e a%ouns of he ie%' %ore opions )i## sho).
Inven34r?: C>e<=
Rueries )heher or no he p#ayer is carrying an ie%. *f he p#ayer can carry %u#ip#e
a%ouns of he ie%' %ore opions )i## sho).
Inven34r?: CraC36n8
=iher c#ears he curren arrange%en of crafing ingrediens' or eva#uaes he% o creae
an appropriae resu# Cif his is no done auo%aica##y (y he recipe ise#fD.
Inven34r?: Sele<3
Ee#ecs a chosen invenory ie%' as hough he p#ayer c#icked on i in he *nvenory %enu.
3i## opiona##y add he specified ie% o he invenory if i is no curren#y he#d.
Menu: C>an8e s3a3e
<rovides various opions o sho) and hide (oh %enus and %enu e#e%ens.
Menu: C>e<= s3a3e
Rueries he visi(i#iy of %enu e#e%ens' and he ena(#ed or #ocked sae of %enus.
M4veaAle: C>e<= 3ra<= B4s6364n
Rueries ho) far a +ragga(#e o(Aec is a#ong i,s rack.
M4veaAle: M4ve al4n8 3ra<=
8oves a +ragga(#e o(Aec a#ong i,s rack auo%aica##y o a specific poin. The effec
)i## (e disa(#ed once he o(Aec reaches he inended poin' or he Acion is run again )ih
he speed va#ue se as a negaive nu%(er.
OADe<3: A22 4r re74ve
*nsaniaes or de#ees 5a%e/(Aecs )ihin he curren scene. To ensure his )orks )ih
save ga%es correc#y' p#ace any prefa(s o (e added in a 2esources asse fo#der.
OADe<3: An67a3e
!auses a 5a%e/(Aec o p#ay or sop an ani%aion' or %odify a 7#end Ehape. The
avai#a(#e opions )i## differ depending on he chosen ani%aion engine.
OADe<3: C>e<= Bresen<e
$se o deer%ine if a paricu#ar 5a%e/(Aec or prefa( is presen in he curren scene.
OADe<3: H68>l68>3
5ives a g#o) effec o any %esh o(Aec )ih he ?igh#igh scrip co%ponen aached o i.
!an a#so (e used o %ake *nvenory ie%s g#o)' %aking i usefu# for uoria# secions.
OADe<3: Sen2 7essa8e
Eends a given %essage o a 5a%e/(Aec. !an (e eiher a %essage co%%on#y1used (y
Advenure !reaor C*nerac' Turn/n' ecD or a cuso% one' )ih an ineger argu%en.
OADe<3: Se3 Baren3
<aren one 5a%e/(Aec o anoher. !an a#so se he chi#d,s #oca# posiion and roaion.
OADe<3: TeleB4r3
8oves a 5a%e/(Aec o a 8arker insan#y. !an a#so copy he 8arker,s roaion. The
fina# posiion can opiona##y (e %ade re#aive o he acive ca%era' or he p#ayer. :or
e-a%p#e' if he 8arker,s posiion is C0' 0' 1D and P4s634n rela36ve 34 is se o Rela36ve T4
A<36ve Ca7era' hen he o(Aec )i## (e e#epored in fron of he ca%era.
OADe<3: TransC4r7
Transfor%s a 5a%e/(Aec over i%e' (y or o a given a%oun' or o)ards a 8arker in he
scene. The 5a%e/(Aec %us have a Moveable scrip aached.
OADe<3: #6s6A6l63?
?ides or sho)s a 5a%e/(Aec. !an opiona##y affec he 5a%e/(Aec,s chi#dren.
Pla?er: C>e<=
Rueries )hich <#ayer prefa( is curren#y (eing conro##ed. This on#y app#ies o ga%es for
)hich <#ayer s)iching has (een a##o)ed in he Eeings 8anager.
Pla?er: C4ns3ra6n
Bocks and un#ocks various aspecs of <#ayer conro#. 3hen using +irec or :irs <erson
conro#' can a#so (e used o specify a <ah o(Aec o resric %ove%en o.
Pla?er: S963<>
E)aps ou he <#ayer prefa( %id1ga%e. *f he ne) prefa( has (een used (efore' you can
resore ha prefa(,s posiion daa & oher)ise you can se he posiion or scene of he ne)
p#ayer. This Acion on#y app#ies o ga%es for )hich <#ayer s)iching has (een a##o)ed in
he Eeings 8anager.
T>6r2-Par3?: Pla?Ma=er
!a##s a specified =ven )ihin a <#ay8aker :E8. 4oe ha <#ay8aker is a separae
$niy Asse' and he <#ay8aker*s<resen preprocessor %us (e defined for his o )ork.
#ar6aAle: C>e<=
Rueries he va#ue of (oh 5#o(a# and Boca# @aria(#es dec#ared in he @aria(#es 8anager.
@aria(#es can (e co%pared )ih a fi-ed va#ue' or )ih he va#ues of oher @aria(#es.
#ar6aAle: C>e<= ran247 nu7Aer
<icks a nu%(er a rando% (e)een 6ero and a specified ineger & he va#ue of )hich
deer%ine )hich su(se>uen Acion is run ne-.
#ar6aAle: Se3
Ees he va#ue of (oh 5#o(a# and Boca# @aria(#es' as dec#ared in he @aria(#es 8anager.
*negers can (e se o a(so#ue' incre%ened or assigned a rando% va#ue. Erings can a#so
(e se o he va#ue of a 8enu*npu e#e%en Csee secion 10.2D' )hi#e *negers' 7oo#eans
and :#oas can a#so (e se o he va#ue of a 8ecani% para%eer. 3hen seing *negers
and :#oas' you can a#so op o ype in a foru%#a Ce.g. 2 P 3 S4D' )hich can a#so inc#ude
okens of he for% Tvar9*+U o denoe he va#ue of a @aria(#e' )here *+ is he uni>ue
nu%(er given o a @aria(#e in he @aria(#es 8anager. 4oe ha foru%#as do no curren#y
)ork on he 3indo)s <hone 8 p#afor%.
8os Acions have an AC3er runn6n8 fie#d. 3ih his' you can choose )ha happens afer an
Acion has (een perfor%ed. 0ou can use his o sop he AcionBis' skip o anoher Acion
)ihin ha AcionBis' or run a differen !uscene. 4oe ha if a !uscene is run' he AcionBis
fro% )hich i )as ca##ed fro% )i## cease.
Acions can (e de#eed' copied' re1arranged' disa(#ed and %ore via a cone- %enu accessed via
he op1righ (uon on each Acion inspecor. A Fnode #ayouG )indo) of any AcionBis can (e
disp#ayed (y c#icking he A<364n'6s3 E2634r (uon a he op of he *nspecor. This )indo) is
designed o he#p %ake co%p#e- AcionBiss easier o fo##o)9 Acions appear as nodes' )hich you
can re1arrange and re1connec o one anoher (y dragging F)iresG fro% oupu sockes on he
righ o inpu sockes on he #ef. 0ou can se#ec %u#ip#e Acions a a i%e (y dragging a (o-
around he%' and %anipu#ae he% in (u#k (y righ1c#icking on e%py space.
:or coders' an AcionBis Cand (y e-ension' a Cutscene' Interaction' Trigger and
DialogueOption scripD is run (y ca##ing is *nerac funcion. The fo##o)ing secions )i##
descri(e he various )ays in )hich AcionBiss are used.
&.3 - HOTSPOTS
?ospos are used o creae )ays for he p#ayer o inerac )ih he scene. 3e can posiion and
sca#e H43sB43 prefa(s over geo%ery' and define *neracion for he% ha run )hen c#icked on.
?ospos need o (e on he DeCaul3 #ayer o (e recognised (y he conro# scrips.
To creae a ?ospo' open he Ecene 8anager and c#ick H43sB43 under he Bogic pane#' fo##o)ed
(y A22 ne9. A ye##o) cu(e )i## appear a he scene origin' %arking he region ha he %ouse
cursor %us hover over in order o se#ec i. The na%e of he ?ospo is )ha )i## appear as he
#a(e# )hen se#eced' (u you can override his )ih he 'aAel .6C n43 4ADe<3 na7e/ fie#d in he
H43sB43 inspecor & his is usefu# for differeniaing %u#ip#e hospos )ih he sa%e #a(e# & an
e-a%p#e (eing he )o 7arre# ?ospos in he de%o.
Transfor% he ?ospo uni# i is in a sensi(#e p#ace & ypica##y covering a piece of se geo%ery
ha you )an he p#ayer o inerac )ih. *f here is such a piece of se geo%ery' you can %ake
ha o(Aec g#o) )hen he ?ospo is se#eced (y adding a H68>l68>3 scrip o i' and hen
referring o i fro% he ?ospo,s OADe<3 34 >68>l68>3 fie#d in he ?ospo inspecor. The
?igh#igh scrip )i## a#so affec 5$*Te-ure co%ponens aached o he sa%e 5a%e/(Aec. *f
you )ish o i%p#e%en a cuso% high#igh' raher han he defau# (righening effec' you can
disa(#e he effec and ca## he ?igh#igh scrip,s e3H68>l68>3In3ens63? funcion in a cuso%
scrip.
3ihin he ?ospo,s inspecor' you can define i,s associaed ineracions (y using he pane#s a
he (oo%. !#ick he I icon in he Use 6n3era<364n pane#' and a ne) ineracion s#o )i## (e
creaed' as sho)n (y he pane# ha appears underneah. The $se ineracion is ca##ed )hen he
p#ayer #ef1c#icks on he ?ospo )ih he %ouse Cor presses he *neracionMA inpu )hen using
he Jey(oard /r !onro##er inpu %ehodD. $n#ess your In3era<364n 7e3>42 Csee secion 5.1D is
se o !one- Eensiive' you can define %u#ip#e $se ineracions.
The In3era<364n fie#d is a reference o he *neracion AcionBis ha )i## run )hen he p#ayer
FusesG he hospo. 0ou can creae an *neracion o(Aec fro% he Ecene 8anager' (u i is easier
o c#ick Au34-<rea3e o he righ of he *neracion fie#d. +oing so )i## creae' rena%e' and #ink a
ne) *neracion o(Aec )ihin he scene' )hich you can hen se#ec and %odify o define )ha
happens )hen he *neracion runs.
This ne) *neracion o(Aec is an AcionBis. /ne Acion )i## have (een creaed auo%aica##y &
he defau# Acion as defined in he Acions 8anager. 0ou can change his Acion' %odify i,s
seings' and add' re%ove and re1arrange oher Acions.
7ack o he ?ospo inspecor9 he I<4n fie#d in he Use 6n3era<364n pane# #es you o choose he
disp#ay icon ha he cursor changes o )hen se#eced' provided he Eeings 8anager a##o)s for
cursor changes. !ursor seings are kep in he Eeings 8anager.
The Pla?er a<364n fie#d dicaes )ha he <#ayer characer does (efore his ineracion is run' e.g.
urn o face he hospo' or )a#k o)ards i. The <#ayer can (e %ade o )a#k o a specific 8arker
if his is se o $al= T4 Mar=er' (u a Mar=er o(Aec %us a#so (e defined' furher up in he
?ospo inspecor. 0ou can creae a ne) 8arker fro% he 4avigaion pane# in he Ecene
8anager.
*f he *neracion %ehod is se o !one- Eensiive' you can a#so define an =-a%ine ineracion'
)hich runs )hen he p#ayer righ1c#icks. 0ou can a#so have %u#ip#e *nvenory ineracions' )ih
each *nvenory ineracion hand#ing he use of one ype of ie% on he o(Aec.
3hen you creae an *nvenory ineracion' a drop1do)n (o- )i## appear in he pane# )here you
can choose )hich invenory ie% is associaed )ih i. *f you )an o creae a defau# response
Ci.e. F* can, use ha here"GD o using an invenory ie% on a hospo )ihou creaing he sa%e
ineracion %u#ip#e i%es' you can define an Un>an2le2 even3 in he *nvenory 8anager. This
is descri(ed furher in secion 6.0.
?ospos can (e urned on and off using he OADe<3: Sen2 7essa8e Acion. A ?ospo is
dec#ared FonG on#y if i is on he +efau# #ayer.
he H43sB43 ra? len83>' )hich you can adAus inside he Eeings 8anager.
&.% - CUTSCENES
A Cu3s<ene is an AcionBis o(Aec ha is run )hen an Acion riggers i. They are creaed (y
c#icking he Cu3s<ene (uon under he Ecene 8anager,s Bogic pane#' fo##o)ed (y A22 ne9.
!uscene o(Aecs are invisi(#e and canno (e ineraced )ih direc#y (y he p#ayer & heir
posiion is uni%poran.
!uscenes can (e used o %ake cine%aics in your ga%e' change o(Aecs or varia(#es
insananeous#y' and run oher !uscenes condiiona##y.
:or e-a%p#e' he de%o scene feaures a cuscene ca##ed /nEar' )hich is run )hen he scene is
sared. This cuscene si%p#y checks he sae of he varia(#e Pla?e2 6n3r4' and acs according#y.
*f he (oo#ean is rue' i p#ays he opening cine%aic9 he !uscene na%ed *nro1. *f i is fa#se' i
%oves 7rain ono he chair and p#ays /nBoad' )hich ses up he roo% o i,s pos1inroducion
sae Cknocking over he canvas' for e-a%p#eD. This is usefu# for de(ugging & (y changing he
sae of Pla?e2 6n3r4 )ihin he @aria(#es 8anager' you can eiher )ach he opening cuscene or
skip o he %ain secion of ga%ep#ay.
4ear#y a## Acions can ca## !uscenes afer running. The Ecene 8anager conains hree furher
!uscene fie#ds9 /n s3ar3' On l4a2' and On var6aAle <>an8e. On s3ar3 is run )hen he scene
(egins & )heher (y enering fro% anoher scene' or (y saring he ga%e fro% ha scene. On
l4a2 is run )hen a scene is #oaded hanks o a #oaded saved1ga%e' regard#ess of )heher or no
he p#ayer )as in ha scene )hen he saved1ga%e )as #oaded. On var6aAle <>an8e is run
)henever a @aria(#e Cas defined in he @aria(#es 8anagerD has (een a#ered. 4oe ha his
!uscene )i## on#y run once he AcionBis ha conained he varia(#e change has co%p#eed.
!uscenes' #ike *neracions and Triggers' )i## pause ga%ep#ay (y defau# )hen hey run. *f you
)ish o %ake a paricu#ar AcionBis run during ga%ep#ay insead' si%p#y choose Run In
Ba<=8r4un2 in he $>en runn6n8 pop1up (o-.
The !uscene inspecor a#so feaures )o %ore fie#ds ha separae i fro% he *neracion and
Trigger inspecors9 S3ar3 2ela? and Au34-save aC3er runn6n8. The #aer )i## creae a saved
ga%e afer i is run & see secion 8.3. The S3ar3 2ela? deer%ines he i%e Cin secondsD ha he
!uscene )i## )ai (efore running i,s Acions. *f a (6ll %essage is sen o a de#ayed !uscene
Cusing he OADe<3: Sen2 7essa8e AcionD' he cuscene )i## no run )hen he i%e runs ou.
This feaure can (e used o creae i%ed se>uences in your ga%e.
&.& - S(IPPIN CUTSCENES
!uscenes & and a## scene1(ased AcionBiss & can (e se o (e skippa(#e (y he p#ayer. 3hen
%ade so' he p#ayer can skip he AcionBis (y pressing he En2Cu3s<ene inpu (uon' as
defined (y he *npu 8anager.
Ekipping an AcionBis si## causes any ga%e #ogic o e-ecue9 @aria(#es )i## si## (e changed'
*nvenory ie%s )i## si## (e added or re%oved' and o(Aecs )i## si## (e %oved o heir e-peced
FendG posiion. ?o)ever' addiiona# )ork %ay (e re>uired if your AcionBis invo#ves p#aying
non1Begacy ani%aions.
7ecause so%e ani%aions %ay (e inended o coninue p#aying once he Acion finishes & or
coninue o anoher :E8 sae in 8ecani%' hey %us si## (e p#ayed )hen an AcionBis is
skipped. Therefore' i is necessary o end your AcionBis )ih Acions ha p#ace your o(Aecs
and !haracers in heir correc ani%aion sae. :or insance' if he <#ayer )aves during a
!uscene (efore reurning o *d#e' you shou#d end your AcionBis )ih an addiona# C>ara<3er:
An67a3e Acion ha specficia##y reurns he <#ayer o he *d#e ani%aion' even if his happens
naura##y )hen he AcionBis p#ays nor%a##y.
The 2+ +e%o,s <ark scene conains e-a%p#es of his necessiy9 he F*nro2G !uscene ends (y
p#aying he 7ird?ide ani%aion on he 7ird 4<!' even hough his ani%aion is p#ayed (y he
:E8 )hen he !uscene p#ays uninerruped.
4oe ha hese addiiona# seps are unnecessary for Begacy ani%aion Acions9 hey )i## (e
skipped as e-peced.
&.* - TRIERS
A Tr688er is an AcionBis ha runs )hen an o(Aec passes hrough i. 7y defau#' i )i## on#y
respond o he <#ayer' (u i can (e se o reac o differen o(Aecs' or o(Aecs )ih a specific
co%ponen' insead. Ei%i#ar o he ?ospo prefa(' a Trigger %us (e posiioned in he Ecene
vie) appropriae#y. Triggers can (e creaed using he Ecene 8anager underneah he Bogic
pane#.
The Trigger inspecor conains a T?Be fie#d. This is used o %ake he Trigger run eiher
)henever he o(Aec is inside i CC4n36nu4usD' )hen he o(Aec eners i for he firs i%e COn
en3erD' or )hen he o(Aec e-is i,s space COn eF63D. The !oninuous opion is genera##y he
%ore re#ia(#e.
The 3+ de%o %akes use of Triggers o affec he ca%era as he <#ayer navigaes he scene. The
defau# ga%ep#ay ca%era is 4av!a%1' (u )hen he <#ayer heads o he far end of he roo%' a
Trigger o(Aec changes he ca%era o 4av!a%2.
Triggers can (e urned on and off using he OADe<3: Sen2 7essa8e Acion. A Trigger urns ise#f
off (y disa(#ing i,s !o##ider co%ponen.
A %ore advanced feaure of Triggers is ha he 5a%e/(Aec i deecs can (e passed o i,s #is of
Acions as a para%eer. :or %ore on AcionBis para%eers' see secion 5.12.
&.+ - CON#ERSATIONS
A C4nversa364n o(Aec #es he p#ayer choose fro% a #is of on1screen dia#ogue opions' )hich
)hen co%(ined a##o) he% o converse )ih an 4<!. They are sared (y using he D6al48ue:
S3ar3 <4nversa364n Acion. =ven if no 4<! is presen' hey can si## (e used o provide he
p#ayer )ih a choice of )ords.
0ou can creae a ne) conversaion (y c#icking C4nversa364n under he Ecene 8anager,s Bogic
pane#' fo##o)ed (y A22 ne9. Bike !uscene o(Aecs' a !onversaion o(Aec is never physica##y
seen (y he p#ayer' so i,s posiion is irre#evan.
Ei%i#ar o ho) a ?ospo defines fie#ds for %u#ip#e *neracion o(Aecs' a !onversaion %anages
fie#ds for %u#ip#e D6al48ue OB364n o(Aecs. As you creae +ia#ogue /pions' you can give each
one a 'aAel Che e- ha appears on screenD' se i,s iniia# EnaAle2 sae' and choose )heher or
no i )i## reurn o he conversaion Cha is' disp#ay he avai#a(#e opions once againD once i has
run. +ia#ogue /pions )i## no appear o he p#ayer un#ess hey are ena(#ed. 0ou can creae
+ia#ogue /pions eiher fro% he Ecene 8anager' or (y c#icking FAuo1creaeG in he
!onversaion inspecor.
3hen a +ia#ogue /pion has run' you can choose )ha happens ne-9 eiher o sop running ha
!onversaion' reurn o he #is of opions' or o run a ne) !onversaion. 0ou can se his )ihin
he !onversaion *nspecor' using he $>en C6n6s>e2 popup.
+ia#ogue /pions can (e ena(#ed and disa(#ed using he C4nversa364n: T488le 4B364n Acion.
This is usefu# for prevening he p#ayer fro% saying he sa%e hing )ice. /pions can a#so (e
#ocked' o ignore fuure ca##s o (e urned on or off.
Eo%ei%es' a p#ayer %ay on#y (e faced )ih one dia#ogue opion & )hen his happens' his
opion can (e p#ayed auo%aica##y. To do his' Aus check he Au34-Bla? l4ne 4B364n check(o-
a he op of he !onversaion inspecor.
!onversaions can a#so (e i%ed' si%i#ar o hose in Te##a#e,s The 3a#king +ead ga%e. *f you
check he Is 367e2G check(o- a he op of he !onversaion inspecor' you can specify he
#engh of i%e ha he conversaion )i## disp#ay. 0ou %us a#so se#ec a defau# +ia#ogue /pion
o run )hen he i%er runs ou. *f a defau# opion is no chosen' he conversaion )i## end )hen
he i%er runs ou.
0ou can a#so open a usefu# C4nversa364n E2634r fro% he op of he !onversaion *nspecor.
:ro% here' you can vie) a## assigned +ia#ogue /pions ha he se#eced !onversaion has' and
c#ick on he% o disp#ay heir AcionBiss in he *nspecor )indo). *f you se#ec a ne)
!onversaion o(Aec' you can >uick#y rever (ack o he previous one fro% he op1#ef of he
)indo).
&.8 - ACTION'IST ASSETS
3ihin a given scene' )e can p#ace !uscenes' Triggers' *neracions and +ia#ogue /pions 1
each of )hich are AcionBiss ha can %anipu#ae o(Aecs )ihin ha scene. 7u so%ei%es'
)e,## )an an AcionBis o run no %aer )hich scene is curren#y #oaded 1 for e-a%p#e' )hen
e-a%ining an *nvenory ie%. And )hen )orking as a ea% on a #arge ga%e' )e %ay a#so )an
o (e a(#e o creae AcionBiss for a scene )ihou inerfering )ih anyone e#se,s )ork.
3ih Advenure !reaor' )e can creae an A<364n'6s3 asse3' )hich is an AcionBis ha e-iss as
a physica# fi#e )ihin your proAec fo#der. This asse is creaed (y righ1c#icking inside he <roAec
)indo)' and choosing !reae 1Q Advenure !reaor 1Q AcionBis.
AcionBis asses are %ain#y used for *nvenory ineracions' and 8enu funcions. :or e-a%p#e'
he +e%o ga%e,s <ause %enu Cas found in he +e%oM8enu8anager asseD runs he
L+ese#ec*nvenoryL AcionBis )hen i urns on. This AcionBis de1se#ecs any acive *nvenory
ie%' %aking sure he %ain cursor is a#)ays disp#ayed )hen navigaing he <ause %enu.
AcionBis asses can a#so %anipu#ae scene o(Aecs. 3hen dragging an o(Aec ono a asse,s
fie#d' a F!onsan *+G nu%(er )i## appear (eneah i. A C4ns3an3 ID nu%(er acs as a uni>ue
reference o he o(Aec' so ha i can si## (e found (y he asse )hen anoher scene is open. *f a
5a%e/(Aec has no !onsan *+ )hen i is assigned o an AcionBis asse,s fie#d' one )i## (e
generaed auo%aica##y (y giving ise#f a ConstantID scrip. *f he 5a%e/(Aec is no curren#y
visi(#e o he fie#d Ce.g. (ecause anoher scene is openD' he Sear<> s<enes (uon underneah he
fie#d can (e used o search a## scenes #ised in he ga%e,s 7ui#d Eeings for he o(Aec in
>uesion.
3hen a 5a%e/(Aec has a ConstantID scrip' i,s *+ nu%(er can (e %anua##y se. *f you )ish
for an asse1(ased Acion o %anipu#ae difference o(Aecs in differen scenes' you can assign he
sa%e *+ nu%(er o each o(Aec o ensure ha he Acion )i## a#)ays (e carried ou.
AcionBis asses can (e ca##ed (y using he En86ne: Run A<364n'6s3 Acion and seing he
S4ur<e fie#d o Asse3 )6le. Ei%i#ar#y' !uscenes and oher scene1(ased AcionBiss can a#so refer
o an asse fi#e for heir Acions.
AcionBiss asses can a#so (e referenced fro% ?ospos and !onversaions in a si%i#ar )ay.
This is usefu# for creaing Lg#o(a#L ineracions' such as !onversaions ha can ake p#ace over
%ore han one scene.
&., - ARRO$ PROMPTS
An Arr49 Pr47B3 is an on1screen indicaor ha he p#ayer can perfor% an acion (y pushing a
direciona# key. This is si%i#ar o he Ruick1Ti%e =vens ha are e%p#oyed in Te##a#e,s The
3a#king +ead ga%e.
The de%o ga%e %akes use of Arro) <ro%ps )hen he p#ayer c#icks on he (arre# for he firs
i%e. Bef and righ arro)s appear on he screen & pushing Bef causes he ro(o o push he
(arre# over' )hi#e pushing 2igh %akes hi% #eave i a#one. 3hen re#ying on Touch Ecreen inpu'
you can a#so acivae arro)s (y s)iping in he given direcion.
Arro) <ro%ps are creaed (y c#icking Arr49 Pr47B3 under he Ecene 8anager,s Bogic pane#'
fo##o)ed (y A22 ne9. As )ih !onversaions and !uscenes' Arro) <ro%p o(Aecs are
invisi(#e and heir ransfor%s are uni%poran.
0ou can use he Arro) <ro%p inspecor o provide any co%(inaion of up' do)n' #ef and righ
arro)s. 0ou can %odify he icon of each arro)' and supp#y a !uscene ha )i## run )hen he
appropriae key is pressed' or arro) #is c#icked' (y he p#ayer. The Arro) <ro%ps )i## (e
disa(#ed auo%aica##y once his happens.
Arro) <ro%ps have a ype fie#d' )hich deer%ines ho) hey %ay (e ineraced )ih. They can
(e se o on#y respond o direciona# %ove%en Ci.e. cursor keysD' cursor c#icks' or (oh.
3hi#e a se of Arro) <ro%ps are on1screen' he p#ayer,s reg#uar %ove%en conro# is disa(#ed.
To %ake a se of Arro) <ro%ps appear' he o(Aec %us (e urned on using he OADe<3: Sen2
Messa8e acion and choosing Turn On as he %essage o send.
&.10 - SOUNDS
A S4un2 o(Aec provides addiiona# seings for Audio Eources' a##o)s vo#u%es o (e adAused (y
he p#ayer' and a##o)s sound o (e p#ayed using he En86ne: Pla? s4un2 Acion.
Eound o(Aecs are creaed (y c#icking he Eound (uon under he Ecene 8anger,s Bogic pane#.
0ou can se up your sound using he Audio Eource co%ponen as nor%a#' (u he #4lu7e fie#d
)i## (e overridden. *nsead' you can use he Rela36ve v4lu7e fie#d in he Eound inspecor o
adAus i,s sound #eve#. This )ay' you can adAus he vo#u%e re#aive o oher sounds of he sa%e
ype Ce.g. %usic or E:HD.
The S4un2 3?Be pop1up #es you designae )hich caegory of sound he o(Aec )i## p#ay. This
)i## affec i,s overa## vo#u%e' since he ga%e a##o)s he p#ayer o choose he vo#u%e of 8usic'
E:H and Epeech audio fro% he /pions %enu. !hoosing F/herG )i## %ake he /pions %enu
ignore he vo#u%e for his o(Aec' %aking i independen fro% he res of he ga%e.
The En86ne: Pla? S4un2 Acion can conro# Eound o(Aecs (y p#aying' sopping and fading
audio. 0ou can a#so change he sound c#ip ha is (eing p#ayed' (u his is no reco%%ended for
audio ha )i## #ike#y (e #ooping )hen he ga%e is saved' since any change in a Eound o(Aec,s
Au264 Cl6B )i## no (e sored in he save daa.
7y defau#' sounds do no carry over )hen changing scene' (u you %ay )ish o have
(ackground %usic coninue p#aying as you navigae he ga%e. 3hen a Eound prefa(,s ype is se
o 8usic' check he Pla? 7us6< a<r4ss s<enes check(o-' and %ove he prefa( ino he roo of
your scene,s hierarchy. The prefa( canno survive a scene #oad un#ess i has no paren
5a%e/(Aec.
&.11 - CONTAINERS
A C4n3a6ner is a scene1(ased #is of *nvenory ie%s Csee secion 6.1 for %ore on *nvenory
ie%sD. This a##o)s for ga%ep#ay such as reasure chess' ha he <#ayer can open and ake fro%
)ihin' and sorage chess' ha he <#ayer can sore a)ay ie%s for #aer use.
A !onainer can have a defau# se of ie%s' ha can (e changed during ga%ep#ay' eiher hrough
Acions or hrough 8enus. To FopenG a !onainer' use he C4n3a6ner: OBen Acion. To vie)
he conens of a !onainer' your 8enu 8anager %us conain a 8enu )ih an Appear type se o
On C4n3a6ner. The +e%oM8enu8anager asse provides such a 8enu' and )ih his ie%s can
(e ransferred (oh )ays (e)een he !onainer and he <#ayer,s *nvenory.
To sore he conens of a !onainer in save ga%e fi#es' a !onainer re>uires ha he
2e%e%(er!onainer scrip (e aached' (u his is rue of a## !onainer prefa(s (y defau#.
&.1" - ACTION'IST PARAMETERS
Eo%ei%es' )e,## )an our ga%e o perfor% he sa%e ask severa# i%es' (u )ih su(#e
differences each i%e 1 for e-a%p#e' )henever he <#ayer picks up an ie%' )e )an i,s
associaed ?ospo o (e disa(#ed' i,s 5a%e/(Aec o (e %ade invisi(#e' and he *e% o (e added
o he invenory.
A<364n'6s3 Bara7e3ers a##o) us o use he sa%e AcionBis o perfor% he sa%e asks o
differen o(Aecs 1 Aus as para%eers do )hen progra%%ing funcions. *n he e-a%p#e a(ove'
para%eers cou#d (e used o creae a sing#e AcionBis ha disa(#es any ?ospo' hides any
5a%e/(Aec' and adds any *e% o he <#ayer,s invenory. This AcionBis )ou#d hen (e ca##ed
every i%e he <#ayer akes an ie% 1 )ih he specific o(Aecs references (y he para%eers (eing
se each i%e.
<ara%eers are avai#a(#e o !uscenes' and asse1(ased AcionBiss. To ena(#e he%' check Use
Bara7e3ersG in he properies (o- a he op of he *nspecor. A ne) (o- )i## appear9 ener he
nu%(er of para%eers you )ish o use' and you can hen re1na%e and choose he ype of each
one. <ara%eers can reference 5a%e/(Aecs' *nvenory ie%s' 5#o(a# @aria(#es and Boca#
@aria(#es 1 hough Boca# @aria(#es are no co%pai(#e )ih asse1(ased AcionBiss.
3henever an Acion can %ake use of a para%eer' he #is of para%eers )i## appear inside he
Acion as a drop1do)n (o-. !hoose a para%eer o LoverrideL he Acion,s defau# fie#d' and
have i (e rep#aced (y he para%eer.
Eo%ei%es he funcion of Acions change (ased on heir fie#d seings. :or e-a%p#e' he
@aria(#e9 !heck Acion )i## give an opion o check for rue or fa#se )hen >uerying a (oo#ean'
and )i## give an opion o check a nu%erica# va#ue )hen >uerying an ineger. 4oe han )hen a
para%eer is assigned o an Acion' i )i## assu%e he sa%e $* and funciona#iy ha i had (efore
he para%eer )as se.
/nce an AcionBis has (een se up o ake para%eers' hese para%eers can (e passed o i (y
ca##ing i fro% anoher AcionBis )ih he En86ne: Run A<364n'6s3 Acion. 3hen he =ngine9
2un AcionBis Acion is used o rigger an AcionBis )ih para%eers' you can se he fie#ds for
each para%eer.
&.13 - DRAAB'E OB1ECTS
Advenure !reaor a##o)s for %ovea(#e o(Aecs ha can (e %anipu#aed direc#y )ih he %ouse
cursor or ouches' creaing a greaer sense of presence and ineraciviy 1 paricu#ar )ih firs
person ga%es. Euch o(Aecs fa## ino )o caegories9 Dra88aAle and P6<=UB o(Aecs. +ragga(#e
o(Aecs are consrained9 hey can on#y (e %oved in cerain )ays9 eiher a#ong a se p#ane' on#y
roaed' or a#ong pre1defined Tra<=s.
To ho#d a +ragga(#e o(Aec' si%p#y ouch Cor c#ickD i and ho#d. The o(Aec )i## (e #e go )hen
he ouch or c#ick is #e go. ?o) far a)ay an o(Aec can (e is deer%ined (y he M4veaAle ra?
len83> fie#d in he Eeings 8anager.
The Ecene 8anager provides a defau# +ragga(#e prefa(' )hich conains a## he co%ponens
necessary' (u no %esh. *,s advisa(#e o add he re>uired %esh o i as a chi#d o(Aec' (ecause he
+ragga(#e,s posiion and roaion is deer%ined (y i,s +rag %ode 1 herefore' adding a %esh as a
chi#d o(Aec a##o)s i,s Transfor% seings o (e se safe#y.
Jey o he )ay a %ovea(#e o(Aec (ehaves is i,s 2igid(ody seings. The +rag and Angu#ar
+rag va#ues are #ocked o 20 )hen an o(Aec is he#d' so i,s he 8ass va#ue ha affecs ho)
>uick#y a he#d o(Aec %oves. A 8ass of 1 gives a 191 re#aionship (e)een he %ove%en of he
%ouse or ouch and he %ove%en of he o(Aec. ?igher va#ues )i## re>uire %ore %ove%en
fro% he p#ayer o %ove he o(Aec' )hich #o)er va#ues )i## re>uire #ess.
+ragga(#e o(Aecs are a heir %os usefu# )hen #ocked o a Track. There are hree Track ypes'
each avai#a(#e as prefa(s in he Ecene 8anager9 S3ra68>3 Tra<=' Curve2 Tra<=' and 'ever
Tra<=. 3hen p#aced in he scene' a Track prefa( )i## disp#ay a )hie #ine in he Ecene )indo)
ha represens he #ocus an aached +ragga(#e o(Aec can ake' )ih a grey circ#e a he sar' and
a )hie circ#e a he end. 3hen %oving a#ong a Track' a +ragga(#e o(Aec )orks (es )hen i,s
(ase !o##ider co%ponen is a Ephere !o##ider' so i,s a good idea o keep his co%ponen even if
you add oher !o##iders o i in chi#d o(Aecs.
A S3ra68>3 Tra<= is used o consrain a +ragga(#e o(Aec a#ong a sraigh #ine. 2oaion effecs
can a#so (e added' o %ake he o(Aec ro## as i %oves' or urn in a scre)1#ike %oion. A Curve2
Tra<= prefa( is used o consrain a +ragga(#e o(Aec a#ong a curved #ine. *f he #ine is #ooped o
for% a circ#e' he nu%(er of possi(#e revo#uions can a#so (e se.
A H6n8e Tra<= prefa( is used o pivo a +ragga(#e o(Aec a(ou i,s cenre. *,s posiion is
#ocked' and can on#y (e roaed in a circu#ar %oion. Bike he !urved Track' i can a#so (e
#ooped. This Track ype is usefu# for o(Aecs such as doors and #evers.
3hen a +ragga(#e o(Aec is %oved' i,s In3era<364n 4n 74ve AcionBis )i## (e run. *f his
*neracion (egins )ih a M4veaAle: C>e<= 3ra<= B4s6364n Acion' i can (e #ooped ono ise#f o
(e run again uni# he desired posiion has (een reached. The M4veaAle: M4ve al4n8 Tra<=
Acion can (e used o %ove he +ragga(#e o(Aec auo%aica##y.
+ragga(#e o(Aecs can (e urned on and off (y using he OADe<3: Sen2 7essa8e Acion on he%.
They sar he scene ena(#ed' (u his can (e changed )ih he Re7e7Aer M4veaAle scrip'
)hich is aached o he prefa( (y defau#.
&.1% - PIC(UP OB1ECTS
<ick$p o(Aecs' un#ike +ragga(#e o(Aecs' can (e free#y %anipu#aed. To ho#d a <ick$p o(Aec'
si%p#y ouch Cor c#ickD i and ho#d. The o(Aec )i## (e #e go )hen he ouch or c#ick is #e go.
?o) far a)ay an o(Aec can (e is deer%ined (y he M4veaAle ra? len83> fie#d in he Eeings
8anager.
<ick$p o(Aecs can a#so (e roaed' (rough c#oser o he screen' and hro)n. The re>uired *npu
a-es o perfor% hese e-ra funcions are #ised in he Eeings 8anager,s 2e>uired inpus secion.
The Ecene 8anager provides a defau# <ick$p prefa(' )hich conains a## he co%ponens
necessary' (u no %esh. The prefa( uses a Ephere !o##ider (y defau#' (u his can (e rep#aced if
necessary )ih anoher.
Jey o he )ay a %ovea(#e o(Aec (ehaves is i,s 2igid(ody seings. The +rag and Angu#ar
+rag va#ues are #ocked o 20 )hen an o(Aec is he#d' so i,s he 8ass va#ue ha affecs ho)
>uick#y a he#d o(Aec %oves. A 8ass of 1 gives a 191 re#aionship (e)een he %ove%en of he
%ouse or ouch and he %ove%en of he o(Aec. ?igher va#ues )i## re>uire %ore %ove%en
fro% he p#ayer o %ove he o(Aec' )hich #o)er va#ues )i## re>uire #ess.
Triggers can (e p#aced in he scene o deer%ine if a <ick$p o(Aec has (een p#aced in he correc
posiion. A Trigger can (e se o deec he <ick$p o(Aec in >uesion Cor a## <ick$ps in genera#
(y choosing An? OADe<3 $63> C47B4nen3 and enering he co%ponen na%e
M4veaAleEP6<=UBD' so ha a se>uence of Acions )i## run )hen he o(Aec eners i.
<ick$p o(Aecs can (e urned on and off (y using he OADe<3: Sen2 7essa8e Acion on he%.
They sar he scene ena(#ed' (u his can (e changed )ih he 2e%e%(er 8ovea(#e scrip'
)hich is aached o he prefa( (y defau#.
*.0 - IN#ENTOR-
*.1 - DEC'ARIN IN#ENTOR- ITEMS
The ie%s ha he p#ayer can pick up over he course of he ga%e are co##ecive#y kno)n as he
Inven34r?. *e%s ha he p#ayer is ho#ding are disp#ayed in he ga%e,s *nvenory %enu' and can
(e used' e-a%ined and co%(ined )ih ?ospos' 4<!s and and oher ie%s.
*nvenory ie%s are dec#ared and %odified using he *nvenory 8anager & he fifh a( in he
%ain Advenure!reaor )indo). =ach ie% has fie#ds for a uni>ue na%e' icon e-ure' and
check(o-es o deer%ine if i is carried (y he p#ayer )hen saring he ga%e' and deer%ining if
he p#ayer can carry %u#ip#e unis of i. This is usefu# for hings #ike currency.
Advenure !reaor provides differen %ehods of invenory hand#ing & ha is' )heher or no
*e%s are se#eced (efore choosing he ?ospo o use he% on' or )heher he ?ospo is chosen
(efore se#ecing )hich *e% o use. *f i is he for%er' ca##ed F!one- EensiiveG (y Advenure
!reaor Csee secion 5.1D' you can a#so %ake use of an A<36ve e-ure for each *e%. An Acive
e-ure is disp#ayed )hen an *nvenory cursor is hovering over a ?ospo' in p#ace of he *e%,s
regua#ar e-ure. The cursor effec ha is e%p#oyed' (e i si%p#e or pu#sing' can (e %odified in
he Eeings 8anager.
*nvenory ie%s can a#so (e sored ino caegories. !aegories can (e creaed' rena%ed and
re%oved fro% he op of he *nvenory 8anager. /nce one %ore caegories e-is' each *nvenory
ie% can (e sored ino one of he%. !aegorising invenory ie%s a##o)s he% o (e sored )hen
creaing invenory %enus & for e-a%p#e' (y caegorising spe## ie%s under FEpe##sG' you can
creae a spe## invenory %enu ha Aus disp#ays spe##s.
3hen he p#ayer is carrying one or %ore ie%s' he *nvenory %enu )i## (e ena(#ed' un#ess i has
(een disa(#ed )ih he Pla?er: C4ns3ra6n Acion. 7y defau#' FusingG an ie% )i## se#ec i' and
he cursor )i## change o he ie%,s e-ure. 0ou can hen use ha ie% on ?ospos' 4<!s and
oher ie%s.
?o)ever' you %ay )an o so%ehing %ore specific o occur )hen he p#ayer c#icks on a
paricu#ar ie%. To do his' you can assign an *nvAcionBis o he ie%,s Use fie#d Cunder
Eandard evensD. *nvAcionBiss are #ike AcionBiss' (u are sored in asse fi#es. !reaing
he% is deai#ed in he ne- secion. $sing *nvAcionBiss' you can a#so se ineracions for
e-a%ining an ie%' co%(ining one ie% )ih anoher' and defining Un>an2le2 even3s.
$nhand#ed evens are Fdefau#G ineracions ha are run )hen no specific ineracion has (een
defined. 3e can use hese evens o creae sandard %essages o he p#ayer )hen hey ry o
co%(ine or use ie%s in )ay he deve#oper hasn, caered for.
:or e-a%p#e' he de%o ga%e %akes use of he Use 4n >43sB43 unhand#ed even. 3hen he
p#ayer ries using he F:ake s)ordG ie% on he pin(oard' )hich doesn, have an ineracion
defined for such a scenario' he ga%e )i## run his unhand#ed even & causing he ro(o o rep#y'
F* can, cu ha.G
*n addiion o defining g#o(a# unhand#ed evens' you can a#so define per1ie% unhand#ed evens'
)hich override he defau#s. :ound under he S3an2ar2 6n3era<364ns secion of an *nvenory
*e%,s edior' you can use hese o e#ici a response fro% he <#ayer ha,s uni>ue o ha *e%.
*." - SCENE-INDEPENDENT IN#ENTOR- HAND'IN
*f our ga%e a##o)s invenory ie%s o (e e-a%ined and co%(ined )ih each oher' )e )i## )an
such ineracions o (e scene1independen' so ha hey can run regard#ess of he scene ha he
p#ayer is in. A<364n'6s3s asse3s a##o) us o do his & see secion 5.8 for %ore.
*.3 - MANAIN IN#ENTOR- IN-AME
/nce dec#ared in he *nvenory 8anager' *nvenory ie%s can (e added o and re%oved fro% he
<#ayer (y using he Inven34r?: A22 4r re74ve Acion. *f %u#ip#e unis of he sa%e ie% can (e
carried C(y icking he Can <arr? 7ul36BleG check(o- in he *nvenory 8anagerD' hen his
Acion )i## a#so a##o) you o affec he nu%(er of unis ha he p#ayer is carrying. :or e-a%p#e'
if you have creaed an ie% ha represens currency' you can use his Acion o hand#e a shop
ransacion & re%oving he p#ayer,s a%oun of %oney (y 50.
To use an *nvenory ie% on a paricu#ar ?ospo or 4<!' refer (ack o secion 5.3.
The Inven34r?: C>e<= Acion is used o perfor% differen Acions (ased on )ha he p#ayer is
carrying. Again' if %u#ip#e unis of he sa%e ie% can (e carried' his Acion )i## a##o) you o
%ake a specific >uery a(ou ho) %any unis of ha ie% he p#ayer is carrying. 2eurning o our
shop e-a%p#e' )e can use his Acion o deer%ine if he p#ayer has enough %oney o (uy an
ie%' and issue a response according#y.
:or coders' he p#ayer,s invenory a runi%e is sored in he <ersisen=ngine o(Aec,s Run367e
Inven34r? co%ponen. A pu(#ic #is inside his scrip ca##ed l4<alI3e7s sores he p#ayer,s
invenory. *nvenory ie%s are given an *+ nu%(er )hen creaed in he *nvenory 8anager'
)hich is used (y he RuntimeInventory scrip o deer%ine )hich ie% is (eing affeced. This
a##o)s ie%s o (e re%oved and insered in (e)een each oher' )ihou desroying heir
references.
*.% - CRA)TIN
As )e## as co%(ining )o ie%s ogeher o so#ve pu66#es' you can a#so define crafing FrecipesG
ha a##o) for %u#ip#e ie%s o (e co%(ined o creae a ne) one. This a##o)s for 8inecraf1sy#e
crafing e#e%ens in your ga%e.
7eneah he #is of *e%s in he *nvenory 8anager' you can dec#are any nu%(er of recipes. =ach
recipe re>uires a nu%(er of *e%s as FingrediensG' and a resu#ing *e% ha is produced )hen
he ingrediens are co%(ined. 2ecipes can opiona##y (e %ade o re>uire a specific crafing
paern & ha is' he arrange%en of ingrediens in he !rafing %enu e#e%en.
*f an ingredien,s *e% has Can <arr? 7ul36Ble checked' you can a#so deer%ine he nu%(er of
insances of his ie% re>uired. :or e-a%p#e' a recipe o creae a #i orch %ay re>uire one e%py
orch and )o (aeries.
To craf ie%s' ingrediens %us (e p#aced ino a !rafing %enu e#e%en. A !rafing e#e%en has
)o ypes9 *ngrediens and /upu. 3hen he correc arrange%en of ie%s are p#aced in a
!rafing (o- of he *ngredien ype' he resu#ing ie% can (e se#eced fro% a !rafing (o- of he
/upu ype. *f he recipe Cas dec#ared in he *nvenory 8anagerD has Resul3 6s au347a36<
checked' he resu#ing *e% )i## appear insan#y in he /upu (o- & oher)ise i )i## re>uire he
Inven34r?: CraC36n8 Acion o (e run o creae he recipe.
To de%onsrae he appropriae use of he !rafing %enu e#e%en' (oh he +e%o and +e%o2+
8enu 8anager asses provide a !rafing %enu' )hich you can copy ino your o)n 8enu
8anager. 4oe ha his %enu,s ABBear 3?Be is se o Manual' and you )i## have o decide for
yourse#f ho) his 8enu opens in your ga%e & )heher i (e (y he Menu: C>an8e s3a3e Acion'
or opening fro% anoher 8enu' or so%e oher %eans.
+.0 - #ARIAB'ES
+.1 - DEC'ARIN #ARIAB'ES
0ou can define (oh 5#o(a# and Boca# @aria(#es. l4Aal #ar6aAles are scene1independen' and
can (e rerieved and %odified regard#ess of scene' )hi#e '4<al #ar6aAles are specific o a scene'
and canno (e read ouside of ha scene.
@aria(#es are used o o keep rack of progress' and a#er ga%ep#ay according#y. :or e-a%p#e' he
de%o ga%e %akes use of a (oo#ean varia(#e ca##ed Tr6e2 l6C36n8 <anvas' )hich is used o incie a
differen reacion fro% he <#ayer characer )hen c#icking on he canvas ?ospo %u#ip#e i%es.
They can a#so (e used o de(ug your ga%e. The de%o ga%es %akes use of anoher (oo#ean
ca##ed Pla?e2 6n3r4' )hich can (e se o rue during deve#op%en o skip he opening cuscene
)hen he ga%e is sared.
A## @aria(#es are defined in he @aria(#es 8anager' (u Boca# @aria(#es can on#y (e defined once
Or8an6se r447 4ADe<3s has (een c#icked in he Ecene 8anager. @aria(#es can (e eiher
(oo#eans Crue1or1fa#se f#agsD' inegers C)ho#e nu%(ersD' f#oas Cnu%(ers )ih deci%a#sD or
srings Ca #ine of e-D. * is i%poran o se a varia(#e,s ype (efore using i in ga%e #ogic. 0ou
can a#so give each varia(#e a na%e' and an iniia# sae.
4oe ha using he @aria(#es 8anager o change a varia(#e,s sae )hi#e he ga%e is running )i##
no affec he ga%e,s curren insance of hose varia(#es' and changes %ade o he @aria(#es
8anager )i## survive )hen he ga%e is sopped. :or de(ugging' he F#iveG va#ues of @aria(#es
can (e seen during ga%ep#ay (y checking S>49 real367e valuesG a he op of he %anager.
As )e## as (eing used F(ehind he scenesG o affec ga%e #ogic' @aria(#es can a#so (e disp#ayed
on screen' eiher via a 8enuBa(e# Csee secion 10.2D' via a !haracer,s dia#ogue' or )hen yping
for%u#as ino he #ar6aAle: Se3 Acion. The oken syna- Jvar:IDK )i## (e rep#aced (y he va#ue
of he associaed @aria(#e. :or e-a%p#e' Tvar92U )i## disp#ay he va#ue of 5#o(a# @aria(#e 2 #ised
in he @aria(#es 8anager. A @aria(#e,s *+ nu%(er is #ised ne- o i in he @aria(#e 8anager &
noe ha his nu%(er is no necessari#y he sa%e as i,s order in he #is.
Boca# @aria(#es %ake use of a s#igh#y differen oken syna-9 Jl4<alvar:IDK.
+." - MANAIN #ARIAB'ES IN-AME
@aria(#es are se using he #ar6aAle: Se3 Acion' and >ueried using he #ar6aAle: C>e<= Acion.
The @aria(#e9 Ee Acion can a#so (e used o ransfer he va#ue of a 8enu*npu 8enu =#e%en
Csee secion 10.2D o a Ering @aria(#e' and 8ecani% para%eer va#ues o 7oo#ean and *negeer
@aria(#es.
:or coders9 )hen he ga%e (egins' he <ersisen=ngine o(Aec,s l4Aal#ar6aAles co%ponen
%akes a copy of he g#o(a# varia(#es' keeping he% separae fro% he @aria(#es 8anager during
runi%e. These are sored in a pu(#ic #is ca##ed g#o(a#@ars' and & #ike invenory ie%s & re#y on
*+ nu%(ers o deer%ine )hich varia(#e is (eing referenced. Boca# varia(#es are sored in he
5a%e=ngine o(Aec,s '4<al#ar6aAles co%ponen' inside he #oca#@ars #is.
+.3 - 'IN(IN $ITH P'A-MA(ER #ARIAB'ES
*f you have he popu#ar <#ay8aker asse' )hich is a separae $niy asse o Advenure !reaor'
you can sync Advenure !reaor,s 5#o(a# @aria(#es )ih <#ay8aker,s 5#o(a# @aria(#es. To do so'
si%p#y se#ec he @aria(#e you )ish o #ink' and change i,s '6n= 34 va#ue o Pla?7a=er l4Aal
#ar6aAle.
*f you have no done so a#ready' you )i## (e pro%ped o add he Pla?Ma=erIsPresen3 scriping
define sy%(o# o your ga%e,s <#ayer Eeings. 0ou can find his fie#d fro% =di ; <roAec
Eeings ; <#ayer.
/nce you have enered his' you can hen ener he na%e of he <#ay8aker 5#o(a# @aria(#e you
)ish o #ink o. 7ear in %ind ha he )o varia(#es %us %ach ype9 if you are #inking a
<#ay8aker f#oa' you %us do so )ih an Advenure !reaor f#oa as )e##.
0ou can a#so choose )heher or no <#ay8aker deer%ines he iniia# va#ue of he Advenure
!reaor 5#o(a# @aria(#e. 5enera##y' your ga%e shou#d on#y affec eiher he <#ay8aker or
Advenure !reaor @aria(#e' raher han (oh. 3hen a <#ay8aker @aria(#e is changed' i,s va#ue
is Fdo)n#oadedG o Advenure !reaor on#y )hen i is needed & ie. )hen he @aria(#e9 !heck
Acion is used o deer%ine i,s va#ue.
7y #inking @aria(#es in his )ay' you can save he va#ue of <#ay8aker 5#o(a# @aria(#es
auo%aica##y.
+.% - 'IN(IN $ITH OPTIONS DATA
5#o(a# @aria(#es can (e used o for% cuso% opions daa' )hich is independen of save ga%e
daa. Eee secion 8.4 on ho) o do his.
CHAPTER II: AD#ANCED )EATURES
8.0 - SA#IN AND 'OADIN
8.1 - O#ER#IE$
Advenure !reaor is capa(#e of saving and #oading a p#ayer,s progress )ih #i#e effor on he
deve#oper,s par. ?o)ever' i is i%poran o undersand he )ay in )hich i does so' and )ha
e-ac#y is recorded in order o creae an effecive save syse% for your ga%e.
The na%e of save fi#es is & (y defau# & he sa%e as your proAec na%e' (u you can rep#ace his
fro% he Eeings 8anger' under Save 8a7e se336n8s.
3hen a ga%e is saved' Advenure !reaor sores )o ypes of daa9 %ain and roo%. 8ain daa
inc#udes he p#ayer,s posiion' he p#ayer,s sandard ani%aions C2+ spries on#yD' he ca%era,s
posiion' he curren scene' and he sae of he invenory' g#o(a# varia(#es' and %enus. This daa
is sored auo%aica##y.
2oo% daa is scene1specific' and on#y consiss of daa ha has (een f#agged for saving. :#agging
5a%e/(Aecs for saving is a si%p#e %aer of aaching he appropriae Remember scrips o
he%. :or e-a%p#e' o save he sae of a conversaion,s dia#ogue opions' he Re7e7Aer
C4nversa364n scrip %us (e aached. A fu## descripion of he various Remember scrips is
given in he ne- secion.
Eo #ong as an o(Aec has (een f#agged appropriae#y' i,s daa )i## (e saved and #oaded.
Advenure !reaor )i## a#so hand#e he sorage and reurn of roo% daa as he p#ayer navigaes
differen scenes.
Eaved ga%e fi#es are sored in $niy,s ABBl6<a364n.Bers6s3en3Da3aPa3>. 0ou can disp#ay his
pah in he $niy conso#e (y ca##ing print(Application.persistentDataPath); in a scrip.
3hi#e Advenure !reaor is capa(#e of soring %os of he essenia# daa needed o proper#y save
a ga%e' i is no capa(#e of saving changes o a 5a%e/(Aec,s reference o an e-erna# asse fi#e &
he %os i%poran effec of his (eing ha changes in ani%aion are no saved. ?o)ever' i is
easy o )ork around his (y using l4Aal #ar6aAles' )hich are a#)ays saved.
5#o(a# @aria(#es can (e used o rever o(Aecs and 4<!s o heir appropriae ani%aion saes
)hen he ga%e is #oaded (y ca##ing upon he% in he scene,s Cu3s<ene 4n l4a2 fie#d' found in
he Ecene 8anager. The de%o provides severa# e-a%p#es of his' a## of )hich are descri(ed in
secion 8.5.
The save syse% )i## a#so no save dyna%ic pahs' i.e. hose generaed (y characers )hen
pahfinding. Thus' if he <#ayer characer is pahfinding do a poin as he ga%e is saved' hey
)i## no #onger (e %oving )hen ha ga%e is #oaded (ack.
:or coders' saved ga%es can (e accessed via he aveystem scrip' )hich is aached o he
<ersisen=ngine' creaed a runi%e. EaveEyse% conains severa# saic funcions o aid in save
%anage%en9 !oadave' ave"ame' aveNe#"ame' !oadAutoave' "etNumlots and
"etavelotName. 8os funcions re>uire he s#o nu%(er as a para%eer. The s#o nu%(er'
)hich refers o he #is of saved ga%es in he %enus' is a#so appended o he save,s fi#ena%e.
:or e-a%p#e' he fo##o)ing code )i## #oad he firs save ga%e s#o9
SaveSystem.LoadGame (0);
*n order o funcion correc#y' a scene %us (e in $niy,s 7ui#d Eeings in order o #oad a saved
ga%e fro% i' and i %us have finished iniia#ising correc#y (efore ransiioning o a ne) one.
+o no ca## !oad"ame fro% )ihin eiher he A#a$e or tart funcions.
8." - SA#IN INDI#IDUA' OB1ECTS
$n#ess i is eiher he 5a%e=ngine' <ersisen=ngine' he <#ayer' or he 8ain!a%era'
5a%e/(Aecs in your scene canno (e saved )ihou an associaed *+ nu%(er. The C4ns3an3ID
scrip' )hen aached o a 5a%e/(Aec' )i## provide such a varia(#e' and )i## no change upon
resaring $niy.
3e %us add a ConstantID scrip o any 5a%e!a%era ha he 8ain!a%era can (e s)iched o
)hen saving is ena(#ed Cha is' during nor%a# ga%ep#ayD. *n doing so' )e a##o) he referenced
o(Aec Cin his case' he 5a%e!a%eraD' o (e Fvisi(#eG o he save syse%' and hus a##o) i o (e
saved. :or he sa%e reason' )e %us aach a ConstantID scip o each 4av8esh if a scene has
%ore han one.
?o)ever' o record specific daa a(ou he 5a%e/(Aec' raher han %ere#y he reference o i' )e
%us use Remember scrips. Remember scrips are a su(c#ass of !onsan*+' )hich give he save
syse% insrucions o a#so save specific hings a(ou ha 5a%e/(Aec. :or e-a%p#e' he
RememberName scrip ensures ha he na%e of i,s associaed 5a%e/(Aec )i## (e saved. The
fo##o)ing is a #is of he various Remember scrips' and )hen hey are used.
Re7e7AerC4ll62er & Aaching his scrip o any !o##ider or Trigger )i## %ake sure he
ena(#ed sae of i,s !o##ider co%ponen )i## (e saved.
Re7e7AerC4n3a6ner & Aaching his scrip o any !onainer o(Aec )i## %ake sure he
ie%s sored )ihin )i## (e saved. This is a par of he !onainer prefa( (y defau#.
Re7e7AerC4nversa364n & Aaching his scrip o any !onversaion o(Aec )i## %ake
sure he on.off.#ock sae of i,s +ia#ogue/pions )i## (e saved. This is a par of he
!onversaion prefa( (y defau#.
Re7e7AerH43sB43 & Aaching his scrip o any ?ospo o(Aec )i## %ake sure i,s
visi(i#iy o he p#ayer,s cursor is saved. Technica##y' i records )heher or no he o(Aec
is on he F+efau#G #ayer or no. Aach his o ?ospos ha %ay (e urned on or off
during ga%ep#ay.
Re7e7AerNa7e & Aaching his scrip o any 5a%e/(Aec )i## record any changes in
said 5a%e/(Aec,s na%e. Aach his o any 5a%e/(Aec affeced (y he H43sB43:
Rena7e Acion.
Re7e7AerM4veaAle & Aaching his scrip o any +ragga(#e or <ick$p o(Aec )i##
record i,s posiion and roaion' as )e## as he posiion a#ong any rack i %ay (e aached
o.
Re7e7AerNavMes>"D & Aaching his scrip o any 4av8esh2+ prefa( )i## record
any changes in i,s ho#e srucure. ?o#es Cin he for% of <o#ygon !o##idersD can (e added
and re%oved fro% 4av8esh2+ prefa(s during ga%ep#ay o add pahfinding o(sac#es.
Re7e7AerNPC & Aaching his scrip o any 4<! )i## record ha 4<!,s ransfor%'
acive pah' and visi(i#iy o he p#ayer,s cursor. 4oe ha in order o a#so save he acive
pah' a ConstantID scrip %us a#so (e presen on he <ah o(Aec. *f your 4<! uses
sprie1(ased ani%aion' he sandard ani%aions are a#so saved.
Re7e7AerTransC4r7 & Aach his scrip o any 5a%e/(Aec o save i,s ransfor% daa.
!an opiona##y save a 5a%e/(Aec,s presence in he scene' if i is de#eed or insaniaed
during ga%ep#ay & (u on#y if he 5a%e/(Aec is a prefa( inside a 2esources asse fo#der.
!an a#so (e used o save )hich 5a%e/(Aec is i,s paren' provided ha 5a%e/(Aec has
eiher a ConstantID scrip of i,s o)n' or is an assigned ?and 7one of a !haracer.
Re7e7AerTr688er & Aach his scrip o any Trigger prefa( o save i,s on.off sae.
Re7e7Aer#6s6A6l63? & Aach his scrip o any 5a%e/(Aec o save i,s renderer
co%ponen,s Fena(#edG sae' and opiona##y ha of i,s chi#dren. This )orks for (oh
%esh and sprie renderers.
Advenure!reaor )i## save he daa of any o(Aec )ih hese scrips aached. To reduce he si6e
of save fi#es' i is )ise o use he% on#y )hen necessary. :or e-a%p#e' he +e%o,s opening
!onversaion' *nro!onv' has no RememberConversation scrip' since he saes of i,s
+ia#ogue/pions never change.
The ?ospo' 4<! and @isi(i#iy scrips a#so a##o) he sae hey record o (e FoffG )hen he
ga%e (egins. :or e-a%p#e' a ?ospo can (e disa(#ed (y defau#' (y aaching a
2e%e%(er?ospo scrip o i' and seing i,s H43sB43 s3a3e 4n s3ar3 o OCC.
The fo##o)ing is a genera# guide#ine for seing a scene up correc#y for saving and #oading9
A## a7eCa7era o(Aecs ha are used during nor%a# ga%ep#ay Cha is' no
pure#y used during cuscenesD have a C4ns3an3ID scrip.
A## C4nversa364n o(Aecs )ih +ia#ogue/pions ha can change have a
C4ns3an3ID scrip.
A## <ah o(Aecs ha characers %ay (e using upon saving have a C4ns3an3ID
scrip.
*f he acive 4av8esh can change during a scene' give a## 4av8eshes a
C4ns3an3ID scrip.
A## H43sB43 o(Aecs ha can (e urned on or off have a Re7e7AerH43sB43 scrip.
A## 4<!s have a Re7e7AerNPC scrip.
A## oher 5a%e/(Aec ypes ha are %oved during ga%ep#ay Chrough i,s
Transfor%' no Aus Ani%aion co%ponenD have a Re7e7AerTransC4r7 scrip.
!oders )ho )ish o (ui#d heir o)n Remember scrips )i## need o reference heir )ork in he
!eveltorage scrip. 3hen a roo% is saved or #oaded' he !eveltorage scrip #ooks for insances
of each Remember scrip' and passes on insrucions o eiher sore or rerieve i,s daa.
Remember scrips are su(c#asses of ConstantID' )hich generaes a F!onsan *+G ineger uni>ue
o he 5a%e/(Aec i,s aached o.
8.3 - AUTOSA#IN
Eave s#o F0G is reserved for Auosaving' and )i## appear as such in he in1ga%e Eave and Boad
%enus.
Auosaves can (e %ade via !uscenes. A he op of a !uscene,s inspecor' ick he Au34-save
aC3er runn6n8G (o- o save he sa%e auo%aica##y once he !uscene has run. 7e a)are ha
his )i## on#y occur if he !uscene does no F(ranch offG ono anoher !uscene o(Aec. Tha is'
none of he Acions )ihin he !uscene are se o Run Cu3s<ene in heir AC3er runn6n8 fie#d.
!oders %ay )ish o #oad a saved1ga%e auo%aica##y a cerain i%es' e.g. if he p#ayer ges a
F5a%e /verG afer (eing spoed (y a guard. This can (e done (y ca##ing he EaveEyse%
scrip,s !oad"ame funcion9
GameObject.ind!ith"a# ("a#s.persistent$n#ine).Get%omponent
&SaveSystem'().LoadGame (0);
8.% - OPTIONS DATA
/pions daa is independen fro% save daa' a##o)ing opion changes o FsurviveG )hen a saved
ga%e is #oaded. They are sored in $niy,s <#ayer<refs' under he Options key.
A## Advenure !reaor ga%es have five opions (y defau#9 )heher or no su(i#es are on' he
ga%e,s #anguage' and he vo#u%e #eve#s of %usic' speech' and sound effecs. These opions can
(e changed in he /pions 8enu ha (oh he +e%oM8enu8anager and
+e%o2+M8enu8anagers carry. 0ou can a#so vie) and edi his daa' as )e## as rese he% o
heir defau# va#ues' in he Eeings 8anager.
/pions daa is #oaded )hen he ga%e (egins' and saved )henever a change is %ade o any of
he%.
* is possi(#e o creae cuso% opions in your ga%e (y )ay of @aria(#es. The '6n= 34 propery
of a 5#o(a# @aria(#e' as #ised in he @aria(#es 8anager' can (e se o OB364ns Da3a. 3hen his
is done' he @aria(#e,s va#ue )i## (e sored in he <#ayer<refs' and no in save ga%e fi#es. 0ou
can hen use he #ar6aAle: Se3 Acion' or C?<le' T488le and Sl62er 8enu =#e%ens o affec he
va#ue.
:or coders' /pion varia(#es are sored in he OptionsData c#ass. The pu(#ic insance of his
c#ass is in he Options scrip' )hich is aached o he <ersisen=ngine' creaed a runi%e.
8.& - HO$ THE DEMO DOES IT
The de%o ga%e' )hi#e si%p#e' de%onsraes a fu##y1funcioning save and #oad syse%.
The firs sep o creaing such a syse% is o (e a)are of he condiions under )hich saving is
possi(#e. 3hi#e #oading is possi(#e a any i%e' a ga%e can on#y (e saved during nor%a#
ga%ep#ay Cha is' no during cuscenes or conversaionsD. :or ha reason' he p#ayer canno save
progress in he de%o uni# he inroducion cine%aic has p#ayed' and )e can use his kno)#edge
o %ake assu%pions a(ou he sae of he scene )hen he ga%e #oads.
3e kno) ha during nor%a# ga%ep#ay' 7rain )i## (e sa in he chair' and he canvas )i## (e
ipped over. Therefore' he On!oad !uscene C)hich is se as he Cu3s<ene 4n '4a2 in he
de%o,s Ecene 8anagerD ses up he ani%aion saes for 7rain' he chair and he canvas. The
<#ayer o(Aec is a#so rese o id#e' since i %ay have (een p#aying a cuso% ani%aion )hen he
p#ayer re>uesed a saved ga%e o #oad.
The sae of he (arre#' )hich %ay have (een ipped over (y he p#ayer )hi#e p#aying' is no so
cerain. Eince he (arre# %oves hrough ani%aion' raher han having i,s Transfor% co%ponen
a#ered' )e %us p#ay he correc ani%aion in he On!oad !uscene. :or his' )e %ake use of a
5#o(a# @aria(#e Cas defined in he @aria(#es 8anagerD ca##ed Tipped barrel & a (oo#ean )hich is
se o (eco%e true )hen he p#ayer ips he (arre# over & see he %arrelTip !uscene. The sae of
his varia(#e is saved auo%aica##y' so )e can check i,s va#ue in /nBoad' and change he
(arre#,s ani%aion according#y.
The res of he save syse% is se up (y carefu# p#ace%en of ConstantID and Remember scrips
on cerain 5a%e/(Aecs9
C4ns3an3ID p#aced on he NavCam& and NavCam' 5a%e!a%eras ensures he
reference o he acive ca%era is sored. /n#y hese ca%eras re>uire his scrip'
since he ga%e can on#y (e saved during nor%a# ga%ep#ay.
Re7e7AerNPC p#aced on %rain ensures his ransfor%aion is sored
Re7e7AerC4nversa364n p#aced on %rainConv Che %ain conversaion o(AecD
ensures he Fena(#edG sae of each +ia#ogue/pion is sored
Re7e7AerH43sB43 p#aced on he #ord' %arrel& and %arrel' ?ospos ensures
heir visi(i#iy o he p#ayer,s cursor is sored. The #ord ?ospo is urned off as
he p#ayer picks i up' and he %arrel& ?ospo is rep#aced )ih %arrel' )hen he
p#ayer pushes he (arre# over.
Re7e7AerTransC4r7 p#aced on he #ord %esh Cinside he MEe5eo%ery
fo#derD ensures is ransfor%aion is sored. 3hen he p#ayer picks he s)ord up'
he %esh o(Aec is hidden fro% vie) (y %oving i o a far1off 8arker ca##ed
HideMar$er.
Addiiona##y' he de%o ga%e %akes use of a 5#o(a# @aria(#e ca##ed Played intro. 7y seing his
(oo#ean o true (efore saring he ga%e' he ga%e )i## skip he opening cine%aic' )hich is
usefu# )hen esing he scene during deve#op%en. The Ontart !uscene' )hich runs )hen he
scene (egins Chaving (een se in he Ecene 8anagerD' checks he sae of his varia(#e and eiher
p#ays he inro' or skips i (y %oving 7rain o he chair and running On!oad.
8.* - 'OADIN SCREENS
*f your ga%e feaures co%p#e- scenes' or i is p#ayed on o#der hard)are' i %ay ake a fe)
seconds o ransiion (e)een scenes. *n his case' you %ay )ish o creae a #oading screen' ha
appears during his pause o a#er he p#ayer ha he ga%e is #oading.
0ou can do his (y creaing a dedicaed L#oadingL scene' )hich is disp#ayed during ransiions.
This does no need o (e an LAdvenure !reaorL scene 1 i can %ere#y (e a ca%era )ih a sprie
e-ure in fron of i.
!reae a scene you )ish o ac a he #oading screen' and add i o your ga%e,s #is of Ecenes in
(ui#d fro% he 7ui#d Eeings. Then' check he $se #oading screenO (o- in he Eeings 8anager'
and supp#y he scene nu%(er of your #oading screen.
,.0 - SPEECH MANAEMENT
,.1 - AUDIO )I'ES
Audio fi#es for speech are dyna%ica##y #oaded a runi%e' %eaning you do no have o creae a
#ink (e)een each D6al48ue: Pla? sBee<> Acion and i,s associaed Audio!#ip. Euch c#ips are
#oaded (y giving each #ine of speech an *+ nu%(er & a uni>ue ineger assigned (y he Epeech
8anager.
0ou can access he Epeech 8anager fro% he fina# a( in he %ain Advenure !reaor )indo)
C3indo) ; Advenure !reaor ; 5a%e ediorD. !#icking a3>er l6nes )i## cause he %anager
o search a## scenes added o he 7ui#d Eeings C:i#e ; 7ui#d EeingsD and give an *+ o every
D6al48ue: Pla? SBee<> Acion. * )i## a#so do he sa%e o #ines conained in *nvAcionBiss
referenced in he *nvenory 8anager & see secion 6.2.
0ou )i## firs (e pro%ped o save he open scene. This is a non1desrucive process9 *+s )i##
on#y (e added o hose Acions )ihou one. 3hen i has finished' he speech #ines found in he
ga%e )i## (e #ised underneah' a#ong )ih he na%e of he speaker and *+ nu%(er. 4oe ha
speech #ines ha are (#ank' or )ihou a speaker' )i## no (e #ised.
Audio fi#es can no) (e %ade for he ga%e. !#icking Crea3e s<r6B3 s>ee3 )i## #e you save an
fi#e conaining your ga%e,s scrip' )hich voice acors can (e given. This scrip fi#e a#so conains
he fi#ena%e ha each #ine is e-peced o have. The fi#ena%e syna- is F!haracer na%eG P F*+
nu%(erG' )hi#e he audio for%a and e-ension can (e any ha $niy recognises. :or e-a%p#e'
7rain,s #ine' F?ey' #i#e ro(o"G has an *+ nu%(er of 21' %eaning he associaed audio fi#e is
na%ed %rain'&(mp). <#ayer #ines are a#)ays na%ed as Player' raher han he <#ayer prefa(,s
na%e.
*f a speech #ine has no associaed !haracer' i is considered a narraion #ine' and he audio fi#e is
na%ed Narration. *n order o p#ay narraion audio' your scene %us eiher conain a <#ayer
prefa( )ih an Au264S4ur<e co%ponen' or have a DeCaul3 S4un2 BreCaA assigned in he Ecene
8anager.
Audio fi#es for speech are p#aced in a Epeech su(fo#der inside your 2esources direcory' as
descri(ed in he Epeech 8anager.
*f your ga%e,s characer engine is se o Begacy Csee secion 3.1D' you can use he D6al48ue:
Pla? SBee<> Acion o se a specific ani%aion o p#ay per #ine. ?o)ever' Advenure !reaor
a#so feaures a %ehod of %oving a characer,s %ouh auo%aica##y' (ased on he vo#u%e of heir
speech audio. This is used (y he de%o ga%e o ani%ae he ro(o,s Aa) )ihou a need for #ine1
specific ani%aion c#ips.
To %ake use of his feaure' si%p#y add he Au34'6BS?n< scrip o a characer' and %odify he
pu(#ic varia(#es in he inspecor as needed. A FAa) (oneG Transfor% )i## need o (e assigned' as
)i## he a-is o roae he (one on.
,." - MANAIN TRANS'ATIONS
Advenure !reaor co%es )ih fu## rans#aion suppor for speech #ines' ?ospos and +ia#ogue
/pion #a(e#s' Kourna# pages' and 8enu e#e%en and *nvenory *e% na%es. A ga%e,s acive
#anguage is sored in i,s /pions +aa Csee secion 8.4D and is conro##ed (y he p#ayer in he
/pions %enu.
3ihin he Epeech 8anager' you can add and re%ove suppored rans#aions underneah he
Banguages pane#. 3hen you are ready o creae a rans#aion' c#ick EFB4r3 3ransla364n o
generae a !E@ fi#e )hich conains your ga%e,s e-. 7e sure o c#ick a3>er 3eF3 (eforehand'
o proper#y co##ec each #ine o (e rans#aed. 0ou can use a spreadshee app#icaion' such as
=-ce# or /pen/ffice' o edi he !E@ fi#e and c#ick I7B4r3 3ransla364n )ihin he Epeech
8anager o updae he rans#aion. 4oe ha he !E@ de#i%eer is a pipe C V D characer. As an
e-a%p#e' he de%o ga%e co%es )ih a :rench rans#aion.
*f your ga%e suppors %u#ip#e rans#aions' and you )ish o updae he% a## fro% Aus one fi#e'
you can a#so use he Epeech 8anager o e-por and i%por a## rans#aions in a sing#e !E@ fi#e.
0ou can a#so e## Advenure !reaor o on#y re#y on rans#aed e-' and ignore he origina# e-
ha )as enered in $niy inspecors. This is usefu# if you )ou#d #ike o updae your ga%e,s %ain
#anguage in a !E@ fi#e as )e## & you can si%p#y creae a ne) rans#aion ha serves as he
ga%e,s %ain #anguage Ceven if i,s in he sa%e #anguage as he origina# ga%e e-D' and use ha as
he defau# rans#aion.
0ou can a#so p#ay a#ernaive speech audio fi#es )hen differen #anguages are se#eced. 7y
checking he FAudio rans#aionsOG (o- in he Eeings 8anager' he engine )i## #ook for
differen audio fi#es inside a su(fo#der of he rans#aion,s na%e. To use he previous secion,s
e-a%p#e' a :rench rans#aion of 7rain,s #ine 21 )i## (e p#aced in Resources * peech * +rench
* %rain'&(mp).
10.0 - MENUS
10.1 - O#ER#IE$
=ach e#e%en of he ga%e,s user inerface & fro% he <ause and /pions %enus o he ?ospo
#a(e# and dia#ogue opion #is & are creaed using 8enus.
Advenure !reaor,s %enu syse% is designed o (e po)erfu# ye si%p#e o use. A## 8enus are
defined )ihin he Menu Mana8er. :ro% here' you can define your ga%e,s 8enus' and edi
(oh heir appearance and funciona#iy.
The de%o ga%e,s 8enu 8anager asse provides a fu##y1funcioning %enu syse% for an
advenure ga%e. 2aher han creae a ne) %enu syse% fro% scrach' you %ay prefer o
dup#icae his asse and hen edi i o your #iking. 4oe ha 8enu 8anager asses group up a##
8enu and 8enu =#e%en asses ogeher 1 you )i## have o se#ec a## he asses Cor Aus he roo
asseD (efore dup#icaing o proper#y copy i.
The fo##o)ing is a run1do)n of he defau# %enu syse%9
Pause & +isp#ays (uons o access he /pions' Eave and Boad %enus' as )e## as o
resu%e ga%ep#ay or >ui he ga%e. Appears eiher )hen p#ayer presses he L8enuL a-is
Cas defined in he *npu EeingsD' or c#icks he L8enuL (uon on he *n5a%e %enu.
OB364ns & A##o)s he changing of various in1ga%e opions' such as audio #eve#s and
#anguage. Accessed on#y via he <ause 8enu.
Save & Biss avai#a(#e saved ga%es o over)rie' )ih an opion o save a ne) fi#e if he
#i%i has no (een reached. Accessed on#y via he <ause 8enu.
'4a2 & Biss avai#a(#e saved ga%es o #oad. Accessed on#y via he <ause 8enu.
Inven34r? & +isp#ays any *nvenory ie%s he#d (y he p#ayer. Accessed (y hovering he
%ouse over he op of he screen during nor%a# ga%ep#ay' once he p#ayer is carrying
so%ehing.
Ina7e & +isp#ays a sing#e (uon o a-is he <ause 8enu. A#)ays visi(#e during
nor%a# ga%ep#ay.
C4nversa364n @ Biss he avai#a(#e +ia#ogue /pions in he acive !onversaion. /n#y
visi(#e )hen a !onversaion is acive.
H43sB43 @ +isp#ays a e- #a(e# sho)ing he na%e of any ?ospo or *nvenory ie%
underneah he cursor. /n#y visi(#e during nor%a# ga%ep#ay.
SuA363les @ +isp#ays he na%e and dia#ogue of he curren#y speaking !haracer. /n#y
visi(#e if Eu(i#es are se o /n fro% )ihin he /pions 8enu.
In3era<364n @ +isp#ays a #is of avai#a(#e *neracion choices for a se#eced ?ospo. 4o
used (y he de%o ga%e 1 on#y visi(#e )hen he ga%e,s *neracion %ehod is se o
!hoose ?ospo Then *neracion Csee secion 5.1D.
C4n3a6ner & +isp#ays he conens of he acive !onainer' and a#so he <#ayer,s
invenory. !#icking on ie% in one #is )i## ransfer i o he oher.
3hen ediing a %enu' you can choose o have i disp#ay in your 5a%e )indo) )hen your ga%e
is no running' o ge a #ive previe) of ho) i )i## #ook. Kus c#ick he Tes3 6n a7e $6n249G
check(o- a he op of he 8enu 8anager.
$pon se#ecing a 8enu o edi' i,s properies (o- )i## appear (eneah he #is of defined 8enus.
:ro% here you can give i a i#e Cfor reference purposes on#yD' assign a (ackground e-ure'
choose i,s orienaion' posiion' si6e' and %ore. The %ain propery o define is i,s ABBear 3?Be.
8enus can (e %ade o appear and disappear auo%aica##y' (ased on heir Appear ype. The
Appear ype can (e se o one of he fo##o)ing9
Manual & +eacivaes he 8enu (y defau#. !an on#y (e sho)n and hidden using he
8enu9 !hange Eae Acion or hrough scriping. <ause his %enu if you )ish o access i
via a key(oard or conro##er.
M4use Over & Acivaes he 8enu on#y )hen he p#ayer,s cursor hovers over i,s defined
area.
Dur6n8 C4nversa364n & Acivaes he 8enu on#y )hen a #is of dia#ogue opions' (y )ay
of a !onversaion prefa(' is %ade avai#a(#e. <ause his %enu if you )ish o access i via
a key(oard or conro##er.
On C4n3a6ner & Acivaes he 8enu )hen a !onainer has (een opened using he
C4n3a6ner: OBen Acion.
On InBu3 (e? @ *denica# o 8anua#' on#y a Togg#e key can a#so (e used o acivae and
deacivae he 8enu. The key,s na%e %us %ach ha of an a-is in he *npu seings.
On In3era<364n & Acivaes he 8enu once he p#ayer c#icks o se#ec a ?ospo. 3i##
deacivae again )hen he cursor #eaves i,s defined area. /n#y for use )ih he
*neracion %ehod !hoose ?ospo Then *neracion Csee secion 5.1D. <ause his %enu if
you )ish o access i via a key(oard or conro##er.
On H43sB43 & Acivaes he 8enu )henever he cursor is hovering over a ?ospo or
*nvenory ie% during nor%a# ga%ep#ay.
$>en SBee<> Pla?s & Acivaes he 8enu )hen a speech #ine is acive' (u on#y if
Eu(i#es are se o /n. !an addiiona##y (e fi#ered o on#y disp#ay for !haracer or
4arraion #ines C4arraion #ines (eing hose )ihou an associaed !haracerD.
Dur6n8 a7eBla? & Acivaes he 8enu on#y during nor%a# ga%ep#ay.
8enus can (e #ocked' and )on, (e sho)n uni# un#ocked' (y checking he S3ar3 8a7e l4<=e2
4CCG check(o-. They can a#so (e #ocked via he Menu: C>an8e s3a3e Acion in1ga%e.
Eo%e 8enus can (e se o pause he ga%e )hen acivaed. The 8enu 8anager a##o)s for a
Pause Aa<=8r4un2 3eF3ure o (e defined' )hich )i## cover he screen )hen his happens.
8enus can a#so (e %ade o run an A<364n'6s3 asse3 )hen hey urn on Csee secion 5.8D. The
+e%o ga%e,s <ause %enu %akes use of his (y riggering an Acion ha dese#ecs he acive
*nvenory' ensuring he %ain cursor is a#)ays acive )hen he <ause %enu is acive.
10." - MENU E'EMENTS
A 8enu is nohing uni# =#e%ens are added o i. 8enu =#e%ens %ake up a 8enu,s
funciona#iy' in he for% of Ba(e#s' 7uons' *cons and %ore. 3hen a 8enu is se#eced' i,s
=#e%ens are #ised underneah he properies (o-. :ro% here you can creae' re%ove and edi
=#e%ens' as )e## as re1arrange heir order.
Appearance seings such as fon' co#our and si6e are defined on a per1=#e%en (asis' a##o)ing
for deep cuso%isaion of 8enu appearances. A## e#e%ens can separae#y %ade visi(#e and
invisi(#e' (oh (y defau# or changes during ga%ep#ay via he 8enu9 !hange Eae Acion. *f an
=#e%en,s <osiion popup is se o Al68ne2' i )i## arrange ise#f auo%aica##y in #ine )ih oher
=#e%ens.
7efore you %ake a ne) =#e%en' you %us firs choose i,s ype' via he Ele7en3 3?Be pop1up
(o-. =#e%ens vary in appearance and funciona#iy depending on heir ype. Eo%e ypes' such
as Ba(e#s' are non1ineracive )hi#e ohers' such as 7uons' can (e c#icked on. 3hen an
=#e%en is se#eced' i,s properies (o- is disp#ayed.
The fo##o)ing #is of =#e%en ypes are avai#a(#e9
Bu334n & A si%p#e (uon ha can (e c#icked on. The Cl6<= 3?Be defines )ha happens
)hen c#icked on. A%ong he avai#a(#e opions are Run A<364n '6s3 and Cus347 S<r6B3'
(oh of )hich are descri(ed in he fo##o)ing secion. 7uons can a#so (e used o scro##
hrough a #is of invenory ie%s' urn pages in a Aourna#' and si%u#ae inpu keys.
CraC36n8 & <rovides a grid for p#acing do)n crafing ingrediens' and a space for he
resu#ing oupu *e%. !hange he CraC36n8 ele7en3 3?Be o choose (e)een hese )o
funcions.
C?<le & A #a(e# ha cyc#es hrough e#e%ens of a sring array )hen c#icked on. The
C?<le 3?Be defines i,s #ink o oher daa' and can (e used o affec ineger @aria(#es.
D6al48'6s3 & +isp#ays +ia#ogue opions of he acive !onversaion. !an eiher (e a #is
of a## avai#a(#e opions' or (e forced o a#)ays disp#ay he Ln,hL opion. *,s c#ick
funciona#iy is hand#ed auo%aica##y. *f he acive !onversaion has %ore acive opions
han he +ia#ogBis is se o disp#ay' he visi(#e opions can (e shifed (y using a 7uon
=#e%en )ih a Cl6<= T?Be of OCCse3 Inven34r? Or D6al48ue.
Dra8 & A##o)s eiher he enire 8enu or a sing#e =#e%en o (e dragged )ihin a pre1
defined (oundary. This a#so )orks on =#e%ens ha are #arger han he 8enu hey,re
conained in' %aking i usefu# for disp#aying docu%ens ha are #arger han he screen.
raB>6< & A##o)s a e-ure o (e dra)n. $n#ike he Ba(e# e#e%en' )hich can a#so
disp#ay a e-ure' he one in a 5raphic can a#so (e ani%aed' if he e-ure is %ade up of
fra%es se>uenced hori6ona##y.
InBu3 & A #a(e# ha can (e edied via key(oard )hen he e#e%en is acive. !an (e used
for pass)ord1inpu pu66#es. /piona##y' a 7uon on he sa%e 8enu can (e FriggeredG
)hen he =ner key is pressed. The e- va#ue can (e se o a Ering varia(#e (y using he
#ar6aAle: Se3 Acion.
In3era<364n & +isp#ays a sing#e *con as defined in he !ursor 8anager. *,s c#ick
funciona#iy is hand#ed auo%aica##y' (ased on he ga%e,s In3era<364n 7e3>42 Csee
secion 5.1D.
Inven34r?B4F & +isp#ays a #is of invenory ie%s carried (y he p#ayer & eiher )ih
icons or )ih na%es. *f i,s Inven34r? A4F 3?Be is se o H43sB43 Base2' his #is )i## (e
furher #i%ied o ie%s caered for (y he acive ?ospo. *f insead i,s se o DeCaul3' he
nu%(er of s#os sho)n can (e #i%ied. *f his is he case' and %ore ie%s are carried han
disp#ayed' a 7uon =#e%en )ih a Cl6<= T?Be of OCCse3 Inven34r? Or D6al48ue can (e
used o shif he disp#ayed ie%s. *f i,s se o D6sBla? Sele<3e2' i )i## sho) he icon of
he curren#y se#eced ie% & noe ha his is for visua# purposes on#y. ?o)ever' if se o
D6sBla? 'as3 Sele<3e2' i )i## provide he #as1se#eced ie% as a c#icka(#e icon' providing
an easy )ay for he p#ayer o re1se#ec heir #as1used ie%.
14urnal & +isp#ays e- fro% a nu%(er of pages. <ages can (e f#ipped hrough (y using
a 7uon =#e%en )ih a Cl6<= T?Be of OCCse3 14urnal. 8ore pages can (e added during
ga%ep#ay via he Menu: C>an8e s3a3e Acion.
'aAel & +isp#ays a e- (o- ha canno (e c#icked on. *f he 'aAel 3?Be is no se o
N4r7al' he e- #a(e# )i## (e rep#aced in1ga%e auo%aica##y. :or e-a%p#e' seing i o
H43sB43 )i## cause he #a(e# o change o he curren#y1acive ?ospo' and seing i o
#ar6aAle )i## cause he #a(e# o sho) he va#ue of pre1defined @aria(#es.
Saves'6s3 & +isp#ays a #is of saved ga%es found in he fi#e syse%. The Cl6<= a<364n is
used o deer%ine if c#icking #oads he% or over)ries he%. *f se o Save' an opion o
save a ne) ga%e )i## sho) if he nu%(er of save fi#es does no e-ceed he %a-i%u% se.
Sl62er 1 +ra)s a hori6ona# (ar )hose )idh represens a deci%a# (e)een 0 and 1. The
Sl62er aCCe<3s fie#d can (e used o #ink i )ih one of he hree sound ypes in he ga%e'
#ink o a f#oa 5#o(a# @aria(#e' or a##o) i,s va#ue o (e defined via a cuso% scrip.
/piona##y' an AcionBis asse can a#so (e run once he ga%e is saved.
T67er 1 +ra)s a hori6ona# (ar )hose )idh represens he i%e re%aining for he p#ayer
o se#ec a +ia#ogue opion' if he acive !onversaion is se o (e i%ed.
T488le 1 Ei%i#ar o a !yc#e' on#y he avai#a(#e va#ues are eiher /n or /ff. The T488le
3?Be fie#d can (e used o #ink i )ih he visi(i#iy sae of su(i#es' affec (oo#ean
@aria(#es' or a##o) i,s va#ue o (e defined via a cuso% scrip.
=#e%ens ha can (e c#icked on can a#so (e assigned )o sound c#ips9 one for )hen he =#e%en
is %ade acive Ci.e.' )hen he %ouse hovers over iD' and anoher for )hen he =#e%en is c#icked
on. 7efore such sound c#ips )i## p#ay' ho)ever' a DeCaul3 S4un2 BreCaA %us (e defined in
your scene' as i is hrough his prefa( ha %enu sounds )i## p#ay. To creae a prefa(' c#ick
S4un2 fro% he #is of o(Aecs in he Ecene 8anager' and hen drag i ino he +efau# Eound
prefa( (o- underneah S<ene Se336n8s.
10.3 - MENU SCRIPTIN
Aside fro% si%p#e co%%ands such as urning 8enus off or disp#aying #a(e#s' Advenure
!reaor,s 8enus re>uire e-ra seps o give he% funciona#iy. /ne of he avai#a(#e opions for a
7uon,s Cl6<= 3?Be is o Run A<364n '6s3 1 specifica##y an AcionBis asse Csee secion 5.8D.
The +e%o ga%e,s 8enu 8anager re#ies on an AcionBis asse )hen he p#ayer c#icks he Rui
7uon in he <ause 8enu 1 he AcionBis runs he En86ne: En2 8a7e Acion o e-i he ga%e.
8enu funciona#iy can (e cuso%ised %uch %ore heavi#y hrough scriping. 3henever a 8enu
is acivaed' a funcion ca##ed OnMenuEnaAle is ca##ed )ihin he MenuS?s3e7 scrip Cfound
)ihin Asses 1Q Advenure !reaor 1Q Ecrips 1Q 8enuD. The acivaed 8enu is sen o he
funcion as a para%eer' so ha specific co%%ands can (e issued o i.
8os c#icka(#e =#e%ens' such as 7uons' can a#so ca## he MenuS?s3e7 scrip )hen c#icked on
(y he p#ayer. !hanging a c#icka(#e =#e%en,s LypeL Cfor e-a%p#e' a 7uon,s !#ick ypeD o
!uso% Ecrip )i## cause he /n=#e%en!#ick funcion is run' )ih c#ick daa sen as para%eers.
10.% - SCENE-BASED MENUS
The Menu'6n= scrip #inks 8enus o scene o(Aecs' %aking i possi(#e for your ga%e o have 3+
%enus. To %ake a scene1(ased 8enu' he 8enu %us firs (e creaed as nor%a# )ihin he 8enu
8anager. Eince i )on, (e direc#y seen (y he p#ayer' i,s appearance is no i%poran. 8ake
sure i,s ABBear 3?Be is se o Manual' and ha EnaAle2 4n s3ar3 is #ef unchecked.
A scene1(ased 8enu re#ies on a separae 5a%e/(Aec for each 8enu =#e%en. *f an =#e%en has
%ore han one Fs#oG Cfor e-a%p#e' a EaveBisD' each s#o %us a#so (e a separae 5a%e/(Aec.
Aach he 8enuBink scrip o each 5a%e/(Aec' and hen use he *nspecor o ener he na%e of
i,s associaed 8enu and =#e%en. *f a 5$*Te- co%ponen is a#so aached o he o(Aec' i,s
Te- fie#d )i## (e se o he #inked =#e%en,s #a(e#. /her)ise' you can access he =#e%en,s #a(e#
fro% he 8enuBink scrip,s e3'aAel funcion.
3hen he 8enuBink scrip,s In3era<3 funcion is ca##ed' eiher hrough cuso% scriping or (y
using he OADe<3: Sen2 7essa8e Acion' he ga%e )i## reac as hough he =#e%en ise#f )as
c#icked on. *f he =#e%en is a 7uon' you can use an AcionBis asse Csee secion 5.8D o
%anipu#ae o(Aecs in your scene' for e-a%p#e %oving he !a%era o focus on anoher =#e%en.
CHAPTER III: E0TENDIN
)UNCTIONA'IT-
11.0 - INTERATIN NE$ CODE
11.1 - CUSTOM SCRIPTS
0ou can ca## a cuso% scrip & or raher' run a funcion )ihin a cuso% scrip & fro% an
AcionBis (y using he OADe<3: Sen2 7essa8e Acion. This Acion can (e used o send a
%essage o anoher o(Aec. *f ha o(Aec ho#ds any scrips ha dec#are a funcion )ih he
%essage,s na%e' hen ha funcion )i## run.
A drop1do)n #is in he OADe<3: Sen2 7essa8e Acion a##o)s you o choose he %essage ha he
Acion )i## send. As )e## as a nu%(er of sandard %essages used (y Advenure !reaor' you can
supp#y a cuso% %essage and' opiona##y' an ineger o pass as a para%eer.
The <aric#eE)ich scrip Cfound in Advenure!reaor ; Ecrips ; /(AecD can (e used in his
%anner o urn paric#e syse%s on and off. Ei%p#y aach he scrip o a <aric#e Eyse%' and
hen use he OADe<3: Sen2 7essa8e Acion o ca## i,s TurnOn and TurnOCC funcions o ena(#e
and disa(#e i respecive#y.
As anoher e-a%p#e' #e,s say )e )an o inegrae an Achieve%en scrip ino our ga%e. This
scrip causes an achieve%en %essage o disp#ay on he screen & he %essage disp#ayed (eing
deer%ined (y an ineger. /ur scrip %igh conain he fo##o)ing funcion9
DisplayAchievement (int achievement(n)mber) *+
Euppose' as par of a !uscene' )e )an Fachieve%en 3G o appear. 3e si%p#y add an OADe<3:
Sen2 Messa8e Acion o our !uscene' se#ec our Messa8e 34 sen2 para%eer as Cus347' ener
D6sBla?A<>6eve7en3 as our Me3>42 na7e' ick he Pass 6n3e8er 34 7e3>42G check(o-' and
ener he nu%(er 3 ino he In3e8er 34 sen2 fie#d.
4oe ha )hen a cuso% scrip is ca##ed in his )ay' i )i## run in para##e# o he AcionBis i is
ca##ed fro% & he ga%e )i## no )ai for he cuso% scrip o finish (efore coninuing. *n order o
)rie a scrip ha inegraes %ore direc#y )ihin he AcionBis syse%' you %ay )an o )rie
your o)n Acion & he process of )hich is ou#ined in he ne- secion.
11." - CUSTOM ACTIONS
:or an inroducion o Acions and heir funcions' refer o he secion 5.2.
=ach Acion used (y Advenure !reaor is a se#f1conained scrip fi#e. They can (e ena(#ed and
disa(#ed (y using he Acions 8anager. 3hen ReCres> l6s3 is c#icked' he Acions 8anager
searches a cuso% fo#der for scrips )ih he F.csG fi#e e-ension' and #iss he%' so ha hey can
(e ena(#ed' disa(#ed' and have a defau# se. /n#y one fo#der can (e defined a a i%e' so a##
acion fi#es %us (e p#aced ogeher.
4oe ha his (uon )i## no )ork if he ga%e,s p#afor% is se o 3e(p#ayer during
deve#op%en.
=ach Acion is a su(c#ass of he Acion (ase c#ass' and i,s i%p#e%enaion and inspecor 5$* are
)rien ogeher. 7y )riing a ne) Acion su(c#ass scrip and p#acing i inside he sa%e fo#der as
he oher Acion scrips' i can (e inegraed ino he syse% for use )ih in AcionBiss and
*nvAcionBiss.
To (e proper#y visi(#e inside he Acions 8anager' a ne) Acion %us have i,s title fie#d defined
)ihin i,s consrucor. An override funcion ca##ed ho#",I is used o disp#ay para%eers inside
i,s inspecor.
An AcionBiss, Acions are sored inside a #is varia(#e. 3hen an AcionBis runs' i ca##s upon
i,s firs Acion Cvia he Acion,s Run funcionD' and hen su(se>uen Acions (ased on he
previous Acion,s co%%and & eiher coninuing o he ne- Acion' skipping o a pre1deer%ined
nu%(er' or ha#ing. The AcionBis )i## on#y %ove ono i,s ne- Acion once he curren one is
no #onger running' as se )ih he isRunning (oo#ean.
The Acion,s Run funcion reurns a f#oa' )hich corresponds o he i%e ha he AcionBis )i##
)ai (efore running he Acion again' o see if he Acion,s ask has (een co%p#eed. A proeced
f#oa ca##ed de-aultPauseTime is ofen ca##ed (y Acions )hen he i%e aken o co%p#ee a ask
canno (e ca#cu#aed.
/nce an Acion,s ask has (een co%p#eed' AcionBis )i## ca## ha Acion,s .nd funcion. This
is a#ready )rien in he Acion (ase c#ass fi#e' and does no nor%a##y need o (e overridden. The
=nd funcion reurns an ineger ha represens he Acion ha he AcionBis shou#d ne- run' if
no he one ha i%%ediae#y fo##o)s. This is ho) AcionBiss can skip cerain Acions. *f he
reurned va#ue is 11' he AcionBis )i## sop and ga%ep#ay )i## resu%e. *f i is 12' he AcionBis
)i## sop (u assu%e anoher AcionBis has aken over ga%e1pausing duies. *f he reurned
va#ue is 6ero' he AcionBis )i## ae%p o run he ne- Acion as nor%a#.
To assis in he creaion of ne) Acions and he#p )ih he undersanding of ho) hey )ork' a
e%p#ae Acion scrip & )ih co%%ens & has (een )rien' ca##ed ActionTemplate(cs. * can (e
found in Asses ; Advenure!reaor ; Ecrips ; AcionBis.
11.3 - CUSTOM PATH)INDIN
Advenure !reaor provides )o %ehods of pahfinding & 8esh !o##ider and $niy 4avigaion
Csee secions 2.10 o 2.12D. 7oh %ehods are )rien in separae scrips' )hich are (oh
su(c#asses of he Nav68a364nEn86ne Ecripa(#e/(Aec c#ass.
The correc su(c#ass is insaniaed a runi%e (y he 4avigaion8anager co%ponen of he
5a%e=ngine prefa(' )hich uses he ACENav68a364nMe3>42 enu% o deer%ine he c#ass,s
na%e. :or e-a%p#e' A!M4avigaion8ehod.$niy4avigaion enu% insaniaes he
4avigaion=ngineM$niy4avigaion c#ass.
To inegrae a ne) pahfinding %ehod ino Advenure !reaor' si%p#y add a %ehod na%e o he
4avigaion8ehod enu% Cfound in Advenure!reaor ; Ecrips ; Eaic ; =nu%s.csD' and
creae a 4avigaion=ngine su(c#ass )ih he na%e syna- 4avigaion=ngineM4e)8ehod4a%e.
0ou can refer o he 4avigaion=ngine scrip Cfound in Advenure!reaor ; Ecrips ;
4avigaionD o see )ha funcions can (e overridden.
The on#y essenia# funcion is 5e<oinsArray' )hich akes )o @ecor3s as inpus and reurns a
@ecor3 array ha descri(es he pah. /her funcions' such as Ee@isi(i#iy and
EceneEeings5$* can (e used o (eer inegrae he %ehod ino your )orkf#o)' (u are no
necessary.
11.% - CUSTOM ANIMATION ENINE
Advenure !reaor provides hree %ehods of ani%aion & Begacy 3+' $niy,s (ui#1in 2+' and
2+ Too#ki. These %ehods are )rien in separae scrips' )hich are su(c#asses of he
An67En86ne Ecripa(#e/(Aec c#ass.
The correc su(c#ass is insaniaed a runi%e for each !haracer and /(Aec9 Ani%ae Acion'
)hich use he ACEAn67a364nEn86ne enu% o deer%ine he c#ass,s na%e. :or e-a%p#e'
A!MAni%aion=ngine.Bgegacy insaniaes he Ani%=ngineMBegacy c#ass.
To inegrae a ne) ani%aion engine ino Advenure !reaor' si%p#y add a %ehod na%e o he
A!MAni%aion=ngine enu% Cfound in Advenure!reaor ; Ecrips ; Eaic ; =nu%s.csD' and
creae a Ani%=ngine su(c#ass )ih he na%e syna- Ani%=ngineM4e)8ehod4a%e. 0ou can
refer o he Ani%=ngine scrip Cfound in Advenure!reaor ; Ecrips ; Ani%aionD o see )ha
funcions can (e overridden.
1".0 @ HO$ IT $OR(S
1".1 - O#ER#IE$
The fo##o)ing secion gives a (road overvie) of he syse% (ehind Advenure !reaor' so ha i
can (e (ui#1upon o caer o a scriper,s needs. The secions ha fo##o) provide a %ore in1deph
e-p#anaion of %ore specific e#e%ens.
The sing#e %os i%poran varia(#e used (y Advenure !reaor is he 8a7eS3a3e' a pu(#ic
varia(#e inside he Eae?and#er scrip' )hich is referenced (y he %aAoriy of he ga%e,s oher
scrips. The 5a%eEae enu% can ake he fo##o)ing four va#ues9 4or%a#' !uscene'
+ia#ogue/pions' and <aused. To ake conro# a)ay fro% he p#ayer' he ga%eEae %us (e se
o !uscene' and reurned o 4or%a# o resu%e ga%ep#ay. The Eae?and#er a#so conains )o
funcions ha can disa(#e and re1ena(#e a## of Advenure !reaor,s syse%s Csee secion 12.4D.
The Eae?and#er scrip is a co%ponen of he <ersisen=ngine prefa(' one of )o FengineG
o(Aecs ha are re>uired for Advenure !reaor o )ork. Pers6s3en3En86ne is scene1independen'
in ha i,s daa survives scene #oading' and a7eEn86ne is scene1specific' and does no survive
scene #oading.
Ecrips find he acive 5a%e=ngine' <ersisen=ngine' and he <#ayer prefa(s (y he ags of he
sa%e na%e' so here %us on#y ever (e one o(Aec )ih each ag presen in he scene a any one
i%e.
/f he )o engines and he p#ayer' on#y he 5a%e=ngine is presen )hen he scene (egins. A
co%ponen inside 5a%e=ngine' ca##ed (6<=s3ar3er' )i## creae an insance of (oh he
<ersisen=ngine and he <#ayer prefa(s if none e-is. This )ay' a ga%e can (egin fro% any
scene' )hich is usefu# for ga%e esing.
The 5a%e=ngine is used o sore and hand#e daa ha does no need o (e carried o he ne-
scene. * houses he p#ayer conro# scrips' he %enu syse%' scene1specific seings and he
dia#ogue1hand#ing scrip.
The <ersisen=ngine is used o sore and hand#e daa ha needs o ransfer fro% one scene o he
ne-. * houses he opions and ga%e saving scrips' saved roo% daa as )e## as #oca# insances of
he varia(#es and invenory ie%s defined in he %anagers.
/n#y one acive ca%era is ever presen in he ga%e & he Ma6nCa7era. The oher ca%eras'
inc#uding he opiona# :irs <erson !a%era' are %ere#y used as reference (y he %ain ca%era.
3hen assigned an Facive!a%eraG varia(#e' he %ain ca%era )i## i%iae ha ca%era,s posiion'
roaion' and fie#d of vie).
8os proAec1specific daa is sored in he various 8anager asses' as e-p#ained in he ne-
secion.
1"." - MANAERS
=ach 8anager is i,s o)n asse fi#e. A proAec can have %u#ip#e 8anagers of he sa%e ype in
i,s Asses fo#der' (u on#y one of each )i## (e used (y he ga%e. 3hich one i uses is deer%ined
(y he ReCeren<es fi#e' )hich %us e-is direc#y in a 2esources direcory.
The 2eferences scrip defines one pu(#ic fie#d for each %anager. The Adv5a%e scrip conains a
saic funcion ca##ed e3ReCeren<es' )hich can (e used o >uick#y o(ain each of he 8anagers
(eing used (y he ga%e. :or e-a%p#e' AdvGame.GetReferences ().settingsManager )i## reurn
he acive Eeings 8anager.
!hanges %ade in he %anagers' e-cep hose %ade in he Ecene 8anager' survive asse%(#y
re#oads. 7ecause %os scrips ha refer o he% do so on#y )hen needed' you can %ake changes
o your ga%e )hi#e he ga%e is running Csuch as changing he %ove%en %ehodD. The g#o(a#
varia(#es defined in he @aria(#es 8anager' ho)ever' are kep separae a runi%e. The
5#o(a#@aria(#es scrip' aached o he <ersisen=ngine prefa(' sore a #oca# copy of he 5#o(a#
@aria(#es )hen he ga%e sars. This )ay' )hen !uscenes and oher ga%e #ogic affec he sae
of he varia(#es' he changes are no passed recursive#y (ack o he @aria(#es 8anager.
1".3 - PATHS
<ahs are used o provide navigaion o !haracers so ha hey can %ove around a scene. The
<ahs scrip sores a #is of @ecor3s' as )e## as addiiona# varia(#es for hings #ike %ove speed'
pah ype' and so on.
These @ecor3s' or nodes' descri(e a roue hrough he scene. A !haracer %oving a#ong a <ah
)i## #oop' ping1pong (e)een he ends' or %ove o rando% nodes depending on he pah ype. A
!haracer %oves a#ong a pah (y assigning ha !haracer,s a<36vePa3> varia(#e (y using he
Se3Pa3> funcion. A !haracer,s 3ar8e3N42e and BrevN42e inegers' )hich represen he arge
node and previous#y1visied node respecive#y' a##o)s he !haracer o deer%ine )here on he
pah hey are' and )hich direcion hey shou#d (e %oving in.
A !haracer %oving a#ong a <ah )i## refer o ha <ah,s scrip o deer%ine i,s course of acion
upon reaching a node. The pu(#ic funcion e3NeF3N42e reurns a node ineger' )hich )i## (e
11 if he !haracer has reached he end of he <ah.
*f a !haracer prefa( has a <ahs scrip aached' i can dyna%ica##y a#er his <ah %id1ga%e.
This is he (asis of pahfinding. The M4veAl4n8P46n3s funcion' inside he !haracer scrip'
)i## re1(ui#d i,s o)n <ah according o a supp#ied array of @ecor3s' effecive#y re1assigning ha
<ah,s nodes.
The array of @ecor3s for his funcion is generaed (y he 4avigaion8esh scrip. The
e3P46n3sArra? funcion re>uires a saring @ecor3 and a arge @ecor3' and ana#yses he
acive 4av8esh o produce he array. *f you )ish o rep#ace he defau# pahfinding a#gorih%
)ih your o)n' his is he funcion o override.
1".% - P'A-ER CONTRO'
The <#ayer is conro##ed indirec#y' via five scrips on he 5a%e=ngine. They are9
Pla?erMenus & ?and#es he disp#ay of %enus according o heir AppearType
Pla?erCurs4r & ?and#es he disp#ay of he cursor
Pla?erInBu3 & F2eads inG he p#ayer,s inpu (uons and a-es
Pla?erIn3era<364n & ?and#es he processing of c#icks on ineracive o(Aecs
Pla?erM4ve7en3 & ?and#es he %ove%en of he <#ayer o(Aec during ga%ep#ay
=ach scrip is independen fro% he ohers as (es can (e. The <#ayer*npu scrip does no refer
o any of he ohers' (u a## ohers refer o i. 7y keeping scrips separae in his )ay' i is no
difficu# o provide he p#ayer )ih %ore conro#.
3hen you )ish o add your o)n cuso% <#ayer conro# )ihou affecing he oher scrips' i,s
reco%%ended ha your <#ayer prefa( uses he 8ecani% engine for ani%aion' so ha you can
scrip para%eer changes )ihou inefering )ih he oher syse%s. *f you )ish o disa(#e
Advenure !reaor a any i%e' even if i is for a (rief i%e such as )hi#e firing a )eapon' you
can easi#y do so (y accessing he JickEarer scrip. Eince i re#ies on o(Aecs creaed a runi%e'
ca##s o i in A#a$e /0 )i## no )ork' (u tart /0 )i## )ork Aus fine. The code o disa(#e and re1
ena(#e Advenure !reaor is as fo##o)s9
GameObject.FindWithTag (Tags.gameEngine).GetComponent
<Kic!tarter"().T#rn$ffAC ()%
GameObject.FindWithTag (Tags.gameEngine).GetComponent
<Kic!tarter"().T#rn$nAC ()%

Manual PDF

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Manual PDF

Hochgeladen von

Copyright:

Verfügbare Formate

Adventure Creator User Manual

Das könnte Ihnen auch gefallen