安装指南

本指南将帮助你在服务器上安装和配置 ProjectE 插件。

前置要求

在安装 ProjectE 之前，请确保你的服务器满足以下要求：

必需条件

Minecraft 版本: 1.16.5 或更高版本（推荐 1.20+）
服务端类型: Spigot 或 Paper（强烈推荐使用 Paper）
Java 版本: Java 17 或更高版本（推荐 Java 21）
服务器权限: 需要有服务器文件的访问权限

可选依赖

Geyser: 如果需要支持基岩版玩家（实验性功能）
Folia: 如果使用 Folia 多线程服务端

安装步骤

1. 下载插件

从以下渠道下载最新版本的 ProjectE 插件：

下载 ProjectE-x.x.x.jar 文件（x.x.x 是版本号）。

2. 安装插件文件

找到你的服务器根目录
进入 plugins 文件夹（如果不存在则创建）
将下载的 ProjectE-x.x.x.jar 文件复制到 plugins 文件夹中

服务器根目录/
├── plugins/
│   └── ProjectE-1.2.4.jar  ← 放在这里
├── world/
├── server.jar
└── ...

3. 安装资源包和数据包（推荐）

ProjectE 提供了官方资源包和数据包，以获得最佳的视觉体验。

安装资源包

在 plugins/ProjectE/pack/ 目录下找到 ProjectE Resourcepack.zip
将资源包上传到你的服务器或文件托管服务
在 server.properties 中配置资源包 URL：

resource-pack=https://your-server.com/ProjectE-Resourcepack.zip
resource-pack-sha1=<SHA1哈希值>
require-resource-pack=false

安装数据包

在 plugins/ProjectE/pack/ 目录下找到 ProjectE Datapack.zip
将数据包解压到世界文件夹的 datapacks 目录：

world/
└── datapacks/
    └── ProjectE Datapack/
        ├── data/
        └── pack.mcmeta

重新加载数据包：

/reload

4. 启动服务器

启动或重启你的 Minecraft 服务器
观察控制台输出，确认插件正确加载

你应该看到类似以下的输出：

[ProjectE] Enabling ProjectE v1.2.4
[ProjectE] Loading configuration files...
[ProjectE] Loading EMC values...
[ProjectE] Registering recipes...
[ProjectE] ProjectE has been enabled successfully!

5. 验证安装

在游戏中或控制台执行以下命令来验证安装：

/projecte

如果看到插件的帮助菜单，说明安装成功！

首次配置

生成的文件结构

首次启动后，插件会在 plugins/ProjectE/ 目录下生成以下文件：

plugins/ProjectE/
├── config.yml              # 主配置文件
├── accessories.yml         # 饰品配置
├── command.yml            # 指令配置
├── condenser.yml          # 凝聚器配置
├── condenser_mk2.yml      # MK2凝聚器配置
├── custommoditememc.yml   # 自定义EMC值
├── darkmatterfurnace.yml  # 暗物质熔炉配置
├── devices.yml            # 设备配置
├── mapping.yml            # 物品映射
├── op_item.yml            # OP物品配置
├── recipe.yml             # 配方配置
├── redmatterfurnace.yml   # 红物质熔炉配置
├── lang/                  # 语言文件
│   ├── zh_cn.yml
│   ├── en_us.yml
│   └── lzh.yml
├── pack/                  # 资源包和数据包
│   ├── ProjectE Resourcepack.zip
│   └── ProjectE Datapack.zip
└── data/                  # 数据存储
    └── players/           # 玩家数据

基础配置

编辑 config.yml 进行基础配置：

# 语言设置
language: zh_cn

# EMC 设置
emc:
  # 是否启用 EMC 系统
  enabled: true
  # 默认 EMC 倍率
  multiplier: 1.0

# 转换桌设置
transmutation-table:
  # 是否启用转换桌
  enabled: true
  # 学习模式 (NORMAL/CREATIVE)
  learn-mode: NORMAL

# 资源包设置
resource-pack:
  # 是否强制使用资源包
  force: false
  # 资源包 URL
  url: ""