在建立或编辑词条前,请先阅读MineWiki方针与指引

PowerNukkitX:修订间差异

来自MineWiki
YYT讨论 | 贡献
无编辑摘要
第1行: 第1行:
[[分类:核心]]
[[分类:核心]]
[[文件:PowerNukkitX BANNER.png|缩略图|463x463像素|PowerNukkitX Logo]]
[[文件:PowerNukkitX BANNER.png|缩略图|580x580px|PowerNukkitX Logo|替代=]]


= 什么是PowerNukkitX? =
= 什么是PowerNukkitX? =

2022年6月13日 (一) 01:58的版本

PowerNukkitX Logo

什么是PowerNukkitX?

简介

PowerNukkitX(简称PNX)是由包括BlocklyNukkit团队在内的中国Nukkit开发者们负责开发维护的Nukkit分支版本,修复了众多BUG,改善了性能,及时跟进新版本支持、支持1.18所有新方块和新物品、支持新版下界、支持史诗地形生成器(Terra)。在这些大更改的情况下,PNX仍然保持了良好的插件兼容性,Nukkit生态中的数千个插件仍然可以在PNX上运行。 得益于完全开源的代码,您在遵守开源协议的情况下使用PowerNukkitX没有任何法律风险,内部的数十万API可以随意调用,您可以深入查看实现,通过JVM生态中的各种工具及其方便地进行开发、调试、注入、拦截。也正因如此,Nukkit生态丰富多彩,成百上千各种各样的插件供您选择,您可以用您喜欢的任意JVM语言编写插件,如Java,Kotlin,Scala,Python,Javascript,Lua……

为什么我们要开发PNX?

最直接的原因就是:只有核心强,生态才能强。

我们可以毫不掩饰地说,去重之后,Nukkit生态是基岩版作品最多的生态之一,也是基岩版最高技术力的圈子之一。但是,Nukkit核心在开发团队被CubeCraft买去开发Geyser 项目之后,开发强度急剧下降,随着国外众多开发者进入JE圈子,国内BDS圈子向心力逐渐加强,Nukkit系核心渐渐地不再能跟上be社区发展的步伐。作为自由开源精神的践行者, 作为Nukkit生态的主力,我们有必要接过Nukkit系服务端开发的任务,续写被EaseCation遗忘的的国人核心开发的篇章。

优势和差异

  • 最新版mcbe协议支持
  • 1.18全物品方块及其功能支持
  • 384格世界支持
  • 新版下界生物群系支持
  • 史诗地形生成器
  • 修复众多bug
  • 自定义物品、方块(WIP)
  • 全开源、全API开放、插件众多
  • 更高性能,多核优化(堆核而非堆cpu频率)

联系链接

快速入门

跟随本教程,十分钟(不包括下载耗时)开启您的第一个PowerNukkitX服务器。

本教程将带您使用PowerNukkitX的启动器(Bootstrap)来快速安装并启动服务器。

配置环境

下载启动器

稳定版:点击下载稳定版启动器master-ef2e75c

最新版: 前往自动构建页面,打开您要下载的版本的构建界面并下载PowerNukkitX-Bootstrap 构件,下载完成后解压。

安装Java环境

Windows

下载OpenJDK17安装包 并按照提示安装,一路默认下一步即可完成安装。

Linux

Ubuntu系统安装:

sudo apt update && sudo apt upgrade -y

sudo apt-get install openjdk-17-jre

启动服务器

命令行启动

将启动器jar包复制到你要开服的文件夹中,并在此文件夹下输入命令:

java -jar Bootstrap-0.0.1-beta-shaded.jar

随后启动器将自动开始配置,按照控制台给出的提示,启动器会自动下载配置好PNX需要的java环境,下载并安装PNX核心及依赖库,随后服务器会自动启动。

如果您在关服后想要再次开服,再次输入上面的命令即可。

正常开服界面如下:欲关闭服务器,输入stop即可。

图形界面启动

如果您使用Windows系统、MacOS系统或带有图形界面的Linux系统,可以通过图形界面来管理并启动服务器。

在Windows或MacOS上,如果您已经正确地配置了Java运行环境,您可以直接双击启动器jar包来打开PNX界面;在Linux上,您可以通过java -jar Bootstrap-0.0.1-beta-shaded.jar --gui

来在安装了图形界面的系统中打开PNX界面,PNX正确启动后会显示如下界面:

点击 窗口 -> 检查更新,打开更新检查窗口:

双击标有叉号的项目,挨个双击子项,启动器就会自动修复你点击的子项,直到所有的叉号都消失为止。

点击 服务端 -> 启动服务端,即可启动PowerNukkitX服务器:

如果出现此界面,输入chs并回车即可以中文模式启动PowerNukkitX服务端。

启动器

启动PNX

为什么用启动器

Bootstrap,启动器,是PNX官方提供的用于启动PowerNukkitX的工具。

它可以通过命令行和图形界面两种方式使用,提供了简单易用的开服体验,具有以下优点:

  • 快捷开服,无需复杂配置
  • 占用资源少,不会对核心运行造成明显影响
  • 自动配置java环境,自动检测并使用性能最高的Java启动PNX
  • 方便安装依赖库、更新服务端核心
  • 可以在只有Java8的面板服启动PNX
  • 自动配置复杂的启动参数

启动器的使用方式,详见“快速入门”章节。

不使用启动器开服

当然,你也可以不用启动器开服,但开服的配置将会较为复杂,传统的开服命令不再适合PNX。

首先,你需要前往Github action,选择一个完整的构建任务,点开进入构建详情界面,找到如下的构建物界面:

确定你登录了Github后,点击下载PowerNukkitX-CorePowerNukkitX-Libs,这将分别下载PNX服务端核心和依赖库的压缩包。

下载成功后,解压上述安装包,将服务端核心跟依赖库分别解压到不同的文件夹中。

接下来,找到你的java17的安装路径,在此路径下找到对应的java二进制文件的绝对路径,记录下来。

现在,你可以着手开始编写你的开服命令了。

开服命令模板如下:

%JAVA% -Dfile.encoding=UTF-8 -Djansi.passthrough=true -Dterminal.ansi=true --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED -cp %PNX%%CP_SPLIT%%LIBS_PATH% cn.nukkit.Nukkit

请您将上述模板中的占位符(两侧为%的文字,包括百分号)按照如下说明进行替换:

占位符 替换为
JAVA java17二进制文件绝对路径
PNX PNX核心jar包路径
CP_SPLIT 系统路径分隔符,Windows为;,Linux为:
LIBS_PATH 存放依赖库的文件夹路径

在命令行上输入您修改完的开服命令,即可启动PNX服务端。

注意,您需要留心依赖库变化,如果依赖库发生变化,您需要手动重新下载依赖库重复上述步骤,依赖库如有变化,恕不另行通知。

注意事项

  • PowerNukkitX要求的最低Java版本为17
  • 补充: 如果您的服务器不能安装Java17,你也可以用使用团队提供的BootStrap

兼容性

大多数为Nukkit制作的插件都可以在PowerNukkitX上使用,但某些插件在运行时可能会出一些错误等或不支持PowerNukkitX添加的新内容。