2.6

docs/mcguide/27-手机网络游戏/课程11：使用Nukkit开服/0-Nukkit开服教程.md

@@ -0,0 +1,103 @@
+---
+front:
+hard: 入门
+time: 60分钟
+---
+
+# Nukkit部署教程
+
+## 前言
+本文默认认为你了解过Nukkit 或者 通过Waterdogpe + Nukkit搭建过第三方服务器。
+
+## 准备阶段
+1. 准备Java版本，建议Java版本为Java17及以上版本
+2. 准备NukkitMOT分支，NukkitMOT原作者已将中国版打包到github主分支内 https://github.com/MemoriesOfTime/Nukkit-MOT
+> 目前仅支持接入Nukkit-MOT，其他分支可自行通过参考NukkitMOT源码进行对接
+3. 准备 WaterDogPE 代理服务端。
+
+
+## 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，不要额外套一层文件夹
+![图](./images/img.png)
+
+## 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)