# 🌌 AOneBlock – 一块，无限冒险
**欢迎来到 AOneBlock 的世界 — 你的整个世界从太空中的一块神奇方块开始。**
AOneBlock 是一个 **支持多人游戏** 的热门生存概念 OneBlock 的创新，最初由 *IJAminecraft* 为单人游戏创建。这款插件基于 **BentoBox 平台** 构建，让你的玩家可以体验一场史诗般的旅程 — 从一无所有开始，只需一个方块……然后建立一个繁荣的世界。
---
## 🎮 什么是 AOneBlock？
- 🧱 **从一个方块开始** — 漂浮在虚空中。
- 🪓 **破坏它**，另一个就会出现。
- 🌀 **通过阶段进行** — 如 *平原*、*地下*、*下界*、*末地* 等。
- ⛏️ **生存、收集和扩张** — 每个方块都至关重要！
每个 AOneBlock 世界都充满了 **超过 12,000 个独特的方块放置点**，通过主题阶段演变，改变节奏、资源和挑战。当玩家完成所有阶段后，循环将再次开始 - 确保长期的可玩性。
AOneBlock 受 SkyBlock 的启发，但提供 **截然不同的游戏体验**：
- 资源稀缺性不同（例如，早期获取水更困难）。
- 无需鹅卵石发生器 — 方块会提供你需要的东西。
- 玩家获得 **一种全新的挑战**，奖励策略和坚持。
---
## ⚙️ 安装指南
> **AOneBlock 需要 [BentoBox](https://bentobox.world) 插件才能运行。**
### 详细步骤：
1. ⬇️ **下载并安装 BentoBox**。
2. 📂 将 `AOneBlock.jar` 放入：
`plugins/BentoBox/addons`
3. ▶️ 启动服务器。
4. 🗂 将创建一个数据文件夹，其中包含 `config.yml` 和阶段配置文件。
5. 🔑 登录并输入 `/ob` 开始！
6. *(可选)*:
7. ⛔ 停止服务器。
8. 🛠️ 编辑 `config.yml` 或任何阶段 `.yml` 文件。
9. 🗑️ 如果需要，删除生成的地图。
10. 🔄 重启服务器。
---
## 🧰 功能和自定义
- 12 个可完全自定义的 **游戏阶段**
- 数百种方块类型、物品、生物和战利品
- 开箱即用 — 或者使用以下内容进行定制：
- 阶段配置
- BentoBox 设置
- 增强游戏体验的插件
---
## 💬 命令概览
- **玩家命令**: `/ob`
- **管理员命令**: `/oba`
- 查看帮助: `/ob help` 或 `/oba help`
📖 查阅 [BentoBox 文档](https://docs.bentobox.world) 以获取高级设置、占位符和权限信息。
---
## ❓ 常见问题解答
**Q: 有哪些可用的阶段？**
**A:** 有 12 个阶段：
> *平原、地下、冬季、海洋、丛林、沼泽、地牢、沙漠、下界、丰富、荒芜、深邃黑暗* 和 *末地*。
**Q: 一个单一的运行有多少个方块？**
**A:** 大约 **12,000 个方块** — 足以让玩家忙碌几天或几周！
**Q: 完成所有阶段后会发生什么？**
**A:** 循环将再次开始 — 回到 *平原* 开始。
**Q: 为什么我不断地掉落并死亡！？**
**A:** 有生存技巧，但这可能很困难！ 你需要建造空间以避免掉落。
**Q: 我无法抓住我开采的方块！我该如何做？**
**A:** 你不能抓住它们全部，但它是一个无限方块！
**Q: 为什么有些方块比其他方块生成得更频繁？**
**A:** 它们就是如此！是随机的。 你可以在阶段文件夹中的配置文件中设置相对概率。 管理员也可以在特定时间强制生成特定方块。（注意海绵！）
**Q: 我如何知道哪个是魔法方块？**
**A:** 打击它会发出绿色的粒子 — 它位于你岛屿的中心。
**Q: 我的魔法方块不见了！我如何得到另一个？**
**A:** 在原始位置放置一个方块。 如果需要，死亡并重生 — 将会生成一个新的。
**Q: 我的魔法方块是液体！我如何开采它？**
**A:** 使用水桶。
**Q: 可以生成哪些生物？**
**A:** 每个阶段都包含不同的生物。 小心 — 它们可能会把你撞下！ 采矿时请仔细倾听。
**Q: 我没有反应时间来应对敌对生物的生成！**
**A:** 做好准备！ 敌对生物在生成之前会发出噪音。 从远处开采并建造防御工事。
**Q: 生物生成时，我的防御被摧毁了！为什么？**
**A:** 生物在生成时会清理空间。 它们路上的方块将会被破坏和掉落。相应地设计你的防御工事。
**Q: 箱子会生成吗？**
**A:** 是的！ 它们会随机出现，并与当前阶段相匹配。 有普通、罕见、稀有和史诗般的箱子。 闪闪发光的箱子很有价值！
**Q: 可以在该地图中到达下界或末地吗？**
**A:** 你可以访问原版的下界，但末地是一个阶段，而不是一个维度。
**Q: 最终目标是什么？**
**A:** 无论你希望它是什么。
⸻
🧾 阶段配置文件
阶段位于阶段文件夹中。 每个阶段都有两个文件：
• 一个用于方块和生物。
• 一个用于箱子。
文件中第一个数字 = 到达该阶段所需的方块数。
每个阶段包含：
• 名称
• 图标
• 固定方块
• 全息图
• 生物群系
• 开始命令、结束命令、首次结束命令
• 要求
• 方块
• 生物
箱子文件包含：
• 阶段编号
• 一个箱子：部分
🔖 名称
阶段的名称。
🧱 图标
用作视觉图标的方块。
📌 固定方块
将在阶段内特定相对计数值处始终出现的方块。
✨ 全息图
在关键方块计数值时出现的浮动文字行。 无需插件。
🌎 生物群系
定义阶段的生物群系。
🧩 命令
在阶段开始或完成时运行控制台或玩家命令。 使用占位符：
• [island], [owner], [player], [phase], [blocks], [level], [bank-balance], [eco-balance]
示例：
start-commands:
- ‘give [player] WOODEN_AXE 1’
- ‘broadcast [player] just started OneBlock!’
end-commands:
- ‘[SUDO]summon minecraft:wither’
end-commands-first-time:
- ‘broadcast &c&l[!] &b[player] &fhas completed the &d&n[phase]&f phase for the first time.’
🧾 要求
进入阶段的条件：
• economy-balance
• bank-balance
• level
• permission
示例：
requirements:
bank-balance: 10000
level: 10
permission: ready.for.battle
🧱 方块
定义方块类型及其概率。
🐾 生物
列出生物及其概率。 仅限于活体/可生成实体。
🎁 箱子
定义战利品表。 使用以下方式在游戏内设置:
/oba setchest
箱子存储在 oneblocks.yml 中。 可以手动编辑，但必须使用有效的 Bukkit 材料名称。
⸻
🔌 插件和扩展
你可以添加 BentoBox 插件，例如：
• ✅ 挑战
• ✅ 点赞
• ✅ 等级
• ✅ 传送点
…但它们是可选的。
⸻
🛠️ 错误和功能请求
📬 提交问题或建议：
https://github.com/BentoBoxWorld/OneBlock/issues
---
## 🔧 兼容性
我们专注于 **最新版本的 Minecraft**，但早期版本也受支持！
从 **下载网站的自定义选项卡** 或 **[GitHub 发布页面](https://github.com/BentoBoxWorld/AOneBlock/releases)** 获取它们。
---
## 💬 支持和贡献
- 有问题或需要帮助吗？
👉 加入我们的 **[Discord 支持服务器](https://discord.gg/sbPeyfw)**
- 发现错误或有建议吗？
👉 在 **[GitHub](https://github.com/BentoBoxWorld/AOneBlock/issues)** 上提出问题
> 这是一项由社区驱动的项目，由志愿者创建。 感谢您成为旅程的一部分！