Minecraft on RunicDolphin806

Minecraft服务器插件

Sun, 22 Feb 2026 00:00:00 +0000

理论和实践均表明，进行与Minecraft相关的开发活动是提升面向对象编程水平的有效途径！

以下是我2026年寒假智斗"org.spigotmc:spigot-api:1.20.1-R0.1-SNAPSHOT"的成果。

MC常量

物品ID

Minecraft的物品ID主要有两套系统：数字ID（老版本用）和英文ID（新版本用）。

在1.13或更高版本，务必使用英文ID。

Bukkit提供了Material的枚举类，可以通过物品的英文ID获取对应的物品。例如：

1Material.BOOK       // 书
2Material.PAPER      // 纸

格式代码

当前，MC的格式代码有§和&两种格式,用来设置文本的颜色与格式。在聊天框、书籍等均可生效。

&实际上是代码中用来方便替代§。因此&6与§6的效果完全一样。

在Windows系统输入§：按住Alt，然后在小键盘依次按0167，松开Alt即可输入。

常用代码
`§0` 黑色	`§1` 深蓝色	`§2` 深绿色	`§3` 深青色
`§4` 深红色	`§5` 紫色	`§6` 金色	`§7` 灰色
`§8` 深灰色	`§9` 蓝色	`§a` 绿色	`§b` 青色
`§c` 红色	`§d` 粉红色	`§e` 黄色	`§f` 白色
`§k` 随机字符	`§l` 粗体	`§m` 删除线	`§n` 下划线
`§o` 斜体	`§r` 重置

1// 使用方式
2lore.add("§5紫色文本§r§7灰色文本");     // 紫色后重置为灰色
3lore.add("§r§c红色文本§r§a绿色文本");   // 分别设置颜色

若使用&，则还需要一层转译：

1lore = ChatColor.translateAlternateColorCodes('&', "&5紫色文本&r&7灰色文本");

Minecraft服务器

Thu, 31 Jul 2025 00:00:00 +0000

我从2025年2月初开始学习搭建MC服务器，到现在也学到了不少知识。以下是我的开服历程，若能对各位有所帮助，实在是我的荣幸。

服务端搭建

常见的服务端

目前MC服务端主要包括：原版、插件端、模组端和混合端四类。

类别	特点
原版	就和MC原版一样，没有特殊功能
插件端	能加插件，不能加模组
模组端	能加模组，不能加插件
混合端	既能加模组，也能加插件

似乎混合端功能更强大，但实际上它的兼容性更差，所以如果想开整合包服务器的话最好还是用模组端。

由于我目前没找到合适的模组代替插件，因此只能用混合端了。

以下是常见的服务端：

服务端	类别	支持
Spigot	插件端	全版本
Paper	插件端	全版本
Forge/Fabric/NeoForge	模组端	全版本
Catserver（猫端）	混合端	1.12.2/1.16.5/1.18.2
Mohist（墨端）	混合端	全版本

安装 Java 环境

Java环境是MC服务器必备的运行环境。Java有多个发行版，不同的MC服务端对应不同的Java。

MC版本	支持
1.12 - 1.16	Java 8
1.17 - 1.20	Java 17
1.21 以上	Java 21

Java可从Oracle官网下载（最新版需要注册账号才可下载）。如果不在意，也可从镜像站例如Adoptium 下载。

使用.exe或.msi文件安装的Java一般自动配置好了环境变量，如果使用.zip安装Java则需手动配置。

服务端启动流程

首先在网络上下载对应的服务端，通常是一个.jar文件。然后新建一个文件夹，将服务端核心放在文件夹内。

然后新建一个文本文档，在文档内输入java -jar 你的服务端核心名.jar，保存后将文件扩展名改为.bat。之后双击.bat文件，服务端将会运行并且在终端实时输出。这时通常会出现是否同意eula协议，此时须在文件夹内找到eula开头的文件，将其中的false改为true。最后再次启动.bat文件，服务端开启成功。

网络配置

搭建服务器最重要的是配置好网络，核心是确定服务器的IP地址和端口号。

局域网联机

局域网联机最简单，只需知道服务器运行的主机的IP地址即可。

Windows平台：win+r打开cmd，输入ipconfig，查看Wifi（无线连接）或以太网（有线连接）下的IP地址。

Linux平台：命令行输入 ip a 。

