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
The plugin works for me in 2017. Version server spigot : 1.11.2 and last minecraft overviewer^^
Thank you
Hey guys ! I think there is a problem with the Java Version. Can you check : http://dev.bukkit.org/bukkit-plugins/mapmarkers/tickets/4-java-version-issue/ ?
It will help me a lot because i can't load your plugin because of the same problem :/
I try to launch my server with Java 1.6/1.7/1.8 but none of them works ...
Will you be updating this to use the new UUID system?
Hey ICWiener42.
I keep getting below message even that i have the latest update of your plugin. Pleased to hear how to fix this problem.
14:24:20 [SEVERE] Error occurred while disabling PlayerMarkers v0.2.0 (Is it up to date?) org.bukkit.plugin.IllegalPluginAccessException: Plugin attempted to register task while disabled at org.bukkit.craftbukkit.v1_6_R3.scheduler.CraftScheduler.validate(CraftScheduler.java:394) at org.bukkit.craftbukkit.v1_6_R3.scheduler.CraftScheduler.runTaskTimerAsynchronously(CraftScheduler.java:137) at org.bukkit.craftbukkit.v1_6_R3.scheduler.CraftScheduler.scheduleAsyncRepeatingTask(CraftScheduler.java:133) at org.bukkit.craftbukkit.v1_6_R3.scheduler.CraftScheduler.scheduleAsyncDelayedTask(CraftScheduler.java:108) at org.bukkit.craftbukkit.v1_6_R3.scheduler.CraftScheduler.scheduleAsyncDelayedTask(CraftScheduler.java:92) at com.github._1am3r.PlayerMarkers.PlayerMarkers.run(PlayerMarkers.java:224) at com.github._1am3r.PlayerMarkers.PlayerMarkers.onDisable(PlayerMarkers.java:88) at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:219) at org.bukkit.plugin.java.JavaPluginLoader.disablePlugin(JavaPluginLoader.java:481) at org.bukkit.plugin.SimplePluginManager.disablePlugin(SimplePluginManager.java:400) at org.bukkit.plugin.SimplePluginManager.disablePlugins(SimplePluginManager.java:393) at org.bukkit.craftbukkit.v1_6_R3.CraftServer.disablePlugins(CraftServer.java:279) at net.minecraft.server.v1_6_R3.MinecraftServer.stop(MinecraftServer.java:345) at net.minecraft.server.v1_6_R3.MinecraftServer.run(MinecraftServer.java:452) at net.minecraft.server.v1_6_R3.ThreadServerApplication.run(SourceFile:583)
a new version?? never ? :(
@Crafter6432
Did this change? I thought async-task are executed in a async thread. Well I'll reread the documentation of it.
@iArren
I usually just export is as a jar in eclipse. I don't know maven, but I think it would be worth learning it. I'll look into it when I have more time again.
@pohype
I'm in the middle of exam preparation. I'll try to look into it afterwards.
Doesn't work with CB 1.5.2
Can anyone help? How to build it from sources?
I use maven usualy, but this I can't understand.
Please move the Save-Task into a Async Thread to prevent laggs.
Does it work with pigmap yet? And can you hide and unhide? Thanks!
@ICWiener42
Now it's all ok, i installed lastest version, sorry for late answer but i thought this plugins was not up to date. Now i installed and bukkit don't request it in console :)
Thanks
@SwingLifeAway
Sorry for the late answer, but I just had the time to test it with newer bukkit versions, and it still works for me. So can you give me the error it gives you?
Hi, I'm using bukkit 1.4.6 R0.2 and the console log tells me that i don't have the PlayerMarkers.jar . but then i see this page and the lastest version is for 1.2.5, and my question is: Can I use this version and is this compatible with my version? Thanks!!
@ICWiener42
An option would be nice. Maybe 2-5px wide border and a configurable color? And if possible the option to make the border the invert of the background. That would be nice i think.
@paalbra
Can be done, but I'm not sure which color the outline should have. Does a black outline suffice? Or should it be the inverted color of the outermost pixels? I think I'll add this as an option somehow, it's probably the best way.
Nice plugin :) I've been using MapMarkers for some time, but I've now switched to this.
One thing I'd like to see: Some skins may be hard to see on the map background. Could there maybe be an idea to have some kind of outline/border on the player markers?
@ICWiener42
Well, take your time... I probably won't need it anymore. Even if pigmap is much more efficient, I decided to switch to overviewer finally.
Thanks for the reply although.
@sawineMT
I'll add it to the TODO list, but unfortunately i can't give you an ETA. Life just got really busy for me (thats also the reason for the lack of updates). But i try to get something done in the next days.