PaperMC 项目安装与使用教程

PaperMC 是一个基于 Minecraft 的服务器软件，旨在提供比原版 Minecraft 服务器更高的性能和可定制性。本教程将引导您了解其基本结构、启动流程以及关键配置文件，帮助您快速上手 PaperMC。

1. 项目的目录结构及介绍

在克隆或下载 https://github.com/PaperMC/papermc.io.git 后，实际的服务器核心代码和运行文件并不直接位于这个仓库中。该仓库主要是PaperMC的官网源码，包括了前端页面、API接口等，而非直接部署的服务器软件包。不过，为了指导目的，我们可以假设您已经从PaperMC的发布页获取了对应的服务器软件包，一般情况下，典型的PaperMC服务器包解压后的目录结构大致如下：

paper/
|-- bin/            # 存放Java可执行文件或其他二进制工具（在实际发布包中不常见）
|-- server.properties   # 服务器的主要配置文件
|-- ops.json          # 拥有操作权限的玩家列表
|-- whitelist.json    # 白名单，指定允许登录的玩家名单
|-- eula.txt          # 接受EULA许可协议文件，需手动修改为eula=true启用服务器
|-- paper.jar         # 主要的启动文件，包含PaperMC服务器程序
|-- plugins/         # 插件存放目录
|-- logs/             # 运行日志存放目录

2. 项目的启动文件介绍

主要启动文件：paper.jar

• 作用：这便是您运行PaperMC服务器的核心文件。通过命令行界面，使用Java运行此JAR文件即可启动Minecraft服务器。
• 启动命令示例：在终端或命令提示符中输入 java -Xmx1024M -Xms1024M -jar paper.jar nogui 来启动服务器，其中-Xmx和-Xms分别指定了最大和最小内存分配。

3. 项目的配置文件介绍

server.properties

• 重要性：服务器的核心配置文件，控制着服务器的基础行为，如端口、是否开启在线模式、服务器名称等。
• 部分关键配置举例：
  • server-port=25565 - 指定服务器监听的端口号。
  • online-mode=false - 是否验证玩家的游戏账号，设置为true时要求玩家有有效的Minecraft账户。
  • motd=A PaperMC Server - “Message of the Day”，显示给连接玩家的信息。

ops.json

• 功能：列出具有操作员权限的玩家列表，以便他们可以执行管理命令。

whitelist.json

• 说明：当开启白名单时，仅在此文件内列出的玩家才能加入服务器。

请注意，对于具体的配置细节，应参考PaperMC的官方文档或社区讨论以获得最新且详细的信息。此外，实际部署时确保阅读并遵守EULA协议。