This plugin allows players to create in-game Points of Interest using signs and allows other players to find them with the standard compass or to view them on a live map with dynmap 1.8+!
Upgrading from versions prior to 1.02 is a Major update. Please refer to release notes and installation guide before upgrading.
Major Features
- Create Points of Interest by creating special signs.
- Find closest Points of Interest and see distance and directions for each.
- [*New in v1.1.x] view Points of Interest on a live map via dynmap 1.8+ integration!
- [*New in v1.0.x] Target nearby POIs with your compass!
- [*New in v1.0.x] Immediately teleport to a Point of Interest.
- [*New in v1.0.x] Most common uses require no typing but there is added flexibility through in-game commands.
For Admins
- Highly configurable with a full suite of
- "Lockdown" config option provides safety in case of a release with breaking config changes. Also allows for temporary disabling of plugin for maintenance purposes with the option to bypass via permissions.
- Uses sqlite as a small, zero-configuration db solution.
- Custom config implementation puts instructions directly above each config node.
Important Links
Commands (In-game help available on each)
- /poi help (List of these actions, or detailed help on a specific action)
- /poi types (List of available POI types) [New in v1.1.x]
- /poi tp (Teleport to a Point of Interest) [New in v1.0.x]
- /poi remove (Removes a Point of Interest)
- /poi search (Radius search for nearby Points of Interest)
- /poi list (List all Points of Interest of a given player, in the current world)
- /poi page (Page through latest results from search or list)
- /poi select (Selects a Point Of Interest by id for further interactions)
- /poi summary (Get a summary of currently selected Point, including directions)
- /poi (Shortcut for /poi summary)
- /poi config (Reloads configuration from file)
Supported Permissions
- crussell52.poi.* - Access to all functionality
- crussell52.poi.view - Ability to search, list, and use compass to find POIs
- crussell52.poi.compass - Ability to use compass to find POIs
- crussell52.poi.action. - Access to all actions under the poi command
- crussell.poi.action.teleport Ability to teleport directly to POIs
- crussell52.poi.action.add - Ability to add POIs - auto-grants remove permission
- crussell52.poi.action.add - Ability to add POIs - auto-grants remove permission
- crussell52.poi.action.remove - Ability to remove your POIs
- crussell52.poi.action.remove.others - Ability to remove POIs owned by self and others
- crussell52.poi.action.search - Ability to search for nearby POIs with command
- crussell52.poi.action.list - Ability to list your POIs or those of others
- crussell52.poi.action.config.reload - Grants the ability to relaod configuration from the file
- crussell52.poi.lockdown.override - Grants ability to operate normally while POI lock down is in effect
- crussell52.poi.max.{dynamic} - Dynamic permissions for unique POI maximums.
- crussell52.poi.type.{dynamic} - Dynamic permissions for access to individual POI types.
Configuration Options
- distanceThreshold: Maximum radius for searching for nearby POIs
- minPoiGap: Minimum distance between any two POIs
- maxSearchResults: Maximum number of POIs returned when searching for nearby POIs
- maxPlayerPoiPerWorld: Maximum number of Points of Interest allowed per player in each World
- crussell52.poi.max: Allows creation of custom permission nodes, each with a specified max (use to override "maxPlayerPoiPerWorld" option)
- worldBlackList: Disallows Points of Interest in listed Worlds
- lockDown: Prevents interaction with POI plugin (overridable via permissions)
- mapMarkerWorlds: Turn on dynmap marker support per world.
- poiTypes: Create POI types. Configure labels, default permissions and what map marker icon to use (if any).
About the Author
I am a 35 year old, professional software developer and I am passionate about quality, maintainable code. I have been playing Minecraft since the early Beta days and love what Bukkit has added to the experience. Like all the other awesome authors of Bukkit Plugins, I created this plugin for the good of the community. This plugin was originally published a couple of years ago and was my first published plugin. I'm happy to have found time to go back and spruce it up and I hope it finds a good home on your server!
If you've enjoyed it, please consider donating. Long gone are the days of "starving college student", but I am recently engaged and also long gone are the days of our parents paying for our wedding! :-) Your donations will help me justify the time I spend working on this instead of other, paid-for, side-work.
Please feel free to view this project's source code on github. If you run into any problems, please let me know and I will do my best to patch it up in a timely manner.
Thank you again, and enjoy!
- Chris