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

Bounty posters are custom maps that show a player's skin and their bounty

Usage

Admins can obtain bounty posters with the command /bounty poster (player) or /bounty poster (player) (receiver) to give someone else a poster. This will generate a map with the player's face on it and their bounty.

Customization

Configuration

All of these settings are in the bounty-poster configuration section in config.yml.

Let Players Have Access to the Poster Command

I don't recommend this on public servers because allowing players to get free items with only a command can get messy. The setting that controls this feature is give-own. By default it is false, but setting it to true will allow players to have access to the /bounty poster (player) command to give themselves a bounty poster.

  give-own: false

Crafting Posters

To craft a bounty poster, all you need is a player head of the person you want to create the poster for and an empty map. You can only craft posters for players with an active bounty.

  craft-poster: true

Wash Posters

Washing a poster will turn a bounty poster into a regular empty map. To wash a poster, throw a bounty poster into a filled cauldron.

 wash-poster: true

Toggling the Bounty Reward

This is turned on by default, and bounty rewards will be displayed on the posters. This requires the maps to be updated every so often. The interval that the posters update can be changed with the update-interval option. To change this feature, change the display-reward option. Disabling this feature can improve server performance but will change the location of the name to be centered. I suggest setting clean-posters to true. More information can be found in the Clean Posters section.

  display-reward: true

Displaying the Bounty Reward

The text for the bounty reward can be changed to whatever you would like. Placeholders and colors can even be used! This option is under the name of reward-text, and by default the text is 'REWARD: {reward}'. This text is positioned directly below the player's name and is centered. Note: Keep this line as short as can be, especially if you aren't using divisions. The longer the text, the smaller it gets, and small text is hard to read on maps.

  reward-text: 'REWARD: {reward}'

Lock Maps

This will freeze the maps as soon as they are created. This can increase server performance. I suggest turning off display-reward to avoid confusion amongst your players.

  lock-maps: false

Currency Wrapping

By default, this is set to false, and the prefix and suffix of the currency will not be shown on the map. Some currency characters, like the diamond used in the default suffix, will show as empty boxes on the map.

  currency-wrap: false

Changing the Name Line

The line with the player's name can be modified just like reward-text. Similarly, don't put too much on this line, or it can become ineligible. Some server owners will add a placeholder here for a prefix, or color the name differently. Note: Placeholders will only be updated on a server restart if save-templates is set to false. Otherwise, the placeholder will be parsed the first time the map is created, and saved forever.

  name-line: '{name}'

Update Interval

This is how often the maps will update in milliseconds. You can increase this to increase server performance.

  update-interval: 2000

Always Updating the Map

With this option enabled, the maps will be updated every update interval regardless of the bounty change. It would be useful to update this if you have a placeholder in reward-text that should be updated.

  always-update: false

Saving Templates

By default, this is set to true, and templates are saved after creation. After a bounty poster is created, the image with just the name and skin will be saved in the posters folder. Creating new bounty posters for a player will use this template instead of creating a new one. You should set this to false if you want the skins to stay updated, or if there is a changing placeholder in the name-line.

  save-templates: true

Clean Posters

Cleaning posters is just an easier way to delete the posters in the posters folder. This will allow the plugin to create new templates for players. After a plugin reload, this option will automatically be set back to false.

  clean-posters: false

Poster Style

If you change anything with the poster style, clean your posters to see the updates.

Background Image

Currently, the background image is a worn piece of paper with a Steve head and the text "WANTED" at the top. This image is located in the posters folder named "bounty poster.png". Replace this poster with any 128x128 pixel PNG image to have as the background. The skin of the player and the text of the name line and reward line will be overlayed on this image. If you only want to translate the wanted text, there is an included file named "poster template.png" with the text removed. Edit that with your translation and replace the bounty poster image. The font used is Simsun-ExtB.

Bounty Poster Template

Font

The default font is Simsun-ExtB. If you want to change the font of the name line and reward line, add a TrueType Font (.ttf) file named "playerfont.ttf" in the posters folder.

Dead Bounty Overlay

When a player dies with a bounty, the poster doesn't get deleted. Instead, the "dead bounty.png" image is overlayed on top. This file is located in the posters folder and has dimensions of 72x72 pixels. Replace this file to change the overlay.

Dead Bounty Overlay


Related Pages