SignLink
| |
| プラグインで簡単に看板へ文字を表示するための橋渡し | |
| Spigot: | SignLink |
|---|---|
| GitHub: | SignLink |
SignLinkは、プラグインから看板へ簡単にテキストを表示するための橋渡しとしての機能を提供します。コマンドを入力するかわりに、看板をクリックしたり、プラグインのさまざまなルーティンが利用できます。また、プレイヤーは『変数』や、その地点での情報を示す%で囲まれたキーバリューも利用できます。
プラグインにはvalues.ymlで設定できるカスタムテキストやティッカーなど、他のプラグインを必要としない昨日も含まれています。看板のデータはファイルに保存され、リロードやサーバーの再起動を経ても引き継がれます。
コマンドブロック
コマンドブロックを用いて変数を書き換えるには、editとsetのコマンドを利用します。
/variable edit varname set newvalue
変数内の変数
バージョン1.16.5-v1から、変数の中に他の変数を含めて宣言することが可能になりました。たとえば、次のようなコマンドを利用します。
/variable edit message set Hello, %playername%! It is %time%
そして看板に%message%や他の変数を入力すれば、プレイヤー名と現在の時間を表示します。他にも、この機能を長い変数名のエイリアスとして利用すれば、看板のテキストに収めることができます。
コマンド
次のコマンドがSignLinkで利用できます。ゲーム内で情報を表示するには/helpを利用できます。また/variableコマンドはエイリアスとして/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