Flowgraph Plugin - SpawnEntity
Author: Kevin "Cry-Vlok" Kirst
RenEvo Sofware & Designs
http://www.renevo.com/

Version: 1.0.1.2
Date: August 27, 2008

------------------------------------------------------------------------------
- 1. About
------------------------------------------------------------------------------
This Plugin adds two (2) custom Flowgraph Nodes that will allow you to spawn
an entity or an archetype entity dynamically from the Flowgraph. You can also
give the new entity a unique name and define its initial starting position and
orientation.

------------------------------------------------------------------------------
- 2. Usage
------------------------------------------------------------------------------
To use this Plugin you will need to have installed the Flowgraph Plugin System
into your Crysis mod folder. Extract the Plugin Dll into your FGPlugins' bin32 and bin64
folders, according to the Dll version. Note that the Plugin's installer will
correctly copy the Plugin Dll files to the right folders. Once copied, just launch
your mod in the Sandbox Editor and the included nodes will appear in the Flowgraph
Editor.

------------------------------------------------------------------------------
- 3. Node Definitions
------------------------------------------------------------------------------
Name:		Entity:Spawn

Purpose: 	Spawns an entity from the rollup bar.

In:		Spawn - (Any) Call to spawn the entity
		Class - (String) Entity class name to spawn. (From the rollup bar)
		Name - (String) Name to give the new entity.
		Pos - (Vec3) Starting position
		Rot - (Vec3) Starting rotation
		Scale - (Vec3) Starting scale

Out:		Done - (Any) Called when spawn order is sent.
		Succeeded - (EntityId) Returns EntityId if spawn is successful.
		Failed - (Any) Called if spawn is not successful.

Remarks:	The Class of the entity is what you see in the Rollup bar when
		you go to place an entity. An example would be "Binoculars" from
		the Items folder. If the entity specified is spawned successfully,
		its EntityId is returned through the Succeeded output port.



Name:		Entity:SpawnArchetype

Purpose: 	Spawns an entity archetype from the loaded Database files.

In:		Spawn - (Any) Call to spawn the entity
		Archetype - (String) Fully-qualified path of the archetype.
		Name - (String) Name to give the new entity.
		Pos - (Vec3) Starting position
		Rot - (Vec3) Starting rotation
		Scale - (Vec3) Starting scale

Out:		Done - (Any) Called when spawn order is sent.
		Succeeded - (EntityId) Returns EntityId if spawn is successful.
		Failed - (Any) Called if spawn is not successful.

Remarks:	The Archetype property should be the fully-qualified path of
		the archetype entity you wish to spawn. An example from the
		Asian Entity Library would be:

		"Asian.Camper\Camp.Heavy_Rifleman_a"

		Note that the Entity Library must be loaded on the level from
		the Database editor before an archetype can be spawned from it.
		If the entity specified is spawned successfully, its EntityId
		is returned through the Succeeded output port.

------------------------------------------------------------------------------
- 4. Contact
------------------------------------------------------------------------------
Name: Kevin "Cry-Vlok" Kirst
Email: kkirst@gmail.com
