syntax-mcfunction 1.0.1

新的介绍内容：

syntax-mcfunction - 提升Minecraft命令开发的语法定义

欢迎来到syntax-mcfunction，一个专为Minecraft命令（.mcfunction）设计的语法定义项目。无论你是游戏开发者还是Minecraft玩家，这里都能助你提升开发效率。如果你喜欢这个项目，请给我们一个⭐！

项目概述：

syntax-mcfunction采用textmate语法规范，提供了一套完整、通用的Minecraft命令语法定义。通过使用通用的语法组件构建，这意味着它不仅支持未来的Minecraft版本，还适用于许多模组命令和自定义语言编译器（如bolt和jmc）。

[!警告] 请注意，本语法定义不包含错误高亮功能，意味着无效命令也会被正确高亮。如果你需要错误验证和自动补全功能，建议使用Spyglass项目，它基于本语法定义构建了语言服务器。

安装指南：

VSCode扩展

你可以通过市场安装扩展，或者在扩展选项卡中搜索syntax-mcfunction。

open-vsix扩展

如果你想在VSCode或其任何分支中使用open-vsix版本，请按照以下说明操作。

Sublime Text

建议使用Package Control管理软件包：

1. 如果尚未安装，请先安装Package Control。
2. 运行Package Control: Add Repository命令，并输入https://github.com/MinecraftCommands/syntax-mcfunction.git添加存储库作为包。
3. 运行Package Control: Install Package并搜索syntax-mcfunction以正常安装包。

或者，你可以将存储库克隆到用户包目录（例如%appdata%\Sublime Text 3\Packages），并手动更新。

与language-mcfunction的区别：

虽然本语法是从头开始创建的，但其工作很大程度上借鉴了原language-mcfunction语法。language-mcfunction的初衷是开发一个通用、简化的.mcfunction版本。

[!注意] 实际上，这个语法的早期原型曾被计划作为language-mcfunction重写的基础。

以下是本语法与原版的一些关键区别：

• language-mcfunction设计为处理单行命令。如果一行出错，不会影响后面的行，命令不能跨多行。
  • 这正是促使我开发syntax-mcfunction的原因（即使在Minecraft 1.20.2引入多行命令之前），因为我需要一个支持多行的语法。
• language-mcfunction包含特定的命令验证，并报告无效命令的错误。
  • syntax-mcfunction在哲学上有所不同。Textmate语法并不适合验证命令——这更适合语言服务器。
  • 此项目通常高亮命令，这样做有助于更容易维护，并且对于像Github这样的平台更友好，因为多种命令扩展/模组命令可能重用.mcfunction扩展名。

因此，在比较这些语法时，着色和高亮会在几个地方有所不同。虽然目标是尽可能接近language-mcfunction，但由于语法设计的整体差异，永远不会有真正的1:1高亮匹配。

贡献指南：

我们乐意接受任何PR，但请先创建相应的issue来跟踪。提交PR时，请确保你的分支不是main，并且允许维护者编辑你的PR。这有助于我对PR进行小的编辑后再合并。

我们只需要编辑yaml文件，因为json和plist文件是自动生成的。你可以在编辑yaml文件后使用npm包js-yaml生成json文件。

npx js-yaml mcfunction.tmLanguage.yaml > mcfunction.tmLanguage.json

发布版本

此存储库中的发布是半自动化的。一旦你的PR合并到main分支，维护者将创建一个新标签来触发我们的Github CI生成新版本。

git tag -a v1.2.3
git push --tags

这将生成语法的json和plist变体，向VSCode和open-vsix市场推送.vsix扩展，并在releases选项卡中创建一个发布。

然后，维护者需要手动填写发布正文，添加变更日志和链接。

致谢：

这个存储库完全致力于我们敬爱的社区成员和朋友，Arcensoth。他在原始language-mcfunction上的工作以及对Minecraft Commands社区的整体贡献是无价的，他将被深深怀念。

安息，Arcensoth