[插件]SignBoard -娱乐-多功能计分板

– 木牌或实体可附上总计600字符.
– 当玩家看木牌/实体显示书本信息.
– 当玩家执行指令:
看着木牌/实体单位
望着木牌/实体单位
点击木牌
攻击或击杀实体单位

(Signboard 自带变量和支持Placeholder API)

你可以在插件作者的服务器体验: bias-mcserver.nitrous.it
厌倦木牌上的狭窄的空间？现在你可以用多达15行(总计600字符)的信息显示你的木牌!你甚至可以将信息显示设置在实体单位上!以及不同条件给木牌和实体附加指令
当玩家看着一个木牌, 计分板可以用来显示附加信息. 强大的交流… 额, 好吧, 什么, 认真点, 在游戏中. 管理员可以为玩家提供指导, 玩家可以显示关于游客的详细信息, RPG 游戏可以提供详细的知识,当玩家进入房间之前… 这里没有极限.

就像你把板附加到木牌上一样, Signboard 可以让板附加到活动实体! 你能将板添加到 NPC上, 玩家看着npc是, 显示计分板信息.

你还可以向木牌和实体附加指令, 多种条件运行. 当玩家看一个木牌/实体, 看完一个木牌/实体时, 点击木牌, 攻击或击杀实体.

作为一种添加效果, SignBoard 让你不必从新开始编辑计分板- 可以给你已经附加过板的木牌并使用指令/sb sign lineX text(见下文).

安装

只需将jar丢进你的plugins文件夹之后重启服务器

基本用法

SignBoard 让你创建的 “板” 然后将 “板” 附加到一个或多个木牌/实体上工作(动物, 村民, 怪物 和 NPCs – 但不是真实的玩家).
如果你有一个板名为 “boardname”, 只要你想的话可以把它附加到你想要的木牌上, 只有将木牌第一行 输入[boardname].你还可以使用/sb sign attach 和 /sb sign detach 指令附加到木牌上或清除.
/sb entity attach 和 /sb entity detach 将板附加到实体上或清除板.
板的内容显示在计分板上,然后每个板都可以有多达15行(每行40个字符).
你可以使用通常Minecraft所有的文本颜色和格式标签
(&0 = 黑色; &1 = 深蓝色;| &2 = 暗绿色; &3 = 暗蓝色; &4 = 暗红色; &5 = 深紫色; &6 = 金色; &7 = 灰色; &8 = 深灰色; &9 = 蓝色; &a = 蓝色; &b = 蓝色; &c = 红色; &d = 淡紫色; &e = 黄色; &f = 白色; &k = 随机; &l = 粗体; &m = 删除线; &n = 下划线; &o = 斜体; &r = 重置).

入门创建

想出一个新的板名
用指令插件一个板/sb board new [板的名称]
在某处放置一个木牌并在第一个输入刚刚创建的板名在 [ ] 直接 (例如 [signboard]). 或者, 用指令/sb sign attach [板名] 附加到一个木牌上
如果你想附加到实体, 使用指令/sb entity attach [板命] 附加到一个实体上(不可以附加到玩家)
接下来看木牌/实体 – SignBoard 会显示默认内容
之后可以用指令编辑/sb board [板名] line行数 [信息](你不需要看着木牌/实体)
提示 & 注意
一旦玩家离开了木牌，当前的计分板将重新加载并需要慎重对待.
SignBoard 记录是你创建的板所以只能有你编辑. 这意味着你只能编辑你的板 创建板之后放置. 要改变旧的木牌, 破坏它并放置一个新的地方.
空白行 – 无论是板还是在木牌上, 你都能用空行代替当前行.
你只能改变你创建的板, 但是没有什么可以阻止玩家输入板名(例外 [boardname]) 在木牌上, 甚至是另外一个玩家创建的板.
要在木牌上使用/detach指令 , 你必须拥有自己木牌. 要在实体上使用/detach指令, 你必须拥有自己的板.
除非你是op, 在这种情况下可以做如何事情:).

提供书

当玩家看木牌或实体时, 你能选择显示计分板信息或将板信息转换成一本书给玩家 – 俩者可以同时使用, 或俩者都关闭.
指令/sb sign show_board 和/sb entity show_board可以切换计分板是否显示.
如果你想给玩家一本书, 指令/sb sign give_book和/sb entity give_book切换是否启用这个功能.
你可以使用这些指令显示计分板和给予书, 或不显示计分板也不给予书.
使用/sb sign status和/sb entity status查看所有功能状态.

书的格式

SignBoard 将自动转换板的文本信息变成一本书 (当 show_book 启用). 由于书本和计分板的尺寸大小不同, 一本书有折页, SignBoard 将尝试把行数和页面整齐,有些微调可能是必须的.
有些小窍门或许可以帮助你:
板行数只有包含&r会在书本上显示为空白行.
当使用\n在你的板上会在书本上换行. 当\n已计分板显示时会被忽略.
当 SignBoard 字符多出了一行, 尝试将完整的单词以及适当地插入空格.但你可能需要修改板上某行结尾和开头时的空格.
如果 SignBoard 发现板行数中有多个字符重复 (像 ‘================’), 会尝试缩短字符, 而不是分成了俩行.

