Z# 语言

Z# 语言

一个让你使用 Z#(ZSharp)编写模组的模组

Z# Language

本模组允许你使用 由 ZombieOS 制作的 Z# 来编写 Minecraft 模组。

什么是 Z#?

Z#(发音为 Z Sharp)是由 ZombieOS 开发的一种开源编程语言。它的语法易于阅读和学习,官方 GitHub 仓库中提供了示例。

这个模组能做什么?

使用这个模组,你可以创建方块、物品、实体、配方、命令、事件等等!

我该如何开始?

首先,你需要将此模组作为依赖项添加到你的 build.gradle(Gradle)或 pom.xml(Maven)中。

完成之后,你需要创建你的 Z# 项目。为此,在你的项目主目录中创建一个名为 project.zsettings 的新文件。下面是一个模组模板,你可以根据需要调整内容。

zsharp = type.settings

Project: "Mod Name":
PID: "mod_id":
Version: [1.0.0.0]:
Authors: ["Author1", "Author2"]:
Description: "Mod Description":
ZSharp: [1.4.0.0]: // 将此替换为你所使用的构建中 Z# Language 模组支持的 Z# 版本
Dependencies ():

创建此文件后,你需要在 src 文件夹内创建一个名为 zsharp 的文件夹,结构如下:

YourMod/
 project.zsettings
 src/main/zsharp/
  MyMod.zsharp

Java、Kotlin 和 Z# 之间无法顺畅通信。这意味着 Z# 无法调用由 Java 或 Kotlin 编写的函数,Kotlin 和 Java 也无法调用由 Z# 编写的函数。

此模组将始终与最新版本的 Z# 保持同步。如果你想使用 Z1(Z# 第 1 代)的版本,请安装 v1 系列;如果你想使用 Z2(Z# 第 2 代)的版本,请安装 v2 系列,以此类推。

面向开发者

使用 Z# 制作模组时,我们建议将此模组的依赖版本设置为你要使用的最低版本,最高不超过下一个世代更新(例如:v1 到 v2(或 Z1 到 Z2))。原因是小版本更新(如 v1.0.0.0 到 1.0.0.1)会修复 bug 并添加一些新内容,而世代更新(如 Z1 到 Z2)会稍微改变现有语法,你的部分代码可能会在更新之间失效。我们会在 Discord 中标注世代更新之间所有变更的内容。