Skip to content

Latest commit

 

History

History
58 lines (45 loc) · 2.34 KB

README.md

File metadata and controls

58 lines (45 loc) · 2.34 KB

Mapcrafter playermarkers

This is a script to show markers of players from a Minecraft server on maps rendered with Mapcrafter.

The script is free software and available under the GPL license. The PHP-Script to generate the player images is a modified version of the script TJ09 wrote (forum link).

Requirements

You need some things to use this script:

  • A map rendered with Mapcrafter
  • A Bukkit Minecraft server with a plugin (MapTools) to provide the player data
  • PHP for your webserver to generate the player images (alternatively, you could also use the default player skin or create the player images manually)
  • PHP write access to a directory to cache the player images
  • PHP-GD library

Installation

  • Copy the files from the playermarkers directory to an accessible web directory.
  • Make sure that PHP has write access to a directory called cache.
  • Install the Bukkit plugin. A ready Jar-File of the MapTools plugin is included.
  • Now configure the plugin to export the player data to an accessible file. You can directly configure this in the config file of the plugin or you can create a symlink to the file (on Linux systems, but I hope that you are already on a Linux system):
ln -s /path/to/minecraft/server/players.json /path/to/www/playermarkers/players.json

  • Now configure the playermarkers.js script. You need to specify the path to the JSON-File with the player data and to the PHP-Script to generate the player images. The script should also use the same update interval as the Bukkit plugin. The interval in the Javascript-File is in milliseconds, so don't be irrated. You can also turn the player movement animation off if you don't want it.

  • The last point is that you have to include the script into your rendered map. Open your Mapcrafter template index.html file and add the following lines after the <script> section where the Mapcrafter UI is initialized:

<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/2.0.0/jquery.min.js"></script>
<script type="text/javascript" src="/path/to/playermarkers.js"></script>
  • Now you can update the template of your rendered map by running mapcrafter -c <configfile> -r.

Have fun with the player markers!