스코어보드로 할말을 남겨보자 - SignBoard

SignBoard

Write on signs to your heart's content

- 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

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

 

(You can see SignBoard in action on my daughter's server: bias-mcserver.nitrous.it)

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).

Demo video:

(In English)

(In Spanish, courtesy of Ajneb97.)

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, 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 signs that SignBoard knows were created by you (unless you're OP). This means you will only be able to edit signs that you create after SignBoard is installed. To change an old sign, break it and put a new one in its place. You'll be able to edit the new sign with no problem.

• Blank lines - both in signs and on boards, you can replace a current line with a blank line.

• 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 own 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 :).

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 board 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.

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 <cmd1> | <cmd2> | ... | <cmdn>.

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] | <cmd1> | [2m] | <cmd2>, when executed, will wait 5 seconds before running <cmd1> and then 2 additional minutes before running <cmd2>. 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.

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 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

Short answer: Yes, SignBoard will work alongside FeatherBoard, and will do so out of the box.

Long answer: Starting on v1.2.2, SignBoard implements a command-based FeatherBoard compatibility workaround. It detects the presence of FB and then issues "/fb off -s" just before showing a board to a user (to turn FB off for that user), and then issues "/fb on -s" when the user moves away (to turn FB back on). It works fine.

Until such time as there's a FeatherBoard API, this solution will have to suffice.

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.

A special thanks to gmalone for helping me work out this solution!

Commands

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 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 'boardname', replacing it with 'text'.

 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.

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.

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 <nbr> - shows the SignBoard version running or displays a version's change history (i.e /sb version 1.1.6).
• /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 <nbr>.

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.
# The original config.yml will be renamed config.bak
#-----:-------------------------------------------------------------------------------------------------------------------------

# 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
# If updates=auto and this version is lower than the actual SignBoard version, it will trigger an automatic config.yml update on the next server restart
version: 1.2.8

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

# Toggle the one-time message shown to OPs ingame when an update is installed
msg_ingame_update_OP: 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 - there's no need to use this, SignBoard already issues "/fb off -s" if it detects FeatherBoard is present
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 - there's no need to use this, SignBoard already issues "/fb on -s" if it detects FeatherBoard is present
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

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.

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 (all of these 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.admin - Gives access to the reload and version commands (OPs only)

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

And here's an example of how to explicity <strong>DENY</strong> some permissions in <strong><span style="color: #0000ff;">PermissionsEX</span></strong>; 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 ... :-)

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.

작성자의 말

안녕하세요 크론입니다

이 플러그인은 스코어보드에 할말을 남길 수 있는 플러그인입니다

다운로드