原创 开源 娱乐 Alcohol —— 酿酒插件 2.0

[MD] # Alcohol 一个为 Minecraft 服务器打造的综合酿酒与种植插件，添加了完整的酿酒产业链、多种自定义机器、丰富的酒类与特殊效果，以及配套的配方查看和物品管理系统。 ## 简介 **Alcohol** 是一款功能丰富的 Paper 服务端插件，灵感来源于 *盛节精酿（Let's Do Brewery）* 与 *葡园酒香（Let's Do Vinery）*，为服务器带来从 **农作物种植 → 原料加工 → 酿造 → 陈酿 → 饮用** 的完整产业链。 ### 核心特色 - **50+ 种酒与饮料** 啤酒、威士忌、葡萄酒、陈酿酒、葡萄汁、苹果汁等，每种酒都有独特的外观、效果和酿造配方。 - **完整的种植系统** 玉米、樱桃、葡萄（含 8 种生物群系变种），支持自然生长、骨粉催熟、蜜蜂授粉，以及自定义掉落。 - **多台自定义机器** 烹饪锅、酿造炉、苹果压榨器、陈酿桶、葡萄藤盆、吧台音乐播放器，每台机器都有独立的 GUI 与进度机制。 - **酿造与陈酿机制** 通过酿造炉产出酒液，再经陈酿桶提升品质。酿造过程包含气压管理、燃料消耗与品质降级机制。 - **丰富的饮酒效果** 原版药水效果 + 自定义特殊效果（攀爬、水上行者、岩浆行者、猫娘、耄耋等），并配有冷却与提示。 - **配方查看器与物品获取 GUI** 通过 `/alcohol recipe` 查看所有机器的配方与合成方式，`/alcohol give` 快速获取插件物品。 - **村民交易** 农民村民会出售樱桃，不会影响原版交易内容。 - **持久化支持** 容器、植物、特殊效果、GUI 页码等数据在重启后自动恢复。 - **多语言支持** 简体中文、繁体中文、英文、日本语、韩语等，也可以自定义或者[贡献语言](https://crowdin.com/project/alcohol-plugin/invite?h=6860356982471666d58e2f04d2e76e872911003) ## 安装 ### 环境要求 | 项目 | 版本 | |------|------| | 服务端 | Paper 26.2 及以上 | | Java | Java 25 | | 依赖插件 | [NoteBlockAPI](https://www.spigotmc.org/resources/noteblockapi.19287/) 1.7.0+（用于吧台音乐播放器） | ### 安装步骤 1. **下载依赖** 将 `NoteBlockAPI-1.7.0.jar` 放入服务器的 `plugins/` 目录。 2. **下载插件** 将 `Alcohol.jar` 放入服务器的 `plugins/` 目录。 3. **启动服务器** 首次启动后，插件会在 `plugins/Alcohol/` 下生成数据目录与配置文件。 4. **添加自定义歌曲（可选）** 将 `.nbs` 歌曲文件放入 `plugins/Alcohol/songs/`，输入 `/alcohol reload` 即可加载。 5. **验证安装** 进入游戏后输入 `/alcohol help`，若能看到帮助列表即表示安装成功。 **⚠ 提示 首次启动后，插件会生成 `data.yml`、`effects.yml`、`config.yml` 和 `songs/` 目录。** ## 配置 ### 数据文件说明 | 文件 | 用途 | 保存时机 | |------|------|---------| | `data.yml` | 保存烹饪锅、酿造炉、苹果压榨器、陈酿桶、葡萄藤盆、玉米、葡萄、樱桃树等状态 | 每 5 分钟自动保存 + 关服保存 | | `effects.yml` | 保存玩家特殊效果、actionbar 显示、隐藏蜘蛛网坐标 | 效果变化时立即保存 + 每 30 秒兜底 | | `config.yml` | 插件语言设置 | 只读或由服主编辑时 | | `songs/` | 存放 `.nbs` 歌曲文件，自动加载到吧台音乐播放器 | 只读 | ### 歌曲添加 1. 用 [Note Block Studio](https://noteblock.studio/) 制作或下载 `.nbs` 文件。 2. 将文件放入 `plugins/Alcohol/songs/`。 3. 输入 `/alcohol reload` 或重启服务器。 4. 打开吧台音乐播放器 GUI，即可看到新歌。 ### 数据备份建议 | 文件 | 频率 | |------|------| | `data.yml` | 每周 | | `effects.yml` | 每周 | | `config.yml` | 非必要 | | `songs/` | 一次性（除非手动修改） | **⚠ 警告** **- 不要手动编辑 `data.yml` / `effects.yml`，YAML 格式错误会导致数据加载失败。** **- 升级插件时旧数据自动兼容，无需清空。** **- 删除 `data.yml` 会丢失所有容器与植物数据，请谨慎操作。** ## 命令 ### 通用指令 | 指令 | 说明 | 权限 | |------|------|------| | `/alcohol help` | 显示帮助列表 | 无 | | `/alcohol recipe` | 打开配方主界面 | `alcohol.recipe` | | `/alcohol recipe <机器> [craft]` | 查看指定机器的配方 / 合成方式 | `alcohol.recipe` | | `/alcohol give` | 打开物品获取 GUI | `alcohol.give` | | `/alcohol give <玩家> <物品> <数量>` | 给予指定玩家物品 | `alcohol.give` | | `/alcohol reload` | 重新加载插件与歌曲 | `alcohol.reload` | | `/alcohol kill <CatGirl\|MaoDie>` | 清除残留的猫娘 / 耄耋实体 | `alcohol.kill` | | `/alcohol refresh [all]` | 重刷玩家背包或机器物品 | `alcohol.refresh` | ### 权限节点 | 权限 | 说明 | 默认 | |------|------|------| | `alcohol.recipe` | 查看配方 | 所有玩家 | | `alcohol.give` | 获取 / 给予物品 | OP | | `alcohol.reload` | 重新加载插件 | OP | | `alcohol.kill` | 清除残留实体 | OP | | `alcohol.refresh` | 重刷物品 | OP | ### 支持的机器名称 `/alcohol recipe <机器>` 中可用的机器名： | 机器名 | 中文 | |--------|------| | `CookingPot` | 烹饪锅 | | `BrewingBox` | 酿造炉 | | `ApplePress` | 苹果压榨器 | | `AgingBarrel` | 陈酿桶 | | `GrapeBasin` | 葡萄藤盆 | | `MusicPlayer` | 吧台音乐播放器 | ## 问题 如果你发现问题或者 Bug，请打开 [Issue](https://github.com/xiaomian124/Alcohol/issues) 或者在 [xiaomian124.top](https://xiaomian124.top/guestbook) 进行反馈。 ## 为我发电 感谢你对我插件的支持！无论金额多少，都是我前进的动力！>> [为我发电](https://ifdian.net/a/xiaomian124) ## 版权与致谢 本插件的玩法设计灵感来源于以下模组： - **盛节精酿（Let's Do Brewery）** —— 作者：[satisfyu](https://github.com/satisfyu) - **葡园酒香（Let's Do Vinery）** —— 作者：[satisfyu](https://github.com/satisfyu) 本插件为**独立实现**，未使用原模组中采用 ARR 协议的任何资源文件。 详细声明见 [NOTICE](https://github.com/xiaomian124/Alcohol/blob/main/NOTICE.md)。 **⚠ 提示 本项目采用 GNU General Public License v3.0 协议开源。 详见 [LICENSE](https://github.com/xiaomian124/Alcohol/blob/main/LICENSE.txt)。** [/MD]

---

[MD] *尽情享受酿造与种植的乐趣吧！* [/MD]