Signboard Plugin

SignBoard Plugin (1.19.1, 1.18.2) lets you attach boards or sets to living entities!

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.

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.

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