Bentobox

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

支持 BentoBox

通过成为 sponsor through GitHub 或 donate via PayPal 来赞助作者. 我们希望你会喜欢我们的作品!

下载

在 https://download.bentobox.world 下载懒人包

游戏模式

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

• BSkyBlock - 你们应该都知道


• AcidIsland - 在酸海中生存


• CaveBlock - 咚咚咚咚咚帕


• SkyGrid - 恐怖的网状地图


• AoneBlock - 你出生在一个石头上，然后呢？

快速入门

• 安装 Bentobox
  
  视频教程（英文） https://www.bilibili.com/video/BV1Qc411h7Ug/ 说明 Bentobox 是一个强大且仅有的插件。以下是经 Bentoboxworld 讨论得出的最简洁的安装方法。 相比其他 Spigot 插件的拖拽式安装，Bentobox 的安装可能会花费一些时间，但是你值得花费这些时间来为你的服务器带来无穷可能。 让我们开始吧！ 下载 Bentobox 稳定版目前可在 Spigot 论坛页面或 GitHub release 页面下载。未经测试的开发版可在 Jenkins 下载。 配置 BentoBox 插件下载完成后，你需要把它丢到服务器的 plugins 文件夹。与 ASkyBlock 不同的是 BentoBox 不需要任何前置插件：但是它会自动与某些插件绑定来增强插件的功能。（比如 Vault、PlaceholderAPI、Multiverse-Core 等） 启动服务器并等待插件完全加载。如果你现在进入服务器，你会发现服务器什么也没有发生。事实上，BentoBox 本身没有任何作用：你只有给它添加插件才能让它“学会”运行一个 SkyBlock 游戏。 OK，现在关闭你的服务器。我们来看看 BentoBox 的配置文件 config.yml 安装扩展 扩展系统是 BentoBox 的特殊所在。但是，这不是普通的扩展：你不能把它们放在 plugins 文件夹。 首先你需要下载你所需要的扩展。官方扩展可在这里找到，同样它们需要在 Release 页面下下载。此网站可以帮助你更容易地下载插件。 最后你需要将下载的扩展放到 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 关闭。 一定要备份哦！ 打开 spigot.yml 并调高 timeout-time，比如 60000 关闭服务器，把 Spigot 1.14.4+ 的服务端 jar 文件放到服务器所在文件夹 删除 ASkyBlock.jar 。不要删除 ASkyBlock 文件夹和世界！ 安装 BentoBox 1.12.0 以上版本 给服务器启动脚本添加 --forceUpgrade 并启动，这将把所有世界升级至最新版本的格式 看到 BentoBox 图案后，关闭服务器 安装 BSkyBlock 扩展、Challenges 扩展、Warps 扩展和Converter 扩展 启动服务器，不要删除 --forceUpgrade 服务器启动后（看到 BentoBox 的 logo 后），输入指令: bsb convert 转换结束后，关闭服务器。！！！关闭服务器而不是输入 reload！！！，否则岛屿世界管理将不能正常工作。 根据你的需要编辑 BSkyBlock 的配置文件 编辑 spigot.yml 并恢复 timeout-time 的原始大小: 比如 60 移除 converter 扩展并删除自动生成的 BSkyBlock 默认世界 删除 --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 提供，但某些插件也提供一些属性。 标签大全见此，或见下一节 设置中心 岛屿所有者可通过设置中心调整岛屿设置。其他玩家（包括岛屿成员）只能查看。 要打开此菜单请使用 /[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 启动服务器，你已经完成了安装 不管你使用的是什么变量 API，你只需要启动服务器。BentoBox 会帮你做好一切 如何在聊天窗口显示变量 如果你使用 EssentialsChat + PlaceholderAPI，你还需要安装 ChatInjector 插件。但是它可能会引发一些问题 我们推荐你使用像 ChatControl 这样支持 PlaceholderAPI 的聊天插件 我可以建议一个新变量吗 到这里提交 placeholder request 各游戏模式的自带变量 可用变量 变量 作用 版本 %[游戏模式]_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] ，该告示牌的内容将在生成岛屿时替换为该游戏模式语言文件内设置的值 提示 & 建议 我们建议你把初始岛屿设置的小一点，初始物品设置多一点，以增加挑战性 尝试创建群岛(上下或左右)，让玩家建筑才能得到资源 如果你连同空气一起制作蓝图，请将选区尽可能缩小 复制完蓝图后，把他粘贴出来检查是否完整

  
  