通俗来说，通过同一个Wifi相连的设备都处于同一个局域网下。连接在同一个局域网下的设备，它们的设备IP地址仅最后一位不同。在同一个局域网下的设备可通过IP地址互相连接。

内网穿透

请在网络上自行查找相关内容。

内网穿透是通过特定技术，将你的内网（如局域网）地址经服务器映射到公网上的过程。此时一个公网IP地址，如：frp-xxx.com:xxxxx就等同于你的局域网地址192.168.x.x。

IPv6连接

这是目前成本最低，效果最好的连接方式。

首先必须确保你和你的伙伴都有IPv6访问，然后win+r打开cmd，输入ipconfig，这时应该可以看到一串240e:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx（必须为240e开头，这样才是公网IPv6），这时[IPV6地址]:端口号的形式就是服务器的IP地址。

目前IP技术分为IPv4和IPv6两种。IPv4地址为12个十进制数，每3个数字用“ : ”隔开；IPv6地址为28个16进制数，每4个数字用“ : ”隔开。由此可见，IPv6地址比IPv4多得多，所以每个IPv6地址都可以作为公网使用。

服务器进阶

修改服务器配置

依据服务端核心的不同，修改方法也有所区别。

启动文件

示例：

 1#!/bin/bash
 2set -e
 3
 4# 1. 如果 MySQL 没装，就装（可选）
 5# sudo apt update && sudo apt install -y mysql-server
 6
 7# 2. 确保 MySQL 服务已启动
 8sudo service mysql start
 9# sudo systemctl is-active --quiet mysql || { echo "MySQL 启动失败"; exit 1; }
10
11# 3. 等待 3306 真正响应
12until nc -z 127.0.0.1 3306; do
13  echo "等待 MySQL 端口 3306 …"
14  sleep 1
15done
16
17# 4. 启动 MC（stop正常退出，崩溃自动重启）
18cd {"服务器所在目录"}
19while true; do
20    java -Xms4G -Xmx8G -jar mohist-1.20.1.jar
21    EXIT_CODE=$?
22    
23    # 退出码 0 = 正常停止 (stop命令)
24    if [ $EXIT_CODE -eq 0 ]; then
25        echo "服务器正常关闭，退出脚本"
26        break
27    fi
28    
29    echo "服务器异常终止 (退出码: $EXIT_CODE)，5秒后自动重启..."
30    sleep 5
31done

在java -jar 你的服务端核心名.jar中，可在-jar之后加上-XmsAG -XmxBG表示给服务器至少分配A个G的内存，至多分配B个G的内存。

特别的，java可以替换为具体的Java/bin路径。若未指明，默认为最新版的Java。

`server.properties`

这是所有服务器都具备的配置文件。

 1allow-flight=true                       #是否启用飞行
 2allow-nether=true                       #是否生成下界
 3broadcast-console-to-ops=true           #是否向管理员发送控制台消息
 4broadcast-rcon-to-ops=true
 5debug=false                             #是否开启调试模式
 6difficulty=normal                       #难度设置
 7enable-command-block=true               #是否启用命令方块
 8enable-jmx-monitoring=false
 9enable-query=false
10enable-rcon=false
11enable-status=true
12enforce-secure-profile=true
13enforce-whitelist=false
14entity-broadcast-range-percentage=100
15force-gamemode=false                    #是否强制设置玩家的游戏模式
16function-permission-level=4             #命令等级设置，最高为4，最低为0 
17gamemode=survival                       #游戏模式设置
18generate-structures=true
19generator-settings={}
20hardcore=false
21hide-online-players=false
22initial-disabled-packs=
23initial-enabled-packs=vanilla
24level-name=play                         #游戏主世界存档名称
25level-seed=                             #游戏主世界地图种子
26level-type=minecraft\:normal            #主世界地图类型
27max-chained-neighbor-updates=1000000
28max-players=40                          #服务器允许的最多人数
29max-tick-time=60000
30max-world-size=29999984
31motd=智算11班公益养老服(1.4)
32network-compression-threshold=256
33online-mode=false                       #是否启用在线模式
34op-permission-level=4                   #管理员命令等级
35player-idle-timeout=0
36prevent-proxy-connections=false         #是否阻止代理连接
37pvp=true                                #是否允许玩家互相攻击
38query.port=25565    
39rate-limit=0
40rcon.password=
41rcon.port=25575
42require-resource-pack=false             #是否强制使用资源包
43resource-pack=                          #资源包链接
44resource-pack-prompt=
45resource-pack-sha1=
46server-ip=                              #服务器运行的IP地址，默认留空为127.0.0.1
47server-port=30067                       #服务器运行的端口
48simulation-distance=10                  #服务器模拟距离，建议设置为4~6
49spawn-animals=true
50spawn-monsters=true
51spawn-npcs=true
52spawn-protection=0                      #出生点保护范围
53sync-chunk-writes=true
54text-filtering-config=
55use-native-transport=true
56view-distance=10                        #服务器视野距离，建议设置为4~6
57white-list=false                        #是否启用白名单

