- There are three downloads needed to make sure everything goes smoothly.
- MapTools 1.3 b87 - This is the manual download and you'll have to unzip the folder when done. A common thing people do is "explore" the zip file, because it looks like a folder in windows, and tries to run it from there. You'll get a dll error because it has not been unpacked. So, upzip it to any folder first.
- JAVA 6 Update 35 (Or latest version 6 of java) - MapTool 1.3 build 87 lacks support for JAVA 7 at this point. Since that has become the default download, there have been many more error reports with the same information and solution.
- Download the correct 32/64bit version of Java 6.32 for your system.
- Install on to your computer.
- Latest video driver for your system - This is less critical, but for older machines this may be needed. I'll leave it to you find the latest and greatest driver for your video card.
- There isn't too much needed to get it to run, but there are some settings to get it to run better.
- Setting for mt.cfg - Edit the mt.cfg file located in the unzipped folder of MapTool and change the JVM line. Make sure you're using the correct drive letter and file location of your java install. These are the most common settings for a system with 2 Gigs of ram or more:
Code: Select all
* - If mt.cfg is not present, you can create using a text editor with the above text or run MapToolLauncher.exe once, close MapTool and then edit.
- Create a Shortcut - In the MapTool unzipped folder there is a file called MapToolLauncher.exe. Right-Click Drag to your desktop or quick launch bar and select Create Shortcuts Here. There are some batch files that can be run, but they lack the proper settings by default and may bog down or error out with some of the larger maps or most common frameworks in the User Creations section. With the shortcut set up, there is no reason to run these unless you're having some video driver problems and then they would need some more configuration anyway.
- Most of these settings are all optional, but I found some changes to the basic settings can avoid some small issues down the line. I've included My Default Settings file to do all these settings for you, but I recommend you review all the info here before installing it.
- [spoiler=... Edit | Preferences | Interactions ...]
- New maps visible to players - It's easy to forget when making a new map that players can just go to it. If you forgot to set up FOW or something then the player is in store for some spoilers. I think it's just best to hide by default.
- New map vision distance - for most campaigns the default 1000 feet is probably too long and unnecessary. Plus, with individual views on, it adds more unwanted data to the token. If you're going to have unlimited vision, just turn off vision in Map | Vision settings.
- Insert smilies - As demonstrated here the 8 ) becomes and this can be cause for some confusing chat output. This is a personal preference and I think it's best turned off.
- Use Tooltips for Inline Rolls - As you'll discover all the rolls will have << >> around them and when using macros, this can cause some output errors or unintended output. Again, a personal preference that I think is better turned on.
- Suppress Tooltips for Macrolinks - When you see it, you'll know why you want to turn this feature on. Also, you can use the alt attribute in the anchor tag to display an intended tooltip when building links. With this off, you can't in the chat window.
- The other changes are also personal preferences. Feel free to experiment.
- [spoiler=... Edit | Preferences | Application ...]
- Campaign autosave every - Default is 5 minutes and on campaigns with large maps, many maps and large amounts of data, this is way too often for me. Plus, this may have been fixed now, but things can go wrong if you're running a macro and then it decides to save at that moment. I feel better setting this to 60 min (mine is every 4hrs and I manually save at key points during the game). This is a personal preference, so set it to what you feel most comfortable with.
- Auto-expose fog on token movement (GM Only) - Go ahead and turn this on, otherwise you'll be cursing to yourself wondering why the FOW doesn't work.
- Hide NPCs from players on new maps - This is an init panel setting and you can change it there as well. I like to hide my NPCs order of action from the players. This is just a default setting.
- Give owners permission in new campaigns - The main reason to do this is so the players can hit the NEXT button to end their turn. Otherwise, the GM is stuck doing this.
- Lock player movement in new campaigns - Leave this off. There is a bug in b87 that may cause an error when trying to move a token who doesn't have initiative.
- Edit | Preferences | Sounds - Turn off Play System Sounds. There's only one sound and it's a beep every time someone posts a chat message.
- [spoiler=... File | Start Server ...]
The important thing to note here is to make sure UPnP is unchecked. I'll discuss the server settings later on in this document. When installing my default settings (below) this is how the panel will look at first start up. You can change settings each time you start a server and it will keep those settings the next time you start a server. I just didn't want to specify a default server name and passwords, but you'll want to add these later.
Start MapTools with created shortcut and then go to the specified menu items.
VALIDATE JAVA AND MAPTOOL VERSION
- Help | Gather Debug Information... - Run this to verify your MT version and the java version.
Code: Select all
==== MapTool Information ====
MapTool Version: 1.3.b87
MapTool Home...: D:\Documents and Settings\Chris\.maptool
Max mem avail..: 989M
Max mem used...: 61M
==== Java Information ====
Java Vendor.: Sun Microsystems Inc.
Java Home...: D:\Program Files\Java\jre6
Java Version: 1.6.0_33
This is everything needed on the MapTool side to make sure you won't have any problems, but now we have to make sure you can connect to the outside world with your modem/router. There is a very detailed document:
This can also be found by browsing the HOW TO section in the forums or going to File | Start Server | Networking Help. But I will give you a general guideline of some of the basics.
READ EVERYTHING FIRST BEFORE MAKING CHANGES.
Step By Step to Port Forwarding (abbr)
- Assuming the Basics
I'm going to assume you are connected to the internet and are reading this, so no need to troubleshoot that. Google is your friend. If you don't know what a modem, router or any other terminology I use there are far better explanations out there than I can provide, so google it.
You may want to make sure you can read this while offline as well and save the text to a file, just in case.
MapTool 1.3 b87 requires you to set up port forwarding. UPnP does not work Port Forwarding is handled by a router and you'll need one of those. But before you go out and buy one, make sure you don't already have a built in router with your modem.
How many routers do you have?
There are many ways and methods to get an internet connection to your computer, but they all start with the modem. Some of these modems and most if not all the new modems have built in routing capabilities. I specifically asked my provider to not give me a modem with a router on it because I knew I wanted to use my own router. Having two routers can lead to conflicts and having ports blocked. There are ways around all that, but let's just keep focused on having one router for now. If you know you have a modem/router or a modem only with a connected router, you can skip ahead to Configure Port Forwarding section.
Look up your modem model
The model number will be written on the back or bottom on a label usually. It may be important to note the version or v1, v2 so write that down too. I have model DCM425C from Comcast. If you don't have the materials that came with your modem, you may have to go online to find out how you log in to your modem. A default user name and password may be required.
Is it a router?
My login is 192.168.100.1 and since it is just a modem, I don't get any routing options like port forwarding or need to log in to the modem with a username and password. This is what I wanted to verify. Now if yours is a router and you don't have any other routers connected to the modem, then you can jump to the Configure Port Forwarding section.
Use only one router
If your modem is a router and you don't "need" your other router, just disconnect it and plug your modem in to your computer.
I have or need two routers
Okay, you verified that your modem is a router and that you need or want to use your personal router for wireless connectivity, multiple connections or better security. You have two options. Either turn off the routing services for the modem/router or turn them off on your other router. This will essentially make that router a "switch" or "gateway". It doesn't control anything, but will direct traffic through it.
Which one to make a gateway?
If you can log on to your modem/router and turn off DHCP services, that will be the easiest way to handle things. Otherwise, you can turn them off on the purchased router, but you'll have to do a little reconnecting in the back. If you turn your purchased router in to a gateway, the cable going to your WAN port will now need to be plugged in to one of your LAN ports. Also, your purchased router tends to have more features than the modem/router, so I would avoid this if possible.
One important note about choosing which router to use is if they have address reservation options. This will typically be near your DHCP services as an option. What it does is take your MAC address and each time you log on to the router it will assign the same local ip address to that computer. This makes port forwarding much easier, especially when your network has multiple devices it provides internet to. Another important note is to verify that the DHCP services are on for the router you chose to make your primary router.
Making my router a gateway
Each bit of hardware uses different software, but they tend to use the same terminology. After logging in to the router you're going to turn in to a gateway, look for key words like LAN and DHCP. It'll usually have associated with it a starting IP address. You'll want to disable that service. If you don't see that option, especially for modem/routers, it may use terminology like GATEWAY.
If you're trying to change your modem/router from a provider and you can't figure it out or are afraid to make the change, contact your service provider and ask them to either make the change for you (remotely) or walk you through it. Customer service will be of little help (usually) and you'll want to speak to a Level 2 technician. Trying to disable DHCP services for a modem/router could result in a worse case scenario. Don't forget to apply the changes in the modem software. If you're connected to your modem/router directly, you'll loose internet. You should be plugged in to your router that's connected to your modem/router when changing the modem/router to a gateway. You may need to restart your modem/router and router to reconnect to internet.
Verify you can still connect to internet
You should now have one of the following configurations and still be able to connect to the internet.
Code: Select all
Modem --> Router --> Computer
Modem/Router --> Computer
Modem/Router --> Router/Gateway --> Computer
Modem/Gateway --> Router --> Computer
If you can't connect to the internet then try restarting all the modem, routers and computers after having them powered off for 60 seconds. If you find that you're not getting a local ip address assigned to you then your router is not reaching your computer, or you have no routing devices. This shouldn't happen and you should review your steps.
Configure Port Forwarding
Log in to your router and look for Port Forwarding under LAN services. Each manufacturer has a different way of doing it, but they all should have the protocol setting TCP/UDP (or Both) for Service Type, starting and ending ports (default for both is 51234, but can be preferably any number above 1024 - I use 6801) and an IP address. This will be the ip of your computer. If you don't know what it is, you can run in a dos window (Windows | Run | type "cmd") and use the command "ipconfig /all" and look for "IP Address". It's usually 192.168.1.xxx. where xxx is a number from 2 to 254. Apply your changes and reset your network card. You can disable/enable or just log off and back on real quick. Many people forget this step.
Start MapTool Server and Connect
Open two instances of MapTool. On the first one, start a server, give it a name, verify UPnP is turned OFF, verify the port matches the one you chose for port forwarding and start. On the second instance, look for your server name and connect. You should now be connected. If not, go to server instance of MapTool and click File | Connection Information. You should have a server name, a local ip address used in your router's port forwarding, an external address that matches http://www.whatsmyip.org/ and a port address that matches the one in your router's port forwarding. If these all match, then check your windows firewall. In the control panel | security center | fire wall there should be an exceptions tab. Java SE should be in list with a checkbox checked. Also verify the location of that instance of java by hitting the edit button. It will show you the path, which should be the same as the path of your install (for example: C:\Program Files\Java\jre6\bin\javaw.exe). If not checked, then check the box and restart MapTool and try again.
What if it still doesn't work?
Well, I'm just trying to detail the most common problems and there could be other situations not covered here that would need an expert to take a look at. Just post to this thread and if we come up with another solution to your problem I'll add it to the list. There's also something called a Hamachi Server, detailed in the FAQ doc link above that will handle all the routing through port 80. It will simulate the router and I believe both the server and clients will have to have it. Or it may go through a 3rd party that redirects routing services to the Hamachi server. I've never used it, but I'm familiar in how it would need to work. I personally would avoid a software solution, but that may be the only option for some people. Sometimes you just don't have access to the modem/router and will not be able to set up port forwarding.