高级插件 - EpicExoticGarden 是一款适用于 Minecraft 服务器的独立异域园艺和农场插件

支持版本

1.12.X
1.13.X
1.14.X
1.15.X
1.16.X
1.17.X
1.18.X
1.19.X
1.20.X
1.21.X
26.X

史诗异域花园 | 异域园艺场 WIKI

🌿 EpicExoticGarden（异域花园 / EEG） | EPIC 系列插件 WIKI

EPIC 系列插件官方文档

quantifyingepic.linchangqing.online

EpicExoticGarden（异域花园 / EEG）
一款面向 Paper/Spigot 的**独立植物、农业、美食与自然扩展插件**。灵感源自经典 Slimefun 附属 *ExoticGarden*，但**完全独立运行，无需安装 Slimefun**。
种植异域灌木与果树、收获魔法作物、烹饪数十道菜肴、调制果汁冰沙——一切都基于**原版 Minecraft 机制**。一个通用 jar，同时支持 **1.12.x 至最新版本**。
---
##

功能特性
-

**异域果树与灌木** —— 葡萄、草莓、樱桃、柠檬、火龙果、菠萝等数十种，种在泥土上，徒手收获
-

**魔法作物** —— 可合成的资源作物（泥土、煤炭、铁、金、红石、钻石……），精华可转化回原版资源
-

**200+ 种物品** —— 水果、原料（面粉、盐、黄油、奶酪……）、工具（Crook 钩子）、熟食、果汁、冰沙与茶饮
-

**原版药水饮品** —— 带颜色的药水，通过饱和效果恢复饱食度，没有任何自定义进食系统
-

**融入自然世界** —— 灌木与果树会自然散落在新生成的区块中；打高草丛有几率掉落种子、灌木和树苗
-

**游戏内图鉴 EpicGuide** —— 分页分类的配方手册，查看每件物品的获取方式与合成配方
-

**配方与饱食度完全可编辑** —— 七个易读的 YAML 文件，配方不写死，不改代码
-

**内置 10 种语言** —— en、de、es、fr、it、nl、pl、pt-BR、ru、zh-CN，可在磁盘上覆盖或新增译文
-

**零依赖** —— 不需要 Slimefun、不需要资源包、不需要 ProtocolLib，丢进 plugins 即可游玩
---
##

安装方法
1. 从 [Releases](https://github.com/kobayashi-007/EpicExoticGarden/releases) 下载 `EpicExoticGarden v1.0.0.jar`
2. 放入服务器的 `plugins/` 文件夹
3. 启动服务器，自动生成 `plugins/EpicExoticGarden/` 目录：
<div class="code-window">
<div class="code-window-bar">
<span class="dot red"></span>
<span class="dot yellow"></span>
<span class="dot green"></span>
<span class="code-window-title">EpicExoticGarden 目录结构</span>
</div>
<pre class="code-window-body"><code>plugins/EpicExoticGarden/
├─ config.yml
├─ recipe/ # 可编辑的配方与饱食度
│ ├─ plants.yml # 植物
│ ├─ fruits.yml # 果实
│ ├─ ingredients.yml # 原料
│ ├─ tools.yml # 工具
│ ├─ dishes.yml # 菜肴
│ ├─ drinks.yml # 饮品
│ └─ magicalcrops.yml # 魔法作物
├─ languages/ # 按语言覆盖物品名与界面文案
└─ schematics/</code></pre>
</div>
环境要求：Paper/Spigot 系服务端、**Minecraft 1.12.x 或更高版本**、Java 8+。
---
##

命令
| 命令 | 说明 |
|---|---|
| `/epicgarden` 或 `/eeg` | 打开图鉴 |
| `/eeg guide` | 打开图鉴 |
| `/eeg give <物品ID> [数量] [玩家]` | 发放 EEG 物品（ID 支持 Tab 补全） |
| `/eeg reload` | 重载配置、语言与饱食度 |
| `/eeg debug` | 查看物品/方块/配方数量与当前语言 |
---
##

权限
| 权限节点 | 默认 | 说明 |
|---|---|---|
| `epicexoticgarden.use` | 所有人 | 使用全部插件内容 |
| `epicexoticgarden.guide` | 所有人 | 打开图鉴 |
| `epicexoticgarden.give` | OP | 发放物品 |
| `epicexoticgarden.reload` | OP | 重载插件 |
| `epicexoticgarden.debug` | OP | 查看调试信息 |
| `epicexoticgarden.pack` | OP | 资源包管理 |
| `epicexoticgarden.admin` | OP | 完整管理权限 |
---
##

配置文件（`config.yml`）
```yaml
# 物品名/界面语言：en, de, es, fr, it, nl, pl, pt-BR, ru, zh-CN
language: en
# 打高草丛时可能掉落的物品（6% 概率）。自定义灌木/树苗首次启动自动登记，
# 把某个条目设为 false 即可禁用对应掉落
grass-drops: {}
# 异域植物永不自然生成的世界
world-blacklist:
- world_nether
- world_the_end
# 每个新区块的生成概率（百分比 0-100）
chances:
TREE: 22
BUSH: 16
```
---
##

修改配方与饱食度
打开 `plugins/EpicExoticGarden/recipe/` 下任意文件：
```yaml
HAMBURGER:
hunger: 10 # 恢复饱食度 0-20
enabled: true # 设为 false 则不注册该配方
amount: 1 # 产出数量
type: SHAPELESS # 或 SHAPED（有序合成）
ingredients:
- BREAD
- COOKED_BEEF
- LETTUCE
```
有序合成示例：
```yaml
CROOK:
hunger: 0
enabled: true
amount: 1
type: SHAPED
pattern:
- "SS"
- " S"
- " S"
ingredients:
S: STICK
```
**令牌规则**
- 自定义物品用物品 ID：`BUTTER`、`GRAPE_JUICE`
- 原版物品用现代材质名：`SUGAR`、`COOKED_BEEF`
- `:数字` 表示重复材料：`DIRT_ESSENCE:8`
- 修改饮品的 `hunger` 会同步改写饱和药水效果时长，保证说明文字与实际回复量一致
**重载规则**
- 饱食度与译文：`/eeg reload` 即时生效
- 合成配方：需重启服务器（Bukkit 无法跨版本可靠注销配方）
- 插件更新后新增物品会**追加**进已有文件，永远不会覆盖你的修改
---
##

翻译与汉化
所有玩家可见文案都在 `languages/<语言>/items.yml` —— 物品名、饱食度模板、图鉴与 GUI 的全部文字。缺少的键自动回退英文；磁盘文件始终优先于 jar 内置默认值，更新后新键会自动合并补齐。
---
##