Wanted Tags - No-Not-Jaden/NotBounties GitHub Wiki

Wanted Tags Picture

The wanted tags feature displays extra tags above a player's head when they reach a certain bounty. By default, this will display a player's bounty, but it can be changed to whatever you want.

Placeholder

The placeholder %notbounties_wanted% will return the same text that is on the tag whether the feature is enabled or not. If you want to use an existing tags plugin, you can use this placeholder along with PlaceholderAPI. If you want to setup wanted tags with the TAB plugin, then you will need to use this placeholder. See Setup with TAB.

Configuration

All of the options to control this feature are in the config.yml file under the configuration section wanted-tag. To disable this feature, set enabled to false.

Offset

The offset option controls how far the tag is above the player's head. It is measured in blocks. If you have other tags, you can change this offset to be above them.

 offset: 0.4

Text

The text option controls what is displayed in the wanted tag. {level} will be replaced with the level text which can be read about below, and {amount} will be replaced with the bounty amount. PlaceholderAPI placeholders are welcome here too.

  text: '&f{level}&6&lWANTED&f: {amount}'

Minimum Bounty

The min-bounty option controls the threshold that bounties need to cross for a player to have a wanted tag.

  min-bounty: 100

Hide When Sneaking

The hide-when-sneaking option controls whether the wanted tag is removed when a player is sneaking. With this disabled, players won't be able to hide without their wanted tag showing.

  hide-when-sneaking: true

Level

The level section allows you to add different text depending on how high the bounty is. You must include {level} in the text for this to show up. You can add as many levels as you want; follow the pattern with (amount):'(text)'. You cannot use decimal values here. In the default configuration shown below, bounties below 1000 and above the min-bounty option will have no level text. Bounties equal to or above 1000 will have one skull. Bounties equal to or above 2500 will have two skulls, and so on.

  level:
    # minimum bounty amount: text
    1000: '&f☠ '
    2500: '&c☠☠ '
    5000: '&4☠☠☠ '

Setup with TAB

If you don't want to use NotBounties' methods of displaying this tag, you can use the placeholder with a nametag plugin like TAB. This section will walk you through setting up the wanted tag to be displayed with the TAB plugin. This only works for Minecraft versions 1.20.3 and greater. If you want to use an earlier version, you must install an earlier version of TAB before unlimited name tags were removed, and use the placeholder with that feature.

Disable wanted tags in the NotBounties config. Under the wanted-tag configuration section, set the enabled option to false.
Install TAB and PlaceholderAPI
Restart your server to load the new plugins.
In TAB's config.yml, find the belowname-objective section. Set enabled to true, fancy-value to %notbounties_wanted%, and title to ''.

belowname-objective:
  enabled: true
  disable-condition: '%world%=disabledworld'
  fancy-value-default: NPC
  fancy-value: '%notbounties_wanted%'
  value: '%health%'
  title: ''

There is more information about this TAB feature here.

Reload TAB with /tab reload

You should now see the wanted tag below player's names. If you don't see it, they may not have a bounty over the min-bounty. I recommend playing around with the TAB configuration to get it looking how you want it to.

config.yml