Bounty Tracker - No-Not-Jaden/NotBounties GitHub Wiki
The bounty tracker feature allows players to track players with bounties using a special compass. This compass will show the direction of the player with optional additional information like world, coordinates, or distance.
Obtaining a Tracker
Empty trackers can be obtained by crafting them or through the command: /bounty tracker empty
. In the default config (give-own: false
), only admins can use this command. Empty trackers are the base component for creating a bounty tracker.
This is the recipe to craft a bounty tracker in Minecraft versions above 1.17
In versions below 1.18, the spyglass is switched with a tripwire hook. In versions below 1.17, the amethyst shards are switched with paper.
After you have an empty tracker, you can obtain a bounty tracker in 3 ways:
- Crafting a bounty tracker with 1 empty tracker and 1 player head. (
craft-tracker: true
) - Clicking on a placed bounty poster in an item frame. (
poster-tracking: true
) - Using the bounty tracker command
/bounty tracker (player)
while holding an empty tracker. (write-empty-trackers: true
)
After the bounty has been claimed, the tracker will reset to an empty tracker (reset-removed-trackers: true
). You can manually turn a bounty tracker into an empty tracker by throwing it into a filled cauldron (wash-trackers: true
).
Commands
/bounty tracker (player)
Gives you a compass that tracks a player with a bounty./bounty tracker (player) (receiver)
Gives receiver a compass that tracks a player with a bounty. Replacing the player withempty
will give an empty tracker.
Permission
To run the first command, a player must have one of the following:
- The
notbounties.admin
permission - The
notbounties.tracker
permission withgive-own: true
- The
notbounties.tracker
permission withwrite-empty-trackers: true
while holding an empty tracker
The second command can only be run by players with the notbounties.admin
permission.
To use all tracker features, the players must have the notbounties.tracker
permission which is given to them by default.
Configuration
All options for this feature are under the bounty-tracker
configuration section. To disable this feature, set enabled
to false.
Minimum Bounty
The minimum-bounty
option sets the minimum required bounty amount to get a tracker for a player.
minimum-bounty: 10
Give Own
The give-own
option allows players to give themselves their own bounty tracker. They will be able to use the command /bounty tracker (player)
to receive a free compass tracker.
give-own: false
Write Empty Tracker
The write-empty-tracker
option allows players to use the bounty tracker command while holding an empty tracker to transform the empty tracker into a bounty tracker to track a player.
write-empty-tracker: true
Wash Tracker
The wash-trackers
option allows players to throw a bounty tracker into a filled cauldron to clean the tracker an receive an empty tracker back.
wash-trackers: true
Craft Tracker
The craft-tracker
option controls if players are allowed to craft an empty tracker. See Obtaining a Tracker for the recipe.
craft-tracker: true
Poster Tracking
The poster-tracking
option controls if players are allowed to click a placed bounty poster with an empty tracker to convert that tracker into a bounty tracker.
poster-tracking: true
Reset Removed Trackers
The reset-removed-trackers
option controls if bounty trackers are turned into empty trackers instead of being removed after the bounty is claimed. This uses the below Remove option when resetting trackers.
reset-removed-trackers: true
Remove
The remove
option decides how to remove old compasses that have already had their bounty claimed. 4 different settings for this correlate to numbers 0-3.
- [0] Don't ever remove compasses
- [1] Remove compasses if players hold them
- [2] Check inventories every 5 minutes
- [3] Check inventories every time a container is opened The performance impact increases the higher the value is.
remove: 2
Glow
The glow
option controls how many blocks the player with the compass needs to be from the player with the bounty until a glow effect is added. Setting the value to 0 disables the glow.
glow: 10
Action Bar
The action-bar
configuration section allows you to change what is displayed on the action bar when a player is holding a tracking compass. To disable the action bar from displaying, set enabled
to false.
Show Always
The show-always
option controls whether the action bar is always displayed while the player is holding the compass or if it only displays when the player clicks.
show-always: true
Player Name
player-name
will show the player name of the person you are tracking in the action bar.
player-name: true
Distance
distance
will show the distance of the person you are tracking in the action bar.
distance: true
Position
position
will show the coordinates of the person you are tracking in the action bar.
position: false
World
world
will show the world of the person you are tracking in the action bar.
world: false
Example
With every option enabled, the action bar would look something like: Not_Jaden - 25m - 13x 63y 20z - world