This page discusses how to manage Points of Interest in your world through signs and commands. It will also discuss all related permissions and configuration options.

Adding

Signs

As of Version 1.0.2, you can add or remove Points of Interest through signs. Adding a POI with a sign is easy. So easy, in fact, that the text command to add a Point of Interest has been removed making signs the only way to add a POI.

To create a POI, simply place a sign using the following special format:

 ----------------
|     [POI]      |
|      My        | 
|   Cool Place   |
|    poiType     |
 ----------------

Once the POI is created, the sign will change to look like this:

 ----------------
|  My Cool Place |
|                |
|   POI[6] by:   |
|    YourName    |
 ----------------

In versions 1.1.0+, the 4th line specifies the type of Point of Interest to create. The type controls the label used to describe your POI and how it appears on the live map when dynmap support is enabled. Available types are controlled by configuration and permissions. Use the in-game "/poi types" command to see what types are available to you! (Note, leaving the 4th line blank is the same as writing "default".)

In versions before 1.1.0, the 4th line must be left blank.

Commands

There is no command related to adding a Point of Interest.

Permissions

There are built-in permissions which affect the ability to add a Point of Interest.

crussell52.poi.action.add

This permission grants or denies the ability to add a Point of Interest.

This permission is granted to ops by default.

This permission implicitly sets the crussell52.poi.action.remove permission.

crussell52.poi.action.add.max.{dynamic}

These are a special permissions that are defined through the configuration and allow for fine control over how many POIs a player can have in each world. The final segment of these permissions are defined in the configuration along with a maximum value. They can be assigned to players or groups like any other permission.

So if crussell52.poi.action.add.max.elder is configured to allow for 50 Points of Interest and Herobrine is granted this permission, he will have a per-world max of 50 POIs.

crussell52.poi.type.{dynamic}

These are special permissions that are defined for each available POI type. The default permission value for these can be set as part of the poiType configuration. Each one grants/denies permission to a specific POI type.

crussell52.poi.type.default is always available, even if you do not configure any poiTypes. It applies to POIs created without a specific type or with the type of "default".

Configuration

There configuration options which control how many Points of Interest are allowed and which worlds support the PointsOfInterest plugin.

maxPoiPerWorld

This sets the default maximum number of Points of Interest allowed for any given player in a single world. This value can be overridden with dynamically configured permissions.

crussell52.action.add.max

This configuration option provides a way to create dynamically configured permissions which allow for a finer level of control over player POI maximums. Each key in this configuration option is combined with the crussell52.poi.action.max. prefix to generate a permission which can be assigned to any player or group to grant them the maximum configured for that option. It is also possible to create a permission which grants unlimited POIs to a player.

Removing

Without the ability to remove Points of Interest, the world could get cluttered.

Signs

If you are near the Sign which marks a POI, it can be removed by destroying the sign. However, this is only possible if you own the POI - even if you have permission to remove the POIs of other players.

To remove POIs that belong to other players, or POIs that are far away, you can use the text command.

Commands

If you are far away from a POI or are trying to remove a POI that belongs to someone else, you must use the command to remove the POI. When using this command you must provide both the ID and the full name of the POI you wish to remove. This is a safeguard against accidentally deleting the wrong POI since there is no way to "undo" a removal. This is all done through the following command:

/poi remove <id> <name>

Permissions

The ability to remove Points of Interests for yourself or others can be controlled with permissions.

crussell52.poi.action.remove

This permission grants or denies the ability to remove your own Points of Interest. This permission is valid for removal through signs or commands.

This permission is granted to ops by default.

If a player is granted the crussell52.poi.action.add permission, they will also be granted this permission. If you want a player to be able to add but not remove their own POIs, then this permission must be explicitly denied.

crussell52.poi.action.remove.others

This permission grants or denies the ability to remove other players' Points of Interest through the related command. Even with this permission, it is impossible to remove another player's POIs by destroying its sign.

This permission implicitly sets the crussell52.poi.action.remove permission.

This permission is granted to ops by default.

Configuration

There are no configuration options directly related to removing POIs.