Bukkit

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!

Features

• 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!

Installation

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!

Usage

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 http://YOUR-DOMAIN-NAME.com/worldmap/
5. Observe the map.
6. Please note that the URL will change depending on where you put the worldmap folder.

Configuration

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

  //Where should be get it from?
  databaseURL: http://boxxians.com/downloads/GeoLiteCity.dat.gz

//This section is for BoxxWorldMap settings.
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.

FAQs

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

Downloads

BoxxWorldMap 1.4 for BukkitHTTPD (no webserver required)

BoxxWorldMap 1.4 for JSONAPI (webserver required)

BukkitHTTPD

JSONAPI

Credits

• V10lator and codename_B for making BukkitHTTPD
• Alec Gorge for making JSONAPI
• maxmind.com for the GeoIP Java library
• Google for the Javascript Maps API

Changelog

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
• UPDATE INSTRUCTIONS:

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