BoxxWorldMap creates a world map (powered by Google maps) and places pictures of your players' avatars' head on the map, according to where they are in the REAL world. So if you live in Newyork, United States, it will put you on the map where Newyork is!


  • Real world map
  • Hosted on your own server - Local or external!
  • Optional player list
  • GeoIP location mapping
  • Ability to show players that are currently online OR all players that are online or offline.
  • Automatic map refreshing - Live data!


For BukkitHTTPD (you don't have a webserver):

  1. Download BukkitHTTPD, and place it in your plugins folder.
  2. Run your server so that the BukkitHTTPD files generate. Stop your server again.
  3. Configure BukkitHTTPD how you like it.
  4. Forward port 8107 (or whatever port you have BukkitHTTPD on)
  5. Download BoxxWorldMap and place BoxxWorldMap.jar in your plugins folder.
  6. Place the "worldmap" directory in the BukkitHTTPD folder.
  7. Start your server. The BoxxWorldMap config files will generate, and GeoLiteCity.dat will download+install.
  8. Edit your configuration and enjoy!

For JSONAPI (you have a webserver):

  1. Download JSONAPI, and place it in your plugins folder (both the jar and folder)
  2. Configure JSONAPI how you like it.
  3. Forward port 20059 (or whatever port you have JSONAPI on). this port also may need to be forwarded on your webserver.
  4. Download BoxxWorldMap and place BoxxWorldMap.jar in your plugins folder.
  5. Edit config.php which is found in the "worldmap" folder that came in the BoxxWorldMap zip download.
  6. Upload the "worldmap" folder to your webserver.
  7. Start your server. The BoxxWorldMap config files will generate, and GeoLiteCity.dat will download+install.
  8. Edit your configuration and enjoy!


For BukkitHTTPD:

  1. Navigate to http://YOUR-SERVER-IP:8107/worldmap/
  2. Observe the map. :D
  3. (please note that the port (the :numbers) may change depending on your BukkitHTTPD configuration. ForJSONAPI:
  4. Navigate to
  5. Observe the map.
  6. Please note that the URL will change depending on where you put the worldmap folder.


//This section shouldn't be changed unless you know what you are doing.
  //Should be automatically download the database for you?
  autoDownload: true

  //Where should be get it from?

//This section is for BoxxWorldMap settings.
  //Should we display offline players, or just online?
  //false: only display players that are online
  //true: show all players that have entered your server
  showOfflinePlayers: false

  //If you display offline players, what's the max number to display?
  //(this is to prevent lag.) Max = 1000
  offlinePlayerLimit: 250
  //Should we display the playerlist sidebar?
  showSidebar: true

To configure BukkitHTTPD, see the BukkitDev page here. To configure JSONAPI, so the Bukkit forum post here.


What is BukkitHTTPD? BukkitHTTPD basically creates a website hosted on your Bukkit server that is accessible from web browsers! This allows you to create websites for your server without renting from a web/VPS provider. BoxxWorldMap uses BukkitHTTPD to let the map be hosted on your own server, unlike RaddaMap. So don't be scared of BukkitHTTPD (like I was). It's very useful and efficient.

What is JSONAPI? JSONAPI allows for communication between your webserver and Minecraft server, using JSON. It's awesome!

I can't see my map!

  1. Make sure your BukkitHTTPD and/or JSONAPI settings are configured correctly.
  2. Make sure you typed in the map URL correctly
  3. Make sure that if you change your BukkitHTTPD or JSONAPI port, you change it in the URL. The default is 8107 or 20059, respectively.
  4. Check that your server is online.
  5. Check your BoxxWorldMap configurations
  6. Look for any errors in the Bukkit console or logs.
  7. If all else fails, ask for help.

Do I have to use BukkitHTTPD or JSONAPI? Yes.

Did you copy RaddaMap? The concept? Perhaps. The code however was NOT copied. With the exception of BukkitHTTPD and the GeoIP library, this was 100% made from scratch by me. How could I copy it if his server (where the website was) is down, and his source isn't given?

Can you add a feature? Sure! Go ahead and request it. I'll take a look and possibly add it. :D


BoxxWorldMap 1.4 for BukkitHTTPD (no webserver required)

BoxxWorldMap 1.4 for JSONAPI (webserver required)





Version 1.4

  • Web overhaul!
  • Added a scrollbar to the player list
  • Changed size and location of the player list
  • Added a title to the player list
  • Implemented automatic map refreshing - live data!
  • Changed playerlist font to Andy.
  • Added click-goto feature. Click on a user in the playerlist and it will zoom to them!
  • Added a player count to the playerlist
  • Added hats to the avatars on the map and playerlist
  • Added border to the playerlist
  • Fixed plugin.yml derp
  • Fixed onDisable() derp
  1. Replace BoxxWorldMap.jar with latest.
  2. Delete your /worldmap/ (web) folder, this includes config.php for JSON users.
  3. Place the latest /worldmap/ folder where the old one was (BukkitHTTPD folder for BukkitHTTPD users, your web server for JSONAPI users)
  4. For JSONAPI users: Configure the new config.php.

Version 1.3

  • Added support for running BoxxWorldMap on an external webserver using JSONAPI by Alec Gorge.

Version 1.2

  • Fixed a bug with hosting on local networks. If you connect to the server on the server (i.e. home server) then you will appear in the ocean near Africa. (better than breaking, right?)

Version 1.1

  • Made the playerlist sidebar optional via config.
  • Files to update: BoxxWorldMap.jar

Version 1.0

  • Initial release

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of ObsceneNameHere ObsceneNameHere Jan 09, 2013 at 22:20 UTC - 0 likes

    Just use Dynmap its the same thing just better maintained...

  • Avatar of the413danny the413danny Sep 19, 2012 at 13:12 UTC - 0 likes

    i cant even load the example links thats supposed to show where the player head is the map thingy no it says cod not connect and refuses connection saying its a invalid url so f this

  • Avatar of JustinM511 JustinM511 Sep 18, 2012 at 17:16 UTC - 0 likes

    Does this work still for 1.3.1 or 1.3.2?

  • Avatar of domdomegg domdomegg Sep 18, 2012 at 16:09 UTC - 0 likes

    Is this dead… I feel so

  • Avatar of domdomegg domdomegg Sep 06, 2012 at 15:57 UTC - 0 likes

    1.3.2 Support?

  • Avatar of nejcneo nejcneo Jun 06, 2012 at 22:03 UTC - 0 likes

    Something is wrong with: ... Plugin can't load this database and it said: Disabling Boxx...

  • Avatar of Mayhem777 Mayhem777 May 18, 2012 at 15:48 UTC - 0 likes

    Works for 1.2.5? :D

    - - - -( Profile )- - - -( Plugins )- - - -

    Issues? Suggestions? Use the forums for my plugins: ( Forums )

    Working on: UnDo v2.0.0
    Last Updated: Time and Weather God v1.0.0

  • Avatar of domdomegg domdomegg May 17, 2012 at 21:23 UTC - 0 likes

    Can't see the players anymore. Also, can you add a feature which makes it possible to use a command, where you set your address (For that IP) eg.

    /boxxworldmap setlocation "7 Something road, City, Post/Zip Code"

  • Avatar of strontkever strontkever May 05, 2012 at 13:52 UTC - 0 likes

    is there a way, or can u add an option to give a certain player a fake position? (dont ask me why, but theres reasons for a couple of the staff :))

    Strontkever Survival No PVP
  • Avatar of domdomegg domdomegg Apr 23, 2012 at 08:59 UTC - 0 likes

    ̶d̶b̶ ̶d̶o̶e̶s̶n̶'̶t̶ ̶w̶o̶r̶k̶

    ̶I̶s̶ ̶t̶h̶e̶r̶e̶ ̶a̶ ̶d̶e̶v̶ ̶b̶u̶i̶l̶d̶ ̶f̶o̶r̶ ̶1̶.̶2̶.̶5̶?̶

    Be really cool if could work with 'dynmap', so you can swap between where players are connected from and where they are in the minecraft map.


    EDIT - Does work now, and found the official GeoCityLite DB (put this in config under 'database url'

    Last edited Apr 25, 2012 by domdomegg


Date created
Nov 27, 2011
Last update
Jan 08, 2012
Development stage
  • enUS
Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License.
Curse link
Recent files