UGMT/Download

General Information

• Prerequisite: Get java JRE 1.4.2 or later from Sun's Java Site first, if you don't have it yet. Sometimes the structure of Sun's site changes, and abbreviations might get you confused. Here are some advisory notes:
  • Java x = Java 1.x, this curious naming is true for all versions since 2.
  • JRE = Jave runtime environment, what you need to run java programs.
  • SDK = Software Development Kit
  • JDK = Java SDK, what I need to develop the UGMT.
  • SE = Standard Edition, this is the home edition you (and I) need
  • EE = Enterprise edition, stuff the "big guys" need. Ignore.
  • ME = Micro edition, runs on cell phones, etc. Ignore.
  So what is JRE 1.4.2? Answer: Java 4 Runtime environment, Update 2. Don't go hunting for old versions. Install Java 6, or whatever they currently offer. The old version is mentioned so people who installed Java before know, whether they need to update or not.


• Installation: Unzip all Zip-files alway into a SINGLE directory, distinct for the UGMT. (Windows XP may suggest wrong directories for you - don't accept them.) You're done. In case you use an explorer or a similar browser tool, you may click "UGMT.bat" or "UGMT.sh" to run the UGMT, depending on your OS. You may as well start theses scripts from a command-line. To install from command-line, you need to enter "unzip All.zip" and then use "UGMT.bat" or "UGMT.sh", depending on your OS.
  
  The title lines below are links to the zip-files.


• Structure: Because people found it helpful to see what the directories should look like, here is an excerpt of the structure, if you install the plugins mentioned correctly.

                                --+- README
                                  +- UGMT.jar
                                  +- properties
                                  +- groups -+- groups.jar
                                  |          +- properties
                                  |          +- ...
                                  |
                                  +- index -+- index.jar
                                  |         +- properties
                                  |         +- ...
                                  +- ...
        



• Warning: Most plugins need a "state.xml" file, which represents the state for it (i.e. what you have saved during the usage of this tool). They are not included in any archives (even in All.zip) but are present in Examples.zip. People would object when a major change that requires them to download "All.zip" again, would also require them to save all their state files. For those that initially install the tool, "Examples.zip" is provided, so that you can start right away and work your way through the tutorials. If you have already used the UGMT and have saved your own state information for your campaign(s), be sure to note overwrite that information when unzipping by installing Examples.zip again. This file is then not for you.


• License: All software on this page is licensed under the CC-GNU GPL, except what is contained in UGMT.jar. UGMT.jar is accompanied by a more generous license. Note that the Data is not considered part of this software.
  

All.zip

Download the framework, plugins and data described below in one haul. Don't forget to read the documentation in the separate sections. Currently this package contains everything. This archive always contains the latest versions of the framework and all plugins. It also has a very short description of the functionality of all contained plugins.

UGMT.zip

This file includes all code needed to run the UGMT. The zip file shouldn't be that big, but I included a sound-file that increases it's size dramatically. Maybe this should be removed. Following is a short list of the currently available plugins and a short description.

• UGMT (Framework) The framework provides the basis for all plugin, i.e. this is where you plug them in. It includes the runtime and the "repository", which is used for safe communication between the plugins. A property file allows you to customize the GUI. Normally all plugins appear in one tabbed pane. If you want several panes, remove the hashmarks in the file (and maybe sort the plugins to your liking). You could even add more panes.


• Calendar The calendar is mostly informational. It will show you the current date. It also shows the sunsign and moon phase. By clicking, you can stay for a designated amount of time, which can be increased/decreased. You are also shown the time until the next dusk/dawn. You can go there by pressing a button. The right panel shows one month worth of calendar dates taken from the Hârn sources. Each row lists the events for that day.


• Character Create characters and modify them. Create HM3 character sheets. Roll their skills through the skills plugin. Allows development including veteran characters. See the tutorial section for an introduction.


• Combat Create combatants with armour and determine armour values with easy additions. Use chars and equipment plugins to include premade material.


• Encounter Rolls encounter and you may modify them. Key to index, sketch or descriptions. Conditional tables possible, with conditions "time", "location", "terrain", "vegetation", "condition", and "weather".


• Equipment Lets you organize equipment of characters by dragging and dropping things around. Characters (and containers) are tree nodes, which when clicked will toggle their equipment (contents).


• Export This plugin allows you to export a few things to a web browser, as might be had on players' devices. Check the boxes for "map", "index", etc. to export either a foggy view of the active group's map, the currently selected index page, etc.. (Cf. index and maps plugin) All you need to do is hook up a small IP-LAN with your players' hardware. Direct them to "http://hostname:8080/map", "http://hostname:8080/index", etc..


• Groups You can create or remove groups. You can activate any one group, which is used by many other plugins as reference. The parameters of the current group are then shown on the right panel, mostly travel related. Members are added through the char-plugin. The vessel area allows you to add vessels.


• Index The left tree view shows a selection of possible indices and two buttons for navigating in the right panel back and forth as a memory aid. The one selected index is the one active. Each time an entry is selected the large panel on the side shows it as hypertext. An active entry may have a correspondence on a map.


• Log Allows you to log weather, locations entered and left, and events. Free-form additions are possible and later removal of entries, partly and whole. Time format can be modified. log entries for the same time stamp are grouped.


• Magic The left shows a tree view of available spells/invocations. Drag-and-drop allows addition of spells to characters' spell set. Magical characters are displayed on the right side as buttons which expand/shrink to show or hide the individual spell list. A popup menu allows the calculation of spell-formulas for characters who have the spell. Development of magic/priestly powers is extended from the char plugin. Pressing the develop button will guide you through the few steps necessary.


• Maps You can locate groups on and toggle "fog-of-war". The tree view shows all available map-sets (called atlas) and its contained maps. By selecting one of the maps, the corresponding image is displayed. You can click on the map inside a selectable entry from the index plugin and activate it. You can also locate a group on the map by clicking. Inter-map navigation is also possible.


• Sound The sound plugin allows you to play *.au, *.wav, *.mp3, *.ogg, and *.aif files keyed to specific events (Calendar, weather, locations). There are very few sounds/musical pieces included, they are free to use. If you have others, they can easily be added; you can your own sounds from your personal library.


• Sketch This plugin allows you to edit and group small pieces of information. You can draw sketches and write notes. It is also possible to add formatted text (HTML) but read-only. Notes can be referenced by other plugins.


• Skills This plugin allows you to edit, group, and roll skills. Adjustments can be made and post-roll situations considered. (What if that adjustment had been -20 instead of -30, or the climb "easy" instead of "normal".)


• Travel The travel plugin shows you the current date. If you right click on the displayed map in the right panel, it will show you how much time will pass until you reach that point. If you left-click you go there. You will see the time of consecutive traveling without rest. Terrain and vegetation is shown as well as the travel condition. (Mud or snow, on water wind speed and direction.) You may enter a travel rate of your own choice or make traveling instantaneous altogether.


• Visual The visual plugin gives a a 3D overview of the map the current goup resides on. It tries to autodetect heights but also supports heightfields. It respects hidden sections of the map and draw combatant markers, if any.


• Weather The weather plugin will show you the current date. If you right click on the displayed calendar in the right panel, it will show you how much time will pass until you reach that point. If you left-click you go there. It shows the sunsign. Below, the moon phase is shown. Snow and mud level, which govern travel conditions are shown and they can be modified. You can stay for a designated amount of time. You will see the time until the next dusk/dawn. You can go there. You can save the weather. You can dump old weather that has expired. The right panel shows one month worth of weather, with 3 day in the past. Each row is one day. Nighttime is shown by a shade of grey, its length depending on time of year.

Data

The data zip-files are unpacked in the same directory as the plugins are. The paths the data uses is included in each. Some data plugins install their data in several directories. (To deinstall a data package separately, you would need to remove all files of the zip-file by hand.) The packages contain seperate copyright statements and are not covered by the software license above. These sections would not be possible without the many contributors, for whose permission to host the conversions to the UGMT I am very grateful. The list has gotten too long to mention each separately. You can inspect them by looking at the individual Copyright files. Much data can be obtained in other form from lythia.com and from other sites and this.

• Examples you need to download if you do not have your own state files already. These files will overwrite anything you have saved, so only install them initially. If you do not have any state files, some things will not work.


• Azadmere contains map and index data for the Durzhan, Zhakom, Irkhar Kyg, and Mercin. (Zhakom is located near Azadmere.)


• Chybisa contains Angryl, Tyannal, and a few other spots.


• FF&F contains char and sketch data for NPCs available as "Friends, Foes and Followers".


• Generics contains mostly NPCs.


• Harn contains Harnic maps with permission from "the creator".


• Kaldor contains index and map data for the Abriel, Athelren, Charmic, Cyre, Chewintin, two Tashal City Blocks, Eliten, Goffin, Henewes, Kolorn, Medarsin, Nebulan, Nenda, Setrew, Stybrin, and some minor ones.


• Nick Lowson's map archive contain several maps from south eastern Harn.


• Mappack contains several maps from across Harn.


• Orbaal contains map and index data for Lorkin, Leriel, Marby, Monthel, Thoen, Sherwyn, and Zuden.


• Other things that are not big enough for a separate archive are combined here. Includes Glenoth, Kedis, Ravin, Sirion, and Zaurial.


• Sounds contains several sound files.


• Spells contains several spell descriptions from various sources. Contact the well-known Hârnic sites and compare. For those you cannot find contact me for further information.


• Tuomo maps contains several maps from across Harn.


• The Warrior's Grave contains data for certain adventures near Chybisa.

Customizing

In case your hardware has restrictions or you want to speed up the tool and like to leave off a few plugins, here is a list of which plugin require another. You can then decide what you really need to install. (Deinstalling is as simple as removing the directory of the plugin altogether.) The optional column gives plugins which enhance the capabilities, e.g. the sound plugin cannot key sounds to weather effects, if the weather plugin doesn't provide them.