Bounty Tracker - No-Not-Jaden/NotBounties GitHub Wiki

Bounty Tracker Picture

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

Bounty Tracker Recipe

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:

  1. Crafting a bounty tracker with 1 empty tracker and 1 player head. (craft-tracker: true)
  2. Clicking on a placed bounty poster in an item frame. (poster-tracking: true)
  3. 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 with empty 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 with give-own: true
  • The notbounties.tracker permission with write-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


Related Pages