World Name Mapping
Why is this required?
Because the name of the worlds in bukkit and in overviewer are configured independently, PlayerMarkers needs to know which bukkit world corresponds to which overviewer world. So only players that are on the currently viewed map are shown. If your world names in bukkit are the same as in the overviewer configuration, you can skip this, as the auto generated config will just work.
Bukkit world names
The bukkit names are just the names of the world folders. So if you didn't set a different name, this will just be "world".
Overviewer world names
The overviewer world names are set in the config that is used to generate the world map with overviewer. A config file will contain something like this:
worlds["survival"] = "/home/username/server/survivalworld" worlds["creative"] = "/home/username/server/creativeworld"
In this example the the names of the worlds are "survival" and "creative"
Configuration of the mapping in PlayerMarkers
The configuration for PlayerMarkers is really simple. On the first start of the plugin, it creates a default mapping for every world in bukkit. This will look similar to this:
Mapping: world: world world_nether: world_nether world_the_end: world_the_end
The first name is the bukkit world name, and the second is the overviewer world name. So just set them accordingly to your setup.
I had a bit of a hard time configuring this because i have a custom name for my server map, but i use the default overviewer only with the "-p 2 --rendermodes=smooth-lighting" parameters.
It works with:
Mapping:
customname: world
So "world" is apparently the default name of the map in the overviewer
However, mapping to this in the config file for PlayerMarkers doesn't work, because Overviewer changes the name when it puts it in the web assets folder file, overviewerConfig.js:
So, for my specific example, my PlayerMarkers config looks like this:
Spirit is the name of my Bukkit world, while Spirit - overworld is the value from my overviewerConfig.js. Hopefully, that makes it a bit more clear, and saves someone else some time.