• 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 可在这里找到 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 上找到

• 插件如何从扩展中获取数据
  
  The Request Handler API 此 API 用于获取扩展数据。哪些数据可以共享取决于你的设置。由于 Java 类加载器的安全设置，插件不可以直接使用扩展内部的类。 示例(Level Addon) Level 扩展共享两个 Request Handler(LevelRequestHandler 和 TopTenRequestHandler)。以下是插件获取玩家岛屿等级的方法 LevelRequestHandler Label: island-level Input map: Key: world-name -> String Value: player -> UUID 因此，这个代码应该是这样的： 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。示例： // 声明 request handlers         registerRequestHandler(new LevelRequestHandler(this));         registerRequestHandler(new TopTenRequestHandler(this)); handler 需在它的 constructor 中定义 label，如： public LevelRequestHandler(Level addon) {         super("island-level"); // label 是 "island-level"         this.addon = addon;     } label 不可与其它扩展冲突 然后，覆盖 handle 方法使其映射为参数 @Override     public Object handle(Map<String, Object> map) { 你可以定义映射内容，但 Object 一定不能是只存在于你的扩展的类。它只能是所有插件都使用的类。如果你引用一个隐藏的类，插件会发生错误。因此、整型、长整型、Bukkit Locations、Worlds 等是可以使用的。 在注释中写上你的映射是一个好习惯 /*             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)          */ 处理映射并输出结果： 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 main version name 作用：声明此扩展的名称 如： name: "Your_Addon" 注意：1.只允许字母数字和下划线(a-z,A-Z,0-9, _)。2.空格将被自动转为下划线。3.这将用于识别该扩展。4.将在用户执行 /bsadmin version Your_Addon  时显示。 main 作用：类 BSAddon 的路径 如： 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 作用：你的扩展的版本 如： 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 description website authors 作用：列出作者 如： 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 作用：你的扩展的简介 如： 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 作用：作者的网站 如： 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
  

FAQ

安装

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

最简单的方式就是从这里下载 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, BSkyBlock#247.

超平坦世界. (来源: 1213videogamer on PlanetMinecraft).

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

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

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

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

可能的原因

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

为什么?

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

解决方案

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

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

为什么?

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

解决方法

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

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

为什么?

这是一个常见错误.

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

# 为这个世界使用你的世界生成器.

# 如果设为 true，插件将不会生成任何东西.

# 且你必须在 bukkit.yml 里指定世界名称和生成器.

# 见 https://bukkit.gamepedia.com/Bukkit.yml

use-own-generator: false

解决方案

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

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

为什么?

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

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

解决方案

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

BENTOBOX 或者其扩展有 BUG

为什么?

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

解决方案

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

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

如果问题仍然存在, 说明这是 BentoBox 的问题. 请在 bug tracker 上反馈.

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

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

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

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

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

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

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

# 每 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.

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

如果你的服务器安装了 GriefPrevention 插件, 有一个选项 会阻止玩家种植 "Sky Trees".

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

AcidIsland.

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

一个故事

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

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

安装

1. 安装 BentoBox 并至少启动一次服务器.


2. 放置此扩展 jar 至 bentobox\addons 文件夹(前两步可合并为创建 bentobox\addons 文件夹然后把扩展扔进去，如果你不想启动一次服务器再关闭的话).


3. 重启服务器.


4. 扩展将生成数据.


5. 关闭服务器.


6. 根据需要修改配置文件.


7. 如果配置文件的修改与世界生成有关，请删除第一次生成的世界.


8. 启动服务器.

SkyGrid

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

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

由 tastybento 制作 & 维护.

有用的链接：

• GitHub 链接 (发布页)


• 问题反馈


• 开发版 (最新稳定版)

安装

1. 安装 BentoBox 运行一次服务器.


2. 将 jar 文件放入 BentoBox 扩展文件夹.


3. 重启服务器.


4. 插件将会创建天空网世界并生成数据文件夹，在文件夹中你会看到 config.yml.


5. 关闭服务器.


6. 根据你的需要编辑 config.yml.


7. 如果你改动了与世界生成&管理有关的设置，请删除刚刚生成的世界.


8. 再次启动服务器.

权限

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

指令

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

变量

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