108 lines
3.8 KiB
Markdown
108 lines
3.8 KiB
Markdown
---
|
||
front:
|
||
hard: 入门
|
||
time: 60分钟
|
||
---
|
||
|
||
# Nukkit部署教程
|
||
|
||
## 前言
|
||
本文默认认为你了解过Nukkit 或者 通过Waterdogpe + Nukkit搭建过第三方服务器。
|
||
|
||
如果你没有了解过，请移步到 [2-Nukkit开服教程](2-Server.properties详解.md)
|
||
|
||
特别鸣谢（排名不分先后）： LT_Name(NukkitMOT作者)、bbbroken(EaseCation服务器开发者)、亦染(社区支持者)
|
||
|
||
## 准备阶段
|
||
1. 准备Java版本，建议Java版本为Java17及以上版本
|
||
2. 准备NukkitMOT分支，NukkitMOT原作者已将中国版打包到github主分支内 https://github.com/MemoriesOfTime/Nukkit-MOT
|
||
> 目前仅支持接入Nukkit-MOT，其他分支可自行通过参考NukkitMOT源码进行对接
|
||
3. 准备 WaterDogPE 代理服务端而。WaterdogPE 已兼容中国版，开源仓库是： https://github.com/MCNeteaseDevs/WaterdogPE_Netease/tree/netease。
|
||
|
||
|
||
## WaterDogPE
|
||
### config.yml 的配置
|
||
|
||
需要修改以下参数，其他配置根据情况自行修改
|
||
```yaml
|
||
|
||
# ....
|
||
|
||
netease_client: true # 启用 netease 客户端的支持
|
||
online_mode: true
|
||
# 开发测试阶段，需要改为false，否则会提示需要 minecraft验证
|
||
# 发布阶段时，需要改为true，之后只能用网易手机客户端连接才能进入
|
||
listener:
|
||
# .....
|
||
|
||
host: 0.0.0.0:19132 # waterdogpe 代理端的IP和端口 。官方提供的机器19132端口可能会被占用，根据实际情况更改
|
||
priorites: # 按顺序配置，第一个是玩家进入时默认在的服务器。 一般为大厅服
|
||
- lobby1
|
||
|
||
# .....
|
||
servers: # 子服务器的连接ID配置，如大厅服、游戏服等等。如子服务器不在同一台机器，则需要写具体的ip。
|
||
lobby1:
|
||
address: 127.0.0.1:19133
|
||
public_address: play.myserver.com:19133
|
||
server_type: bedrock
|
||
|
||
|
||
permissions: # 权限配置，一般用于配置管理员的权限，用于测试、调试。仅通过名字识别，建议发布阶段去掉，改为用插件实现相关调试功能
|
||
玩家id:
|
||
- waterdog.player.transfer
|
||
- waterdog.player.list
|
||
- waterdog.command.server
|
||
|
||
```
|
||
|
||
### 装载客户端模组
|
||
|
||
当通过waterdogpe代理后，需要将客户端模组存放在waterdogpe 根目录下的 packs 文件夹中，不要存放在NukkitMOT根目录
|
||
> 除非你仅通过NukkitMOT单端开服 否则waterdogpe 会自动将nukkit模组加载数据包拦截
|
||
|
||
> 但如果关闭waterdogpe的资源包功能，Nukkit数据包依然会被waterdogpe拦截而无法正常进入游戏
|
||
|
||
确保 config.yml 已启用资源包
|
||
```yaml
|
||
enable_packs: true # 必须打开
|
||
overwrite_client_packs: true # 按需
|
||
force_server_packs: true # 按需
|
||
```
|
||
|
||
### 模组打包格式
|
||
|
||
waterdogpe 仅支持 zip和mcpack包，不支持文件夹。
|
||
可以将行为包、资源包都存放在packs目录中。
|
||
目前仅支持 manifest.json ，不支持 pack_manifest.json
|
||
|
||
zip打包格式为： 压缩包一级目录下就是 manifest.json，不要额外套一层文件夹
|
||
|
||
|
||
## Nukkit-MOT
|
||
|
||
nukkit社区的插件
|
||
https://cloudburstmc.org/resources/categories/nukkit-plugins.1/
|
||
|
||
### server.properties 配置
|
||
|
||
为了确保Nukkit-MOT正常接入中国版，您需要调整一些配置
|
||
```properties
|
||
xbox-auth=off
|
||
netease-client-support=on
|
||
only-allow-netease-client=on
|
||
```
|
||
|
||
### 模组装载
|
||
|
||
如果使用 waterdogpe 代理，则需要将模组放在 waterdogpe 目录，而非Nukkit目录
|
||
如果仅适用Nukkit，则将行为包合资源包都放在Nukkit目录下有关 netease的文件里
|
||
|
||
### NukkitMaster插件
|
||
|
||
NukkitMaster相当于Spigot服的SpigotMaster，内置封装了PyRPC、订单接口、消息收发等功能，API和使用方法和SpigotMaster一样。
|
||
|
||
|
||
### 自定义物品、方块和实体
|
||
|
||
Nukkit-MOT本身已经支持自定义物品、方块、实体的功能，可以参考[官方文档](https://www.nukkit-mot.com/zh/docs/tutorial-extras/custom/custom_item)
|