==================
DESCRIPTION:
==================

A DA2 port of the script that I made for Origins which allows you to spawn any creature from both the base game and DLCs. Creatures spawned with this script can be optionally assigned as hostile, neutral, or friendly to the player as well as have their creature rank overwritten.

Special thanks to Shanamah for showing me how to compile scripts for DA2

==================
NOTES:
==================

Because the console text is invisible in DA2, I added floating messages to show that the script is running/show some help text if the command was formatted incorrectly. If you don't see any text appear when you run the script, then you most likely have a typo in the "runscript spawn_cr" portion of the command

I tried to implement the "spawn with animation" script that I made for the Origins version of this mod but I had trouble getting most of the animations to play in game, even with the zz_playanimation script that is included in the vanilla game files, so I decided to scrap the idea

==================
USAGE:
==================

runscript spawn_cr <Tag> [Group] [Rank]

<Tag>    - Creature tag for the creature to be spawned (See included reference doc for a list of tags)
[Group]  - Optional identifier that sets the creature's group to hostile, neutral, or friendly. If empty, the creature's default group will be used
[Rank]    - Optional identifier that sets the creature's rank to one of the following values: [invalid|critter|normal|lieutenant|boss|elite_boss|player]. If empty, the creature's default rank will be used

==================
EXAMPLES:
==================

Spawn Anders
    runscript spawn_cr gen00fl_anders

Spawn a hostile Corypheus
    runscript spawn_cr drk000cr_corypheus hostile

Spawn a neutral Varterral
    runscript spawn_cr mrl251cr_varterral neutral

Spawn a friendly Duke Prosper
    runscript spawn_cr eye600cr_boss_prosper friendly

Spawn a hostile Danarius with the "boss" rank
    runscript spawn_cr fen311cr_danarius hostile boss

==================
OPTIONAL SCRIPTS:
==================

Included in the "optional files" section is a set of scripts for converting NPCs into "non-party followers." This means the NPC will follow you around (and potentially fight with you if it is spawned as friendly), but will not cross through area transitions, and doesn't count as an actual party member

The npf_add script converts an npc to a non-party follower

The npf_remove command turns them back to normal (NOTE: this means that the NPC will stay wherever it was standing when you ran the command)

For both of these scripts, you can either provide a creature tag to target a specific NPC, or leave the parameter blank to run the script on the nearest NPC. Also, plot follower NPCS (your main comapnions) will not be affected by this scripts.

==================
OPTIONAL SCRIPT USAGE:
==================

runscript npf_add [Tag]

<Tag>    - Optional Creature tag for the creature to be added as a non-party follower (See included reference doc for a list of tags). If this parameter is not provided, the script will add the closest NPC.


runscript npf_remove [Tag]

<Tag>    - Optional Creature tag for the creature to be removed as a non-party follower(See included reference doc for a list of tags). If this parameter is not provided, the script will remove the closest non-plot NPC.

==================
ACKNOWLEDGEMENTS:
==================

pygff for helping me get the list of all of the creatures from the ERF files

Shanamah for showing me how to compile scripts for DA2

==================
INSTALLATION:
==================

Unzip the downloaded file and place the "Creature Spawn Script" folder into your override folder.

==================
UNINSTALLATION:
==================

Delete the "Creature Spawn Script" folder from your override folder.