`bukkit.yml`

`spiogt.yml`

安装插件和模组

使用SSH远程连接服务器主机

参见：SSH配置简介

使用MySQL管理玩家数据

对于多个服务器，如果想不同服务器之间共享玩家数据（如权限、经验等），可以使用MySQL数据库。

下面以服务端插件PowerRanks为例进行说明。

打开PowerRanks的配置文件，找到关于数据来源的配置。将type改为mysql，并配置好端口、用户名和密码。这样在启动时，插件会自动从127.0.0.1:3306端口的root用户读入数据。

 1...
 2storage:
 3  type: mysql
 4  mysql:
 5    host: 127.0.0.1
 6    port: 3306
 7    database: powerranks
 8    username: root
 9    password: *******
10    ssl: false
11    verbose: false
12...

在MySQL的表中创建新表，命名为powerranks，此处名称应与配置文件中的database后的名称相同。
启动MC服务器，这样Powerranks插件就会自动在MySQL中创建数据表，可以对其进行相关操作。

注意：使用MySQL的数据时，每次启动服务器前应当先启动MySQL客户端，否则插件会报错。

可以使用命令：sudo service mysql start

开发者选项

制作自己的服务端插件

Minecraft教程

Sat, 10 Aug 2024 00:00:00 +0000

认识Minecraft

Minecraft（简称MC），作为全球销量第一的游戏，深受众多玩家喜爱。

MC分为Java版、基岩版、主机板（Xbox版）和网易版。

下载Minecraft

正版和离线版

MC的正版与否取决于你的微软账号上有没有MC。换句话说，无论是否购买正版，你都可以下载到MC的游戏文件并启动游玩。唯一的区别在于非正版玩家无法进入开启了正版验证的服务器，因此MC中的“非正版”也被称之为“离线版”。

离线版依然可以进入未开启正版验证的服务器

MC Java版启动器

MC Java版本身没有.exe之类的文件，必须得有一个启动程序才能运行。

启动器	支持系统
Minecraft Launcher （官方启动器）	Windows/MacOS
Plain Craft Launcher 2（PCL2）	Windows
Hello Minecraft Launcher （HMCL）	Windows/Linux

也有部分发烧友喜欢在Android平台上启动MC Java版。目前，Android系统流行的启动器主要是Fold Craft Launcher和ZalitLauncher

注意：千万不要指望Android平台上MC Java版的表现和Windows系统的一样。

启动器的原理就是整合了启动游戏核心 .jar文件的功能。因此如果愿意，也可以使用IntelliJ IDEA启动。

MC基岩版

MC基岩版则相对简单很多。只需要在相应的平台里下载MC基岩版即可。

平台	下载地点
Windows	Microsoft Store
Android	Google Play
iOS	Apple Store

鉴于国内通常无法打开Google网站，如果想体验Minecraft基岩版，可以在苦力怕论坛下载。

注意，论坛中下载的并非正版，请于下载体验后24小时内删除！

Minecraft Java版进阶

Java版游戏文件

Minecraft Java版对玩家文件管理的要求较高，因此需先了解其文件结构。

1.minecraft           # 游戏文件根目录
2├── assets           # 游戏资源文件夹
3├── global           # 全局配置
4├── libraries        # 加载库文件
5├── versions         # 版本文件夹（开启版本隔离后生效）
6├── …

其中versions文件夹是我们进行操作的主要位置。

版本隔离

版本隔离是MC Java版独特的功能，它使得每个Java游戏版本都相互独立，互不影响。

注意：版本隔离选项默认是关闭的，第一次使用应当在启动器设置内将“版本隔离”设置成“各版本相互独立”。

安装 MOD

Java版的优势之一就是能方便自由地安装mod、材质和光影等。

