Please leave a positive review if the plugin worked as intended and if you are feeling generous, support my work.
If you have any issues with the plugin or want to share any cool ideas I could add to this plugin do let me know in the discussion, I will address them as soon as possible. Please do not drop those in the reviews.
Description
Diamond Finder Compass is a plugin for Minecraft servers (Bukkit/Spigot). It allows a player to give themselves a compass that finds any block in a given radius.
It is:
Fast: Plugin is optimized for performance.
Easy to use: Type the command and follow the compass, as easy as it gets.
Free: Absolutely free to use.
Fun: Reduce the grind, add more fun.
Usage:
/dcomp : To get the compass / Block Locator
/dcomp find <MATERIAL_NAME> : Sets your compass to find the specified block
/dcomp radius <Integer> : Sets compass to search within specified radius
/dcomp reset : Resets the compass, so that it can locate the blocks again.
NOTE: Compass is set up such that once it finds a block, it will remember its location and compass will keep pointing it till the block is broken or the /dcomp reset is called or radius or search block is changed. This was done to improve server performance and un-necessary spam.
Permissions
diamondfindercompass.use : Basic permission which gives Players permission to use the compass
diamondfindercompass.get : Gives Players the ability to get the compass.
diamondfindercompass.change : Players will be able to change their compass's settings(search block, search radius)
diamondfindercompass.<MATERIAL_NAME>.find : Player will be able to set the search block to this Material / Block name.
You can check all the material names here.
diamondfindercompass.all.find : Player will be able to set any block as a search block.
Change the below variables if needed in config.yml in your plugins folder.
Update 1.1.1
- Permission bug hotfix
- Added diamondfindercompass.use as a different permission just to use the compass
- Now u can change the messages sent to the users by editing the config.yml file.[Detailed explanation on what each variable does is explained in the config.yml file]
- Compass name can now be changed in config.yml
- Custom Lore can be added to the Compass in config.yml
- Added more sound effects and particle effects for compass interactions.
Code (YAML):
#--------------------------------------------------
# NOTE: ONLY CHANGE THE VALUES AND NOT THE VARIABLE NAMES
#--------------------------------------------------
#--------------------------------------------------
# Player specific
#--------------------------------------------------
# These values are default values set when the server starts
# Players can still be able to change this for themselves if they have permissions, however that won't change the config file
# default value for searching of block
DEFAULT_RADIUS : 25
# default value for the block search
DEFAULT_BLOCK : DIAMOND_ORE
# set the max search radius for players. Higher number can hurt the server's performance, tweak according to the server's hardware or requirement.
MAX_RADIUS : 50
#--------------------------------------------------
#--------------------------------------------------
# Server specific
#--------------------------------------------------
#Players cannot change these
# Name of the compass
ITEM_NAME : '&3Block Locator'
# Add custom lore to the compass, to add more lines split them with '|'
ITEM_LORE : '&aRight Click to start locating |&b /dcomp help &a- for more info'
# Use custom place holders
# @Player : Name of player using it
# @Block : Currently set Block's name
# @Radius : Currently set Radius
# @Compass : Name of compass
# @MaxRadius : Max radius set in MAX_RADIUS
DISPLAY_MESSAGES:
SUCCESS :
# When a Player receives the Compass
ITEM_RECEIVED : '&aAdded & [email protected] &ato your inventory'
# When a Player changes search Block
BLOCK_CHANGED : '&aChanged the block to & [email protected]'
# When a Player changes search Radius
RADIUS_CHANGED : '&aChanged the radius to & [email protected]'
# When a Player resets the compass
RESET_COMPASS : '& [email protected] &alocation is reset'
# When a Player breaks the block
BLOCK_FOUND : '&aYou found the block'
# When a Compass detects the search block
BLOCK_DETECTED : '& [email protected] &afound, follow the compass'
FAIL :
# When a Compass does not detect a block
BLOCK_NOT_DETECTED : '&cNothing detected'
# Player does not have the permission to use the plugin
NO_PERM_PLUGIN : '&cYou do not have the permission to use DiamondFinderCompass'
# Player does not have the permission to change the compass settings
NO_PERM_CHANGE : '&cYou do not have the permission to change the compass settings'
# Player does not have the permission to set the search block to the block he entered
NO_PERM_FIND_BLOCK : '&c You do not have the permission to find that block'
# Player tried to set the search radius more than MAX_RADIUS
RADIUS_GREATERTHAN_CONFIG : '&cMax radius is set to @MaxRadius, you cannot exceed this value'
# Player entered an incorrect block name / Material name
INCORRECT_BLOCK_NAME : '&cThat block name does not exist'
# Player entered a non-integer
INCORRECT_RADIUS : '&cInput a valid integer'
#--------------------------------------------------
# NOTE: ONLY CHANGE THE VALUES AND NOT THE VARIABLE NAMES
#--------------------------------------------------
#--------------------------------------------------
# Player specific
#--------------------------------------------------
# These values are default values set when the server starts
# Players can still be able to change this for themselves if they have permissions, however that won't change the config file
# default value for searching of block
DEFAULT_RADIUS : 25
# default value for the block search
DEFAULT_BLOCK : DIAMOND_ORE
# set the max search radius for players. Higher number can hurt the server's performance, tweak according to the server's hardware or requirement.
MAX_RADIUS : 50
#--------------------------------------------------
#--------------------------------------------------
# Server specific
#--------------------------------------------------
#Players cannot change these
# Name of the compass
ITEM_NAME : '&3Block Locator'
# Add custom lore to the compass, to add more lines split them with '|'
ITEM_LORE : '&aRight Click to start locating |&b /dcomp help &a- for more info'
# Use custom place holders
# @Player : Name of player using it
# @Block : Currently set Block's name
# @Radius : Currently set Radius
# @Compass : Name of compass
# @MaxRadius : Max radius set in MAX_RADIUS
DISPLAY_MESSAGES:
SUCCESS :
# When a Player receives the Compass
ITEM_RECEIVED : '&aAdded & [email protected] &ato your inventory'
# When a Player changes search Block
BLOCK_CHANGED : '&aChanged the block to & [email protected]'
# When a Player changes search Radius
RADIUS_CHANGED : '&aChanged the radius to & [email protected]'
# When a Player resets the compass
RESET_COMPASS : '& [email protected] &alocation is reset'
# When a Player breaks the block
BLOCK_FOUND : '&aYou found the block'
# When a Compass detects the search block
BLOCK_DETECTED : '& [email protected] &afound, follow the compass'
FAIL :
# When a Compass does not detect a block
BLOCK_NOT_DETECTED : '&cNothing detected'
# Player does not have the permission to use the plugin
NO_PERM_PLUGIN : '&cYou do not have the permission to use DiamondFinderCompass'
# Player does not have the permission to change the compass settings
NO_PERM_CHANGE : '&cYou do not have the permission to change the compass settings'
# Player does not have the permission to set the search block to the block he entered
NO_PERM_FIND_BLOCK : '&c You do not have the permission to find that block'
# Player tried to set the search radius more than MAX_RADIUS
RADIUS_GREATERTHAN_CONFIG : '&cMax radius is set to @MaxRadius, you cannot exceed this value'
# Player entered an incorrect block name / Material name
INCORRECT_BLOCK_NAME : '&cThat block name does not exist'
# Player entered a non-integer
INCORRECT_RADIUS : '&cInput a valid integer'
#--------------------------------------------------
Resource Information
Author:
----------
Total Downloads:
471
First Release:
Jan 4, 2021
Last Update:
Jan 7, 2021
Category:
---------------
All-Time Rating:
2 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings