PowerNukkitX: A Java repository from kkj9333

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

🤔什么是PowerNukkitX ？

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

加入我们:

Discord
QQ

PowerNukkitX的优势：

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

🎮 如何使用

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

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

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

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

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

使用步骤:

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

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>