SignLink

From BergerHealer Wiki
Revision as of 14:57, 1 October 2023 by TC Bot (talk | contribs) (Updating to match new version of source page)
Jump to navigation Jump to search
Other languages:
Deutsch • ‎English • ‎Français • ‎Nederlands


« Go back

SignLink acts as a bridge between plugins and signs to easily display text on signs. Instead of entering commands, clicking the sign, or any other routine plugins could use, players can enter 'variables', key values starting (and ending) with %, to show information at that spot.

It also includes features no other plugin is needed for, such as custom text and ticker values you can set in values.yml. Signs are stored on file, they survive reloads and server restarts.

Command blocks

To change variables using command blocks, you can chain the edit and set commands.

/variable edit varname set newvalue

Variables in variables

As of version 1.16.5-v1, it is possible to declare variable names inside the value for a variable. For example, you can do:

/variable edit message set Hello, %playername%! It is %time%

And now putting %message% on signs (or in other variables!) will display the values of playername and time in-place. This can also be used to alias long variable names, so they can fit on signs.

Commands

The following commands are supported by SignLink. For in-game information you can use /help. The /variable command has alias /var.

Command Description
/togglesignupdate Turns sign updating on or off
/reloadsignlink Reloads the variable values in values.yml​
/variable list Lists all variables you can edit​
/variable deleteall Deletes all variables​
/variable deleteunused Deletes all unused (not on sign) variables​
/variable edit [name] Changes the variable you are editing. Can be chained with other commands.​
/variable forplayers [names] Changes for which players the variable is edited. Only the set players will see the changes you do on the variable​
/variable set [value] Sets the currently editing variable's value​
/variable get Gets the currently editing variable's value​
/variable setticker [args] Sets a ticker mode for a variable to animate the text. Arguments:
- /variable setticker [left/right/blink/none] [interval]
- /variable setticker [interval] [left/right/blink/none]
- /variable setticker [left/right/blink/none]
- /variable setticker [interval]​
/variable delete (force) Deletes the variable if it is not used. If force is specified, the variable is removed anyhow.

Configuration

The linkedsigns.txt contains information of where signs are located. The values.yml sets the (standard) usable keys.

# In here you can set default values for this plugin.
# The ticker property can be LEFT, RIGHT or NONE and sets the direction message is 'ticked'.
# tickerInterval sets the amount of ticks (1/20 of a second) are between the ticker update.
# The value is the thing to display or tick.
# To use colors in your text, use the § sign followed up by a value from 0 - F.
# Example: §cRed to display a red colored 'Red' message.
# You can find all color codes on the internet (they may use & there, ignore that!)
sign:
    ticker: NONE
    value: This is a regular message you can set and is updated only once.
test:
    tickerInterval: 3
    ticker: LEFT
    value: 'This is a test message being ticked from right to left.'

Placeholders

Signlink supports the PlaceholderAPI plugin in both directions. This means that you can use Signlink to display placeholders on signs, or use signlink variables in other plugins that support placeholders.

  • You can use signlink variables in other plugins by prefixing it with sl_. For example, %sl_time% will display the time variable.
  • Adding placeholder names to the 'autoUpdateVariables' list in SignLink's config.yml will make them work on signs, with the same name.
  • To display long placeholder names on signs, you can use a shorter variable name and set its value to %placeholder_name%

Permissions and commands

Use /togglesignupdate to turn sign updating on or off, just in case someone made a huge amount of updating signs that causes lag. Permission nodes (Bukkit permissions):

signlink.addsign:
    description: Allows you to build signs containing variables
    default: op
signlink.toggleupdate:
    description: Allows you to set if signs are being updated or not
    default: op
signlink.reload:
    description: Allows you to reload the values.yml
    default: op