SignBoard

SignBoard v1.6.16

(For Spigot/Paper/Bukkit 1.8.7 to 1.19.3 - For details, see version support, below)

Write on signs to your heart's content

Now with multi-language support

 

 - Attach unlimited text to signs or living entities (including armor stands, villagers, mobs and Citizens2 NPCs!).
- Give text out as a book when players look at the sign/entity.
- Run commands when the player:

  • looks at a sign/entity
  • looks away from a sign/entity
  • clicks a sign
  • attacks or kills an entity
Do you have players who speak different languages?
Or want to communicate different content to different player classes?
SignBoard can now show group-specific content, so you can show players texts in different languages, or according to their player classes! Read more in the Categories section, below.
 

SignBoard01

SignBoard02

SignBoard books

 

Tired of the cramped space on your signs? Now you can have an unlimited amount of text shown with your signs! You can even attach that text to living entities! AND you can attach commands to signs and entities to run at different times!

 

With SignBoard, you create "boards" of text and attach these boards to signs or living entities. Each board can hold up to 15 lines (a total of 600 characters per board). You can also group several boards into a "set" and use the set as a single body of text.

When players look at a sign or entity, the scoreboard area is used to show them the text on the boards. It's great for communicating... er, well, anything, really, in a game. Admins can provide players with instructions, players can show visitors detailed info about their builds, RPG games can provide detailed lore when a party enters a room... There's no limit.

In much the same way as you attach boards to signs, Signboard lets you attach boards or sets to living entities! You can attach a board or a set to a villager or an NPC, for example, and whenever a player looks at the NPC, the text will be shown. (Armor stands also work as living entities).

When players are shown a set of boards, only one board is shown at a time. Players can cycle back and forth between the boards by right- or left-clicking the sign/entity. That way, a set works like pages in a book.

You can also attach commands to both signs and entities, and control when these commands will run. Commands can be run when the player looks at a sign/entity, looks away from a sign/entity, clicks a sign, attacks or kills an entity. 

As an added perk, SignBoard also lets you edit sign lines without having to break the sign and write everything from scratch - just look at a sign you've created and use the command /sb sign lineX [text] (see below).

SignBoard03

Demo video:

(In English)

(In Spanish, courtesy of Ajneb97.)

 

Version support

SignBoard v1.6.3 and above support all Bukkit/Spigot/Paper versions from 1.13.3 to 1.19.3. SignBoard v1.6.2 supports all Bukkit/Spigot/Paper versions from 1.8.7 to 1.16.1.

(Signboard has its own set variables and supports Placeholder API) 

Multi-language support

As of version 1.6.6, SignBoard supports different languages for its interface (menus and messages). This allows users to choose their own language preference and use the plugin in that language. Right now it has options for English (US), Portuguese (BR), and Spanish (CO), but you can translate the locale file into other languages – just make sure to share them with us, and we'll include them in future releases of SignBoard!

Check out the /sb locale commands.

The default text for new boards has also been moved into the locale files. So now when a new board is created, each player will see its default text in their (chosen) preferred language.

In fact. every line on every board gets processed for translations. So, if you were to add a line to the locale files that said , "This is a board line": "Esta é uma linha de placa" then every board containing "This is a board line" would show the translated version from the respective locale file, according to each player's preferred locale.

Installation

Just drop the jar in your plugins folder and restart the server
 

Basic usage

SignBoard works by letting you create "boards" and then attach those "boards" to one or more signs or to living creatures - animals, villagers, monsters, armor stands, NPCs and even real live players (only OPs can attach boards to players). 

You can group boards into sets by using the /sb set command. A set then behaves like a single body of text, and the various boards it contains will be shown in sequence as the player right or left-clicks.

You can also use the /sb sign attach and /sb sign detach commands to attach or remove a board or set from a sign.

Attach and detach a board or set from a living entity with the commands /sb entity attach and /sb entity detach.

The content of the board is shown in the scorecard area, so each board can have up to 15 lines of 40 characters each.

You can use all of the text color and formatting tags normally used in Minecraft (&0 = black; &1 = dark blue;| &2 = dark green; &3 = dark acqua; &4 = dark red; &5 = dark purple; &6 = gold; &7 = grey; &8 = dark grey; &9 = blue; &a = green; &b = acqua; &c = red; &d = light purple; &e = yellow; &f = white; &k = magic; &l = bold; &m = strikethrough; &n = underline; &o = italic; &r = reset).

