一起来开空岛服吧——bentobox系列插件配置教程
本教程跟wdsj.wiki配合使用效果更佳
前言
看到这里可能有人要问了，插件安装谁不会？？但是bentobox的安装下载确实有一些不一样，实际上，bentobox更像是一个"工具箱"或"前置插件"，它为各种插件提供了运行所必需的环境，只安装一个bentobox实际上并不能为你的服务器添加多少功能，需要安装各种扩展才能够为你的服务器添加实质性的功能。
安装注意事项
但此时距离完美的开启一个服务器还有一定的距离，为了让bentobox的各个世界能够正常工作，我个人强烈建议空岛服只添加空岛玩法，并将空岛世界设为服务器默认世界，具体步骤如下
[游戏模式]_world:
generator: BentoBox
[游戏模式]_world_nether:
generator: BentoBox
[游戏模式]_world_the_end:
generator: BentoBox
请自行将[游戏模式]替换为你自己所选的游戏模式
BentoBox介绍及常用配置详解
bentobox是一切其附属扩展的基石
1. BentoBox配置
在其配置文件中有如下项目较为重要
2. BentoBox指令
BentoBox的所有指令前的bentobox均可简写为bbox
总结一下，就是大概只有两条常用指令，/bentobox manage与/bentobox reload
3. 关于数据库的迁移
BentoBox及其所有扩展的数据存储方式都只能统一在BentoBox的配置文件中修改与设置，如果需要从一个存储方式迁移到领一个存储方式，请遵循以下步骤
本插件提供的拓展玩法，和附属的添加教程在下一篇，也可以在wdsj.wiki查看
本教程跟wdsj.wiki配合使用效果更佳
前言
- 谈到空岛插件，相信大多数服主第一反应是Askyblock，但是这个插件最终止步于1.12.2，取而代之的是一个全新的插件BentoBox，但就我观察看来，此插件国内相关教程较少，但使用此插件的服主却不少(而且问答版中也有一定数量的此插件的提问帖)，因此我认为写下一篇从零开始的bentobox使用教程是必须且必要的。
- 本教程将从安装插件开始，到各种配置文件的设置，以及我踩过的大大小小的坑都会向各位进行分享。
- 本教程适用人群
- 一切想要使用bentobox插件开服的服主
- 本教程适用环境及所需相关工具
- 服务端： Spigot/Paper/任意支持安装bentobox的服务器
- 文本编辑器：Visual Studio Code(Notepad++也可，但请不要使用Windows自带的记事本)
看到这里可能有人要问了，插件安装谁不会？？但是bentobox的安装下载确实有一些不一样，实际上，bentobox更像是一个"工具箱"或"前置插件"，它为各种插件提供了运行所必需的环境，只安装一个bentobox实际上并不能为你的服务器添加多少功能，需要安装各种扩展才能够为你的服务器添加实质性的功能。
安装注意事项
但此时距离完美的开启一个服务器还有一定的距离，为了让bentobox的各个世界能够正常工作，我个人强烈建议空岛服只添加空岛玩法，并将空岛世界设为服务器默认世界，具体步骤如下
- 删除原有的主世界、地狱、末地世界，即world、world_nether、world_the_end
- 打开server.properties，修改level-name=world为level-name=[游戏模式]_world，例如我选用bskyblock作为我的Gamemode，那么我就需要修改为level-name=bskyblock_world
- 打开bukkit.yml，为三个世界指定世界生成器，即在bukkit.yml文件的末尾添加以下一段
[游戏模式]_world:
generator: BentoBox
[游戏模式]_world_nether:
generator: BentoBox
[游戏模式]_world_the_end:
generator: BentoBox
请自行将[游戏模式]替换为你自己所选的游戏模式
BentoBox介绍及常用配置详解
bentobox是一切其附属扩展的基石
1. BentoBox配置
在其配置文件中有如下项目较为重要
general:
# 此项为语言设置，修改为zh-CN则为简体中文
default-language: en-US
...
# 此项为数据存储方式的配置，默认为json，如果服务器有配置mysql可以在此处设置
database:
# 存储方式 可以为 JSON MySQL MariaDB MongoDB SQLite PostgreSQL YAML(已启用)
type: JSON
# 以下内容省略，有数据库配置要求的同学相信自己也会弄这个，也就填一填用户名密码了
...
island:
# 此项定义了玩家进行各项操作之间的冷却时间
cooldown:
time:
# 玩家被踢出多少分钟后才能重新加入一个队伍
invite: 60
# 玩家需要等待多少分钟才能与他人组队
coop: 5
# 玩家需要等待多少分钟后才能设置信任一名玩家
truet: 5
# 玩家需要等待多少分钟后才能在解除封禁一名玩家后重新封禁他
ban: 10
# 玩家需要等待多少秒才能在重置一个岛后再次重置它
reset: 300
...
web:
github:
# 是否允许从GitHub上获取升级或其它扩展
# 如果出现无法连接网络之类的报错，可以考虑关掉这一项
download-data: true
...
2. BentoBox指令
BentoBox的所有指令前的bentobox均可简写为bbox
[B][SIZE=4]/bentobox: 显示所有指令
/bentobox version: 显示bentobox及所有扩展的版本
/bentobox about: 显示版权和协议信息
/bentobox manage: 显示管理面板 <--- 较为常用
/bentobox catalog: 显示目录(可以在这里下载&更新扩展，不推荐在这里下载更新，可能因为网络出现问题)
/bentobox reload: 重载插件，包括扩展、配置和语言 <--- 较常用，注意需要连续输入两次才可生效
/bentobox locale: 执行本地化语言文件分析(用途未知，我测试时此项会不明报错)[/SIZE][/B]
总结一下，就是大概只有两条常用指令，/bentobox manage与/bentobox reload
3. 关于数据库的迁移
BentoBox及其所有扩展的数据存储方式都只能统一在BentoBox的配置文件中修改与设置，如果需要从一个存储方式迁移到领一个存储方式，请遵循以下步骤
- 关闭服务器
- 为了保障安全，请先备份你的先前存储的数据
- 编辑plugins\BentoBox\config.yml找到database，修改下方的type选项为合适的迁移类型；例如最常见的从默认的JSON转MYSQL，那么你就需要在type后填上JSON2MYSQL，所有支持的转移方式请查阅附录中完整的BentoBox配置翻译条目
- 确保你已经填写了目标存储方式所需的信息，例如MYSQL就需要填写数据库名、登录用户名及密码，这里额外补充一点，数据库是需要你自行在MYSQL中创建的，插件只能自动为你创建数据表，而不能为你创建数据库，请务必注意
- 如果你的数据库很大，那么迁移的过程将会很长，可能会造成服务器主线程长时间未响应，为了避免服务器被watchdog终止，修改spigot.yml中的timeout-time为一个比较大的值
- 启动服务器，BentoBox将立刻进行岛屿数据的迁移
- 等待服务器完成启动之后，在控制台中输入指令bbox migrate，BentoBox会继续迁移玩家以及扩展的数据
- 完成~ 之后可以根据自己的需要，将config.yml中的迁移方式修改为目标存储方式，例如JSON2MYSQL就可以修改为MYSQL，当然不改也行，全凭自己喜好
本插件提供的拓展玩法，和附属的添加教程在下一篇，也可以在wdsj.wiki查看
最后编辑:
