插件手册:betonquest:命令和权限

这是本文档旧的修订版!


命令和权限


指令一览

  • /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'将删除它。

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

Journal subcommand works in the same way as those two above. Adding and removing looks like /q journal Beton add default.wood_started (or del), and you can also specify the date of entry when adding it, by appending date written like this: 23.04.2014_16:52 at the end of the command. Note that there is _ character instead of space!

Objective subcommand allows you to list all active objectives (shown as their labels) of the player. It can also directly add or cancel objectives using instruction strings. You can also complete the objective for the player using complete argument - it will run all events and remove the objective.

Running events for online players can be done with event argument: '/q event Beton give_emeralds' would run “give_emeralds” for player Beton (if he's online) from default package (not necessarily “default” but rather the default one specified in config.yml). If you want to run a static event, replace player's name with -.

There is also condition argument for checking conditions, for example '/q condition Beton has_food'. Events and conditions need to be defined in their files, this command doesn't accept raw instructions. You can skip package name, the plugin will assume you're reffering to package specified in default_package option in config.yml file.

If you need to create for example “Nettlebane” quest item, just hold it in your hand and type '/q item nettlebane'. It will copy the item you're holding into the items.yml file and save it there with the name you specified (in this case “nettlebane”). You can skip the package name here as well.

The '/q give package.item' command will simply give you specified item.

Config subcommand is used to modify or display values in configuration files. set option replaces the value with what you typed, add simply adds your string to the existing value. (Note on spaces: by default the plugin won't insert a space between existing and added value. You can however achieve that by prefixing the string with _ character. For example: existing string is objective location, and you want to add 100;200;300;world;10. Your command will look like /q config add default.events.loc_obj _100;200;300;world;10). read option allows you to display config value without modifying it.

Path in this command is like an address of the value. Next branches are separated by dots. For example language setting in main configuration has path config.language, and a text in “bye” player option in default quest has path default.conversations.innkeeper.player_options.bye.text

You can purge specific player with '/q purge Beton' command, where Beton is the name of the player. To purge the entire database at once simply change the prefix in config.yml or delete database.db file.

Delete command ('/q delete') allows you to delete from the database every tag, point, objective or journal entry with specified name.

Rename command ('/q rename') allows you to rename every tag, point, objective or journal entry in the database. In case of an objective it will also rename the objective in objectives.yml, so it continues to work correctly.

If you want to backup your configuration and database make sure that your server is empty (this process requires all data to be saved to database → all players offline) and run '/q backup' command. You will get a zip file containing all your data, ready to be unzipped for restoring the plugin.

Update command ('/q update') will try to download the newest version of the plugin and save it to the update folder. This folder is then handled by Spigot to update the plugin. If you accidentally use this command but do not wish to update the plugin, you should remove BetonQuest.jar file from the plugins/update folder before restarting/reloading the server.

Using '/q create beton' command you will create new package named 'beton'. It will contain the default quest.

The /q vector command allows you to create vector variables from the specified in first argument location variable to your position. The result will be saved to the “vectors.{second argument}” variable.

  • 插件手册/betonquest/命令和权限.1533269626.txt.gz
  • 最后更改: 2018/08/03 12:13
  • Afry_