UO Event 1.3

What is it ?
A tool that will generate Event commands at the press of a button. 
The tool interfaces with UO Auto Map (UOAM in short) for various options. Download UOAM at http://uo.stratics.com/uoam
Originally designed to help Counselors and Interest Volunteer, UO Event now focuses on helping the Event Moderators.
This tool is intentionally not distributed in public. To get the latest release, contact Xena Dragon.

Installation:
To install the tool execute setup.exe and pick a directory in which to install.  
If you already have added or changed locations in your current version, make sure to backup the file locations.txt in your Event Tool directory and restore that after you install this version !! 
If you have shard-specific locations, you can now stick those in separate files. See the locations page for more info on this. 

Usage:
First of all: Not all commands work for all roles. Please check your manual (or use the .pl command) to see which commands are available to you.

Let the mouse hover over the buttons to see a small description of the function of each button.

With the View menu you can select an event role that suits your in-game character. 

Role Views:
Most buttons speak for itself. If additional parameters are needed for a command then a window will pop-up allowing you to enter them. Currently the tool supports the command set for Event Moderators and Event Drones.

Selecting Locations:

The locations pop-up has some extra options:
•	Map: Centers the UOAM map on the selected location
•	Marker: Drops the UOAM marker on the selected location
•	Track: Toggles the UOAM tracking option
•	Collapse: Collapses all nodes of the locations tree
•	Expand: Expands all nodes of the locations tree
•	Add: Allows you to add one location to the tree
•	Edit: Allows you to edit the selected location
•	Delete: Deletes an entire node of the tree
•	Import: Imports locations that were exported to a file. Use this to share locations with others. You can also read and auto-convert UOAM .map files
•	Export: Exports the selected node and all levels below it to a file
•	Also note that double-clicking on a location will add that location to an 'Event' node. Very handy to have several locations used in one event grouped together

All locations are stored in an easy to navigate tree-structure. Currently there are over 800 locations on file.

Locations are stored in several files. There is one main “locations.txt” file that will be replaced when you re-install the tool. Be sure to make a backup of that file if you value your added locations. There are also shard specific files that contain locations for a specific shard.  These files are not overwritten when you re-install the tool.  All shard specific locations must be stored in the locations branch named “Shard”. When entering a shard name, use the full name, with spaces where needed. For instance “Great Lakes” would be a valid name, and “napavalley” would be an invalid name.

Spawning:

•	Spawning monsters and animals is done by selecting one from the list and clicking on 'Spawn'. You will get a target cursor in UO that allows you to pick the spot on-screen where to spawn. 
•	Alternatively it is possible to spawn a monster or animal anywhere on the map by using the 'Select Location' button. You'll be able to select a x,y,z location by using the Locations pop up.
•	Double-clicking on a monster/animal will add that creature to the 'Event' node. Very handy to have several spawned creatures used in one event grouped together
•	A spawn "Here" button that will only work if you have UOAM running. It will spawn a monster at the exact position where you are standing in-game. Just be invisible and click repeatedly to spawn a bunch of monsters around you.
•	A spawn "Area" and "Circle" button that will spawn 8 monsters or items (gold for instance) in a circle around you. This command requires UOAM to be running. "Area" is a wider circle than "Circle".
•	Some spawn types are not allowed to be spawned just like that. For those spawns, a pop-up message will appear asking you if you have asked permission to spawn this.  Do not spawn anything that you need permission for without getting permission first !

Targeting:

Some commands pop-up this window that allow you to select the method of targeting.
•	You can enter your favorite targets in the favorites list. This list is saved when the tool is exited and loaded again at startup. Use this to keep track of frequently used targets, such as other event characters.
•	The 'Delete Target' button lets you remove targets from the target list.

Options Menu:

The options menu has the following entries: 
•	About                		- Will display the about screen
•	Add Text to Log File 	- Allows you to enter remarks to the log file. Very handy for when you write your report at the end of the week
•	Select Log File      	- In the log file the start and end date/time will be written everytime you start and stop the tool. You can use this information to check the amount of time you spent on events per week. Default filename is EventLog.txt 
•	Switch to Hor./Vert. 	- To toggle the orientation of the tool

Also there are some switches that you set in the options menu:
•	Always on Top 	- To have the tool always as topmost window
•	Coordinates in () 	- Previously x,y,z coordinates did not have to have parenthesis around them. This will let you switch between both formats. 
•	Show Commands	- This will (ab)use the Party command 'Note to self' to show all commands the tool generates in the UO Journal log.

Tweaking:

•	Tweaking of self or other event characters can be done with this panel. The 'Fame', 'Karma' and 'Hue' buttons bring up another window that allow you to easily pick titles and colors to tweak.
•	The 'Set All non-skills' and 'Set All Skills' buttons can come in handy. These only work on auto-targets. The first one sets all stats and other non-skill attributes to the values entered in the fields. The second one sets *all* skills to the value entered in the skill level field. This can be used to quickly tweak all skills of an event drone to zero.
•	Quick Autotarget Setup takes pre-set values from the file “tweaks.txt” and allows you to quickly tweak creatures into specials.

Setting of Town Cryers:

Clicking the 'Set Town Cryer' button gives this window. With it you can easily set a series of Town Cryers with a predefined set of messages.  Simply select which Cryers you want to set, and select which sentences you want those cryers to say.  Use the Shift and/or Ctrl keys to make your selection.  When all has been set, click 'Go!' and sit back :) 

It will require a bit of time to enter all Town Cryer ID's and locations into the tool, but that time is easily gained back the first time multiple cryers have to be set for an event. 
UO Auto Map interface:

The interface with UOAM allows you to teleport across Britannia *real* easy. Just right-click on the UOAM map and select 'Extensions' from the menu. Then select Teleport or Create Moongate. Note: You need UOAM version 3.6 or higher. UOAM is a 3rd party tool that is approved by OSI, so no worries about using it.

Also, UOAM provides the UO Event tool with coordinates for the Spawn Here, Spawn Circle and Spawn Area commands.

Download UOAM from http://uo.stratics.com/uoam/

That´s all. Have fun!

History:
Version 1.0  	- Initial release
Version 1.1	- Removed all references to ‘volunteers’
	- Added Chivalry, Focus and Necromancy to the tweak all list
	- Added a warning message about backpacks emptying when ‘becoming’ 
Version 1.2	- Added Quick Autotarget Setup to the Tweak panel
Version 1.3    - Updated the drone command list 
                    - Added shard specific location files
                    - Added new expanded spawn list
                    - Added spawntype to the quick autotarget setup 

Who did it ?
R.D. di Giovanni
also known as Xena Dragon
Webmaster of UO Stratics
xena@stratics.com