newspawns readme file

please read with Word Wrapping on (found under the format menu in notepad)

Installation:

Extract all .u, .ini, and .int file into your UT's System folder

Usage:

Add the mutator from the ingame menus or for servers the mutator name is newspawns.newspawns.
You may delete the int file if you prefer it not showing on the mutators list but you will have to use the server method and not GUI

Setup:

By default the only map set up was DOM-Olden, to set up a new one you must open the spawnprofiles.ini file, and copy the layout to map1 map2 etc


Adding spawn points/ingame commands

The mutator will automaticially dump all spawn points to dumplocations.ini as MapName= and defaultpoints[x]=
You can have your current location dumped by typing in game !dumplocation
You can have a new spawn point added immediately by typing in game !addpoint   (note that ballowaddpoints must be set to True)


So for example you can copy existing spawn points over, then dump the location of the one you don't like and remove it.  Or you can make all new spawnpoints from scratch.  You must set the new map you want to a profile in the ini first like so: [newspawns.map1] map=DM-Deck16][     You must do this before the map is loaded, so reload the map for the profile to load and to make changes ingame



Note: Do not leave spaces in arrays, if [3] is blank, then any number higher than 3 will be presumed blank. There is no cleanup function, if you manually remove one you must re-number them



Admin commands:

!testspawns  Will spawn a barrell at each spawn point
!finishtest  Will destroy all barrells

- Default config options (in dumplocations.ini)

[newspawns.newspawns]
debug=False                      leave this as false, its only for debugging if a problem comes up
isdisabled=False		 Pointless option, but lets you disable the loading of the mutator at startup
ballowaddpoints=False		 If set to True, the !addpoints command will be allowed (for yourself and all other players, spectators)
dumplocation[x]=		Location you have dumped for later usage (removing spawn points, may later be able to add objects at these locations)

MapName=			Tells you the map name for defaultpoints
defaultpoints[x]=		All default spawn points dumped for the named map



Limits

- to 100 spawn points per map, currently only supports 10 maps. [and requires new classes to be generated and some changes to the default options before recompiling]


Future

- I will likely add support for multiple team spawnlocations, and the spawning in of objects in predetermined places Redeemer etc

- Probably seperate the default config options from the dumplocations



Bonus

As a bonus I threw in a mutator that triggers the hatch to open in this map and can be used in other maps to trigger triggers automaticially right after map starts. Off hand maps that come to mind are the sail in DM-KGalleon, the cage in DM-Tutorial, and the shieldbelt in DOM-Olden.  Mutator must be added by commandline
name: newspawns.triggers


Credit:

billybill (Author/Release)
MrLoathsome (Random Spawn Locations). 
Feralidragon (for help with teleport effect)