Getting Started

  1. Come up with a name for a new board
  2. Create a board with the command /sb board new [boardname]
  3. Place a sign somewhere, look at the sign  and attach the board to it with the command /sb sign attach [boardname]
  4. If you want to attach the board to a living entity, look at it and use the command /sb entity attach [boardname]
  5. Look at the sign or entity - SignBoard will use the scoreboard area to show the default content for your new board
  6. Edit your board with the command /sb board [boardname] lineX [text] (you don't have to be looking at the sign/entity for this)
  7. Group several boards into a set with the /sb set command. Then attach the set to a sign or entity with /sb sign attach and /sb entity attach. When you look at the sign/entity, the first board in the set will be shown; cycle through the other boards by right- or left-clicking the sign/entity.

Tips & Notes

  • Existing scoreboards are respected and will be reloaded as soon as the player looks away from the sign.
  • You can only edit a sign that you could break. When you try to use a sign, SignBoard tests if you would be able to break and replace it, and only then lets you use it. You'll also be able to edit the sign with /sb sign lineX text.
  • Blank lines - both in signs and on boards, you can replace a current line with a blank line; just set the line's content to &r and it'll go blank.
  • You will only be able to change boards that you created, but there's nothing keeping you from using an existing board name (e.g. [boardname]) on a sign, even if that board was created by another player.
  • To use the attach/detach commands on a sign, you must have the ability to break the sign. To use the attach/detach commands on an entity, you must own the board in question. Unless you're OP, in which case you can do anything :).

Editing a board's content

When you create a new board, it comes with a default content. You can edit the lines on any board in three different ways:
 
  • /sb board [boardname] lineX [content] - changes the content of line X directly
  • /sb board [boardname] lineX-Y [content] - changes the content of lines X thru Y (e.g. 1-3, or 3-1 - the order matters)
  • /sb board [boardname] linepushX [content] - changes the content of lines starting on lineX, and pushes any existing lines down.
[content] can be any text, and in the last two commands it can even span multiple lines - as long as you use \n to indicate a line break.
 
For example, the content text 4\n text 3\n text 2 contains two line breaks, so it has text for three lines. If you use the command
/sb board [boardname] line4-3 text 4\n text 3\n text 2
you will replace the contents of line 4 with "text 4", and the contents of line 3 with "text 3"; "text 2" would be ignored, since you only specified two lines to update (4-3).
 
Similarly, if you use the command
/sb board [boardname] linepush4 text 4\n text 3
you will replace the contents of line 4 with "text 4", of line 3 with "text 3", AND the old contents of lines 4,3,2,1 would be "pushed down" as the new content is inserted, causing line 2 to end up with the old content for line 4, and line 1 to end up with the old content for line 3.
 
A few of things to remember:
  1. The title line is line16.
  2. Each line can only hold 40 characters; anything beyond that will be truncated.
  3. No two lines can have the same content, so if you want two lines to look the same, insert invisible &r characters in them to make them different from each other.

Showing multiple boards with board sets

Starting on version 1.3.2, SignBoard lets you show multiple boards to your players whenever they look at a sign or living entity. This is accomplished by grouping a number of boards into a set.
Use the /sb set commands to create, delete and list existing sets. Attach and detach sets from signs and entities the same way you attach/detach boards: with the /sb sign and /sb entity attach and detach commands.
Once a set is attached, the first board on the set will be shown when the player looks at the sign/entity. Then the player can cycle through the different boards by left- and right-clicking. Sets can contain as many boards as you want.

A couple of notes about entities with sets attached to them:

  • Right-clicks: When a set is attached to an entity, the first right-click on the entity is taken over by SignBoard. A second right-click on the entity (within half a second), though, will be processed normally. For example, if you attach a set to a villager, a single right-click on the villager will cycle to the previous board on the set, and the villager trade GUI will not be shown. However, if you double right-click the villager, the first right click will cycle the board and the second one will bring up the trade GUI.
  • Left-clicks: When a set is attached to an entity, you will have to (left) click that entity to cycle through the boards; clicking an entity normally means you're attacking and potentially damaging that entity. Therefore, when an entity has a set attached SignBoard intercepts the click and cancels the damage. The "/sb entity onattack" command will still work, but the entity will take no damage.

Giving out books

When a player looks at a sign or at an entity, you can choose to show the board text on screen or to give the text as a book to the player - or both, or neither. The commands /sb sign show_board and /sb entity show_board toggle the showing of the board's text on the screen. If you would rather give the player a book with the text, the commands /sb sign give_book and /sb entity give_book toggle that function. You can also use these commands to both show the board on the screen and give the book, or to neither show the board nor give the book.

Use the /sb sign status and /sb entity status to check the status of all options defined.

As of version 1.6.12, the command /sb board give_as_book [boardname] [playername] can be used to immediately give a certain board's content to a player as a book. This command can be used, for example, in a sign's or entity's "run" commands to give out the corresponding book only when the sign or entity is clicked on, instead of when the player looks at it.

Formatting books

SignBoard will automatically convert your board texts to place them in books (when show_book is enabled). Since the size of the lines in a book and on the scorecard are so different, and a book has page breaks, SignBoard will attempt to break the lines and the pages neatly, but some fine-tuning may be necessary.
Here are some tips to help you with that:

  • Board lines containing only &r will show as blank lines on the book.
  • Use \n anywhere on your boards to break the current book line. The \n will be ignored when the board is shown on-screen.
  • When SignBoard breaks a long line, it will try to do so at full-word boundaries and will try to insert blank spaces as appropriate. But you may need to manage spaces at the end or beginning of certain lines on the board.
  • If SignBoard finds a board line made up of a single character repeated several times (like '================'), instead of breaking that line in two book lines, it will shorten it so it fits into a single book line.

Running commands on sign click or on entity attack or kill

Just as you attach boards to signs and entities, you can also attach commands that will be run at specific times. These can be any command that an admin can issue in-game. The commands will be run as if they were issued by the player and as if the player had admin authority.  The commands accept variable substitution just like any SignBoard command. 

Commands are specified as a sequence, separated by a vertical bar, like | | ... | .

As of version 1.3.3, you can also insert delays in the sequence, with the syntax [Tu], where T is an integer > 0 and u is a time unit: 's', 'm' or 'h'. For example, a sequence of [5s] | | [2m] | , when executed, will wait 5 seconds before running and then 2 additional minutes before running . Use the delays with care; delayed commands will be executed even if the player is no longer looking at the sign/entity, or even gone from the server.

Certain commands can only be run from the server console. As of version 1.6.13, you can prefix your command with _rfc_ to tell SignBoard to run the command from the server console. Like this: /sb sign before _rfc_ tell Ebaldino hi.

The following SignBoard commands control what happens and when:

  • /sb sign before and /sb entity before - Let you specify a list of commands to be run every time a player looks at a sign or an entity, just before the board text is shown. (If the show_board option is off, the commands still run).
  • /sb sign after and /sb entity after - Let you specify a list of commands to be run every time a player looks away from asign or an entity, just after the board text is hidden. (If the show_board option is off, the commands still run).
  • /sb sign onclick - Lets you specify a list of commands to be run when the player clicks on the sign.
  •  /sb sign onrightclick - Lets you specify a list of commands to be run when the player right-clicks on the sign.

  • /sb sign onshiftclick and /sb sign onrightshiftclick - Let you specify a list of commands to be run when the player shift-clicks or shift-right-clicks the sign, respectively.

  • /sb entity onattack - Lets you specify a list of commands to be run every time the entity is attacked.
  • /sb entity onkill - Lets you specify a list of commands to be run when the entity is killed.

Use the /sb sign status and /sb entity status to check the status of all options defined.

Variables

Use any of these variables anywhere in your boards. Make sure to include the "{" and "}".

When the board is shown to a player, the variables will be replaced with their real-time values.

  • {ServerDate} = the current date.
  • {ServerTime} = the current time.
  • {PlayersNow} = the number of players on the server.
  • {PlayersMax} = the max. number of players on the server.
  • {PName} = the player's name.
  • {PDisplayName} = the player's display name.
  • {PHealth} = the player's health.
  • {PCoords} = the player's current position.
  • {PMobKills} = the number of mobs killed by the player.
  • {PKills} = the number of players killed by the player.
  • {PDeaths} = the number times the player has died.
  • {PTimeAlive} = the time since the player last died.
  • {PMoney} = the player's money (requires Vault).

Placeholder API

Placeholder API support started with Signboard version 1.1.8. This allows you to use variables ("placeholders") from many other plugins, in addition to an extensive list of "native" Placeholder API variables.

To use Placeholder API, download the plugin, drop it into your plugins folder and restart the server. In the game, issue the command /papi ecloud list all and look for the placeholder group you want. Then click on it and accept the command to download it. Then all you have to do is use the placeholders like variables on your boards, surrounded by '%' (%placeholder%).

Placeholder API native variables and their groups are listed here.

FeatherBoard Compatibility

As of version 1.4.9, SignBoard uses the FeatherBoard API for out-of-the-box compatibility. A special thanks to jamisen10 for bringing the FB API to my attention.
 
Up to version 1.4.8, SignBoard, implemented a command-based FeatherBoard compatibility workaround. It detected the presence of FB and then issued "/fb off -s" just before showing a board to a user (to turn FB off for that user), and then "/fb on -s" when the user moved away (to turn FB back on).
 
If you have another scorecard plugin that is keeping SignBoard from properly showing its boards, and that plugin has "off" and "on" commands such as those described above, you can use the "cmd_before" and "cmd_after" options in config.yml to implement the same "off/on" mechanism as for FeatherBoard. Or you can do the same for individual boards, using the board commands. A special thanks to gmalone for helping me work out this solution!
  

Categories

Categories allow you to communicate different content to different groups of players.

 
This is a very powerful feature that lets you do some interesting things, for example:
  • Show your players content in their preferred language. This is not a translation feature - you still have to create the content in the different languages, but you can attach a single board to a sign or entity, and have SignBoard pick the right version of that board to show, depending on the player who's looking at it.
  • Show specific boards for different character classes. When a wizard looks at a sign in a dungeon room, they will see the board you prepared for wizards; when a fighter looks at the same sign, they will see the board for fighters, and so on.
  • Show specific boards for different player ranks. When a Gold player looks a sign in a Depot, they will see the board you prepared for Gold players; when a Platinum player looks at the same sign, they will see the board for Platinum players...
And it's not just for languages or classes! Categories also work for any other groups of players you can think of!
 
How does this work? It depends on whether or not you use permissions on your server:
 
1. CATEGORIES IF YOU USE PERMISSIONS
- Every existing permission, for instance, lang.ptbr, is considered a category.
- To create boards that belong to a category, simply create (with /sb board newcopy, or rename) the board and add ^ (the category separator) plus the name of the category at the end of the new board. So if the original board was signboard, the new board will be called signboard^lang.ptbr.
 
That's it. Whenever a player who has lang.ptbr permission looks at a sign/entity where the signboard board is attached, signboard^lang.ptbr will be shown instead.
Just think of all your currently existing boards as belonging to a blank "default" category. And you can create any new category you like.
 
IMPORTANT: Remember that opped players have all permissions, so they will always see the category board as if they had been given that permission. For setting up and testing this feature, it's best to use a de-opped player.
 
2. CATEGORIES IF YOU DON'T USE PERMISSIONS
If you don't use permissions, you will need to create the categories, assign them to players, and then create the category boards.
 
- Use /sb cat new [categoryname] to create a new category. For example: /sb category lang.ptbr
- Use /sb cat assignplr [categoryname] [playername] to assign the category to a player
- Make a category board by creating a board (with /sb board newcopy, or rename) and adding ^ (the category separator) plus the name of the category at the end of the new board. So if the original board was signboard, and the category was lang.ptbr the new board will be called signboard^lang.ptbr.
 
That's it. Whenever a player who has the lang.ptbr category looks at a sign/entity where the signboard board is attached, signboard^lang.ptbr will be shown instead.
Just think of all your currently existing boards as belonging to a blank "default" category. And you can create any new category you like.
 
CATEGORIES - ADDITIONAL (VERY USEFUL) INFORMATION:
- Remember that every permission is considered a category.
- Remember that opped players have all permissions, so they will always see the category board as if they had been given that permission. For setting up and testing this feature, it's best to use a de-opped player.
- When you attach a board to a sign or entity, SignBoard will always attach the "root" board, not the one containing the category specification (i.e., the signboard board, NOT the signboard^lang.ptbr board).
- The "^" character is the category separator by default. If this character appears on a board name, everything after it will be considered a category name. This default character can be changed in config.yml - make sure to pick a character that you have never used in your pre-existing board names. And try to keep your category names short.
- You can have boards that belong to multiple categories; e.g. ; welcomeTavern1^ptbr^fighters,   welcomeTavern1^enus^fighters,   welcomeTavern1^ptbr^wizards, etc.
- You can assign players to multiple categories in two different ways: (a) use /sb category assignplr [categoryname] [playername] several times; (b) use /sb playercat [playername] assign [categoryname1] [categoryname2] ... [categorynameN]. Or simply give them the corresponding permissions.
- If a player looks at a board that belongs to multiple categories, the player must have been assigned to ALL those categories (or permissions) in order to be shown the right board. Otherwise, they will be shown the default board. Try to keep the number of boards with multiple categories to a minimum, otherwise this will be difficult to manage.
 
IMPORTANT: When creating boards that belong to multiple categories, be careful not to repeat category types. That is, it's OK to have welcomeTavern1^ptbr^wizards (language + class) but it is NOT OK to have welcomeTavern1^ptbr^esco (language + language) - this would make SignBoard try to match  a player with both ^ptbr and ^esco, in other words, a player that should be shown both Portuguese and Spanish at the same time. There's nothing to prevent you from doing this if you want, but we seriously discourage you from doing it, as things can get confusing very fast. 

 

Commands

Root Command Aliases

The standard root command for SignBoard is /sb. Since other plugins may also use /sb, SignBoard supports four command aliases. But simply having an alias doesn't keep SignBoard from responding every time you try to use those other plugins. So SignBoard lets you choose which root command aliases it will respond to. 

SignBoard can respond to any of these five root commands: /sb /signboard /sbd /sbrd /signbd.

The active_aliases parameter in config.yml controls which ones are actually used. For example, the following configuration line would make SignBoard accept all 5 root commands:

active_aliases: sb signboard sbd sbrd signbd

By default, only three options are active (sb sbd signboard), but you can mix and match as needed to ensure compatibility with other plugins in your server. The first option on the list will be the one featured on all of SignBoard's help texts (usually "/sb").

Player commands 

Information commands 

  • /sb help - Shows plugin description and commands.
  • /sb howto - Step by step instructions for SignBoard.
  • /sb variables - Lists all variables available and how to use them.

 Board commands 

  • /sb board new [boardname] - Create a new board for use in signs.
  • /sb board list - List all your boards - and their attachments.
  • /sb board list [boardname] - List the contents of a specific board.
  • /sb board clear [boardname] - Clears the content of a board.
  • /sb board copy [boardname] [newname] - Copies board 'boardname' to 'newname'.
  • /sb board delete [boardname] - Delete the board named 'boardname'.
  • /sb board rename [boardname] [newname] - Rename board 'boardname' to 'newname'.
  • /sb board [boardname] lineX text - Edit line X on the board, replacing it with 'text'.
  • /sb board [boardname] lineX-Y text - Replaces the content of lines X thru Y with the lines in text (use \n to indicate line breaks).
  • /sb board [boardname] linepushX text - inserts any lines in 'text'  (separated by \n) into the board, starting on line X and pushing the existing content down.
  • /sb board give_as_book [boardname] [playername] - gives the board's text to the specified player as a book.

 Set commands 

  • /sb set new [setname] = [board1] [board2] ... [board n] - Create a new set of boards.
  • /sb set delete [setname] - Delete the set called 'setname'.
  • /sb set list - List all your sets
  • /sb set list [setname] - List the boards that make up a specific set

Sign commands  

  • /sb sign lineX text - Edit the sign you're looking at, replacing line 'X' (1-4) with 'text'.
  • /sb sign attach [boardname] - Attaches a board to a sign.
  • /sb sign detach [boardname] - Detaches any board from a sign.
  • /sb sign status - Shows the current state of the sign's options.
  • /sb sign show_board - Toggles the on-screen board attached to the sign.
  • /sb sign give_book - Whether or not the board text should be given as a book (toggle).
  • /sb sign before <cmd|cmd> - A list of commands to run when player looks at the sign.
  • /sb sign after <cmd|cmd> - A list of commands to run when player looks away from sign.
  • /sb sign onclick <cmd|cmd> - A list of commands to run when player clicks the sign.
  • /sb sign onshiftclick <cmd|cmd> - A list of commands to run when player shift-clicks the sign.
  • /sb sign onrightclick <cmd|cmd> - A list of commands to run when player right-clicks the sign.
  • /sb sign onrightshiftclick <cmd|cmd> - A list of commands to run when player right-shift-clicks the sign.

Entity commands 

  • /sb entity attach [boardname] - Attaches a board to a (non-player) living entity.
  • /sb entity detach [boardname] - Detaches any board from a living entity.
  • /sb entity status - Shows the current state of the entity's options.
  • /sb entity show_board - Toggles the on-screen board attached to the entity.
  • /sb entity give_book - Whether or not the board text should be given as a book (toggle).
  • /sb entity nametag [ignore|hide|show]- Determines whether the nametag of an entity with a board attached will be visible or not when the player is shown the board.
  • /sb entity before <cmd|cmd> - A list of commands to run when player looks at the entity.
  • /sb entity after <cmd|cmd> - A list of commands to run when player looks away from entity.
  • /sb entity onattack <cmd|cmd> - A list of commands to run when player attacks the entity.
  • /sb entity onkill <cmd|cmd> - A list of commands to run when player kills the entity.

Category commands (OP only): 

  • /sb cat new [categoryname] - Creates a new category.
  • /sb cat delete [categoryname] - Deletes a category.
  • /sb cat assigncat [playername] [categoryname1] [categoryname2] ... [categorynameN] - Assign multiple categories to a player.
  • /sb cat assignplr [categoryname] [playername1] [playername2] ... [playernameN] - Assign multiple players to a category.
  • /sb cat unassign [categoryname] [playername] - Unassign a player from a category.
  • /sb cat list - List existing categories (not permissions).
  • /sb cat status [categoryname] - Displays the status of a category.
  • /sb cat [playername] - Displays categories (not permissions) for a player.
Admin commands
  • /sb board list all - Lists board names for all players
  • /sb set list all - Lists all sets for all players
  • /sb reload - reloads config.yml settings
  • /sb version - shows the SignBoard version running or displays a version's change history (i.e /sb version 1.6.5).
  • /sb cleanup - cleans signs.yml and attachments.yml of any signs that were deleted in the game while SignBoard wasn't running. Don't use this unless you're sure there are 'dead' signs in the yml files. Backup your signs.yml and attachments.yml, and make sure all your worlds are loaded before running this command.

Auto updates

By default, SignBoard will automatically download and install new updates when you restart or reload the server.

You can control this feature by changing the updates: option in config.yml.

Valid values for updates: are:

  • auto (downloads and installs new versions automatically);
  • check (only checks if a new version is available);
  • off (turns off updates completely).

An update check message will always be shown on the console.

After an update, OPs receive a one-time message telling them about the new version. They can check version history with the command /sb version .

Auto config.yml updates

No need to update your preferred settings in config.yml !!

When a new version is downloaded and installed, SignBoard will update the config.yml file preserving your custom settings automatically.

Settings in config.yml

The following are the default settings in config.yml:

 

#-----:-------------------------------------------------------------------------------------------------------------------------
# SignBoard config.yml
# If auto update is active for SignBoard, the config.yml file will be automatically updated as well
# When config.yml is updated, all changes you made to the VALUES of the settings will be PRESERVED and copied over to the new config.yml
# ... however, any changes you made to the COMMENTS in this file will be overwritten by the default comment.
#-----:-------------------------------------------------------------------------------------------------------------------------

# Auto updates:
# Possible values for updates:
# auto (downloads and installs new versions automatically);
# check (only checks if a new version is available);
# off (turns off updates completely).
updates: auto

# Config.yml version - if this is lower than the actual SignBoard version (use /sb version), it means you probably should do a manual merge of config.new and config.yml. Also, you should manually get the new locale files from the jar and manually merge those as well. Really, it's A LOT EASIER to use auto updates.
# If updates=auto and this version is lower than the actual SignBoard version, it will trigger an automatic config.yml and locale files update on the next server restart.
version: 1.6.15

# default language locale - specifies the default locale file to use for all in-game texts. Locale files are in the Locales folder, and must follow the same name pattern (e.g. sblocale_enUS.yml)
# the use of additional locale files can be turned on and off - see players_use_locales, below.
default_locale: enUS

# players_use_locales - allows every player to choose their own locale by activating the commands /sb locales list, /sb locales set, /sb locales clear
# Even if players_use_locales is false, SignBoard will always use the default locale file. Locale files are in the Locales folder, and must follow the same name pattern (e.g. sblocale_enUS.yml)
players_use_locales: true

# Category separator - in board names, anything that appears after this character will be considered a category name
# If you change the category separator after having boards that use it, you will have to either delete those boards or manually edit their names in boards.yml so they use the new separator.
# If you choose to edit boards.yml, DO IT WITH EXTREME CARE and don't change ANYTHING other than the separator character, or your boards may stop working.
category_separator: ^

# Toggle the use of color on SignBoard console messages:
msg_color_onconsole: true

# Toggle the one-time message shown to OPs in-game when an update is installed.
msg_ingame_update_OP: true

# Detect the presence of FeatherBoard and work around it by issuing /fb off and /fb on before boards are shown/hidden.
# If this is set to false, SignBoard will have problems with FeatherBoard and you must manage any conflicts yourself (maybe by using permissions).
# If this is set to true, SignBoard will work alongside FeatherBoard, but the transitions (showing/hiding boards) will be slower.
featherboard_aware: true

# Commands Before - these commands will be run right before showing a board to a player (every time).
# This feature was created to allow you to temporarily disable other plugins that interfere with SignBoard showing its boards.
# But it can be used to run any commands you like. All commands will be run as the player and as if the player were Op.
# Separate multiple commands with a |. Anything after a # will be ignored. Commands accept SignBoard variables.
# FEATHERBOARD users - see the featherboard_aware option in this config.yml
cmd_before: # tell {PName} about to say hey | tell {PName} hey

# Commands After - these commands will be run right after showing a board to a player (every time).
# This feature was created to allow you to re-enable other plugins that interfere with SignBoard showing its boards.
# But it can be used to run any commands you like. All commands will be run as the player and as if the player were Op.
# Separate multiple commands with a |. Anything after a # will be ignored. Commands accept SignBoard variables.
# FEATHERBOARD users - see the featherboard_aware option in this config.yml
cmd_after: # tell {PName} about to say bye | tell {PName} bye

# View distance:
# How close (in blocks) you have to be to a sign to activate its board
# (remember that wall signs are actually located on the block they're facing).
view_distance: 5

# Entity view distance:
# How close (in blocks) you have to be to a living entity to activate its board
# Remember: works best if you look the living entity in the face
entity_view_distance: 8

# Entity view radius:
# Signboard determines if you're "looking" at a living entity by analyzing how closely you're looking at the entity's left eye.
# So there's a radius around the entity's left eye that's the threshold for saying that you're looking at it.
# This process is never very precise, but we can achieve a more "natural" hit/miss by using a slightly larger radius for small entities and a slightly smaller radius for larger entities
# The radius parameter can vary from 0.01 to 0.15
# Radius for small creatures: bat, chicken, endermite, magmacube, ocelot, pig, rabbit, silverfish, wolf
entity_small_viewradius: 0.10
# Radius for medium creatures: blaze, cavespider, creeper, guardian, NPCs, pigman, sheep, shulker, skeleton, slime, spider, villager, witch, zombie
entity_medium_viewradius: 0.06
# Radius for large creatures: cow, enderdragon, enderman, ghast, giant, horse, irongolem, mooshroom, polarbear, snowman, squid, wither
entity_large_viewradius: 0.02

# Reserved words:
# SignBoard will not allow the following words to be used for board names
# ...instead, it will tell the user the name is already taken.
# This is not meant to be a bad word filter; please try to keep the list short.
# DO NOT change the format of these lines or use punctuation or special characters among the words.
# The words are not case sensitive.
reserved_names:
- boards board board1 board2 board3 board01 board02 board03 signs sign sign1 sign2 sign3 sign01 sign02 sign03
- one two three four five six seven eight nine ten
- 1 2 3 4 5 6 7 8 9 10
- server admin all

# Command aliases:
# SignBoard can respond to any of these five root commands: /sb /signboard /sbd /sbrd /signbd
# The active_aliases parameter controls which ones are actually used.
# For example, the following configuration would make SignBoard accept all 5 root commands: active_aliases: sb signboard sbd sbrd signbd
# By default, only three options are active, but you can mix and match as needed to ensure compatibility with other plugins in your server.
# The first option on the list will be the one featured on all of SignBoard's help texts (usually "/sb").
# Don't try to add other alias options; SignBoard only accepts these five.
active_aliases: sb sbd signboard

# Logging:
# Set to true to enable logging of SignBoard's startup process (only during server start).
# The major steps that take place during startup are timed and written to log.yml. The log is cleared at each server restart.
log_on: false

# Keeping backups:
# By default, SignBoard keeps a copy of all its configuration files every time a new SignBoard version is installed.
# It also keeps an updated copy of the "last OK" configuration files, so that if you manually damage any of the files, you'll have a fallback and be able to copy the "last OK" file back.
# To disable this feature, set "keep_backups" to false.
keep_backups: true

 

 

Permissions

By default, SignBoard allows every user to use the howto, variables, sign, entity, and board commands, and also allows every OP to use the reload and version commands. Additionally, all commands attached to a sign or an entity will run when they are triggered.

To change permissions, use a permissions manager (like PermissionsEX). Even if given the signboard.admin permission, a user must be OP to use the reload and version commands.

The default permissions are as follows (signcmds and entitycmds are false by default, all of the other are true by default for all players):

  • signboard.* - Gives access to all non-admin SignBoard commands
  • signboard.sign - Allows editing signs and attaching boards to them
  • signboard.signcmds - Allows specifying commands for signs
  • signboard.entity - Allows attaching boards to entities
  • signboard.entitycmds - Allows specifying commands for entities
  • signboard.board - Allows creating and editing boards
  • signboard.set - Allows creating and deleting sets
  • signboard.book - Allows giving out board texts as books
  • signboard.howto - Gives access to the howto command
  • signboard.variables - Gives access to the variables command
  • signboard.category - Gives access to the category commands
  • signboard.locale - Gives access to the locale command
  • signboard.admin - Gives access to all SignBoard commands, including reload and version
  • signboard.cmdrun.* - Enables or disables running all commands attached to a sign or an entity
  • signboard.cmdrun.signlook - Enables or disables running commands upon looking at a sign
  • signboard.cmdrun.entitylook - Enables or disables running commands upon looking at an entity
  • signboard.cmdrun.signclick - Enables or disables running commands upon clicking on a sign
  • signboard.cmdrun.signrightclick - Enables or disables running commands upon right-clicking a sign
  • signboard.cmdrun.entityattack - Enables or disables running commands upon attacking an entity
  • signboard.cmdrun.entitykill - Enables or disables running commands upon killing an entity

Here's an example of how to explicitly GIVE these permissions in PermissionsEX; all players in the group called "playersallowed" will explicitly receive all SignBoard player permissions:

groups:
  playersallowed:
    - signboard.sign
    - signboard.signcmds
    - signboard.entity
    - signboard.entitycmds
    - signboard.board
    - signboard.set
    - signboard.book
    - signboard.howto
    - signboard.variables
    - signboard.locale 

And here's an example of how to explicity DENY some permissions in PermissionsEX; all players in the group called "playersdenied" will be prevented from specifying any commands to be run when signs or entities are looked at, looked away from, clicked or killed. Notice the extra "-" that negates the permission.

groups:
  playersdenied:
    - -signboard.signcmds
    - -signboard.entitycmds

Next steps

  • None at this point. I will entertain requests...

Donations

No pressure ... :-)

Donate

Stats Disclosure

This plugin utilizes a plugin metrics system, which means that the following information is collected and sent to bstats.org:

  • Your server's randomly generated UUID
  • The amount of players on your server
  • The online mode of your server
  • The bukkit version of your server
  • The java version of your system (e.g. Java 8)
  • The name of your OS (e.g. Windows)
  • The version of your OS
  • The architecture of your OS (e.g. amd64)
  • The system cores of your OS (e.g. 8)
  • bStats-supported plugins
  • Plugin version of bStats-supported plugins

Go into /plugins/bStats/config.yml to disable stat collecting if you wish.

 


Comments

  • To post a comment, please or register a new account.
Posts Quoted:
Reply
Clear All Quotes

About This Project

  • Project ID
    101933
  • Created
    Aug 23, 2016
  • Last Released File
    Nov 12, 2022
  • Total Downloads
    148,171
  • License

Categories

Members

Recent Files

Bukkit