| 两侧同时换到之前的修订记录
前一修订版
后一修订版
|
前一修订版
|
插件手册:betonquest:命令和权限 [2018/08/03 12:01]
Afry_ |
插件手册:betonquest:命令和权限 [2019/01/27 07:48] (当前版本)
小小k酱 修正格式问题 |
| ====== 命令和权限 ====== | ====== 命令和权限 ====== |
| |
| ---- | （版本：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 |
| |
| * /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.admin - 所有权限, 拥有全部bq权限 |
| * betonquest.journal - 允许使用/ j命令（默认为玩家） | * betonquest.journal - 允许使用/ j命令（默认为玩家） |
| * betonquest.backpack - 允许使用/背包命令（默认为玩家） | * betonquest.backpack - 允许使用/背包命令（默认为玩家） |
| * betonquest.conversation -允许与NPC交谈（默认为玩家） | * betonquest.conversation - 允许与NPC交谈（默认为玩家） |
| * betonquest.language - 允许更改语言（默认为玩家） | * betonquest.language - 允许更改语言（默认为玩家） |
| |
| |
| ====== 主要命令介绍 ====== | ===== 主要指令介绍 ===== |
| |
| Reloading loads all data from configuration, but not everything is updated. Player's data isn't touched to avoid lags made by database saving. The database is also the same, you will have to reload/restart the whole server for the database to change. | 重载会从配置加载所有数据，但不是所有数据都会被更新。 不会触及玩家的数据以避免数据库保存被滞后。 数据库也是一样的，您必须重新加载/重新启动整个服务器才能更改数据库 |
| |
| Tags subcommand allows you to easily list and modify tags. '/q tags Beton' would list tags for player Beton. '/q tags Beton add test' would add "test" tag for that player, and '/q tags Beton del test' would remove it. | Tags子命令允许您轻松列出和修改标签。 ''/ q tags {player}'' 会列出这个玩家的标签。 ''/ q tags {player} add test''将为玩家添加“test”标签，''/ q tags {player} del test''将删除它。 |
| |
| Points subcommand is similar - listing points is done the same way. Adding points to a category looks like that: '/q points Beton add reputation 20' (adding 20 points to "reputation" category). You can also subtract points with negative amounts. Removing the whole point category can be achieved by '/q points Beton del reputation'. | /q p 命令相当于 /q p list。''/ 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! | Journal 子命令的工作方式和上边两个相同。 添加和删除看起来像''/q journal {player} add default.wood_started''（或del），你也可以在添加时指定输入日期，方法是在命令末尾添加如下所示的日期：''23.04.2014_16:52''。 注意，用''_''字符代替空格！ |
| |
| 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. | Objective 子命令允许您列出玩家的所有任务（显示为任务标签）。 可以使用指令字符串直接添加或取消任务。 您还可以使用完整参数完成玩家的目标 - 这将执行所有事件(events)并删除任务。 |
| |
| 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 -. | 可以使用事件参数来直接对[在线玩家]执行事件：''/q event {player} give_emeralds''将为为玩家（如果他在线）运行“give_emeralds”。 如果要运行静态事件，请用 - 替换玩家的名称。 |
| |
| 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. | 检查条件还有条件参数。例如''/q condition {player} has_food''。 需要在配置文件中定义事件和条件，此命令不接受原始指令。 您可以跳过包名称，插件将执行在 config.yml 文件中的 default_package 所指定的包。 |
| |
| 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. | 如果您需要创建例如“Nettlebane”任务物品，只需将其握在手中并输入''/q item nettlebane''即可。 它会将您持有的项目复制到items.yml文件中并使用您指定的名称（在本例中为“Nettlebane”）保存。 您也可以在此处跳过包名称。 |
| |
| The '/q give package.item' command will simply give you specified item. | ''/q give package.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. | Config 子命令用于修改或显示配置文件中的值。set选项将值替换为您键入的值，add只是将您的字符串添加到现有值。（注意不要有空格：默认情况下，插件不会在现有值和附加值之间插入空格。但是，您可以通过在字符串前加上''_''字符来实现这一点。例如：现有字符串是位置，并且您想要添加''100; 200; 300; world; 10''.你的命令看为''/q config add default.events.loc_obj _100; 200; 300; world; 10''）。 read选项允许您显示配置值而无需修改它。 |
| |
| 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 | Path 子命令类似于一个地址的值。下一个分支用点分隔。 例如，主配置中的语言设置具有路径config.language字段，然后“bye”这个玩家选项中具有路径''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. | 您可以使用''/q purge {player}''命令清除特定玩家信息，其中{player}是玩家的名字。 要立即清除整个数据库，只需更改config.yml中的前缀或删除database.db文件。 |
| |
| Delete command ('/q delete') allows you to delete from the database every tag, point, objective or journal entry with specified name. | 删除命令（''/q delete''）允许您从数据库中删除具有指定名称的每个标签，目标，任务或任务记录。 |
| |
| 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. | 重命名命令（''/q rename''）允许您重命名数据库中的每个标签，目标，任务或者记录。如果是任务，它还将重命名objectives.yml中的目标，以便继续正常工作。 |
| |
| 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. | 如果要备份配置和数据库，请确保服务器为空（此过程需要将所有数据保存到数据库 - >所有玩家都离线）并运行'' q backup''命令。您将获得一个包含所有数据的zip文件，随时可以解压缩以恢复插件。 |
| |
| 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. | 更新命令（''/q update''）将尝试下载最新版本的插件并将其保存到更新文件夹。然后由Spigot处理此文件夹以更新插件。如果您不小心使用此命令但不希望更新插件，则应在重新启动/重新加载服务器之前从 plugins / update 文件夹中删除BetonQuest.jar文件。 |
| |
| Using '/q create beton' command you will create new package named 'beton'. It will contain the default quest. | 使用''/q create beton''命令，您将创建名为''beton''的新包。它将包含默认任务。 |
| |
| 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. | /q vector 命令允许您从第一个参数（位置变量）中指定的位置创建矢量变量。结果将保存到“vectors.{second argument}”变量中。 |