安装mod的前提是安装mod加载器，这是绝大多数mod的加载环境。常用mod加载器如下：

名称	版本支持	特点
Forge	1.5.2 - 最新	最流行，支持大量模组
Fabric	1.14 - 最新	轻量加载器，提供快照版本
NeoForge	1.20.1 - 最新	新兴加载器，由Forge发展而来，极具潜力

mod加载器一般互不兼容，只能选择其中一个。

当安装了mod加载器后，下载适配当前加载器的模组并放到对应游戏版本的/versions/你的游戏版本/mods文件夹中，启动游戏即可畅玩！

以下提供mod加载器的安装方法。

启动器内安装

PCL2、HMCL等第三方启动器内置了mod加载器下载方式，在安装新版本时即可选择是否安装mod加载器。

通用安装方法

在mod加载器相应的官网下载文件，并按说明安装。

以Forge为例进行说明：

进入Forge官网，选择需要下载的MC版本。
点击Installer，此时将跳转到广告界面。若你的网络状况较好，应当会在界面右上角出现“SKIP”按钮，点击“SKIP”即可下载Forge文件。
定位到文件所在位置，双击打开.jar文件，稍等一会儿就会打开安装界面，选择“Install client”，再选择安装位置，点击确定即可安装成功。

Forge

此时打开启动器，应当能在版本列表中看到刚安装的Forge版本。

安装材质和光影

安装材质的方法较为简单，直接下载好需要的材质文件（通常是压缩包的形式），将其放入/versions/你的游戏版本/resourcepacks文件夹即可。

安装光影则需要MOD的前置支持，安装好对应MOD后，将下载的光影文件放入/versions/你的游戏版本/shaderpacks文件夹。

模组加载器	对应MOD
Forge	1.12.2 以下：Optifine；1.16.5 以上：Oculus
Fabric	Iris

导入地图

地图（实际上就是一个存档）的导入就是将该地图文件夹全部放入/versions/你的游戏版本/saves文件夹中即可。

MC联机

MC的联机是一项复杂且具有挑战性的操作。学习MC的联机，您将了解并掌握《计算机网络》50% 以上的内容！

局域网联机

这是最简单的联机方式，需要房主和玩家在同一个局域网下，也就是连接同一个Wifi。

遗憾的是，校园网等大型局域网可能不支持这种方式。因为即使连接到同一个Wifi，ipv4地址的第3个十进制数（也就是网关）可能不相同，这样就无法通过 ipv4:端口号的方式联机。

幸运的是，现在一些大型局域网已经支持了ipv6。这时，可以使用[ipv6]:端口号的方式启动局域网联机。

选做：使用Radmin VPN创建虚拟局域网

不过，使用Radmin VPN创建虚拟局域网可以解决ipv4地址网关不同的问题。只需要双方同时下载Radmin VPN，由其中一方创建虚拟局域网，然后同时连接到该局域网下，即可联机成功。

之所以称之为局域网联机，是因为在这种联机操作下，服务端就是房主的客户端（也就是房主的电脑就是服务器，所以房主必须上线）。与之相对应的就是服务器联机。

服务器联机

详见：“Minecraft服务器——开服经历回顾”

常见问题

微软账号无法登录

有时网络运营商的 DNS 可能无法很好地解析微软的验证服务器地址，导致微软账号的登录界面无法进入，无法与小伙伴愉快游玩Hypixel。解决方法为更换更可靠的公共 DNS。

进入设置 > 网络和 Internet，点击正在连接的 Wi-Fi 或以太网的 “属性”。
找到 “DNS 服务器分配”，点击“编辑”。
将其更改为“手动”，然后打开 IPv4 开关。在“首选 DNS”中输入 8.8.8.8，在“备用 DNS”中输入 8.8.4.4。（这是 Google 的公共 DNS，非常稳定）。
保存设置，重新登录。

以上解决办法来源此处

更改DNS服务器后可能会影响其他网站的访问速度。当登录微软账号成功后，最好立即切换回自动DNS。

链接网站

网站	内容
MC百科	下载MC Java版mod，整合包等资源。
苦力怕论坛	下载MC基岩版资源包、行为包、材质、光影、地图等。
LittleSkin皮肤站	托管MC皮肤文件。
Minecraft捆绑包商店	购买Minecraft正版。
Modrinth	下载MC和MC服务器资源。