Bentobox 帮助文档翻译 - 联机教程

Jeansou

本帖最后由 Jeansou 于 2023-2-17 11:21 编辑

本贴施工中...
此贴更新可能不及时，最新翻译请至 BentoBox 帮助文档

BentoBox

BentoBox 是一个岛屿生存类游戏的核心插件，它可以提供像 SkyBlock, AcidIsland, OneBlock 那样的游戏模式. BentoBox 是集岛屿地形生成, 团队管理, 岛屿保护等功能于一体的插件. 更多功能还可以通过添加 BentoBox 扩展来实现 (你可以理解为迷你插件). 服主们可以自由地对插件进行个性化配置.

插件下载

你可以在 https://download.bentobox.world 上下载预配包

2021.12 数据，可能有更多内容

# Bentobox

Bentobox 是许多岛屿游戏的前置插件，比如 AcidIsland 和 BSkyBlock。它可提供像岛屿创建、团队管理、岛屿保护等的功能。当然这些游戏和功能需要附属插件来支撑。管理员可以自定义他们需要的功能。

## 支持 BentoBox

通过成为 [sponsor through GitHub](https://github.com/sponsors/tastybento) 或 [donate via PayPal](https://www.paypal.me/BentoBoxWorld) 来赞助作者. 我们希望你会喜欢我们的作品!

## 下载

在 [https://download.bentobox.world](https://download.bentobox.world/) 下载懒人包
## 游戏模式

Bentobox 目前提供以下游戏模式：

- BSkyBlock - 你们应该都知道
- AcidIsland - 在酸海中生存
- CaveBlock - 咚咚咚咚咚帕
- SkyGrid - 恐怖的网状地图
- AoneBlock - 你出生在一个石头上，然后呢？

## 快速入门

安装 Bentobox

### 视频教程（英文）
https://www.bilibili.com/video/BV1Qc411h7Ug/
### 说明

Bentobox 是一个强大且仅有的插件。以下是经 Bentoboxworld 讨论得出的最简洁的安装方法。

相比其他 Spigot 插件的拖拽式安装，Bentobox 的安装可能会花费一些时间，但是你值得花费这些时间来为你的服务器带来无穷可能。

让我们开始吧！

------

### 下载 Bentobox

稳定版目前可在 [Spigot 论坛页面](https://www.spigotmc.org/resources/bentobox-skyblock-acidisland-skygrid-caveblock.73261/)或 [GitHub `release` 页面](https://github.com/BentoBoxWorld/bentobox/releases)下载。**未经测试**的开发版可在 [Jenkins](https://ci.codemc.org/job/BentoBoxWorld/job/BentoBox/) 下载。

### 配置 BentoBox

插件下载完成后，你需要把它丢到服务器的 `plugins` 文件夹。与 ASkyBlock 不同的是 BentoBox 不需要任何前置插件：但是它会[自动与某些插件绑定](https://github.com/BentoBoxWorld/bentobox/wiki/Hooks)来增强插件的功能。（比如 Vault、PlaceholderAPI、Multiverse-Core 等）

启动服务器并等待插件完全加载。如果你现在进入服务器，你会发现服务器什么也没有发生。事实上，**BentoBox 本身没有任何作用**：你只有给它添加[插件](https://github.com/BentoBoxWorld/bentobox/wiki/Addons)才能让它“学会”运行一个 SkyBlock 游戏。

OK，现在关闭你的服务器。我们来看看 BentoBox 的配置文件 `config.yml`

### 安装扩展

扩展系统是 BentoBox 的特殊所在。但是，这不是普通的扩展：你不能把它们放在 `plugins` 文件夹。

首先你需要下载你所需要的扩展。官方扩展可在这里找到，同样它们需要在 `Release` 页面下下载。此[网站](https://download.bentobox.world/)可以帮助你更容易地下载插件。

最后你需要将下载的扩展放到 `plugins\BentoBox\addons` 文件夹。启动你的服务器以生成配置文件。为避免造成数据丢失或服务器崩溃，请关闭服务器后再对配置文件进行编辑。

请注意扩展可能与你正在使用的 BentoBox 版本不兼容。官方扩展**都会**说明它所支持的版本。一般向上兼容。
转换 ASkyBlock 到 BSkyBlock

###视频教程
https://www.bilibili.com/video/BV1Dz411b711/
### 兼容性

转换器应与最新版 BentoBox、BSkyBlock 一起使用。这是一个 BentoBox 插件，你需要把它放到 BentoBox 扩展文件夹。

### 说明

此插件将 ASkyBlock 的数据导入到 BentoBox/BSkyBlock 中。以下项目将被导入：

- 玩家和队伍
- 岛屿
- 传送点
- 大多数配置
- 挑战

以下项目不会被导入：

- Schematics - 不再支持。请使用 BentoBox 蓝图。
- 生物群系 - 不再独立支持。请使用 Biome 扩展。
- Magic Cobblestone - 不再独立支持。该扩展正在开发中
- 酸水/酸雨设置 - 不再支持
- 团队频道 - 不再支持
- Coop conversation - 机制变化，需要玩家手动重做。
- 等级相关设置 - 不再独立支持，请使用 Level 扩展。

### 备份

**警告：**此操作可能损坏服务器，请确保你已经备份所有的服务器文件。

### 准备工作

**注意：**这不会对 ASkyBlock 的世界做出任何改变，除非你也升级了服务端。转换完成后，你仍可以使用旧世界。

如果你正在使用 1.12.2 那么你必须将你的服务端升级至最新的 Minecraft 版本。

### 步骤

**注意:** 如果你的 ASkyBlock 世界类型为放大化，你将需要调高服务器的超时时间以免服务器被 Watchdog 关闭。

*一定要备份哦！*

1. 打开 spigot.yml 并调高 **timeout-time**，比如 60000
2. 关闭服务器，把 Spigot 1.14.4+ 的服务端 jar 文件放到服务器所在文件夹
3. 删除 ASkyBlock.jar 。**不要**删除 ASkyBlock 文件夹和世界！
4. 安装 BentoBox 1.12.0 以上版本
5. 给服务器启动脚本添加 **--forceUpgrade** 并启动，这将把所有世界升级至最新版本的格式
6. 看到 BentoBox 图案后，关闭服务器
7. 安装 **BSkyBlock** 扩展、**Challenges** 扩展、**Warps** 扩展和**Converter** 扩展
8. 启动服务器，不要删除 **--forceUpgrade**
9. 服务器启动后（看到 BentoBox 的 logo 后），输入指令: **bsb convert**
10. 转换结束后，关闭服务器。**！！！关闭服务器而不是输入 reload！！！**，否则岛屿世界管理将不能正常工作。
11. 根据你的需要编辑 BSkyBlock 的配置文件
12. 编辑 spigot.yml 并恢复 **timeout-time** 的原始大小: 比如 60
13. 移除 converter 扩展并删除**自动生成**的 BSkyBlock **默认**世界
14. 删除 --forceUpgrade 并启动服务器。

**注意:** BentoBox 使用 PAPI 或 MVdW 变量。详细信息请看变量章节。

**注意:** Challenges 及 Warps 扩展不是必需的。
数据库转换

BentoBox 的默认数据文件是一个 JSON 文档，但你可能想把数据存储在其它地方比如 MySQL。这里以 JSON 转 MySQL 为例。
步骤
- 关闭服务器
- 备份当前的数据
- 打开 BentoBox 的配置文件，设置存储方式为 JSON2MYSQL
- 确保你已经填写了 MySQL 的相关信息，且数据库已创建，MySQL 版本推荐 5.7 以上
- 如果数据很多，请调大服务器的超时时间以免转换失败
- 启动服务器，转换将立即开始
- 服务器启动完成后，输入 bbox migrate 指令以转换 Addon 数据
- 最后，你可以把存储方式改为 MYSQL（本步骤可不做）

## 关于 BentoBox

指令

可用指令(1.6.0)

指令
权限
作用
/bentobox [help/h]
bentobox.admin
显示所有可用指令
/bentobox about
bentobox.about
显示版权和授权信息
/bentobox catalog
bentobox.admin.catalog
显示目录
/bentobox locale
bentobox.admin.locale
分析语言文件
/bentobox manage/overview
bentobox.admin.manage
显示管理面板
/bentobox migrate
bentobox.admin.migrate
将数据从一个数据库迁移到另一个数据库
/bentobox reload/rl
bentobox.admin.reload
重载插件、配置、语言
/bentobox version/v/versions/addons
bentobox.version
显示 BentoBox 及其插件版本

如果你需要报告错误或者请求帮助，请附上插件版本
权限
- BentoBox 权限（用 Markdown 写的表格不知道为什么前面会有空白）
  
  | 权限 | 父权限 | 默认给予 | 作用 |
  | ---------------------- | -------------- | -------- | -------------------------------- |
  | bentobox.admin | | op | 允许执行几乎所有的 BentoBox 指令 |
  | bentobox.admin.catalog | bentobox.admin | op | 允许使用 /bentobox catalog |
  | bentobox.admin.locale| bentobox.admin | op | 允许执行 /bentobox locale |
  | bentobox.admin.manage| bentobox.admin | op | 允许执行 /bentobox manage |
  | bentobox.admin.migrate | bentobox.admin | op | 允许执行 /bentobox migrate |
  | bentobox.admin.reload| bentobox.admin | op | 允许执行 /bentobox reload |
  | bentobox.about | | 所有玩家 | 允许执行 /bentobox about |
  | bentobox.version | | 所有玩家 | 允许执行 /bentobox version |
- AcidIsland 权限
  
  | **权限** | **默认给予** | **作用** |
  | ----------------------------------- | ------------ | -------------------------------------- |
  | acidisland.admin.clearresetall | op | 允许重置所有玩家岛屿重置次数 |
  | acidisland.admin.delete | op | 彻底删除一个玩家（包括岛屿） |
  | acidisland.admin.deleteisland | op | 删除脚下的岛屿 |
  | acidisland.admin.noban | op | 不可被封 |
  | acidisland.admin.purge | op | 允许清除旧岛屿 |
  | acidisland.admin.register | op | 把距离最近的一个岛屿的所有权给予某玩家 |
  | acidisland.admin.reload | op | 重载 config.yml |
  | acidisland.admin.reserve | op | 将一空区域设为某玩家的下一个岛屿所在地 |
  | acidisland.admin.setlanguage | op | 重置所有玩家的语言并设定默认语言 |
  | acidisland.admin.setrange | op | 允许调整岛屿保护半径 |
  | acidisland.admin.setspawn | op | 允许使用出生点工具 |
  | acidisland.admin.settingsreset | op | 重置所有岛屿的保护设置 |
  | acidisland.admin.unregister | op | 移除玩家对岛屿的所有权但不删除岛屿 |
  | acidisland.mod.bypasscooldowns | op | 绕过冷却时间 |
  | acidisland.mod.bypassexpel | op | 无视岛屿逐客令 |
  | acidisland.mod.bypasslock | op | 无视岛屿锁定 |
  | acidisland.mod.bypassprotect | op | 无视岛屿保护 |
  | acidisland.mod.clearreset | 无 | 清除岛屿重置限制 |
  | acidisland.mod.info | op | 查看玩家信息 |
  | acidisland.mod.lock | op | 锁定或解锁岛屿 |
  | acidisland.mod.name | 无 | 命名玩家岛屿 |
  | acidisland.mod.noburn | op | 不会被酸水腐蚀 |
  | acidisland.mod.resethome | op | 设置或重置玩家重生点 |
  | acidisland.mod.resetname | 无 | 重置玩家岛屿名 |
  | acidisland.mod.team | 无 | 管理队伍 |
  | acidisland.mod.tp | op | 传送到一个岛屿 |
  | acidisland.island | 所有玩家 | 使用 **/island** 指令 |
  | acidisland.island.ban | 无 | 允许封禁某一游客 |
  | acidisland.island.create | 所有玩家 | 创建岛屿 |
  | acidisland.island.expel | 所有玩家 | 允许下逐客令 |
  | acidisland.island.home | 所有玩家 | 允许传送到自己的岛屿 |
  | acidisland.island.info | 所有玩家 | 查看岛屿等级 |
  | acidisland.island.language | 所有玩家 | 选择语言 |
  | acidisland.island.lock | 无 | 允许锁岛 |
  | acidisland.island.name | 所有玩家 | 设置自己岛屿的名字 |
  | acidisland.island.reset | 所有玩家 | 可以重置岛屿 |
  | acidisland.island.sethome | 所有玩家 | 设置岛屿重生点 |
  | acidisland.island.settings | 所有玩家 | 查看服务器设置 |
  | acidisland.island.spawn | 所有玩家 | 回到重生点 |
  | acidisland.island.team | 所有玩家 | 使用队伍指令 |
  | acidisland.island.team.coop | 所有玩家 | 使用团队合作指令 |
  | acidisland.island.team.trust | 所有玩家 | 添加信任玩家 |
  | acidisland.settings.* | 所有玩家 | 使用控制面板 |
  | acidisland.team.maxsize.[NUMBER] | 无 | 获得更大的队伍 |
  | acidisland.island.maxhomes.[NUMBER] | 无 | 设置更多家. |
  | acidisland.island.range.[NUMBER] | 无 | 获得更大的岛屿保护范围 |
- BSkyBlock 权限
- CaveBlock 权限
- SkyGrid 权限
- Biomes 权限
- Challenges 权限
  
  由于此插件可用于多种游戏模式，在使用时需要加上 bskyblock 等前缀，比如在空岛世界打开挑战菜单的命令为 /bskyblock challenges
- Level 权限
- Limits (addon.yml)权限
岛屿保护、标签、等级设置

## 岛屿保护, 属性 & 等级设置

### 说明

所有实体在岛屿上的行为都可以通过设置属性来约束。大多数标签由 BentoBox 提供，但某些插件也提供一些属性。

标签大全[见此](https://github.com/BentoBoxWorld/BentoBox/wiki/Flags)，或见下一节

### 设置中心

岛屿所有者可通过设置中心调整岛屿设置。其他玩家（包括岛屿成员）只能查看。

要打开此菜单请使用 `/[player_command] settings` 指令（权限：`[gamemode].island.settings`）

管理员可通过 `/[admin_command] settings <玩家名>` 指令强制改变岛屿设置

#### 保护设置

该页面为设置中心的首页面。它包含保护属性

该属性通过判断玩家等级保护岛屿。左右键点击属性图标来改变设置

大多数属性的默认设置为允许岛屿所有者以上的等级做出该行为。但是某些属性也允许游客。

管理员可设置岛屿保护范围以外的保护设置(`/[管理员指令] settings`)

#### 设置页面

#### 显示模式

#### 隐藏属性

(BentoBox 1.4.0+)管理员可通过按下 Shift+左键 (如果你的潜行键不是 Shift 请使用你所设置的潜行键+左键单击) 来隐藏某一属性。隐藏后该图标将具有消失诅咒附魔且在玩家菜单中消失。要恢复显示，按下 shift + 左键

### 等级

- 被封禁: -1（部分未使用）
- 游客：0
- 合作者：200
- 受信任：400
- 成员：500
- 副岛主：900
- 岛屿主：1000
- MOD：5000（未使用）
- 管理员：10000 (未使用)

### 绕过保护

### 管理员设置中心

#### 全局设置

#### 全局默认保护设置
- 岛屿属性
  
  ### 什么是岛屿属性
  
  BentoBox 的岛屿属性与 WorldGuard 的区域属性相似：它们都用于允许或禁止某些事情的发生。
  
  ### 这是属性介绍列表
  
  (更新于 2019/8/16)
  
  - ANIMAL_SPAWN: 启用 = 允许动物生成禁用 = 禁止动物生成
  - ANVIL: 是否允许使用铁砧
  - ARMOR_STAND: 是否允许操作盔甲架
  - BEACON: 是否允许操作信标
  - BED: 是否允许使用床
  - BOAT: 是否允许使用船
  - BREAK_BLOCKS: 是否允许破坏
  - BREEDING: 是否允许动物繁殖
  - BREWING: 是否允许使用酿造台
  - BUCKET: 是否允许使用桶
  - BUTTON: 是否允许使用按钮
  - CONTAINER: 是否允许使用箱子、潜影盒和花盆。其他容器由其它属性控制
  - DISPENSER: 是否允许使用发射器
  - DROPPER: 是否允许使用投掷器
  - ELYTRA: 是否允许使用鞘翅
  - HOPPER: 是否允许使用漏斗
  - CHEST_DAMAGE: 爆炸是否可以破坏箱子
  - CHORUS_FRUIT: 是否允许紫颂果传送
  - CLEAN_SUPER_FLAT: 允许清除超平坦区块。除非世界生成出现问题，否则不必打开
  - COARSE_DIRT_TILLING: Toggle tilling coarse dirt and breaking podzol to obtain dirt
  - COLLECT_LAVA: 是否允许收集岩浆（覆盖buckets）
  - COLLECT_WATER: 是否允许收集水（覆盖buckets）
  - COMMAND_RANKS: 编辑指令等级，不是一个属性，但是在设置菜单中
  - CRAFTING: 是否允许使用工作台
  - CREEPER_DAMAGE: 是否启用爬行者伤害
  - CREEPER_GRIEFING: 是否启用爬行者破坏 - 避免游客带着一只爬行者来炸岛
  - CROP_TRAMPLE: 是否允许踩坏耕地
  - DOOR: 是否允许使用门
  - DRAGON_EGG: 是否允许点击龙蛋，此属性不会阻止放置或破坏龙蛋
  - DYE: 禁止使用染料
  - EGGS: 是否允许扔鸡蛋
  - ENCHANTING: 是否允许使用附魔台
  - ENDER_CHEST: 是否允许使用/合成
  - ENDERMAN_DEATH_DROP: 末影人手上的方块会在杀死时掉下
  - ENDERMAN_GRIEFING: 允许末影人搬走岛屿内的方块
  - ENDER_PEARL: 是否允许使用末影珍珠
  - ENTER_EXIT_MESSAGES: 显示进出消息
  - EXPERIENCE_BOTTLE_THROWING: 是否允许扔经验瓶
  - FIRE_BURNING: 是否允许火烧毁物品
  - FIRE_EXTINGUISH: 是否允许灭火
  - FIRE_IGNITE: 是否允许非玩家点火
  - FIRE_SPREAD: 是否允许火焰扩散
  - FISH_SCOOPING: 允许使用桶捉鱼
  - FLINT_AND_STEEL: 允许玩家点火
  - FURNACE: 是否允许使用熔炉
  - GATE: 是否允许使用栅栏门
  - GEO_LIMIT_MOBS: 清除逃离岛屿的生物
  - HURT_ANIMALS: 允许击杀动物
  - HURT_MONSTERS: 允许击杀怪物
  - HURT_VILLAGERS: 允许击杀村民
  - ITEM_FRAME: 是否允许使用物品展示框
  - ITEM_FRAME_DAMAGE: 允许生物破坏物品展示框
  - INVINCIBLE_VISITORS: 请在设置中心设置
  - ISLAND_RESPAWN: 玩家重生在岛屿上
  - ITEM_DROP: 允许丢东西
  - ITEM_PICKUP: 允许捡东西
  - JUKEBOX: 允许使用唱片机
  - LEAF_DECAY: 允许树叶凋落
  - LEASH: 允许使用拴绳
  - LEVER: 允许使用拉杆
  - LIQUIDS_FLOWING_OUT: 是否允许液体流出岛屿保护范围，这可以阻止用水和岩浆在两座岛间建桥
  - LOCK: 是否锁岛
  - MILKING: 是否允许挤牛奶
  - MINECART: 是否允许使用矿车
  - MONSTER_SPAWN: 是否允许生成怪物
  - MOUNT_INVENTORY: 允许查看马的背包
  - NAME_TAG: 是否允许使用命名牌
  - NATURAL_SPAWNING_OUTSIDE_RANGE: 是否允许在岛屿外天然生成生物
  - NOTE_BLOCK: 是否允许使用音符盒
  - OBSIDIAN_SCOOPING: 允许使用空桶将黑曜石变成岩浆并装进桶里。避免新玩家不停重置岛屿
  - OFFLINE_GROWTH: 禁用后，岛屿所有者及成员均不在线时植物将停止生长。可能会减少卡顿
  - OFFLINE_REDSTONE: 同上离线时不运行红石
  - PISTON_PUSH: 是否允许活塞推出岛屿方块
  - PLACE_BLOCKS: 是否允许建筑
  - POTION_THROWING: 是否允许扔药水
  - NETHER_PORTAL: 是否允许使用下界传送门
  - END_PORTAL: 是否允许使用末地传送门
  - PRESSURE_PLATE: 是否允许使用压力板
  - PVP_END: 是否允许在末地 PVP
  - PVP_NETHER:是否允许在下界 PVP
  - PVP_OVERWORLD: 是否允许在岛屿上 PVP
  - REDSTONE: 是否允许使用红石
  - REMOVE_END_EXIT_ISLAND: 阻止末地的岛屿生成在 (0, 0) 位置。Paper 端有一个设置可以防止这发生
  - REMOVE_MOBS: 当传送到岛屿时清除岛屿的怪物。清楚半径及白名单见 config 设置
  - RIDING: 是否允许骑乘
  - SHEARING: 是否允许使用剪刀
  - SPAWN_EGGS: 是否允许使用刷怪蛋
  - TNT_DAMAGE: 允许 TNT 破坏及伤害(包括 TNT 矿车)
  - TNT_PRIMING:禁止点燃 TNT
  - TRADING: 是否允许交易
  - TRAPDOOR: 是否允许使用活板门
  - TREES_GROWING_OUTSIDE_RANGE: 允许树木长出岛屿
  - TURTLE_EGGS: 允许破坏海龟蛋
  - FROST_WALKER: 是否允许使用冰霜行者附魔
  - EXPERIENCE_PICKUP: 是否允许捡起经验球
  - PREVENT_TELEPORT_WHEN_FALLING: 禁止玩家掉落时使用指令回岛
  - WITHER_DAMAGE: 是否允许凋零破坏方块、攻击玩家
变量

变量可以让你在其它插件中显示 BentoBox 的一些数据，或在 BentoBox 中显示其他插件的数据。

## 如何使用变量

### 首先，下载你需要的变量 API

BentoBox 支持 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)

### 启动服务器，你已经完成了安装

不管你使用的是什么变量 API，你只需要启动服务器。BentoBox 会帮你做好一切

## 如何在聊天窗口显示变量

如果你使用 EssentialsChat + PlaceholderAPI，你还需要安装 [ChatInjector](https://www.spigotmc.org/resources/chatinjector.38327/) 插件。但是它可能会引发一些问题

我们推荐你使用像 [ChatControl](https://www.spigotmc.org/resources/chatcontrol%E2%84%A2-the-ultimate-chat-plugin-500-000-downloads-1-2-5-1-14-4.271/) 这样支持 PlaceholderAPI 的聊天插件

## 我可以建议一个新变量吗

到这里提交 [placeholder request](https://github.com/BentoBoxWorld/BentoBox/issues/new?assignees=&labels=Status%3A+Pending%2C+Type%3A+Enhancement&template=placeholder_request.md&title=Placeholder%3A+)

## 各游戏模式的自带变量

### 可用变量

| 变量 | 作用 | 版本 |
| ----------------------------------------------------- | ---------------------------------- | ------ |
| %[游戏模式]_world_friendly_name% | 世界昵称 | 1.4.0|
| %[游戏模式]_world_islands% | 所在世界的岛屿数量 | 1.5.0|
| %[游戏模式]_island_distance% | 岛屿间距的一半 | 1.4.0|
| %[游戏模式]_island_distance_diameter% | 岛屿间距 | 1.5.0|
| %[游戏模式]_island_protection_range% | 岛屿保护区域的半径 | 1.4.0|
| %[游戏模式]_island_protection_range_diameter% | 岛屿保护区域的直径 | 1.5.0|
| %[游戏模式]_island_owner% |岛屿主的名字 | 1.4.0 |
| %[游戏模式]_island_creation_date% | 岛屿创建日期 | 1.4.0|
| %[游戏模式]_island_name% | 岛屿名 | 1.4.0|
| %[游戏模式]_island_center% | 岛屿中心的坐标 | 1.5.0|
| %[游戏模式]_island_center_x% | 岛屿中心的 x 坐标 | 1.5.0|
| %[游戏模式]_island_center_y% | 岛屿中心的 y 坐标 | 1.5.0|
| %[游戏模式]_island_center_z% | 岛屿中心的 z 坐标 | 1.5.0|
| %[游戏模式]_island_members_max% | 岛屿的最大成员数 | 1.5.0|
| %[游戏模式]_island_members_count% | 岛屿上除了游客和管理员外有多少人 | 1.5.0|
| %[游戏模式]_island_members_list% |列出岛屿上等级在成员以上的玩家，以逗号分隔 | 1.13.0 |
| %[游戏模式]_island_trustees_count% | 岛屿信任者人数 | 1.5.0|
| %[游戏模式]_island_coops_count% | 与该岛合作的人数 | 1.5.0|
| %[游戏模式]_island_visitors_count% | 岛屿上的人数 | 1.5.0|
| %[游戏模式]_island_bans_count% | 岛屿上已封禁的人数 | 1.5.0|
| %[游戏模式]_visited_island_protection_range% | 当前岛屿的保护半径 | 1.5.2|
| %[游戏模式]_visited_island_protection_range_diameter% | 当前岛屿保护直径 | 1.5.2|
| %[游戏模式]_visited_island_owner% | 当前岛屿的所有者姓名 | 1.5.2|
| %[游戏模式]_visited_island_creation_date% | 当前岛屿的创建日期 | 1.5.2|
| %[游戏模式]_visited_island_name% | 当前岛屿的名称 | 1.5.2|
| %[游戏模式]_visited_island_center% | 当前岛屿的中心坐标 | 1.5.2|
| %[游戏模式]_visited_island_center_x% | 当前岛屿的中心 x 坐标 | 1.5.2|
| %[游戏模式]_visited_island_center_y% | 当前岛屿的中心 y 坐标 | 1.5.2|
| %[游戏模式]_visited_island_center_z% | 当前岛屿的中心 z 坐标 | 1.5.2|
| %[游戏模式]_visited_island_members_max% |当前岛屿的最大成员数 | 1.5.2 |
| %[游戏模式]_visited_island_members_count% | 当前所在岛屿共有多少岛屿主、副岛主、成员 | 1.5.2 |
| %[游戏模式]_visited_island_members_list% | 当前所在岛屿的成员(及以上等级)清单 | 1.13.0 |
| %[游戏模式]_visited_island_trustees_count% | 该岛屿上受信任玩家人数 | 1.5.2|
| %[游戏模式]_visited_island_coops_count% | 当前岛屿合作者数量 | 1.5.2|
| %[游戏模式]_visited_island_visitors_count% | 当前所在岛屿总人数 | 1.5.2|
| %[游戏模式]_visited_island_bans_count% | 当前所在岛屿封禁了多少人 | 1.5.2 |
| %[游戏模式]_has_island% | 是否拥有岛屿 | 1.5.0|
| %[游戏模式]_rank% | （我的）岛屿排名 | 1.5.0|
| %[游戏模式]_resets% | （我的）岛屿重置了多少次 | 1.5.0|
| %[游戏模式]_resets_left% | (我的)岛屿能重置多少次 | 1.5.0|
| %[游戏模式]_deaths% | （我）死了多少次 | 1.12.0 |
| %[游戏模式]_on_island% | （我所在的）岛屿是我的吗 | 1.13.0 |

游戏模式可以是这些：caveblock、skygrid、acidisland、bskyblock

### 还有其它

每个游戏模式都有自己的变量，具体点击上方目录查看
蓝图

# 蓝图

蓝图是用来创建初始岛屿的

蓝图类似创世神的 schematics 但是两者并不兼容。蓝图是为 BentoBox 及其扩展而设计，不依赖第三方插件或接口

蓝图可通过蓝图管理器来进行打包(可以且最多包括主世界、下界和末地)。每个蓝图包可设置图标、描述、使用权限及其他一些设置

### 问与答: 我有很多 schematics ，我可以把它们转换为蓝图吗

你需要在游戏内进行

方法：

1.使用创世神（WorldEdit）加载 schematics 文件
2.粘贴到某个地方，最好粘贴在空的地方(比如 Minecraft 预设世界 - 虚空)
3.在岛屿出生点处立一块牌子，并输入 [spawn_here]
4.（可选）放置欢迎牌的位置并输入 [start]
5.使用管理员蓝图指令 pos1 和 pos2 选择岛屿(不是 WorldEdit)
6.使用管理员蓝图复制指令复制蓝图
7.使用管理员蓝图保存指令保存蓝图
8.使用此方法创建末地岛和下界岛

注意: 一定要在岛屿正中间放一块基岩，这将帮助 BentoBox 定位并生成岛屿，否则岛屿可能生成在错误的地方(比如酸海底)

## 异步处理

所有的蓝图操作都是异步进行的，不会使服务器产生任何卡顿。它可能需要很多秒来生成一个大岛屿，但是你可以在配置文件中修改生成速度。默认设置适配大多数系统。如果你打开了 timings ，你会发现生成过程耗费了很多时间，但是这仅仅是 1000块/tick 的速度并不会使你的服务器卡顿

## 教程

制作自定义岛屿：

1.通过设置一条对角线上的两个对角来选中岛屿
2.复制岛屿
3.保存岛屿。如果你想覆盖默认岛屿，保存为 island、 nether-island、end-island，你需要确认才能覆盖
4.打开蓝图管理器(比如/bsb blueprint)创建一个新包，设置图标，组，蓝图等

### 视频教程

https://www.bilibili.com/video/BV15T4y1G77Q/

## 指令

以 BSkyBlock 为例

- /bsb bp pos1 - 设置点Ⅰ
- /bsb bp pos2 - 设置点Ⅱ
- /bsb bp copy - 复制选区内除空气以外所有东西
- /bsb bp copy air - 复制选区（如果你给 CaveBlock 或 AcidIsland 创建岛屿则必须复制空气）
- /bsb bp paste - 粘贴选区
- /bsb bp save - 保存选区到文件(.schem)
- /bsb bp load - 加载一个蓝图文件
- /bsb bp - 打开蓝图管理器

如果是AcidIsland 请将 bsb 替换为 acid

## 蓝图管理菜单

蓝图管理菜单可帮助你编辑岛屿模板

要创建一个新模板，点击菜单左下角的绿色旗帜，然后在聊天界面输入新模版的名字

新创建的模板默认图标为红色羊毛，右边可定义 3 个蓝图

- 绿色玻璃板 - 主世界
- 红色玻璃板 - 下界蓝图
- 黄色玻璃板 - 下界蓝图

右键清除蓝图记录

可用蓝图在一行深灰色玻璃板下方，点击你需要的蓝图，他将会发光，然后点击绿/红/黄色玻璃板。你可以为不同维度设置不同的蓝图，也可以设置相同的

要增加描述，右键模板图标并在聊天界面输入描述内容。尽量使每一行都较短，避免文字显示不全。描述支持颜色代码

要改变模板的图标，你只需要点击背包里的物品，该物品将变为模板图标。要更改蓝图图标，点击该蓝图并点击背包中的物品

如果要使用权限来限制玩家可使用的模板点击菜单中的画图标。权限将会显示在该物品描述上。(权限样式: `游戏模式的插件名.island.create.模板名`)

右键点击 TNT 删除该模板

要重命名模板或蓝图的名称，请使用菜单，千万不要从文件中修改

## 编辑文件

蓝图文件扩展名为 .blu ，不要编辑它。模板文件扩展名为 .json 你可以编辑它

## 模板是否创建成功

每个模板必须具有主世界的蓝图，否则 BentoBox 将使用默认岛屿来替换且控制台中会显示一条错误。虽然下界和末地的岛屿不必设置，但是不设置会导致不生成(玩家前往下界/末地直接掉虚空)

## 告示牌

BentoBox 有两个特殊告示牌，一个用于设置玩家岛屿出生点，一个用于设置欢迎告示牌

### 出生点告示牌

在你想要玩家出生的地方放上一个告示牌并写上 [spawn_here]，每个维度可单独设置

### 欢迎告示牌

在需要欢迎信息的地方立下告示牌并写入 [start] ，该告示牌的内容将在生成岛屿时替换为该游戏模式语言文件内设置的值

## 提示 & 建议

- 我们建议你把初始岛屿设置的小一点，初始物品设置多一点，以增加挑战性
- 尝试创建群岛(上下或左右)，让玩家建筑才能得到资源
- 如果你连同空气一起制作蓝图，请将选区尽可能缩小
- 复制完蓝图后，把他粘贴出来检查是否完整

使用 BentoBox API

API 简介

# 欢迎来到 BentoBox 开发者文档

BentoBox is a platform plugin that supports a suite of API's for addons that run on it. The architecture is virtually identical to the Bukkit plugin system. You can create GameModeAddons like BSkyBlock that provide players with your own game mode experience, or you can develop utility plugins, like Warps that enable players in any game mode (or even normal worlds) to use warp signs.

# Java 文档

Javadocs 可在[这里](https://javadocs.bentobox.world/)找到

The core API package is world.bentobox.bentobox.api.*. Methods in those packages are kept as stable as possible over the long term. Methods and classes outside of the api package may change a lot or more frequently.

# 示例扩展

BONNe 开发了一个示例扩展，你可以在 [GitHub](https://github.com/BONNePlayground/ExampleAddon) 上找到
插件如何从扩展中获取数据

# The Request Handler API

此 API 用于获取扩展数据。哪些数据可以共享取决于你的设置。由于 Java 类加载器的安全设置，插件不可以直接使用扩展内部的类。

## 示例(Level Addon)

Level 扩展共享两个 Request Handler([LevelRequestHandler](https://github.com/BentoBoxWorld/Level/blob/develop/src/main/java/world/bentobox/level/requests/LevelRequestHandler.java) 和 [TopTenRequestHandler](https://github.com/BentoBoxWorld/Level/blob/develop/src/main/java/world/bentobox/level/requests/TopTenRequestHandler.java))。以下是插件获取玩家岛屿等级的方法

### LevelRequestHandler

Label: `island-level`

Input map:

- Key: `world-name` -> String
- Value: `player` -> UUID

因此，这个代码应该是这样的：

```java
UUID uuid = player.getUniqueId();
String worldName = player.getWorld().getName();
Long result = (Long)AddonRequestBuilder
.addon("Level")
.label("island-level")
.addMetaData("world-name", worldName)
.addMetaData("player", uuid)
.request();
```

你可以在 Addon 源代码或文档中找到它们所共享的项目

# 从一个扩展里共享数据

要共享数据，你需要为其创建类，然后在你的扩展中声明 request handlers。示例：

```java
// 声明 request handlers
registerRequestHandler(new LevelRequestHandler(this));
registerRequestHandler(new TopTenRequestHandler(this));
```

handler 需在它的 constructor 中定义 label，如：

```Java
public LevelRequestHandler(Level addon) {
super("island-level"); // label 是 "island-level"
this.addon = addon;
}
```

label 不可与其它扩展冲突

然后，覆盖 `handle` 方法使其映射为参数

```java
@Override
public Object handle(Map<String, Object> map) {
```

你可以定义映射内容，但 Object 一定不能是只存在于你的扩展的类。它只能是所有插件都使用的类。如果你引用一个隐藏的类，插件会发生错误。因此、整型、长整型、Bukkit Locations、Worlds 等是可以使用的。

在注释中写上你的映射是一个好习惯

```java
/*
What we need in the map:
0. "world-name" -> String
1. "player" -> UUID
What we will return:
- 0L if invalid input/player has no island
- the island level otherwise (which may be 0)
*/
```

处理映射并输出结果：

```java
if (map == null || map.isEmpty()
|| map.get("world-name") == null || !(map.get("world-name") instanceof String)
|| map.get("player") == null || !(map.get("player") instanceof UUID)
|| Bukkit.getWorld((String) map.get("world-name")) == null) {
return 0L;
}

return addon.getIslandLevel(Bukkit.getWorld((String) map.get("world-name")), (UUID) map.get("player"));
}
```

这里的输出是 `Object` 因此插件作者还需要转换格式，在这里是 `long`。可通过设置适当的参数检查来保护你的扩展收到错误的映射格式。
Addon
- addon.yml
  
  ## 这个文件有什么用？
  
  addon.yml 用于提供你的扩展信息。如果没有这个文件或者填写错误，BentoBox 将不会加载该扩展并标记为 `INVALID_DESCRIPTION`
  
  ## 必需属性
  
  - [name](#name)
  - [main](#main)
  - [version](#version)
  
  ### name
  
  **作用**：声明此扩展的名称
  
  **如**：
  
```yaml
name: "Your_Addon"
```
  
  **注意**：1.只允许字母数字和下划线(a-z,A-Z,0-9, _)。2.空格将被自动转为下划线。3.这将用于识别该扩展。4.将在用户执行 `/bsadmin version Your_Addon`时显示。
  
  ### main
  
  **作用**：类 `BSAddon` 的路径
  
  **如**：
  
```yaml
main: fr.poslovitch.myaddon.Your_Addon
```
  
  **注意**：1. This must contain the full namespace including the class file itself, like Bukkit. Therefore if your namespace is `fr.poslovitch.myaddon`, and your class file is called `Your_Addon`, this must be `fr.poslovitch.myaddon.Your_Addon`.
  
  ### version
  
  **作用**：你的扩展的版本
  
  **如**：
  
```yaml
version: 1.0.0
```
  
  **注意**：1. Version is an arbitrary string, however the most common format is MajorRelease.MinorRelease.FixRelease (如: 3.6.1). 2. Displayed when the user types `/bsadmin version Your_Addon`.
  
  ## 可选属性
  
  - [authors](#authors)
  - [description](#description)
  - [website](#website)
  
  ### authors
  
  **作用**：列出作者
  
  **如：**
  
```yaml
authors: ["Poslovitch", "Tastybento", "可能还有你? :P"]
# Don't hesitate to add our nicknames into the authors list of your addon, we would appreciate that!
```
  
  **注意：**1. Gives credit to the developper(s) 2. Displayed when the user types `/bsadmin version Your_Addon`.
  
  ### description
  
  **作用：**你的扩展的简介
  
  **如：**
  
```yaml
description: "It makes you die when you jump. So 2017."
```
  
  **注意：**1. The description can have multiple lines (cause you need a lot of place to explain what your super addon is doing!). 2. Displayed when the user types `/bsadmin version Your_Addon`.
  
  ### website
  
  **作用：**作者的网站
  
  **如：**
  
```yaml
website: "https://www.mcbbs.net"
```
  
  **注意:**1. If you have no dedicated website, a link to the addon's GitHub repository should do the job. 2. Displayed when the user types `/bsadmin version Your_Addon`.
内置指令

| 名称 | label | 缩写 | 权限 | 作者 | 最低版本 |
| ----------------------------- | ---------- | ----------------- | -------------------------- | ---------- | -------- |
| DefaultHelpCommand | HELP | | | tastybento | |
| AdminDeleteCommand | delete | | [前缀].admin.delete | | |
| AdminGetrankCommand | getrank | | [前缀].admin.setrank | tastybento | |
| AdminInfoCommand | info | | [前缀].admin.info | | |
| AdminRegisterCommand | register | | [前缀].admin.register | | |
| AdminReloadCommand | reload | | [前缀].admin.reload | tastybento | |
| AdminSetrankCommand | setrank | | [前缀].admin.setrank | tastybento | |
| AdminSetspawnCommand | setspawn | | [前缀].admin.setspawn | Poslovitch | 1.1 |
| AdminTeleportCommand | tpCommand| | [前缀].admin.tp | | |
| AdminUnregisterCommand | unregister | | [前缀].admin.unregister | | |
| AdminVersionCommand | version | v | [前缀].admin.version | | |
| AdminWhyCommand | why | | [前缀].admin.why | | |
| AdminDeathsCommand | deaths | | [前缀].admin.deaths | Poslovitch | |
| AdminDeathsResetCommand | reset | | | Poslovitch | |
| AdminDeathsSetCommand | set | | | Poslovitch | |
| AdminRangeCommand | | | [前缀].admin.range | Poslovitch | |
| AdminRangeDisplayCommand | DISPLAY | SHOW;HIDE | [前缀].admin.range.display | Poslovitch | |
| AdminRangeResetCommand | reset | | [前缀].admin.range.reset | | |
| AdminRangeSetCommand | set | | [前缀].admin.range.set | | |
| AdminResetsCommand | resets | | [前缀].admin.resets | | |
| AdminResetsResetCommand | reset | | | | |
| AdminResetsSetCommand | set | | | | |
| AdminSchemCommand | schem | | [前缀].admin.schem | | |
| AdminSchemCopyCommand | copy | | | | |
| AdminSchemLoadCommand | load | | | | |
| AdminSchemOriginCommand | origin | | | | |
| AdminSchemPasteCommand | paste | | | | |
| AdminSchemPos1Command | pos1 | | | | |
| AdminSchemPos2Command | pos2 | | | | |
| AdminSchemSaveCommand | save | | | | |
| AdminTeamAddCommand | add | | [前缀].admin.team | | |
| AdminTeamDisbandCommand | disband | | [前缀].admin.team | | |
| AdminTeamKickCommand | kick | | [前缀].admin.team | | |
| AdminTeamSetownerCommand | setowner | | [前缀].admin.team | | |
| IslandBanCommand | ban | | [前缀].island.ban | | |
| IslandBanlistCommand | banlist | banned;bans | [前缀].island.ban | | |
| IslandCreateCommand | create | new | [前缀].island.create | Tastybento | |
| IslandGoCommand | go | home;h | [前缀].island.home | tastybento | |
| IslandInfoCommand | info | who | [前缀].island.info | Poslovitch | |
| IslandLanguageCommand | language | lang | [前缀].island.language | Poslovitch | |
| IslandResetCommand | reset | restart | [前缀].island.create | tastybento | 1.1 |
| IslandResetnameCommand | resetname| | [前缀].island.name | tastybento | |
| IslandSethomeCommand | sethome | | [前缀].island.sethome | | |
| IslandSetnameCommand | setname | | [前缀].island.name | tastybento | |
| IslandSettingsCommand | settings | flags | [前缀].island.settings | Poslovitch | |
| IslandSpawnCommand | spawn | | [前缀].island.spawn | Poslovitch | 1.1 |
| IslandUnbanCommand | unban | | [前缀].island.ban | | |
| IslandTeamCommand | team | | [前缀].island.team | | |
| IslandTeamCoopCommand | coop | | [前缀].island.team.coop | tastybento | |
| IslandTeamInviteAcceptCommand | accept | | [前缀].island.team | tastybento | |
| IslandTeamInviteCommand | invite | | [前缀].island.team | | |
| IslandTeamInviteRejectCommand | reject | | [前缀].island.team | | |
| IslandTeamKickCommand | kick | | [前缀].island.team | | |
| IslandTeamLeaveCommand | leave | | [前缀].island.team | | |
| IslandTeamPromoteCommand | string | | [前缀].island.team.promote | | |
| IslandTeamSetownerCommand | setowner | | [前缀].island.team | | |
| IslandTeamTrustCommand | trust | | [前缀].island.team.trust | tastybento | |
| IslandTeamUncoopCommand | uncoop | | [前缀].island.team.coop | tastybento | |
| IslandTeamUntrustCommand | untrust | | [前缀].island.team.coop | tastybento | |
| BentoBoxAboutCommand | about | | | tastybento | |
| BentoBoxCommand | bbox | | [前缀].bentobox.admin | | |
| BentoBoxReloadCommand | reload | | [前缀].admin.reload | tastybento | |
| BentoBoxVersionCommand | version | v;versions;addons | | tastybento | |
JavaDocs

BentoBox 配置文件
https://github.com/JeansouLiu/BentoBox_Chinese/blob/master/src/main/resources/config.yml

想要帮助我汉化？

# FAQ

## 安装

### 我该怎样安装 BentoBox, BSkyBlock 和其它一些东西?

最简单的方式就是从这里下载 [https://download.bentobox.world](https://download.bentobox.world/) 懒人包. 你也可以查看第一页 §1.5.1 来查看标准安装方式. **欢迎成为 BentoBox 大家族的一员!**

## 配置

### 我该怎么设置自定义岛屿模板?

你需要用到一个叫**蓝图**的**内置模板格式**. 蓝图的详细介绍请见 §1.6.5.

### 哪些数据库的哪些版本受支持?

最低标准:

- **MySQL** 5.7 以上
- **MariaDB** 10.2.3 以上
- **MongoDB** 3.6 以上
- **SQLite** 3.28 以上
- **PosgreSQL** 推荐保持最新版

### 我该怎么减少玩家的岛屿面积?

每个岛屿都有保护范围. 你最大可以把保护范围增加到岛屿之间的距离. 岛屿半径可以通过指令或权限增加. 权限只会在玩家登录时检查, 所以如果你只想使用权限来管理, 玩家必须重新登录以使之生效. 指令操作会立即生效. 保护范围将会应用于整个岛屿.

**权限**

给予岛屿主 `[这里输入游戏模式].island.range.<范围阿拉伯数字>` 权限.

- 岛屿主需要重新进入游戏才能使设置生效
- 如果岛主变化，插件会自动检测新岛主的权限以确定保护范围大小.

**指令**

使用 `/[这里输入管理员命令前缀] range` 指令.

## 已知问题

### 生成超平坦区块

*详见:* [BentoBox#1212](https://github.com/BentoBoxWorld/BentoBox/issues/1232), [BSkyBlock#247](https://github.com/BentoBoxWorld/BSkyBlock/issues/247).

*超平坦世界. (来源: [1213videogamer on PlanetMinecraft](https://www.planetminecraft.com/member/1213videogamer/)).*

如果你看到了超平坦区块，说明该世界的世界生成器已损坏. 有很多原因会造成此情况.

**我们建议你还原到出现这种情况之前的备份**. 尽管我们提供了解决这种情况的方法, 但我们**不保证其一定有效**. 并且这些方案都是为了**尽可能的找到问题的根源, 并没有考虑对性能和玩家的影响**. 请自行决定是否使用这些方案.

最快的修复方式是在管理员控制面板中移除超平坦区块，但是在你找到问题根源之前，超平坦区块仍会生成.

不管怎样, **先关闭你的服务器以避免对岛屿世界进一步的损坏**.

#### 可能的原因

##### BENTOBOX 或者其扩展已经停止运行

**为什么?**

BentoBox 或者游戏模式扩展没有在服务器中启用. 这一般由兼容性问题引起.

**解决方案**

阅读日志文件并查找启动过程中的报错信息. 尝试每次只安装除 BentoBox 以外的一个插件并启动你的服务器数次以找到引起问题的插件.

##### 在 `BUKKIT.YML` 中未设置该世界的生成器

**为什么?**

这是一种常见的情况. **当你将岛屿世界设为服务器首选世界时**, 你忘记在 `bukkit.yml` 里设置世界生成器.

**解决方法**

确保你每一步都按照 §5.1 操作.

##### `USE-OWN-GENERATOR` 选项被设为了 `TRUE`

**为什么?**

这是一个常见错误.

这个选项经常被误解为是启用神奇刷石机 (但是[它是一个扩展](https://github.com/BentoBoxWorld/MagicCobblestoneGenerator)!) 的选项. 这个选项的用途已经在注释中写明:

```yaml
# 为这个世界使用你的世界生成器.
# 如果设为 true，插件将不会生成任何东西.
# 且你必须在 bukkit.yml 里指定世界名称和生成器.
# 见 https://bukkit.gamepedia.com/Bukkit.yml
use-own-generator: false
```

**解决方案**

如果你不打算使用第三方生成器，请将此项改为 `false`.

##### 另一个插件试图控制该世界的生成

**为什么?**

尽管很少见，但是这种情况仍然存在.

有一些插件, 尤其是世界管理插件 (例如 Multiverse), 往往提供一些选项覆盖世界生成器设置.

**解决方案**

检查你的所有插件找出最有可能引发此问题的插件. 世界管理插件或与世界有关的插件都有可能引发此问题. 向插件开发者反馈或者修改配置文件.

##### BENTOBOX 或者其扩展有 BUG

**为什么?**

现在，这几乎不可能. 但是因为一些不明原因 bug 仍然可能出现.

**解决方案**

首先确定这是与 BentoBox 本身有关的问题，比如移除除了 BentoBox 以外的所有插件.

如果移除后问题不再出现, 说明这是由其他插件引起的. 如果是这样，请向上翻并阅读“另一个插件试图控制该世界的生成”.

如果问题仍然存在, 说明这是 BentoBox 的问题. 请[在 bug tracker 上反馈](https://github.com/BentoBoxWorld/BentoBox/issues).

#### 之后我该怎么清除已经生成的超平坦区块?

如果你有备份, 将世界和 BentoBox 还原到上一个状态.

然而你可能没有备份, 你需要进入游戏并输入 `/[在这里输入管理员指令前缀] settings` 指令打开控制面板。找到并打开 “Clean Super Flat”.

*The Clean Super Flat flag in BSkyBlock's Admin Settings Panel*.

启用后，**超平坦区块将会缓慢的被重新生成为正常的区块**. 这只有在该区块加载时才会执行, 所以你要么到有超平坦区块的地方晃悠一圈, 要么让该选项启用几天直至区块被清除. **不要忘记关闭该选项!** 它非常非常消耗性能...

### 玩家创建岛屿时服务器会卡顿!

首先, 岛屿的粘贴速度对你的服务器来说可能太快了. 尝试降低它的值. 在 BentoBox 的 `config.yml` 查找此选项:

```yaml
# 每 tick 粘贴的方块数.
# 值越小，卡顿越不明显，但是时间会变长.
# 相反，值越大复制速度越快，但是卡顿越严重，在区块未完全加载时可能引起服务器崩溃
paste-speed: 64
```

如果服务器仍然卡顿，则可能与区块生成有关:

- 尝试降低游戏模式配置文件中的 "distance between islands" 设置. 值越小意味着生成的区块越少. **这需要完全重置世界和数据库**.
- 使用 Paper 作为服务端. Paper 能够异步处理区块的生成.
- 预生成世界. 尤其对一些很耗性能的游戏模式, 比如 CaveBlock 和 SkyGrid.

## API

### 我该如何开始编写 BentoBox 扩展? 有 API 吗?

Yes, there is definitely an API. Writing addons is very similar to writing plugins except there is a lot more API available for things like teams, protections, commands, panels and pasting.

详见 §6.1

### 岛屿上无法种树苗!
*相关问题:* [BentoBox#277](https://github.com/BentoBoxWorld/BentoBox/issues/277).

如果没有任何信息提示玩家不能种植树苗, 那么**这不是** BentoBox 造成的问题.

如果你的服务器安装了 **GriefPrevention** 插件, 有一个[选项](https://github.com/TechFortress/GriefPrevention/wiki/Setup-and-Configuration#preventing-tree-grief) 会阻止玩家种植 "Sky Trees".

------

最后更新: 2020 年 12 月 19 日, 16:13:55

BSkyBlock

玩家需要在一座遗忘在天空中的岛屿上生存
由 tastybento 制作&维护

一些可能有用的链接

## 介绍

**BSkyBlock** 是新版本 Minecraft 的 **ASkyBlock**.

## 安装

1. 安装 BentoBox 运行一次服务器.
2. 将 jar 文件放入 BentoBox 扩展文件夹.
3. 重启服务器.
4. 插件将会创建空岛世界并生成数据文件夹，在文件夹中你会看到 config.yml.
5. 关闭服务器 .
6. 编辑 config.yml 以适合你的服务器.
7. 如果你改动了与世界生成&管理有关的设置，请删除刚刚生成的世界.
8. 再次启动服务器.

## Config.yml

config.yml 与 ASkyBlock 的差不多*但是并不完全一样*. 岛屿间距和保护范围是以半径计算的，即真正的范围是你所输入的数字的 2 倍! 岛屿间距的默认值为一个区块的大小.

## 权限

见 §1.6.2.3

## 指令

### **BSkyBlock 管理员指令** (缩写: /bsb)

| **指令** | **介绍** | **权限** |
| ------------------------------ | ------------------------------------------------ | ----------------------------- |
| **/bsbadmin** | 显示所有 BSkyBlock 指令 | bskyblock.island |
| **/bsbadmin add** | 向岛主的团队中加人 | |
| **/bsbadmin biomes** | 生物群系管理员指令. 为玩家打开管理员生物群系菜单 | |
| **/bsbadmin challenges** | 允许使用 /bsbadmin challenges 管理员指令 | bskyblock.admin.challenges |
| **/bsbadmin deaths** | 编辑玩家的死亡数 | |
| **/bsbadmin delete** | 删除玩家的岛屿 | bskyblock.admin.delete |
| **/bsbadmin disband** | 解散岛屿主的队伍 | bskyblock.mod.bypassprotect |
| **/bsbadmin getrank** | 获取玩家岛屿排名 | |
| **/bsbadmin info** | 获取你所在岛屿的信息 | bskyblock.mod.info |
| **/bsbadmin kick** | 从一个队伍中踢出一个玩家 | bskyblock.mod.bypassexpel |
| **/bsbadmin level** | 计算玩家的岛屿等级 | |
| **/bsbadmin range** | 管理员岛屿半径指令 | |
| **/bsbadmin register** | 把当前未领取的岛屿给某玩家 | bskyblock.admin.register |
| **/bsbadmin reload** | 重载插件 | bskyblock.admin.relaod |
| **/bsbadmin reset** | 重置一个玩家的岛屿 | bskyblock.admin.settingsreset |
| **/bsbadmin schem** | 管理模板 | |
| **/bsbadmin schem copy [air]** | 复制所框选的区域(加上 air 为包括空气) | |
| **/bsbadmin schem load** | 加载模板到剪切板 | |
| **/bsbadmin schem origin** | 设置模板的中心为当前位置 | |
| **/bsbadmin schem paste** | 粘贴剪切板内容到当前位置 | |
| **/bsbadmin schem pos1** | 设置点 1 | |
| **/bsbadmin schem pos2** | 设置点 2 | |
| **/bsbadmin schem save** | 保存剪切板内容 | |
| **/bsbadmin setowner** | 授予某玩家岛屿所有权 | bskyblock.admin.register |
| **/bsbadmin setrank** | 设置一个玩家的排名 | |
| **/bsbadmin setspawn** | 设置出生点 | bskyblock.admin.setspawn |
| **/bsbadmin top** | 显示排行榜 | |
| **/bsbadmin tp** | 传送到一个玩家的岛屿 | bskyblock.mod.tp |
| **/bsbadmin tpend** | 传送到一个玩家的末地岛 | bskyblock.mod.tp |
| **/bsbadmin tpnether** | 传送到玩家的下界岛 | bskyblock.mod.tp |
| **/bsbadmin unregister** | 剥夺玩家对岛屿的控制权，但不删除岛屿 | bskyblock.admin.unregister |
| **/bsbadmin version** | 显示 BentoBox 及其 addon 的版本 | bskyblock.island |
| **/bsbadmin why** | 开启/关闭控制台调试信息 | |

### BSkyBlock 玩家指令 (缩写: /is)

| **指令** | **作用** | **权限** |
| ----------------------------- | ---------------------------------------- | --------------------------- |
| **/island** | 主命令 | bskyblock.island |
| **/island about** | 关于此插件 | bskyblock.island |
| **/island ban** | 将玩家从你的岛屿封禁 | bskyblock.island.ban |
| **/island banlist** | 列出被封禁的玩家 | bskyblock.island.ban |
| **/island biomes** | 打开生物群系菜单 | |
| **/island challenges [等级]** | 允许玩家使用 /island challenges 指令 | bskyblock.challenges |
| **/island create** | 创建一个岛屿 | bskyblock.island.create |
| **/island go** | 传送到你的岛屿 | bskyblock.island |
| **/island info** | 显示你或其他玩家的岛屿信息 | bskyblock.island.info |
| **/island language** | 选择语言 | bskyblock.island.language |
| **/island level [玩家]** | 计算你的岛屿等级或显示 [玩家] 的岛屿等级 | |
| **/island reset** | 重置你的岛屿 | bskyblock.island.reset |
| **/island sethome** | 设置你的岛屿传送点 | bskyblock.island.sethome |
| **/island setname** | 设置你的岛屿名 | bskyblock.island.name |
| **/island settings** | 显示岛屿设置 | bskyblock.island.settings |
| **/island spawn** | 传送到出生点 | bskyblock.island.home |
| **/island resetname** | 重置岛屿名 | bskyblock.mod.resetname |
| **/island unban** | 将玩家从你的岛屿解除封禁 | bskyblock.island.ban |
| **/island team** | 管理你的队伍 | bskyblock.island.team |
| **/island team accept** | 同意邀请 | bskyblock.island.team |
| **/island team coop** | 允许玩家参与你的岛屿排名 | bskyblock.island.team.coop|
| **/island team demote** | 降低玩家在你的队伍中的等级 | bskyblock.island.team |
| **/island team leave** | 离开你的队伍 | bskyblock.island.team |
| **/island team invite** | 邀请玩家加入你的队伍 | bskyblock.island.team |
| **/island team kick** | 将玩家踢出你的队伍 | bskyblock.island.expel |
| **/island team promote** | 提高玩家在你的队伍中的等级 | bskyblock.island.team |
| **/island team reject** | 拒绝一个邀请 | bskyblock.island.team |
| **/island team setowner** | 转让岛屿 | bskyblock.island.team |
| **/island team trust** | 将玩家在队伍中的等级设为受信任 | bskyblock.island.team.trust |
| **/island top** | 显示排行榜 | |
| **/island team uncoop** | 将玩家的合作者等级移除 | bskyblock.island.team.coop|
| **/island team untrust** | 将玩家的受信任等级移除 | bskyblock.island.team.trust |
| **/island warp** | 传送到玩家的传送牌 | |
| **/island warps** | 打开传送点列表 | |

### 岛屿设置 (/is settings)

目前有 59 个保护设置, 6 个基本设置和 17 个 BSkyBlock 岛屿设置. 每个设置都可为不同的玩家等级设置不同的设置: 游客, 合作者, 受信任, 成员, 副岛主和岛主有不同的设置.

| **设置分类** | **选项列表** |
| ------------------ | ------------------------------------------------------------ |
| 保护设置 | 动物骑乘, 铁砧, 盔甲架, 信标, 床, 破坏方块, 动物繁殖, 酿造台, 桶, 按钮, 紫颂果, 用桶收集岩浆, 收集水, 扔鸡蛋, 附魔台, 末地门, 末影珍珠, 拾取经验球, 火焰, 扑灭火焰, 捕鱼, 冰霜行者, 熔炉, 门, 攻击动物, 攻击怪物, 攻击村民, 丢弃物品, 物品拾取, 使用唱片机, 使用拴绳, 使用拉杆, 锁岛, 挤奶, 打开箱子等, 使用命名牌, 下界传送门, 写书, 放书, 压力板, 红石类, 剪羊毛, 刷怪蛋, 下一页 (告示牌图标), TNT 损坏, 踩坏耕地, 活板门, 海龟蛋, 使用门, 村民交易, 工作台, 使用容器, 使用发射器, 投掷器, 使用漏斗, 使用物品展示框, 扔药水, 上一页 (告示牌图标) |
| 基本设置 | 动物生成, 末地 PVP, 火焰扩散, 怪物生成, 下界 PVP, 主世界 PVP |
| BSkyBlock 岛屿设置 | 破坏箱子, 清除超平坦区块, 允许在砂土上耕种, 爬行者, 爬行者破坏方块, 末影箱, 末影人移动方块, 进入/离开消息, 岛屿重生, 离线红石继续运行, 活塞推方块, 移除怪物, 允许采集黑曜石, 羽落传送, 指令等级, 无敌访客, 限制岛屿生物 |

------

最后更新: 2020年5月28日 20:06:23

## 变量

### 挑战变量

| 变量名 | 作用 | 最低版本 |
| :--------------------------------------------- | :--------------------- | :------- |
| %bskyblock_challenges_total_completion_count%| 玩家尝试完成挑战的次数 | 0.8.2 |
| %bskyblock_challenges_completed_count% | 玩家完成的挑战数 | 0.8.2 |
| %bskyblock_challenges_uncompleted_count% | 玩家未完成的挑战数 | 0.8.2 |
| %bskyblock_challenges_completed_level_count% | 玩家已完成的等级数 | 0.8.2 |
| %bskyblock_challenges_uncompleted_level_count% | 玩家尚未完成的等级数 | 0.8.2 |
| %bskyblock_challenges_unlocked_level_count% | 玩家已解锁的等级数 | 0.8.2 |
| %bskyblock_challenges_locked_level_count% | 玩家未解锁的等级数 | 0.8.2 |
| %bskyblock_challenges_latest_level_name% | 最近一次解锁的等级名 | 0.8.2 |
| %bskyblock_challenges_latest_level_id% | 最近一次解锁的等级 ID| 0.8.2 |

### 等级变量

| 变量 | 作用 | 最低版本 |
| :------------------------------------- | :------------------------------------- | :------- |
| %Level_bskyblock_island_level% | 玩家的岛屿等级 | 1.9.0 |
| %Level_bskyblock_visited_island_level% | 玩家所在的岛屿的等级 | 1.9.0 |
| %Level_bskyblock_top_value_#排名#% | 排行榜中第 `#排名#` 名的玩家的岛屿等级 | 1.9.0 |
| %Level_bskyblock_top_name_#排名#% | 排行榜中第 `#排名#` 名的玩家名 | 1.9.0 |

### 评分插件变量

| 变量 | 作用 | 最低版本 |
| :------------------------------------------------- | :---------------------------- | :------- |
| %bskyblock_likes_addon_island_likes_count% | 玩家岛屿的点赞数 | 1.7.0 |
| %bskyblock_likes_addon_island_likes_place% | 点赞数排名 | 1.7.0 |
| %bskyblock_likes_addon_island_dislikes_count% | 玩家岛屿的被踩次数 | 1.7.0 |
| %bskyblock_likes_addon_island_dislikes_place% | 被踩数排名 | 1.7.0 |
| %bskyblock_likes_addon_island_rank_count% | 玩家岛屿的排名 (赞和踩的综合) | 1.7.0 |
| %bskyblock_likes_addon_island_rank_place% | 综合排名 | 1.7.0 |
| %bskyblock_likes_addon_top_likes_owner_name_X% | 点赞数第 X 名的岛屿的岛主名 | 1.7.0 |
| %bskyblock_likes_addon_top_likes_island_name_X% | 点赞数第 X 名的岛屿名 | 1.7.0 |
| %bskyblock_likes_addon_top_likes_count_X% | 点赞数第 X 名的岛屿点赞数 | 1.7.0 |
| %bskyblock_likes_addon_top_dislikes_owner_name_X%| 被踩数第 X 名的岛屿的岛主名 | 1.7.0 |
| %bskyblock_likes_addon_top_dislikes_island_name_X% | 被踩数第 X 名的岛屿名 | 1.7.0 |
| %bskyblock_likes_addon_top_dislikes_count_X% | 被踩数第 X 名的岛屿的被踩数 | 1.7.0 |
| %bskyblock_likes_addon_top_rank_owner_name_X% | 综合排名第 X 名的岛屿的岛主名 | 1.7.0 |
| %bskyblock_likes_addon_top_rank_island_name_X% | 综合排名第 X 名的岛屿名 | 1.7.0 |
| %bskyblock_likes_addon_top_rank_count_X% | 综合排名第 X 名的岛屿的分数 | 1.7.0 |

------

最后更新: 2020年6月4日 20:58:22

## 翻译

作者需要您的帮助！

（本段话为机翻）BentoBox 及其附件中的绝大多数字符串都可以翻译成几乎任何语言。但是，BentoBox 附带的大多数翻译或所说的插件都是由社区提供的，我们在很大程度上依赖社区。我们无法审查这些翻译的所有内容，也无法保证其质量，因此，我们高度赞赏任何贡献。（机翻结束，因为这段话没什么用）

如果此插件不支持你使用的语言或者你想要润色已存在的语言，请先阅读翻译指南然后开始翻译！
如果你的语言未在下方列出，请在 Discord 上联系作者，作者会为你做翻译前的准备，然后你可以开始翻译！

| 可用 | 语言名 | 语言代码 | 进度 |
| :--- | :----------------------------------------------------------- | :------- | :----------------------------------------------------------- |
| ✅ | 美式英语 | `en-US`| 100% (默认语言) |
| ✅ | [简体中文](https://gitlocalize.com/repo/2953/zh-CN/src/main/resources/locales) | `zh-CN`| ![progress](https://gitlocalize.com/repo/2953/zh-CN/badge.svg) |
| ❌ | [繁体中文（香港）](https://gitlocalize.com/repo/2953/zh-HK/src/main/resources/locales) | `zh-HK`| ![progress](https://gitlocalize.com/repo/2953/zh-HK/badge.svg) |
| ❌ | [繁体中文（台湾）](https://gitlocalize.com/repo/2953/zh-TW/src/main/resources/locales) | `zh-TW`| ![progress](https://gitlocalize.com/repo/2953/zh-TW/badge.svg) |
| ❌ | [克罗地亚语](https://gitlocalize.com/repo/2953/hr/src/main/resources/locales) | `hr` | ![progress](https://gitlocalize.com/repo/2953/hr/badge.svg)|
| ✅ | [捷克语](https://gitlocalize.com/repo/2953/cs/src/main/resources/locales) | `cs` | ![progress](https://gitlocalize.com/repo/2953/cs/badge.svg)|
| ✅ | [法语](https://gitlocalize.com/repo/2953/fr/src/main/resources/locales) | `fr` | ![progress](https://gitlocalize.com/repo/2953/fr/badge.svg)|
| ❌ | [德语](https://gitlocalize.com/repo/2953/de/src/main/resources/locales) | `de` | ![progress](https://gitlocalize.com/repo/2953/de/badge.svg)|
| ❌ | [匈牙利语](https://gitlocalize.com/repo/2953/hu/src/main/resources/locales) | `hu` | ![progress](https://gitlocalize.com/repo/2953/hu/badge.svg)|
| ✅ | [印度尼西亚语](https://gitlocalize.com/repo/2953/id/src/main/resources/locales) | `id` | ![progress](https://gitlocalize.com/repo/2953/id/badge.svg)|
| ✅ | [意大利语](https://gitlocalize.com/repo/2953/it/src/main/resources/locales) | `it` | ![progress](https://gitlocalize.com/repo/2953/it/badge.svg)|
| ✅ | [日语](https://gitlocalize.com/repo/2953/ja/src/main/resources/locales) | `ja` | ![progress](https://gitlocalize.com/repo/2953/ja/badge.svg)|
| ✅ | [韩语](https://gitlocalize.com/repo/2953/ko/src/main/resources/locales) | `ko` | ![progress](https://gitlocalize.com/repo/2953/ko/badge.svg)|
| ✅ | [拉脱维亚语](https://gitlocalize.com/repo/2953/lv/src/main/resources/locales) | `lv` | ![progress](https://gitlocalize.com/repo/2953/lv/badge.svg)|
| ✅ | [波兰语](https://gitlocalize.com/repo/2953/pl/src/main/resources/locales) | `pl` | ![progress](https://gitlocalize.com/repo/2953/pl/badge.svg)|
| ✅ | [葡萄牙语](https://gitlocalize.com/repo/2953/pt/src/main/resources/locales) | `pt` | ![progress](https://gitlocalize.com/repo/2953/pt/badge.svg)|
| ❌ | [罗马尼亚语](https://gitlocalize.com/repo/2953/ro/src/main/resources/locales) | `ro` | ![progress](https://gitlocalize.com/repo/2953/ro/badge.svg)|
| ❌ | [俄语](https://gitlocalize.com/repo/2953/ru/src/main/resources/locales) | `ru` | ![progress](https://gitlocalize.com/repo/2953/ru/badge.svg)|
| ✅ | [西班牙文](https://gitlocalize.com/repo/2953/es/src/main/resources/locales) | `es` | ![progress](https://gitlocalize.com/repo/2953/es/badge.svg)|
| ❌ | [土耳其语](https://gitlocalize.com/repo/2953/tr/src/main/resources/locales) | `tr` | ![progress](https://gitlocalize.com/repo/2953/tr/badge.svg)|
| ❌ | [越南语](https://gitlocalize.com/repo/2953/vi/src/main/resources/locales) | `vi` | ![progress](https://gitlocalize.com/repo/2953/vi/badge.svg)|

------

最后更新: 2020年5月31日 03:48:12

BSkyBlock 配置文件汉化

代码:

https://github.com/JeansouLiu/BSkyBlock_Chinese/blob/master/src/main/resources/config.yml

# AcidIsland.

海水已被核污染，不要试图去游泳

由 tastybento 制作&维护
一些链接
GitHub 地址 (Releases)
Issue tracker
开发版本 (最新稳定版)

## 一个故事

你出生在一个岛屿上, 你发现你周围都是具有腐蚀性的海洋! 如果你爱玩 Skyblock, AcidIsland 将为你提供新的挑战!

这是 SkyBlock 的一个分支. 你将不用再担心坠落, 但是你必须时刻提防着酸水，访问其他玩家的岛屿将只能通过坐船.

## 安装

1. 安装 BentoBox 并至少启动一次服务器.
2. 放置此扩展 jar 至 bentobox\addons 文件夹(前两步可合并为创建 bentobox\addons 文件夹然后把扩展扔进去，如果你不想启动一次服务器再关闭的话).
3. 重启服务器.
4. 扩展将生成数据.
5. 关闭服务器.
6. 根据需要修改配置文件.
7. 如果配置文件的修改与世界生成有关，请删除第一次生成的世界.
8. 启动服务器.

权限
同 BSkyBlock，将权限中所有 bskyblock 替换为 acidisland
指令
同 BSkyBlock，将 bsb 改为 acid，is 改为 ai
变量
同 BSkyBlock，[gamemode] 为 acidisland (即 bskyblock —> acidisland)
Last update: May 29, 2020 16:05:21

配置文件注释翻译

代码:

https://github.com/JeansouLiu/AcidIsland_Chinese/blob/master/src/main/resources/config.yml

# SkyGrid

**SkyGrid** 是著名的天空网生存游戏. SkyBlick, SethBling 的作者在 2012 年发布了此类型的地图.

天空网游戏有目标和技巧，并且可以多人合作，技巧和方法使它非常有趣!

由 [tastybento](https://github.com/tastybento) 制作 & 维护.

有用的链接：

- [GitHub 链接](https://github.com/BentoBoxWorld/SkyGrid) ([发布页](https://github.com/BentoBoxWorld/SkyGrid/releases))
- [问题反馈](https://github.com/BentoBoxWorld/SkyGrid/issues)
- [开发版](https://ci.codemc.org/job/BentoBoxWorld/job/SkyGrid) ([最新稳定版](https://ci.codemc.io/job/BentoBoxWorld/job/SkyGrid/lastStableBuild/))

## 安装

1. 安装 BentoBox 运行一次服务器.
2. 将 jar 文件放入 BentoBox 扩展文件夹.
3. 重启服务器.
4. 插件将会创建天空网世界并生成数据文件夹，在文件夹中你会看到 config.yml.
5. 关闭服务器.
6. 根据你的需要编辑 config.yml.
7. 如果你改动了与世界生成&管理有关的设置，请删除刚刚生成的世界.
8. 再次启动服务器.

## 权限

同 BSkyBlock, 将权限中的 bskyblock 改为 skygrid

## 指令

同 BSkyBlock, 将指令中的 is 改为 skygrid

## 变量

同 BSkyBlock, 将变量中的 bskyblock 改为 skygrid

配置文件

# CaveBlock

让~~矮小~~的玩家们活在地底吧. 挖矿, 合成, 然后敲打出一个大洞 (*打洞洞*)!

由 [BONNe](https://github.com/BONNe) 开发.

一些链接

- [GitHub 仓库](https://github.com/BentoBoxWorld/CaveBlock) ([发布页](https://github.com/BentoBoxWorld/CaveBlock/releases))
- [反馈问题](https://github.com/BentoBoxWorld/CaveBlock/issues)
- [快照版](https://ci.codemc.org/job/BentoBoxWorld/job/CaveBlock) ([最新稳定版本](https://ci.codemc.io/job/BentoBoxWorld/job/CaveBlock/lastStableBuild/))

## 安装

1. 安装 BentoBox 并至少启动一次服务器.
2. 将 jar 文件放入 BentoBox 扩展文件夹.
3. 重启服务器.
4. 插件将会创建天空网世界并生成数据文件夹，在文件夹中你会看到 config.yml.
5. 关闭服务器.
6. 根据你的需要编辑 config.yml.
7. 如果你改动了与世界生成&管理有关的设置，请删除刚刚生成的世界.
8. 再次启动服务器.

## 配置文件

## 权限

同 BSkyBlock，将权限中的 bskyblock 改为 caveblock

## 指令

同 BSkyBlock，将指令中的 is 改为 cave

## 变量

同 BSkyBlock, 将变量中的 bskyblock 改为 caveblock

------

更新: 6月3日, 2020 20:26:39

# AOneBlock

**AOneBlock** 来自于 **IJAminecraft** 上一个很火的生存地图: OneBlock.
玩家需要设法在一个方块上生存下来, 看起来挺魔幻的...

由 [tastybento](https://github.com/tastybento) 开发&维护.

## 简介

OneBlock 将把你放在一片虚空中仅有的一块方块上. 你将怎么活下去?

## 开发进度

此游戏模式当前处于测试阶段.

## 指令

玩家指令为 `/ob`. 管理员指令为 `/oba`.

## FAQ

Q: 有哪些等级?

A: 共 11 个等级: 平原, 地底, 冬日, 海洋, 丛林, 沼泽, 地牢, 沙漠, 下界, 盛世, 荒芜和末地. 每个等级带有一系列方块, 物品和一些生物.

Q: 11 个等级里共有多少个方块?

A: 目前有 11,000 个!

Q: 最后一个等级之后?

A: 等级会重置.

Q: 为什么我总是掉下去死掉!

A: 你需要一些技巧才能活下来, 这并不容易! 你需要搭建护栏.

Q: 为什么有些方块出现的比较频繁?

A: 没错! 你可以在 phases 文件夹里的配置文件中设置概率.

Q. 我该怎么辨认魔力方块?

A. 打它一下, 它会冒出青烟.

Q. 我的魔力方块不见了! 我该怎么得到另一个?

A. 你需要在那放一个方块. 在最坏的情况下, 你需要杀死你自己才能生成它.

Q. 我的魔力方块是液体! 我该怎么得到它?

A. 使用桶.

Q: 那些生物可以被生成?

A: 每个等级生成的生物不同. 小心它们把你推下去! 你可能还会听到敌对型生物向你走来的声音.

Q. 敌对型生物生成时我还没反应过来!

A. 提前做好准备. 在挖掘方块时注意听，你将在它们生成之前听到它们的声音. 如果你正处于战斗等级, 搭建好护栏准备战斗吧. 你可以尝试在挖掘方块时离它远一些.

Q. 当生物生成时, 我的护栏被破坏了! 凭什么?

A. 生物的生成需要空间. 任何挡道的东西都会被破坏. 你需要重新搭建你的护栏.

Q: 会生成箱子吗?

A: 奖励箱会根据当前等级而生成. 箱子类型有普通, 特殊, 稀有和超级箱子. 好箱子会冒火花的哦.

Q: 在此游戏模式中，我有可能进入下界或末地吗?

A: 默认情况下，下界是存在的，但是没有末地.

Q: 最终目标是什么?

A: 这取决于你!

Q. 我要安装 Levels 扩展吗?

A. 这由你来决定, 但是要注意的是玩家拥有无限的方块，这将导致等级变得很高. 建议使用点赞扩展而非等级扩展.

## 安装

0. 安装 BentoBox 并至少运行一次服务器.
1. 将 jar 文件放入 BentoBox 扩展文件夹.
2. 重启服务器.
3. 插件将会创建单方块世界并生成数据文件夹，在文件夹中你会看到 config.yml.
4. 关闭服务器.
5. 根据你的需要编辑 config.yml.
6. 如果你改动了与世界生成&管理有关的设置，请删除刚刚生成的世界.
7. 启动服务器.

## 等级配置文件

等级配置文件位于 phases 文件夹.

每个等级包含两个文件 - 其中一个方块可配置方块和生物, 另一个则用于配置奖励箱.

配置文件的第一个数字代表到达该等级所需要开采的方块数. 这是每个等级设置的关键.
每个等级都有一个名字, 一个生物群系以及下面这些设置:

- 方块
- 生物

在箱子配置文件中, 则只包含等级要求和奖励箱设置.

### 方块

在方块设置部分列出了一些 Bukkit 物品，在物品名后是出现概率. All the probability values are added up for the whole phase and the chance of the block being placed is the relative probability divided by the total of all the probabilities.

### 生物

The mob section list mobs that can spawn and their relative probability along with blocks. You can only list entities that are alive and can spawn in this list.

### 奖励箱

If CHEST is listed in the blocks section, then it will be randomly filled according to this section. You can define as many chests as you like. The first number is a unique chest number. Then follows the chest contents that includes the slot number and the item stack contents. Finally there is the chest's rarity, which can be COMMON, UNCOMMON, RARE or EPIC. The best way to set chests is to do it in game. Fill a chest with the contents you want and then while looking at it enter the command `/oba setchest <phase> <rarity>` where <phase> is the name of the phase and rarity is the rarity. Use Tab Complete to see the options. The chest will be automatically added to the oneblocks.yml file and be ready to use. Deleting chests must be done by editing the oneblocks.yml file for now and reloading the addon.

Be very careful when editing the chest items and check that the material is a true Bukkit material and spelled correctly.

### Other Add-ons

OneBlock is an add-on that uses the BentoBox API. Here are some other ones that you may be interested in:

* [**Addons**](https://github.com/BentoBoxWorld/BentoBox/blob/develop/ADDON.md)

You can add all the usual addons to OneBlock, like Challeges, Likes, Level, Warps, etc. but it is not required.

## Permissions

Permissions can be found [here](Permissions).

## Commands

Commands can be found [here](Commands).

## Placeholders

Placeholders can be found [here](Placeholders).

可爱小天空

支持，建议翻译附属插件的简绍

1971106843

聊天等级显示变量有吗

Jeansou

1971106843 发表于 2020-5-17 23:11
聊天等级显示变量有吗

%Level_[gamemode]_island_level%

复制代码

1971106843

Jeansou 发表于 2020-5-19 10:36

等级

变量不能用呀，聊天我用的trchat插件，支持变量聊天的呀

Jeansou

1971106843 发表于 2020-5-19 12:44
等级变量不能用呀，聊天我用的trchat插件，支持变量聊天的呀

placeholderapi的配置文件里面
允许未验证的变量

1971106843

Jeansou 发表于 2020-5-19 17:41
placeholderapi的配置文件里面
允许未验证的变量

api里面开了运行未经验证的扩展为什么还是不行

可爱小天空

麻烦楼主翻译一下oneblock的权限谢谢了

Jeansou

1971106843 发表于 2020-5-19 23:54
api里面开了运行未经验证的扩展为什么还是不行

建议你去问一下trchat的开发者

Jeansou

1971106843 发表于 2020-5-19 23:54
api里面开了运行未经验证的扩展为什么还是不行

[gamemode] 可以是这些
bskyblock
acidisland
skygrid
caveblock
没有"[]"

1971106843

Jeansou 发表于 2020-5-23 08:39
[gamemode] 可以是这些
bskyblock
acidisland

原来如此啊

pipoa

炸了。。。

鹊吟猫

本帖最后由鹊吟猫于 2020-6-9 11:18 编辑

1.15.2服务器版本
1.13.1bentobox插件版本
1.13.1acidisland插件版本
海岛世界在没创建新海岛前旁边会生成原版世界的区块比如下图

原因和版上的生成超平坦一致嘛？

Jeansou

本帖最后由 Jeansou 于 2020-6-18 21:08 编辑

鹊吟猫发表于 2020-6-9 11:11
1.15.2服务器版本
1.13.1bentobox插件版本
1.13.1acidisland插件版本

原因差不多

mhy1993mhy

可以可以可以

2719035729

我这里出现了一个错误翻译过来就是试图执行命令时出现内部问题

Jeansou

2719035729 发表于 2020-7-4 16:10
我这里出现了一个错误翻译过来就是试图执行命令时出现内部问题

你输入了什么命令

2719035729

Jeansou 发表于 2020-7-4 16:56
你输入了什么命令

输入了is 不过不知道为什么现在又可以了。。。。。。。。。。

2719035729

本帖最后由 2719035729 于 2020-7-14 14:10 编辑

我导入默认挑战后  在输入 is challenges 就出现插件内部出现异常那个an开头的红色字体，就是那个图片第一张图
下面这个是后台报错[Server thread/ERROR]: null
org.bukkit.command.CommandException: Unhandled exception executing 'is challenges' in world.bentobox.aoneblock.commands.IslandCommand(is)
      at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:156) ~[spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at org.bukkit.craftbukkit.v1_15_R1.CraftServer.dispatchCommand(CraftServer.java:711) ~[spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.PlayerConnection.handleCommand(PlayerConnection.java:1657) ~[spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.PlayerConnection.a(PlayerConnection.java:1497) ~[spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.PacketPlayInChat.a(PacketPlayInChat.java:47) ~[spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.PacketPlayInChat.a(PacketPlayInChat.java:1) ~[spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.PlayerConnectionUtils.lambda$0(PlayerConnectionUtils.java:19) ~[spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.TickTask.run(SourceFile:18) [spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.IAsyncTaskHandler.executeTask(SourceFile:144) [spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.IAsyncTaskHandlerReentrant.executeTask(SourceFile:23) [spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.IAsyncTaskHandler.executeNext(SourceFile:118) [spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.MinecraftServer.ba(MinecraftServer.java:918) [spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.MinecraftServer.executeNext(MinecraftServer.java:911) [spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.IAsyncTaskHandler.awaitTasks(SourceFile:127) [spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.MinecraftServer.sleepForTick(MinecraftServer.java:895) [spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at net.minecraft.server.v1_15_R1.MinecraftServer.run(MinecraftServer.java:828) [spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      at java.lang.Thread.run(Unknown Source) [?:1.8.0_181]
Caused by: java.lang.NullPointerException
      at world.bentobox.challenges.panel.CommonGUI.lambda$generateChallengeDescription$4(CommonGUI.java:430) ~[?:?]
      at java.util.ArrayList.forEach(Unknown Source) ~[?:1.8.0_181]
      at world.bentobox.challenges.panel.CommonGUI.generateChallengeDescription(CommonGUI.java:355) ~[?:?]
      at world.bentobox.challenges.panel.user.ChallengesGUI.getChallengeButton(ChallengesGUI.java:370) ~[?:?]
      at world.bentobox.challenges.panel.user.ChallengesGUI.addFreeChallenges(ChallengesGUI.java:210) ~[?:?]
      at world.bentobox.challenges.panel.user.ChallengesGUI.build(ChallengesGUI.java:95) ~[?:?]
      at world.bentobox.challenges.commands.ChallengesCommand.execute(ChallengesCommand.java:77) ~[?:?]
      at world.bentobox.bentobox.api.commands.CompositeCommand.call(CompositeCommand.java:266) ~[?:?]
      at world.bentobox.bentobox.api.commands.CompositeCommand.execute(CompositeCommand.java:239) ~[?:?]
      at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:149) ~[spigot-1.15.2.jar:git-Spigot-800b93f-8160e29]
      ... 16 more

Jeansou

2719035729 发表于 2020-7-14 13:50
我导入默认挑战后在输入 is challenges 就出现插件内部出现异常那个an开头的红色字体，就是那个图片 ...

BentoBox 版本
challenge 扩展的版本
aoneblock 的版本

2719035729

Jeansou 发表于 2020-7-14 14:36
BentoBox 版本
challenge 扩展的版本
aoneblock 的版本

challenges-0.8.3
aoneblock-1.4.0
bentobox-1.14.1

Jeansou

本帖最后由 Jeansou 于 2020-8-3 10:43 编辑

2719035729 发表于 2020-7-15 08:02
challenges-0.8.3
aoneblock-1.4.0
bentobox-1.14.1

升级一下 BentoBox 版本
建议用 paper 端
aoneblock 在 spigot 上会报错

Q派

麻烦问一下wsm没有is指令我这里输入is说没有指令我用的是caveblock

Jeansou

郑宏睿XF 发表于 2020-8-10 13:24
麻烦问一下wsm没有is指令我这里输入is说没有指令我用的是caveblock

Caveblock 的指令是 /cb

Q派

Jeansou 发表于 2020-8-10 22:37
Caveblock 的指令是 /cb

非常感谢

piastic

似乎使用了%Level_bskyblock_topname1%的时候只显示了这个%Level_bskyblock_topname1%而不是具体的变量？怎么回事（懵逼）

Jeansou

piastic 发表于 2020-8-15 23:49
似乎使用了%Level_bskyblock_topname1%的时候只显示了这个%Level_bskyblock_topname1%而不是具体的变量？怎 ...

安装 level 扩展了吗
请检查变量显示的位置是否支持 placeholderapi

piastic

Jeansou 发表于 2020-8-16 10:50
安装 level 扩展了吗
请检查变量显示的位置是否支持 placeholderapi

level扩展已安装（不然怎么可能会用到排行榜）
使用的位置是trhologram，我记得是支持papi的

Jeansou

piastic 发表于 2020-8-16 12:02
level扩展已安装（不然怎么可能会用到排行榜）
使用的位置是trhologram，我记得是支持papi的 ...

PlaceholderAPI config 里有没有启用

cloud_allow_unverified_expansions: true

复制代码

另外 trhologram 或者 bentobox 可能不支持最新版的 PlaceholderAPI

Blank°

MagicCobblestoneGenerator这个扩展有教程么，我愣是没搞明白这个插件怎么改掉落这些

Jeansou

本帖最后由 Jeansou 于 2020-10-12 22:55 编辑

Blank° 发表于 2020-10-11 18:56
MagicCobblestoneGenerator这个扩展有教程么，我愣是没搞明白这个插件怎么改掉落这些 ...

~~这个不能改掉落~~

Blank°

Jeansou 发表于 2020-10-11 22:15
这个不能改掉落

就是挖圆石随机掉落的物品啊

Jeansou

本帖最后由 Jeansou 于 2020-10-12 22:53 编辑

Blank° 发表于 2020-10-12 18:38
就是挖圆石随机掉落的物品啊

参考
https://github.com/BentoBoxWorld/MagicCobblestoneGenerator/blob/master/src/main/resources/generatorTemplate.yml

tiers:
# 刷手机 ID
stone_age:
# 在游戏中显示的名称
name: "Stone Age"
# 描述
description:
- Generates cobblestone and
- stone a bit
# 图标
icon: "COBBLESTONE:1"
# 刷石机方块类型: COBBLESTONE, STONE or BASALT. Self explanatory.
type: COBBLESTONE
# 是否为默认刷石机.
# Requirements will be ignored.
default: true
# 启用刷石机的费用. Requires Vault plugin.
# Will be payed only on active switching between generators.
activation-cost: 0.0
# 掉落物和概率. Use actual blocks please.
# Chance supports any positive number.
# Everything in the end will be normalized.
blocks:
STONE: 10
COBBLESTONE: 89
GRAVEL: 1
# Treasure that has a chance to be dropped when block is generated.
# ONLY on generation, not on block break.
treasure:
# Chance from 0 till 1.
chance: 0.001
# Materials that can be dropped.
material:
COAL: 99
IRON_NUGGET: 1
# Maximal amount of items dropped.
# it will be from 1 till defined amount.
amount: 2

复制代码

worldse

弱弱的问一句，我想给部分玩家更大的空岛，应该怎么搞啊

2310472225

请问大佬村民限制和漏斗限制在哪里呀

GXLiLuoQin

1971106843 发表于 2020-5-19 23:54
api里面开了运行未经验证的扩展为什么还是不行

[gamemode]改成bskyblock啥的

1620401549

翻译挺不错的额，继续加油

明之寻

会用了谢谢楼主的辛苦付出

linxichen666

都打我吊袜带哇无无无无无

800805.

这么多标签是什么情况？

小沈wink

点不开咋办

凉城_

怎么没有矿物设置呢？

wangdiandao

网站无了，直接404

sgsshsy555

666666666666666666666666666

星殒龙之殇

网站404了啊啊啊，好可惜

xuxin233

我要光明正大的的水贴

shn_king

可以可以可以

Seuyon

请问bentobox附属Challenges的挑战任务有汉化版本吗？

maochacha

这个教程太好了，刚好适合我

沐RaM

这种好贴怎么能被解锁卡束缚

下一页最后一页