PlayerMarkers
Overview
This is a similar plugin to the MapMarkers plugin. It outputs online and offline player locations to a JSON file which can than be viewed in website generated by a mapping tool (like Minecraft-Overviewer). It also supports the multiworld feature of Overviewer.
Downloads
Features
- Player locations are saved in JSON format to configurable path
- Also outputs the location of offline players (if they were previously online while the plugin was running)
- Display offline players with their skin grayed out
- Only displays players on the currently viewed world
- Configurable refresh time
- Cache for the skins
Requirements
- A working installation of Overviewer on your webserver
Plugin Configuration
- lang: (default: en). Can bet set to en (english) or fr (french). For other language, simply use en and change the strings manually in file localization.en.yml
- tagmessage (default: true) This will add a tag to message sent from this plugin
- updateInterval: (default: 5000) How often should the markers be updated (in ms)
- targetFile: (default: /path/to/overviewer_output/markers.json) Path to which the data is written. Should point to the directory of the generated map
- saveOfflinePlayers: (default: true) Enable or disable tracking offline player locations. When disabled, only online players will be shown.
- offlineFile: (default: locations.bin) Path to the file where the locations of offline players are saved. If this is not an absolute path, it is treated as a sub path of plugins/PlayerMarkers
- Mapping: (default: generated at first start) This maps the name of the bukkit world names to the names configured in the overviewer config. See World Name Mapping for more details.
- hideVanishedPlayers (default: true). Offline player will not be outputed in the json file
- hideSneakingPlayers (default: false). Sneaking players will not be outputed in the json file
- hideInvisiblePlayers (default: true). Invisible players will not be outputed in the json file
- hideSpectatorPlayers (default: true). Spectator players will not be outputed in the json file
- sendJSONOnVanishedPlayers (default: true) Offline players will have a different status id
- sendJSONOnSneakingPlayers (default: false) Sneaking players will have a different status id
- sendJSONOnInvisiblePlayers (default: false) Invisible players will have a different status id
- sendJSONOnSpectatorPlayers (default: false) Spectator players will have a different status id
Installation
Short version
- Download both PlayerMarkers.jar and PlayerMarkers_WebFiles.zip
- Drop the PlayerMarkers.jar file in the plugins directory
- Unzip the contents of the PlayerMarkers_WebFiles.zip file to your overviewer web_assets directory (it should create a playermarkers directory)
- Edit the index.html in the overviewer web_assets directory and include the line
<script type="text/javascript" src="playermarkers/playermarkers.js"></script>
- Either start the server to create the config file, or create one yourself (in plugins/PlayerMarkers/config.yml)
- If your world names in bukkit differ from the names in the overviewer configuration see World Name Mapping to setup the mapping.
- If you want to enable the cache for the player skins, make sure your web-server has write permissions for the playermarkers directory of the generated map
Long version
- See Installation
Data format
- See Data Format
Permissions
- playermarkers.show
Player will be shown on the map (exported in the json file)
- playermarkers.admin
Can change plugin configuration with commands
Commands
- playermarkers <config> <value> Change the value of a setting
Planned Features
- Option to customize the size of the player skin icon
- Add commands to hide / unhide, and a corresponding permission node
- Show health of the player in opened player marker
Changelog
Plugin
v0.3.0
- Added option in web files to automatically follow a player
- Added option in web files to change the spawn location
- Changed web files to be pure javascript (php not required anymore)
- Added config option to disable sneaking, invisible and spectator player locations
- Added config option to send a different id for offline, sneaking, invisible and spectator players
- Added update checker
- Strings are not in separate yml file for easy customization
- Added permissions
v0.2.0
- Added config option to map bukkit world names to overviewer world names
- Added config option to disable offline player locations
- Added config option to set the path where the offline player locations are stored
Web Files
v0.3.0
- Added option in web files to automatically follow a player
- Added option in web files to change the spawn location
- Changed web files to be pure javascript (php not required anymore)
v0.2.0
- Merged player.php and player_grey.php
- Add "big" picture feature (opened player markers have now a proper picture, not a upscaled one)
Complete Changelog
See Changelog
Does anyone have this working with pigmap ?
Or would it be possible that you (ICWiener42) please indicate what should be modified to run with pigmap ? I've noticed that the playermarkers.js is configured to work with overviewer, I've been fiddling a bit with it, but I don't feel I'm close to get it to work yet.
Thank you
Two features that would be great, players able to hide themselves with a command (and maybe a permission node to go with that?) and a player-list on the side that showed all the players logged in.
@Minedeath
Yeah that would be cool, but i think this would be enough for a new plugin. Perhaps when i have some spare time, i think it would be a fun project... ;-)
Ok, cool. A next very cool feature was a Chat function between the map and Minecraft. But I think that this was to much work.....
Benj
@Minedeath
I just played around a bit with rescaling, and it actually doesn't look too bad. But it requires some changes in player.php. I think i'm going to add a config option for the size of the resulting png. But i can't promise that i can do it this weekend, but i try ;-)
Thank you now it was working perfect! Cool Plugin. Was it possible to make the Skins bigger? Because i think there was too small when it fully zoomed.
@Minedeath
Hi,
your server is not giving much information, but i guess the "500 internal server error" is because of the missing gd module of php (Sorry, forgot to mention that in the requirements. It's now in there). If its your server consider installing this module. If not, try replacing the included player.php with the player.png file. This way your only able to see the default player skin for everybody instead the customized skins. I'll add this to my TODO list to include a check for the gd module, and probably a way to manually create the skins and serve them from a folder without creating them from the skins.
Hi,
I have made all like the Installation guide. But it wasn't work. Can you help me?
The map was located here: http://titan105.server4you.net/map
Benj
Awesome, thank you! :)
@jyggen
Hi, i found the problem. I totally forgot to mention in the description that the name of the world has to match the name of the map in overviewer. But thinking about it, i think this is not the best nor the most obvious solution. I think i will have to implement a mapping option in the config, so that the map name in bukkit and the map name in overviewer do not need to be the same.
For now the simplest solution is to either rename the overviewer map or the bukkit map. Or you could change line no. 34 in playermarkers.js from
to
But this will disregard the world the player is on. So all players will be visible on all worlds.
That said, i'm working on a solution and hope that it will be ready this weekend.
Can't see the markers for some reason. markers.json is correctly created/updated and the ajax requests are successful, but the markers aren't visible. Url: http://minecraft.pback.se/