Skip to content

Setting up Dynamic Map with IIS

mikeprimm edited this page Dec 29, 2011 · 11 revisions

This page assumes:

  • The root directory of your webserver is found at C:\Inetpub\wwwroot\.
  • You have IIS and CraftBukkit running on the same machine.
  • You have ASP.NET enabled in IIS (http://support.microsoft.com/kb/315122).

Start:

  • To start, create the directory C:\Inetpub\wwwroot\dynmap\.
  • Create the directory C:\Inetpub\wwwroot\dynmap\tiles\.
  • Copy the contents of the web directory found in the repository to C:\Inetpub\wwwroot\dynmap\.

You should now have the following file: C:\Inetpub\wwwroot\dynmap\up.aspx.

  • Go to minecraft_server/plugins/dynmap/configuration.txt and make sure you have the property tilespath set to C:\Inetpub\wwwroot\dynmap\tiles\:

    The path where the tile-files are placed.

    tilespath: C:\Inetpub\wwwroot\dynmap\tiles

  • Restart your Minecraft server.

  • Join your Minecraft server and place a few blocks (randomly) to trigger dynmap to generate tiles for your map.

If everything went alright, you should now find some new .png files in C:\Inetpub\wwwroot\dynmap\tiles\. You can also go to http://yourwebserver/dynmap/ in your browser. It should display the map, but also display an error not being able to update (player locations and map changes).

Open up C:\Inetpub\wwwroot\dynmap\config.js in Notepad and uncomment the following section below the line 'For proxying webserver through aspx.':

    // For proxying webserver through aspx.
    url: {
    configuration: 'up.aspx?path=configuration',
    update: 'up.aspx?path=world/{world}/?{timestamp}',
    sendmessage: 'up.aspx?path=sendmessage'
    },

Also make sure to comment the section in the top of config.js:

    // For internal server or proxying webserver.
    //url : {
    //      configuration : 'up/configuration',
    //      update : 'up/world/{world}/{timestamp}',
    //      sendmessage : 'up/sendmessage'
    //},

Now refresh your browser. It should now display online players on http://mywebserver/dynmap/, keeping them up-to-date.

Troubleshooting

Go to your webserver and open up a browser there. Go to http://localhost/dynmap/up.aspx?path=configuration. It should show some text representing the configuration you have in configuration.txt. If it shows some sort of error, analyse the error. If you can't figure out what to do, please come to IRC or the forums.

Also, some version of IIS (7.x in any case) will not automatically assign the proper MIME type for the *.json files that can be needed by dynmap (resulting in a 406 error when attempting to load these files, such as those used by the Markers API). To address this, follow the procedure here - http://support.microsoft.com/kb/942050 - to define the MIME type 'application/json' to the 'json' file extension.

Also, for more details on how to get IIS6 and IIS7 handing JSON properly, see http://www.sencha.com/forum/showthread.php?33266-Some-Problem-with-JSON&p=229858&viewfull=1#post229858