在点击木牌或攻击/击杀实体运行指令
你也可以给木牌/实体添加指令, 就像你可以给木牌/实体附加一个板. 管理员可以在游戏中添加 可以是任何指令. 这个指令将会运行 如果是玩家使用的也需要相关权限. 指令支持signboard任何的变量以及指令.
以下 SignBoard 指令 控制触发条件:
/sb sign beforeand and /sb entity before – 让你看木牌/实体时运行指令, 计分板显示之时运行. (如果 show_board 是关闭的, 指令还是会运行).
/sb sign afterand and /sb entity after – 让你看完木牌/实体时运行指令, 计分板隐藏之时运行. (如果 show_board 是关闭的, 指令还是会运行).
/sb sign onclick – 让你点击木牌时运行指令.
/sb entity onattack – 让你攻击实体之后运行指令.
/sb entity onkill – 让你击杀实体之后运行指令.
使用 /sb sign status 和 /sb entity status 查看木牌/实体状态.

变量

这些变量可以在你的板上任何地方使用. 确保包括 “{” 和 “}”.
当板会显示给玩家,变量将替换为当前数据值.

{ServerDate} = 服务器日期.
{ServerTime} = 服务器时间.
{PlayersNow} = 服务器现在的玩家数量.
{PlayersMax} = 服务器最大的玩家数量.
{PName} = 玩家名称.
{PDisplayName} = 玩家的显示名 如/前缀/称号等.
{PHealth} = 玩家血量.
{PCoords} = 玩家的位置.
{PMobKills} = 被玩家击杀的怪物数量.
{PKills} = 被玩家击杀的玩家数量.
{PDeaths} = 玩家死亡数量.
{PTimeAlive} = 玩家上次死亡时间.
{PMoney} = 玩家金钱数量 (需要 Vault).

指令

玩家指令

/sb help - 显示插件和指令的说明.
/sb howto - SignBoard的用法说明，这里有一步一步的说明.
/sb variables - 列出所有可用变量以及说明.
/sb sign lineX text - 编辑你看着的木牌, 输入行数'X' (1-4) 之后输入 '文本'.
/sb board new [boardname] - 为木牌插件新的板.
/sb sign attach [boardname] - 木牌上附加一个板.
/sb sign detach [boardname] - 将木牌上的板清除.
/sb sign status - 查看当前木牌的状态.
/sb sign show_board - 切换木牌是否显示计分板.
/sb sign give_book - 切换木牌是否给予书本.
/sb sign before  - 指定一个指令在玩家看着木牌时执行.
/sb sign after  - 指定一个指令在玩家看完木牌之后执行.
/sb sign onclick  - 指定一个指令在玩家点击木牌执行.
/sb entity attach [boardname] - 实体(非玩家)上附加一个板 .
/sb entity detach [boardname] - 将实体上的板清除.
/sb entity status - 查看当前实体的状态.
/sb entity show_board - 切换实体是否显示计分板.
/sb entity give_book - 切换实体是否给予书本.
/sb entity before  - 指定一个指令在玩家看着实体时执行.
/sb entity after  - 指定一个指令在玩家看完实体之后执行.
/sb entity onattack  - 指定一个指令在玩家攻击实体时执行.
/sb entity onkill  - 指定一个指令在玩家击杀实体时执行.
/sb board list [board] - 列出指定"板" - 以及内容.
/sb board delete [boardname] - 删除指定"板".
/sb board rename [boardname] [newname] - 将你的板重命名"板名" "新板名".
/sb board [boardname] lineX  - 编辑'板名' 的 行数 'X', 之后的 '文本信息'.

管理指令

/sb board list all - 列出所有板名以及板的主人
/sb reload - 重载 config.yml 上的设置
/sb version  - 查看当前运行的 SignBoard 版本或显示其他版本的更新日志(i.e /sb version 1.1.0)
/sb cleanup - 删除 signs.yml 和 attachments.yml 中关于SignBoard任何迹象,而不是运行. 一般不要使用这个,除非你确认yml文件不运行的迹象,请备份signs.yml 和 attachments.yml,并确保你在运行此命令之前,所有世界加载.

自动更新
默认情况下, SignBoard 当你重启服务器时，将自动下载并安装新的版本.
可以通过这个选项控制这个更新功能:选项在config.yml.
有效的更新:有:
auto (自动下载并安装新版本);
check (检查是否有版本更新);
off (完全关闭更新功能).

检查更新信息提示会在后台.
更新后, OP将收到关于新版本的信息. 也可以使用指令查看版本更新日志/sb version .

config.yml自动更新
没必要更新你的 config.yml 已修改的设置!!

下载并安装新版本时,Signboard将保持你的习惯更新config.yml文件自动设置.
config.yml 设置
以下是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.10

# Toggle the use of color on SignBoard 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

权限

默认权限下, SignBoard 允许每个玩家使用howto,sign,entity和board等指令, 以及允许使用重载和版本指令.
默认权限如下所示. 更改权限, 使用权限管理插件 (像 PermissionsEX). 即使给了 signboard.admin 权限, 玩家也只能使用重载和版本指令

permissions:
   signboard.*:
      description: 允许使用非管理指令
commands
      children:
         signboard.sign: true
         signboard.entity: true
         signboard.board: true
         signboard.howto: true
         signboard.variables: true
   signboard.sign:
       description: 允许使用sign相关指令
to them
       default: true
   signboard.entity:
       description: 允许使用entity相关指令
       default: true
   signboard.board:
      description: 允许创建和编辑板
      default: true
   signboard.howto:
      description: 允许查看教程指令
      default: true
   signboard.variables:
      description: 允许查看变量指令
      default: true
   signboard.admin:
      description: 允许使用重载和版本查看
commands
      default: op

插件下载