Avrae Utilities for SublimeText

一个用于 Sublime Text 的插件，其中包含用于 Avrae Discord 机器人的实用程序

重要提示

此软件包会根据需要与 Avrae API 进行远程连接以收集和更新信息。它只会在用户提示时进行连接，而不会未经过用户的提示进行任何外部连接。

设置

为了使此插件能够获取和更新您的 GVAR、Workshop 别名或 Workshop 片段，您需要给它您的令牌。

1. 转到 Avrae 并登录仪表板
2. 按 F12 打开开发者工具
3. 转到“应用”选项卡
4. 在左侧，在“本地存储”下选择 'https://avrae.io'
5. 复制“avrae-token”键旁边的“值”
6. 在 Sublime Text 中打开命令表
7. 使用 Preferences: Avrae Utilities Settings 命令，将复制的令牌粘贴到“token”键中

注意

请勿泄露此令牌，因为任何获得此令牌的人都可以潜在地访问您的 Discord 账户。

功能

此插件包含以下功能

Draconic 语法

专为 Avrae 由于别名使用的 Draconic 语言（Python 子集）提供方便的语法高亮。它已设置为在自动 *.alias、*.snippet 和 *.gvar 文件类型上工作。

获取和更新 GVARs

使用指令面板中的Avrae 工具：获取 GVAR和Avrae 工具：更新 GVAR，您可以在不访问仪表板的情况下检索和更新 GVAR。如果您想在本地保存，可以使用文件扩展名.gvar，并将 GVAR 的 ID 放置在文件名中的任何位置。您可以在 ID 前后添加标签/描述，以便组织 GVAR。

工作坊集合

在 SublimeText 中，您可以执行各种操作来获取和更新工作坊集合。

获取集合信息

您可以使用Avrae 工具：获取集合数据命令收集集合内所有别名和片段 ID 的 json 数据。这将要求您提供集合 ID。您可以通过访问工作坊中的集合并查看 URL 来找到它。在 avrae.io/dashboard/workshop/ 之后的所有内容都是您的 ID。

运行Avrae 工具：获取集合数据命令并提供您的 ID 后，将结果保存为collection.id到您希望保存集合的文件夹中。

现在有了collection.id，如果当它打开时运行Avrae 工具：获取集合数据命令，它将更新该文件。

获取集合描述

您可以使用Avrae 工具：获取集合描述命令获取集合的 markdown 描述。如果您有一个正在打开并保存的readme.md文件，位于包含collection.id的文件夹中，它将从这个文件中获取集合信息。否则，它会要求您提供集合 ID。

更新集合描述

如果您想更新描述，可以运行Avrae 工具：更新集合描述，它将打开的当前readme.md推送到工作坊，使用保存到同一文件夹中的相同文件夹中的collection.id。

获取别名/片段

collection.id 内部将包含每个别名/子别名/片段的名称和 ID。您可以使用这些 ID 结合 Avrae 工具：获取工作坊别名和Avrae 工具：获取工作坊片段命令使用。

然后您可以使用 Avrae 工具：获取别名 命令检索每个别名/片段，它可以保存为aliasName.alias，其中aliasName是真实的别名或片段名称。

在具有collection.id的文件夹中保存您的别名/片段后，当您在打开别名时运行Avrae 工具：获取别名命令时，会自动从collection.id中获取 ID。真方便！

更新别名/片段

如果您想更新它们，可以运行Avrae 工具：更新别名，它将当前打开的别名推送到工作坊，使用保存到同一文件夹中的相同文件夹中的collection.id。此后，您可以在 Discord 中对其进行测试。

更新和获取别名/片段描述

您还可以使用Avrae 工具：获取别名描述和 Avrae 工具：更新别名描述（以及它们的片段等效操作）来获取和更新您的别名和片段描述。您可以将其保存为 aliasName.md，其中aliasName是实际的别名或片段名称。

文件夹结构

编辑文档的支持将在未来的更新中提供。

以下是一个示例集合文件夹结构

root
 | # This is the folder your collection will live in
 ├ Collection Name
 | | # This contains the json collected by the `Get Collection Data` command
 | ├ collection.id 
 | | # This contains the markdown for the collection description
 | ├ readme.md 
 | | # This contains the alias itself, collected by the `Get Workshop Alias` command, and updated with the `Update Workshop Alias` command
 | ├ aliasName.alias 
 | | # This contains the markdown the alias description
 | ├ aliasName.md 
 | | # This contains the subalias alias itself, collected by the `Get Workshop Alias` command, and updated with the `Update Workshop Alias` command
 | ├ aliasName subAalias.alias 
 | | # This contains the markdown the alias description
 | ├ aliasName subAalias.md 
 | | # This contains the snippet itself, collected by the `Get Workshop Snippet` command, and updated with the `Update Workshop Snippet` command
 | ├ snippetName.snippet 
 | | # This contains the markdown the snippet description
 | └ snippetName.md

复制攻击

如果您有编写好的自动化 JSON，您可以选择所有内容并运行Avrae 工具：复制攻击命令，它将压缩它，预置!a import Test并将其复制到剪贴板，以便轻松在 Discord 中进行测试。