1. 简介

Kingcq2025/5/28大约 5 分钟

注意

本文档内容大部分由 ai 基于讲座 PPT 生成，讲座对应的示例代码在这里。

开启 Minecraft 开发之旅：为什么是 Paper 插件？

欢迎来到 Minecraft 服务器开发的世界。在正式写下第一行代码之前，我们需要先理清一个核心问题：在众多修改游戏的方式中，为什么我们要选择 Paper 插件 开发？这不仅关乎技术选型，更关乎你未来服务器的受众、性能以及维护成本。

Minecraft 的官方服务端（Vanilla）是由 Mojang 提供的，它稳定但封闭，无法直接加载第三方代码。为了实现更多功能，社区经历了一场宏大的技术演进：

Vanilla (原版)：官方发布的服务端，仅支持原版游戏特性，无法安装插件。
CraftBukkit (早期开拓者)：它是第一个大规模流行的插件服务端。它通过封装 NMS（Minecraft 内部源码），为开发者提供了一套标准的 API（Bukkit API）。虽然因为版权纠纷（DMCA）一度陷入停滞，但它的 API 规范沿用至今。
Spigot (性能优化者)：在 CraftBukkit 的基础上进行了大量代码优化，提供了配置选项来减轻服务器负担。Spigot 也是目前大多数插件兼容性的基准。
Paper (现代标准)：这是我们本课程的主角。 Paper 是 Spigot 的分支，它通过异步区块加载、更先进的任务调度以及对数百个原版 Bug 的修复，成为了目前社区公认的最优性能选择。它不仅完全兼容 Spigot，还提供了更强大的 Paper API。
Purpur (极致定制)：Paper 的进一步包装，提供了更多极其细碎的可配置项（如修改生物 AI 行为），适合追求极致定制化的腐竹。

我们的选择

作为开发者，我们通常基于 Paper API 进行开发，因为它在保持高度兼容性的同时，提供了比 Spigot 更加现代化、更具性能优势的接口。

在 Minecraft 的开发生态中，主要存在三种修改游戏逻辑的方式。我们从编写难度、安装门槛和功能上限三个维度来深度对比：

数据包是原版游戏提供的一种“逻辑封装”方式，基于 JSON 和 .mcfunction 命令文件。

编写难度：入门极易，精通极其折磨。 修改合成表、战利品表极快。但如果你想实现复杂的数学运算（如正弦函数）或逻辑循环，你只能依靠“记分板”和“隐形实体”来模拟寄存器，这被称为“在沙子上造电脑”，逻辑链路极难维护。
安装难度：完全零门槛（玩家无感）。 只要服务端装了数据包，原版客户端进入即可生效。
局限性： 无法连接外部数据库（MySQL/Redis），无法进行多线程处理，高频执行复杂命令会严重消耗服务器 TPS。

模组通过修改或注入（Mixin）游戏底层字节码来改变游戏。

编写难度：比较困难。 需要深厚的 Java 功底，且需要理解晦涩的 NMS（Minecraft 内部混淆名）源码。由于没有像插件那样的标准 API 封装，版本更新往往意味着大规模重构。
安装难度：门槛较高。 玩家必须安装对应的加载器，并保证客户端 Mod 列表与服务端完全一致。这对于获取散户玩家非常不利。
功能上限：无所不能。 模组可以修改客户端渲染，加入全新的 3D 模型、按键绑定和复杂的 GUI 界面。这是插件无法企及的。

插件是基于高度封装的 API（如 Paper API）开发的独立逻辑模块。

编写难度：中等偏上。 只要你有 Java 基础，配合详尽的 API 文档，你可以快速调用如 player.sendMessage() 这样语义化的方法。它拥有成熟的面向对象体系和庞大的开源库。
安装难度：完全零门槛（玩家无感）。 仅需在服务端文件夹放入 .jar 文件。玩家使用原版客户端直连，这是大型服务器（如 Hypixel）选择插件架构的核心原因。
功能上限：逻辑控制极强。 虽然不能像 Mod 那样自由地添加全新的 3D 渲染模型（注：现在可以通过资源包配合数据组件实现部分功能），但在逻辑控制、数据库交互、分布式部署方面，插件有着绝对的优势。

通过上面的对比，我们可以得出选择插件开发的三个核心理由：

开发效率与文档支持：Paper API 提供了极高的抽象，你不必关心底层复杂的 NMS 逻辑。同时，全球有数以万计的插件开发者，你遇到的 99% 的问题都能在社区找到答案。
极低的获客成本：在互联网时代，“门槛”就是流失率。插件不需要玩家下载复杂的整合包，原版即玩，这决定了你的服务器能够触达更广阔的玩家群体。
强大的工程化能力：插件本质上是标准的 Java 程序。你可以使用 Maven/Gradle 进行构建，可以使用分布式架构处理千万级数据，可以使用异步线程优化计算负载。这让 Minecraft 不再仅仅是一个游戏，更像是一个可以无限扩展的逻辑平台。

在接下来的课程中，我们将正式搭建开发环境，从最基础的 onEnable() 生命周期开始，一步步构建出属于你自己的 Minecraft 游戏世界。