User Tools

Site Tools


gmtoolhowto

This is an old revision of the document!


GMTool - How To...

For a specific description of the different plugins, see Plugins.

Installation

First you need to have a Java runtime installed, at least version 6 (but version 7 should be fine, too).

Installation of the gmtool itself is pretty simple: Extract the contents of the gmtool.zip file somewhere. If everything is alright, you should be able to start it by double clicking the “gmtool.jar” file.

To add new plugins, simply copy them into the ”/plugins” folder of the gmtool.

Starting

When starting the program by simply double clicking the “gmtool.jar” file, the first thing you should see is something like this:

Welcome

In this screen you can select your “Scenario” (which stores the images, texts, sounds, etc.) and the PluginSet your want to use.

You can either enter a name in the Scenario text field (it will be created) or choose an existing scenario file with the ”..” button to the right. If you selected an existing scenario file but want to create a new one, you can simply edit the text, again, a new one will be created.

The PluginSet is a little bit more complicated: The GMTool itself is dumb. It doesn't do anything, it's nothing more than an empty shell. To do something, for example, manage notes, you have to load a “Plugin”. Don't worry, there are already some generic plugins for you to use - system specific ones will follow. A PluginSet is simply the combination of some plugins. For example, let's say you want to manage your AD&D group. You could want to use the Sound-Player and the Note-Plugin, but not the Image-Plugin, as you want to handle that by giving out real handouts. So you simply create a PluginSet, call it “Sound and Notes” and the GMTool will only load these two plugins.

You can either choose a PluginSet from the drop-down box, create a new one, edit an existing one or even delete one. For the later three options, simply click the ”..” button to the right. Choose “Add” if you want to add a new PluginSet, “Edit” if you want to edit the currently selected one or “Remove” if you want to delete it.

Clicking “Ok” will end the dialog and start the GMTool.

Create or Edit PluginSets

If you chose to add or edit a PluginSet, you will see this dialog:

Obviously, you can choose the name of the PluginSet at the top. You could, for example, create one PluginSet for every system you want to manage - or one for every campaign.

In the right list, all available plugins are listed. By clicking the ”«” button in the middle, you can move it into the PluginSet (click ”»” to remove it again).

At the moment, that's all there is (the rest is not functional yet). Simply click “Ok” to confirm your changes or “Cancel” to leave without changing anything.

Main Window

If you used the Example PluginSet, then the main window will look like this:

In the title, you can see the name of your choosen scenario.

As you can see, every plugin is displayed as a “tab” (Images, Notes, Sounds). As each plugin is unique, see their descriptions for more information about a specific one.

A plugin can (but does not have to) add buttons to the area at the bottom for tasks you might need often. For example, here, you see a “Show Image” button for the image viewer (this can show an image on an attached 2nd screen for your players to see) and the “Stop” (“||”) and “Start” (”>”)buttons for the sound player.

Always there are the save/load buttons: Use them to store the scenario into a file. This will save all loaded files in the different plugins and allow you to re-load them later. Please note, that at the moment, only the used filenames are stored, so copying only the scenario file onto another computer will NOT be enough. There will be an option to export a scenario to a .zip file later.

gmtoolhowto.1348754985.txt.gz · Last modified: 2012/09/27 16:09 by irian