====== 命令和权限 ======

（版本：2018-10-16 翻译：Afry, kjiang [[https://github.com/Co0sh/BetonQuest/blob/b18b2b1521d79e3020864808f1d5c59f39f28361/docs/03-Commands-and-permissions.md|原文链接]]）

===== 命令一览 ======
(备注：前面带有~~的都是翻译不准确的，需要修改)
  * **/j** - 获得小本本，里边记录任务状态。(里边的内容需要BQ编辑者自己写)
  * ~~ **/bc** - 打开罗盘
  * **/backpack** - 打开任务背包
  * **/q** - 显示所有指令
  * **/q reload** - 重载BQ(每次编写完BQ任务后都需要重载)
  * **/q objectives {playerName} [list/add/del/complete] [instruction]** - 显示玩家的当前任务
  * **/q tags {playerName} [list/add/del] [tag]** - lists 显示玩家所有的标签
  * **/q points {playerName} [list/add/del] [category] [amount]** - 显示玩家所有类型的积分
  * ~~ **/q journal {playerName} [list/add/del] [package.pointer] [date]** - 任务列表操作~~
  * **/q event {playerName} {package.eventID}** - 对玩家执行事件
  * **/q condition {playerName} {package.conditionID}** - 显示玩家执行中的事件
  * **/q item {package.itemID}** - 用手中的物品，在BQ的物品表里边加入一个新的条目
  * **/q give {package.itemID}** - 获得BQ物品表里边的某个物品
  * ~~ **/q config {set/add/read} {path} [value]** - 配置BQ文件目录
  * **/q purge {playerName}** - 删除玩家所有的BQ信息
  * ~~ **/q rename {tag/point/objective/entry} {oldName} {newName}** - 重命名数据库中各种东西的名称
  * ~~ **/q delete {tag/point/objective/entry} {name}** - 删除数据库中指定东西
  * ~~ **/q backup** - 创建数据库和配置文件的备份
  * ~~ **/q create {package}** - 创建给定名称的新包package, 包含默认请求quest
  * ~~ **/q vector {packname.variable} {newvariable}** - 计算从第一个位置变量到您位置的向量, 并将其另存为第二个变量（原文：calculates the vector from first location variable to you position and saves it as second variable）
  * ~~ **/questlang= {lang}** - 改变玩家所用的语言（如果在控制台使用则改变所有玩家），默认将使用config.yml里定义的语言

===== 命令别名 =====
（这些是命令的缩写）
  * **/j**: bj, journal, bjournal, betonjournal, betonquestjournal
  * **/backpack**: b, bb, bbackpack, betonbackpack, betonquestbackpack
  * **/q**: bq, bquest, bquests, betonquest, betonquests, quest, quests
      * **objective**: o, objectives
      * **tag**: t, tags
      * **point**: p, points
      * **event**: e, events
      * **condition**: c, conditions
      * **journal**: j, journals
      * **item**: i, items
      * **give**: g
      * **rename**: r
      * **delete**: d, del
      * **create**: package
  * **/questlang**: ql

===== 权限一览 =====

  * betonquest.admin - 所有权限, 拥有全部bq权限
  * betonquest.journal - 允许使用/ j命令（默认为玩家）
  * betonquest.backpack - 允许使用/背包命令（默认为玩家）
  * betonquest.conversation - 允许与NPC交谈（默认为玩家）
  * betonquest.language - 允许更改语言（默认为玩家）


===== 主要指令介绍 =====

重载会从配置加载所有数据，但不是所有数据都会被更新。 不会触及玩家的数据以避免数据库保存被滞后。 数据库也是一样的，您必须重新加载/重新启动整个服务器才能更改数据库

Tags子命令允许您轻松列出和修改标签。 ''/ q tags {player}'' 会列出这个玩家的标签。 ''/ q tags {player} add test''将为玩家添加“test”标签，''/ q tags {player} del test''将删除它。

/q p 命令相当于 /q p list。''/ q points {player} add reputation 20''（在“声望”类别中添加20点）。 您还可以给一个负数来减少点数。 删除整点类别可以用''/ q points {player} del reputation''来实现。

Journal 子命令的工作方式和上边两个相同。 添加和删除看起来像''/q journal {player} add default.wood_started''（或del），你也可以在添加时指定输入日期，方法是在命令末尾添加如下所示的日期：''23.04.2014_16:52''。 注意，用''_''字符代替空格！

Objective 子命令允许您列出玩家的所有任务（显示为任务标签）。 可以使用指令字符串直接添加或取消任务。 您还可以使用完整参数完成玩家的目标 - 这将执行所有事件(events)并删除任务。

可以使用事件参数来直接对[在线玩家]执行事件：''/q event {player} give_emeralds''将为为玩家（如果他在线）运行“give_emeralds”。 如果要运行静态事件，请用 - 替换玩家的名称。

检查条件还有条件参数。例如''/q condition {player} has_food''。 需要在配置文件中定义事件和条件，此命令不接受原始指令。 您可以跳过包名称，插件将执行在 config.yml 文件中的 default_package 所指定的包。

如果您需要创建例如“Nettlebane”任务物品，只需将其握在手中并输入''/q item nettlebane''即可。 它会将您持有的项目复制到items.yml文件中并使用您指定的名称（在本例中为“Nettlebane”）保存。 您也可以在此处跳过包名称。

''/q give package.item''命令只会给你指定的物品。

Config 子命令用于修改或显示配置文件中的值。set选项将值替换为您键入的值，add只是将您的字符串添加到现有值。（注意不要有空格：默认情况下，插件不会在现有值和附加值之间插入空格。但是，您可以通过在字符串前加上''_''字符来实现这一点。例如：现有字符串是位置，并且您想要添加''100; 200; 300; world; 10''.你的命令看为''/q config add default.events.loc_obj _100; 200; 300; world; 10''）。 read选项允许您显示配置值而无需修改它。

Path 子命令类似于一个地址的值。下一个分支用点分隔。 例如，主配置中的语言设置具有路径config.language字段，然后“bye”这个玩家选项中具有路径''default.conversations.innkeeper.player_options.bye.text''

您可以使用''/q purge {player}''命令清除特定玩家信息，其中{player}是玩家的名字。 要立即清除整个数据库，只需更改config.yml中的前缀或删除database.db文件。

删除命令（''/q delete''）允许您从数据库中删除具有指定名称的每个标签，目标，任务或任务记录。

重命名命令（''/q rename''）允许您重命名数据库中的每个标签，目标，任务或者记录。如果是任务，它还将重命名objectives.yml中的目标，以便继续正常工作。

如果要备份配置和数据库，请确保服务器为空（此过程需要将所有数据保存到数据库 - >所有玩家都离线）并运行'' q backup''命令。您将获得一个包含所有数据的zip文件，随时可以解压缩以恢复插件。

更新命令（''/q update''）将尝试下载最新版本的插件并将其保存到更新文件夹。然后由Spigot处理此文件夹以更新插件。如果您不小心使用此命令但不希望更新插件，则应在重新启动/重新加载服务器之前从 plugins / update 文件夹中删除BetonQuest.jar文件。

使用''/q create beton''命令，您将创建名为''beton''的新包。它将包含默认任务。

/q vector 命令允许您从第一个参数（位置变量）中指定的位置创建矢量变量。结果将保存到“vectors.{second argument}”变量中。