HPL3/Amnesia: Rebirth/Tutorials/Wraiths - Revision history

Crater: clarified agent activation

2020-11-12T11:07:45Z

clarified agent activation

Crater: formatting 3

2020-11-11T11:27:16Z

formatting 3

Crater: formatting 2

2020-11-11T11:25:47Z

formatting 2

Crater: formatting / fixed link

2020-11-11T11:25:27Z

formatting / fixed link

Crater: Created basic wraith setup tutorial

2020-11-11T11:22:55Z

Created basic wraith setup tutorial

New page

This tutorial will go over the basic setup required to use a Wraith agent. This tutorial assumes you have basic mapping and scripting knowledge.

== Map Setup ==

First, make sure any agents placed in your map are set to be inactive. This ensures that, when later activated in your map script, the agent is successfully added to AgentBlackboard.

The agent requires path nodes to move around, so make sure your map is populated with plenty of nodes. You can use the PathNodeGenerator area type to easily generate a large amount of nodes automatically (make sure whatever surfaces you want to generate nodes on are inside the area), but you may still want to place nodes manually in areas with difficult or precise navigation.

Wraiths require special map setup to function properly. Import the linked expobj file and place the objects far beneath your map, such as at 0,-1000,0. This allows the wraiths spotlight to function.
[https://mega.nz/file/bBNAWbBT#N3yaOVIKjlLxL4H9LpjnRnjVUB1i6lnPU6C3yq59Ox8/ temp]

== Scripting Setup ==

In your map scripts OnEnter() routine, include the following function. This links the wraith billboard objects used for the spotlight to any Wraith agents in your map.

<syntaxhighlight lang="c++">Blackboard_AddWraithBillboards("WraithBillboard");</syntaxhighlight>

If all other prerequisites are fulfilled, your Wraith should be reactive to the player upon being activated in the map script.

To give the Wraith additional behavior, set up and switch the Wraith into the appropriate mode and issue commands as desired.

{{tip| More information on Wraith modes and commands can be found on the [[HPL3/Amnesia:_Rebirth/Scripting/Agents/Wraiths|Wraith agent page]].}}
{{ConstructionNotice| Wraith agent page coming soon!}}

← Older revision		Revision as of 11:25, 11 November 2020
Line 7:		Line 7:
	The agent requires path nodes to move around, so make sure your map is populated with plenty of nodes. You can use the PathNodeGenerator area type to easily generate a large amount of nodes automatically (make sure whatever surfaces you want to generate nodes on are inside the area), but you may still want to place nodes manually in areas with difficult or precise navigation.		The agent requires path nodes to move around, so make sure your map is populated with plenty of nodes. You can use the PathNodeGenerator area type to easily generate a large amount of nodes automatically (make sure whatever surfaces you want to generate nodes on are inside the area), but you may still want to place nodes manually in areas with difficult or precise navigation.

−	Wraiths require special map setup to function properly. Import [https://mega.nz/file/bBNAWbBT#N3yaOVIKjlLxL4H9LpjnRnjVUB1i6lnPU6C3yq59Ox8/ this expobj file] and place the objects far below your map, such as at <code>0,-1000,0</code>. This allows the ~~wraiths~~ spotlight to function.	+	Wraiths require special map setup to function properly. Import [https://mega.nz/file/bBNAWbBT#N3yaOVIKjlLxL4H9LpjnRnjVUB1i6lnPU6C3yq59Ox8/ this expobj file] and place the objects far below your map, such as at <code>0,-1000,0</code>. This allows the Wraith spotlight to function.

@@ Line 16: / Line 16: @@
 <syntaxhighlight lang="c++">Blackboard_AddWraithBillboards("WraithBillboard");</syntaxhighlight>
-If all other prerequisites are fulfilled, your Wraith should be reactive to the player upon being activated in the map script.
+If all other prerequisites are fulfilled, your Wraith should be reactive to the player upon being activated via <code>Entity_SetActive()</code> in the map script.
 To give the Wraith additional behavior, set up and switch the Wraith into the appropriate mode and issue commands as desired.

@@ Line 12: / Line 12: @@
 == Scripting Setup ==
-In your map scripts OnEnter() routine, include the following function. This links the wraith billboard objects used for the spotlight to any Wraith agents in your map.
+In your map scripts <code>OnEnter()</code> routine, include the following function. This links the wraith billboard objects used for the spotlight to any Wraith agents in your map.
 <syntaxhighlight lang="c++">Blackboard_AddWraithBillboards("WraithBillboard");</syntaxhighlight>

@@ Line 7: / Line 7: @@
 The agent requires path nodes to move around, so make sure your map is populated with plenty of nodes. You can use the PathNodeGenerator area type to easily generate a large amount of nodes automatically (make sure whatever surfaces you want to generate nodes on are inside the area), but you may still want to place nodes manually in areas with difficult or precise navigation.
-Wraiths require special map setup to function properly. Import the linked expobj file and place the objects far beneath your map, such as at 0,-1000,0. This allows the wraiths spotlight to function.
+Wraiths require special map setup to function properly. Import [https://mega.nz/file/bBNAWbBT#N3yaOVIKjlLxL4H9LpjnRnjVUB1i6lnPU6C3yq59Ox8/ this expobj file] and place the objects far below your map, such as at <code>0,-1000,0</code>. This allows the wraiths spotlight to function.
-[https://mega.nz/file/bBNAWbBT#N3yaOVIKjlLxL4H9LpjnRnjVUB1i6lnPU6C3yq59Ox8/ temp]
 == Scripting Setup ==