Skip to content

Minecraft

本节内容

本节将包含你在 Minecraft 服务端接入海豹核心需要了解的特定内容。

Minecraft 支持

海豹核心支持与安装了 sealdice-minecraft 插件的 Minecraft 服务器(如 Paper、Purpur)进行对接。

架设 Minecraft 服务端

下面以 Windows 平台为例,简单介绍 Minecraft 服务端的架设。

架设 Minecraft 服务器首先需要根据选定对应的 Java 版本。

  • 服务端版本 1.0 - 1.11.x 可以使用 Java 6Java 7,但推荐使用 Java 8
  • 服务端版本 1.12(17w13a) - 1.16.5(1.17-21w18a),需要使用 Java 8
  • 服务端版本 1.17(21w19a) - 1.17.1 需要使用 Java 16
  • 服务端版本 1.18(1.18-pre2) 及以上版本需要使用 Java 17 及以上。
  • 此为一般情况,部分服务端会推荐对应 Java 版本,请按需安装对应 Java 版本。

注意

sealdice-minecraft 插件需要 Java 18 及以上的 Java 版本,如需要在低版本运行请自行验证服务端与 Java 版本是否匹配。

获取服务端核心

前往 Paper MC 下载对应版本的服务端核心文件。

启动服务端

新建一个空白文件夹,放入服务端核心,编写一个简单的 bat 启动脚本(可新建一个 txt 文件后,修改文件后缀)。

Create Bat 1

启动脚本内容如下:

cmd
@echo
java -Xms2G -Xmx2G -jar spigot-1.20.4.jar nogui
  • -Xms2G -Xmx2G:此项设定服务器占用的内存,按照需求更换数字,例如 1024m6G
  • -jarnogui 之间的 spigot-1.20.4.jar 更改为文件夹内对应的服务端核心文件文件名。

退出并保存文件,将该文件后缀改为 .bat。修改后文件夹如下所示:

Create Bat 2

启动 start.bat 文件,即可开始运行服务端。

提示

首次打开 start.bat 启动脚本,会下载 mojang_1.20.4.jar 等一系列的文件并创建文件夹,在下载和创建完成后会首次启动会自行关闭。

打开在文件夹内新创建的 eula.txt,将 eula=false 改为 eula=true

text
...
#By changing the setting below to TRUE you are indicating your agreement to our EULA (https://aka.ms/MinecraftEULA).
#Fri Feb 30 00:00:01 HKT 2024
eula=true  # 请把该项修改为 true
...

再次启动脚本 start.bat

当出现 Done (7.837s)! For help, type "help" 时,服务器首次启动完毕。

在 CMD 内键入 stop,等待服务器保存并关闭,即可进入下一个步骤。

放入 sealdice-minecraft 插件

前往 Sealdice Minecraft GitHub Release 下载 jar 文件放进 plugins 文件夹。

再次运行脚本 start.bat 以启动服务器。

在服务器日志中出现:

cmd
[00:00:07 INFO]: [SealDicePlugin] Enabling SealDicePlugin v1.0.2*
[00:00:07 INFO]: [SealDicePlugin] ChatServer started on port: 8887
[00:00:07 INFO]: [SealDicePlugin] Server started!

证明 sealdice-minecraft 插件已经正确安装,并且插件将会开启一个端口 8887 供海豹使用。

使用在控制台使用 sealport [端口] 或在游戏中使用 /sealport [端口] 可以修改连接端口。

至此,Minecraft 服务端的准备工作已经完毕。

海豹核心与 Minecraft 服务端连接

账号设置 页,选择 账号类型Minecraft(Paper)

SealDice UI

URL 的填写请根据下列情况选择:

海豹核心与 Minecraft 服务端部署在同一台服务器:

SealDice UI

此时输入使用 localhost:[端口] 即可完成连接,默认端口为 8887

当服务器后台日志中出现:

cmd
[00:00:10 INFO]: [SealDicePlugin] 0:0:0:0:0:0:0:1 entered the room!

证明海豹核心已和 Minecraft 服务端连接完毕。

sealdice-minecraft 插件的使用

指令

提供两个插件指令:

sealdice [文本]

使用该指令的玩家视为向海豹私聊发送了一条消息。

但是命令方块和控制台使用该指令会被视为公屏发送。

sealport [端口]

使用该指令需要 OP 权限。该指令用于设置与海豹连接的端口。

权限

提供一个权限:

sealdice.admin

该权限允许/禁止玩家设置与海豹连接的端口,默认为 false