kkj9333 / PowerNukkitX

Make Nukkit Great Again!

🌐Need to switch languages? / 多语言文档

🤔什么是PowerNukkitX ？

PowerNukkitX是基于PowerNukkit的一个分支版本，由PowerNukkitX小组负责开发维护，如遇任何问题可提交Issue反馈。

加入我们:

• Discord
• QQ

PowerNukkitX的优势：

1. 支持1.19.20协议。
2. 原生支持384限高（目前仅限主世界，其余则为256格限高）。
3. 原生支持地狱世界，无需另外安装插件补丁等。
4. 原生支持香草命令和命令方块等（完善中）。
5. 内置Terra 地形生成器（如有问题点此查看）。
6. 支持使用JavaSrcipt语言编写插件 （可在此处查找开发文档）。
7. 支持自定义方块 / 物品 / 实体（完善中，文档待补充）。
8. 内置生物AI，无需安装MobPlugin（开发中，未完善）。
9. Todo...

---

🎮 如何使用

PowerNukkitX要求的最低Java版本为17,请自行安装且配置环境变量.

我们建议您使用PNX-CLI运行PowerNukkitX,为什么?

1. PNX-CLI使用GraalVM Native Image编译,无需java运行环境即可使用,占用内存小,运行效率高
2. 简化GraalJit和JDK的安装,拥有GraalJit,您的JS插件运行效率会提升100倍
3. 提供高效自适应的启动命令,无需手动编写
4. 纯命令行操作,简洁有效,linux命令风格
5. github版本同步,更新版本无需重复下载依赖库,只需一键命令

您可以在此处查看如何启动PNX。

如果您的平台不适合使用PNX-CLI,那么请查看以下步骤。

使用步骤:

1. 从release下载libs.tar.gz和powernukkitx.jar
2. 将libs.tar.gz中的libs文件夹解压到和powernukkitx.jar同一路径下
3. 运行以下命令

Windows版本

java -Dfile.encoding=UTF-8 ^
-Djansi.passthrough=true ^
-Dterminal.ansi=true ^
-XX:+UnlockExperimentalVMOptions ^
-XX:+UseG1GC ^
-XX:+UseStringDeduplication ^
-XX:+EnableJVMCI ^
--module-path=.\libs\graal-sdk-22.2.0.jar;.\libs\truffle-api-22.2.0.jar; ^
--add-opens java.base/java.lang=ALL-UNNAMED ^
--add-opens java.base/java.io=ALL-UNNAMED ^
-cp .\powernukkitx.jar;.\libs\* ^
cn.nukkit.Nukkit

Linux版本

java -Dfile.encoding=UTF-8 \
-Djansi.passthrough=true \
-Dterminal.ansi=true \
-XX:+UnlockExperimentalVMOptions \
-XX:+UseG1GC \
-XX:+UseStringDeduplication \
-XX:+EnableJVMCI \
--module-path=./libs/truffle-api-22.2.0.jar:./libs/graal-sdk-22.2.0.jar: \
--add-opens java.base/java.lang=ALL-UNNAMED \
--add-opens java.base/java.io=ALL-UNNAMED \
-cp ./powernukkitx.jar:./libs/* \
cn.nukkit.Nukkit

---

📌 声明

PowerNukkitX 是基于PowerNukkit和Nukkit的修改优化版本，修复了其BUG，添加了更多的功能支持等，如LiteLoader （完善中）插件兼容等。

• 请注意PowerNukkitX 非Cloudburst的开发人员维护，它依靠的是开源社区的开发者们用爱发电，如果您在使用PowerNukkitX时遇到了发现了任何问题，您首先应该在此存储库创建一条issue （同时请注意阅读贡献帮助指南中的规定）。

• 同时我们推荐您进行定期备份等操作，并使用为PowerNukkitX 制作的插件，并使用稳定版PNX进行部署。

• 大多数Cloudburst Nukkit都可在该服务端上兼容使用，但在运行时可能会出一些错误等或不支持PowerNukkitX添加的新内容。

🧾 关于Nukkit核心

Nukkit 是一款为Minecraft: Pocket Edition而生的服务端，有着如下优势:

• 基于Java开发，速度更快，更稳定，高性能。
• 具有友好的架构，您可简单快速的上手为其开发插件等。
• Nukkit正在不断优化改进中，同时我们欢迎您为我们的开发做出贡献。

---

🛠 创建插件

• 添加PowerNukkitX至您的依赖项中（它由Maven Central托管，因此您无需指定自定义存储库）。

点此查看完整的Gradle示例

repositories {
    mavenCentral()
}

dependencies {
    compile group: 'cn.powernukkitx', name: 'powernukkitx', version: '1.19.20-r4'
}

点此查看完整的Maven示例

<dependencies>
    <dependency>
        <groupId>cn.powernukkitx</groupId>
        <artifactId>powernukkitx</artifactId>
        <version>1.19.20-r4</version>
    </dependency>
</dependencies>

---

🛠 构建JAR核心文件

• git clone https://github.com/PowerNukkitX/PowerNukkitX
• cd PowerNukkitX
• git submodule update --init
• ./mvnw clean package

• 编译后的JAR文件可在 target/ 目录中找到。

• 编译完成的JAR文件运行参见如何使用。

🧐 贡献一份力量

您在提交任何问题或代码上传合并等请求时，请先阅读贡献帮助指南后再进行提问或其它操作，信息不足或格式错误等我们将不会回复您并关闭您的请求。

---

🌐 友情链接

• 🌐 PowerNukkitX官网
• 👩🏽‍💻 PowerNukkitX文档库
• 💬 PowerNukkitX Discord
• 💾 下载测试版PowerNukkitX
• 🔌 Cloudburst Nukkit 插件中心
• 🔌 PowerNukkit 插件中心

🎨 数据统计

2019 - 2022 © BlocklyNukkit | PowerNukkitX