Minecraft Java Server Installer for Raspberry Pi, PINE64 and Other SBCs.
大强翻译整理 Latest update 2021/05/05
说明
Pinecraft 是基于 Linux 的 Minecraft “我的世界”服务器端安装器，能让你快速搭建基于树莓派（包括其他单板电脑）的 Minecraft 游戏服务器。安装器能够自动完成服务器端的安装与设定工作。如果你已经使用 Pinecraft 创建了属于自己的 Minecraft 游戏服务器，也可以通过再次运行 Pinecraft 安装程序进行升级，以体验最新版的功能。
用 Pinecraft 安装器，俺家闺女只用了20分钟的时间就搭建完成了整台游戏服务器。关于安装的图文解说，将用另外的一篇文章做介绍。
Linux操作系统
经过测试，Pinecraft 安装器可在 Raspberry Pi OS Lite 32 位版本和 Ubuntu Server 12.04 64-Bit for Raspberry Pi 服务器版上使用。对于树莓派 Raspberry Pi 4b 8G 内存版，推荐使用 Ubuntu Server 64 位服务器操作系统，64位操作系统能够让树莓派8G版本调用更多的内存资源。Ubuntu Server 12.04 64位操作系统下载地址:https://ubuntu.com/download/raspberry-pi/thank-you?version=20.04.2&architecture=server-arm64+raspi
硬件要求
我的世界官方服务器Vanilla需要基于 Debian 发行版的 Linux 操作系统，比如Raspberry Pi OS Lite，但不要为采用的 Linux 系统安装桌面环境。如果树莓派内存大于4G，推荐使用 64 位的 Linux 操作系统以便利用更多的内存提升性能。
- 树莓派主板，内存至少为 4G
- 稳定的电源，推荐树莓派官方 5V3A Type-c 接口电源
- 良好的散热，保证在 CPU 超频模式下稳定运行
- 千兆网线，通过网线将树莓派连接到路由器
- 高速 microSD 卡，容量为16G 或 32G
玩家账号
运行我的世界服务器并不需要账号，玩游戏才需要账号。每位游戏玩家都需要一个 Minecraft Java 版账号，以便通过 Java 版 Minecraft 客户端进行游戏。
可从某宝购买“我的世界 Java 版兑换码”，然后在 Windows 10 中登陆 Microsoft 账户进行游戏兑换。也可以从 https://minecraft.net 官网直接购买。
注意：Minecraft Java 版客户端不是 Windows 10 应用商店中的 Minecraft 版本，也不是网易版的账号。
Minecraft 游戏服务器版本
选择“我的世界”游戏服务器版本。Pinecraft 安装器包含了如下版本：
Paper 支持插件/创建速度快Paper版基于 Spigot 并兼容其插件，Paper 在 Spigot 基础上做了性能优化。更多信息https://papermc.io/
Fabric 支持插件/创建速度快轻量级的 Minecraft 服务器。更多信息 https://fabricmc.net/
Spigot 支持插件/创建速度慢在 Craftbukkit 上进行优化，Spigot 允许在服务端使用mods。Spigot 能够在树莓派Pi 4 4G、8G版本或者其他不少于 4G 内存的设备上流畅运行。更多信息 https://www.spigotmc.org/；更多关于 Mods 的介绍请参考 https://minecraft.fandom.com/zh/wiki/Mods?variant=zh
Cuberite 创建速度慢 Cuberite 是采用C++编写的备选服务器类型，只能使用老版 Jave 客户端进行游戏，当前支持的“我的世界”客户端版本为 1.12.2。Cuberite 的优势是能够在旧型号树莓派上运行。
Vanilla 创建速度快Vanilla 是我的世界官方服务器版本，不允许采用 mods，对单板电脑（single-board computer）优化很有限，在树莓派 Pi 4 的 4G 版上能够流畅运行。更多信息 https://minecraft.net
游戏模式
生存模式 生存模式（Survival Mode）是 Minecraft 中的一种游戏模式。在该模式中，玩家必须要收集资源、建造建筑、和怪物战斗、进行饥饿管理和探索世界来生存和发展。
创造模式 创造模式（Creative Mode）移除了游戏中的生存内容，并且允许玩家方便自由地创造和破坏结构与机械，也可使背景音乐发生改变。玩家甚至可以在创造模式中飞行。
Plugin 插件
对于任何支持插件的 Minecraft 服务器，只需将插件 ZIP 压缩文件放置到 ~/minecraft/plugins 目录中，然后在终端窗口中运行命令 ~/minecraft/restart ，通过重启服务器让插件生效。任何插件都可能对服务器性能造成影响，并导致不稳定的情况出现。可以从 https://www.spigotmc.org/resources/ 下载更多用于 Bukkit / Spigot 的插件。
游戏备份
如需备份 Minecraft 中的游戏进程，请先运行命令 stop 脚本停止Minecraft服务器后再进行备份；完成备份后，使用 server 脚本命令重新启动Minecraft服务器。
自动超频
Pinecraft 安装程序运行到最后阶段，会询问否需要启用 CPU 超频以获得更好的游戏性能。安装程序通过重写 /boot/config.txt 文件来设置超频，在重写之前会自动将 config.txt 文件备份为 /boot/config-DATETIME.txt ，如果在设置超频后出现任何无法进入系统的情况，可以通过恢复备份的 config.txt 配置文件来恢复系统。
Pinecraft安装程序使用
重启服务器后连接到 Minecraft 服务器的终端窗口，以便从 pinecraft 目录运行安装脚本：cd pinecraft 进入 pinecraft 安装目录 sudo ./install 用管理员权限运行安装程序当安装完成后，会要求重启服务器。如果你选择了自动启动 Minecraft 服务器，开机后系统就会自动运行并创建 Minecraft 游戏世界。第一次启动将耗费10多分钟的时间，请耐心等待。10-15分钟后可以用 Minecraft Java 客户端连接服务器。如想重启服务器，千万不要使用传统的Linux命令，必须用如下指令：sudo ~/minecraft/reboot
Minecraft服务器命令脚本
Minecraft 的命令脚本放置在 ~/minecraft 目录中。
~/minecraft/server 运行 Minecraft 服务。如果选择了在树莓派通电后启动游戏服务器，此脚本将在每次开机后被自动运行。
~/minecraft/reboot 如需重启整台服务器，先运行此命令以便保存所有树莓派随机内存中的游戏文件，防止游戏过程丢失。重启服务器的时间将长达15-20分钟，请耐心等待。
~/minecraft/stop 安全地停止 Minecraft 游戏服务。在重启树莓派服务器或者断电关机之前，你需要运行此程序以保存游戏进度。
游戏联网
Minecraft 服务运行在25565端口。如果局域网中游戏，只需要在游戏中设置树莓派的 IP 地址即可。如果家中宽带拥有公网 IP，可通过设置路由器端口转发将服务器共享给其他玩家；如果没有公网 IP，也可以免费使用 No-IP 这样的动态域名解析服务（https://www.noip.com）。无论如何，建议你在将家中的 Minecraft 服务器暴露于公网之前，在服务器端设置一些外挂程序，以便保护每位玩家在 Minecraft 世界中建造的内容。
日志文件
~/minecraft/logs/latest.log
以上是 Minecraft 服务器的日志文件存放路径。
可以通过运行命令 tail -f ~/minecraft/logs/latest.log 进行查看。
错误提示
- Server gets killed by Linux
服务器进程被 Linux 关闭。如果出现这种情况，运行命令：
dmesg -T| grep -E -i -B100 'killed process
查看进程被关闭的原因。造成进程被杀的一般原因都是因为服务器上运行了其他程序，从而导致系统资源不够造成的。 对于单板电脑，必须采用无桌面模式，也不要运行除 Minecraft 服务之外的其他进程。可以通过编辑 ~/minecraft 目录中的
server 脚本来调整分配给 Minecraft 游戏服务的内存大小。
- Overclock says N/A
超频不可用。这是因为你使用的硬件并没有经过 Pinecraft 安装程序的测试，为了保证设备的安全，安装程序禁用了超频功能。
常见问题
官方文档：Minecraft游戏配置
在调整Minecraft 任何设置之前，请先采用默认的配置文件config进行启动，之后根据需要对配置文件进行修改。配置文件所在位置：~/minecraft/server.properties。对于如何修改Minecraft游戏的配置文件server.properties，请参考官方说明 https://minecraft.gamepedia.com/Server.properties#Java_Edition_3
官方文档：Minecraft游戏服务器设
https://minecraft.fandom.com/wiki/Tutorials/Setting_up_a_server
Spigot / Paper / Fabric插件
https://www.spigotmc.org/resources/categories/spigot.4/
一般问题
- How do I become admin? /op says I don't have permission. 尝试成为游戏的管理员，但提示称不被允许。
解决办法：玩家用Minecraft游戏客户端连接树莓派Minecraft服务器，SSH登录服务器后，打开 ~/minecraft/logs/latest.log 文件查看玩家的UUID。也可以通过这个在线工具查，注意仅限正版Java账号玩家。工具网址：https://category5.tv/tools/minecraft/uuid/
用以下格式编辑 ~/minecraft/ops.json 文件：
[
{
"uuid": "UUID",
"name": "USERNAME",
"level": 4
}
]
用玩家的UUID和USERNAME替换对应的值。修改完成后，使用 ~/minecraft/reboot 命令重启服务器，重启后设置的玩家将被赋予游戏管理员权限，之后还可以在游戏中用 /op 命令指定其他的玩家为游戏管理员。
- 如何重新生成游戏中的世界？
如果只是想简单的删除当前的游戏世界，指需要移除对应的world文件夹即可。
Step 1: 在树莓派服务器停止Minecraft服务~/Minecraft/stop
Step 2: 删除以包含了world名的文件和文件夹rm -rf ~/Minecraft/world*
Step 3: 用sudo ~/minecraft/reboot命令重启服务器，重启后大约需要10-15分钟的时间来创建新的世界
===大强的树莓派系列文章===
*树莓派 Pi 4 安装操作系统和更新引导固件 https://www.jianshu.com/p/d093cb6f7a0d
*在树莓派 Pi 4b上搭建 Minecraft 游戏服务器 https://www.jianshu.com/p/4c850bf6a286
*树莓派 Pi 4b 上搭建 Minecraft 游戏服务器图文教程 https://www.jianshu.com/p/836b5e3a3746
参考资料：
1. Minecraft Server Installer for Raspberry Pi and Other SBCs https://github.com/Cat5TV/pinecraft
2. Free Raspberry Pi 4 Minecraft Java Server 2021 with Pinecraft https://www.youtube.com/watch?v=1A4FtaiNkrg
3. How to Install Minecraft Server On Raspberry Pi 4 with Pinecraft https://www.youtube.com/watch?v=OKfeB3jklqo
