[MD][/MD]
[MD]# 基岩版的空岛插件

- 文档地址:[docs](http://docs.chuxiao.xyz/)
[/MD]
Skyblock 2.0 - 空岛简介
岛屿生成
给每位玩家创建单独的空岛
岛屿范围保护
岛屿范围保护,免去烦恼
岛屿等级计算
等级系统,激励玩家游玩兴趣
岛屿传送点设置
岛屿之间互动
岛屿邀请功能,多人同岛
合作共赢
食用方法
BUG反馈群: 173011240
指令操作
[MD]# 开始
## 准备工作
- 安装了`liteloaderBDS`服务端
- 任意文本编辑器
## 安装
1. 下载插件 [skyblock](https://www.minebbs.com/resources/trendsky-3-0.4264/)
2. 解压并解压 `skyblock.zip` 文件 , 将得到的文件全部放入 plugins 目录下
```diff
├── plugins
+│ ├── skyblock
+│ ├── skyblock.js
```
3. 启动你的服务器 , 并观察控制台输出
```bash
[skyblock] skyblock is ranning ...
```
4. 服务器启动完成后 , 请根据自己的需求 修改config `skyblock\config.json` 配置文件
修改完成后 , 输入以下指令 , 重载插件
```bash
ll reload skyblock.js
```
# 指令一览
## 指令表
| 指令 | 描述 | 权限|
| ---- | ---- |---- |
|/is | 打开空岛菜单 | 玩家|
|/is create | 创建空岛 | 玩家|
|/is delete | 删除空岛 | 玩家|
|/is spawn | 返回空岛 | 玩家|
|/is set perms | 设置岛屿权限 | 岛主|
|/is is set spawn | 设置岛屿出生点 | 玩家|
|/is invite \<player> | 邀请玩家加入岛屿 | 玩家|
|/is invite accept |接受邀请 | 玩家|
|/is invite refuse | 拒绝邀请 | 玩家|
|/is kick \<player> | 踢出玩家 | 岛主|
|/is warp create | 创建传送点 | 玩家|
|/is warp delete | 删除传送点 | 玩家|
|/is warp list | 查看传送点列表 | 玩家|
|/is level get | 查询等级 | 玩家|
|/is level top | 等级排行 | 玩家|
|/is level setvalue | 设置手中方块价值 | OP|
|/is perms add | 添加信任权限 | 玩家|
|/is perms set | 设置信任名单 | 玩家|
|/is perms list | 信任列表 | 玩家|
|/is tip | 设置岛屿欢迎语 | 玩家|
|/is manage | 岛屿管理 | OP|
|/is manage set | 管理自定义岛屿 | OP|
|/is manage proxy | 代理岛屿 | OP|
|/is manage exit | 退出代理岛屿 | OP|
|/is manage tp \<name> \<warpName> | 传送至自定义岛屿 | 玩家|
## 可能有疑惑的指令
### 传送至自定义岛屿
`/is manage tp <name> <warpName>`
` <name>` 岛屿名
`<warpName>` 传送点名
例 : `/is manage tp 主城 出生点` 即 执行这条指令的玩家将会被传送至 名为主城的岛屿所设置的名为出生点的传送点
# 配置文件
## 主要配置项
文件路径 `skyblock/config.json`
```json
"language": "zh_cn", // 语言
```
```json
"island": {
"x": 0, // 起始岛屿坐标
"y": 0,
"range": 64, // 岛屿范围
"distance": 800 // 岛屿间隔
}
```
::: warning
`island` 中的 `x` `y` 配置项在创建岛屿后请勿再次修改
:::
```json
"base": {
"respawn": [0, 10, 0, 0], // 删除岛屿后会被传送的位置
"reset_limit": 3, // 删除岛屿次数闲置
"member_limit": 3, // 最大岛屿成员限制
"open_the_end": true, // 是否开放末地
"open_the_nether": true // 是否开放地狱
},
```
```json
"blueprint": [
{
"name": "经典空岛", // 模板名称
"type": "sky1", // 模板文件(无需后缀)
"x": 9, // 模板 长度
"y": 63, // 加载高度
"z": 9, // 模板 宽度
"offset": [ // 偏移
0, // x
5, // y
2 // z 中心点向z轴方向偏移两格
],
"description": "经典空岛,原汁原味。" // 模板描述
},
],
```
```json
"worldPermission": { // 世界权限 参见下
"destroy_block": false,
"place_block": false,
"drop_item": true,
"take_item": true,
"atk_friendly_mob": false,
"atk_hostile_mob": false,
"atk_player": false,
"allow_ues_crafting_table": true,
"allow_ues_furnace": false,
"allow_ues_blast_furnace": false,
"allow_ues_smoker": false,
"allow_ues_enchanting_table": true,
"allow_ues_beacon": false,
"allow_open_anvil": false,
"allow_open_barrel": false,
"allow_open_hopper": false,
"allow_open_chest": false,
"allow_open_dropper": false,
"allow_open_dispenser": false,
"allow_open_shulker_box": false,
"allow_open_firegen": false,
"allow_use_projectile": false,
"allow_use_bucket": false
}
```
## 权限列表
| 权限名称 | 描述 |
|-----------------------------|---------------------|
| destroy_block | 允许破坏方块 |
| place_block | 允许放置方块 |
| drop_item | 允许丢出物品 |
| take_item | 允许拾取物品 |
| atk_friendly_mob | 允许攻击动物 |
| atk_hostile_mob | 允许攻击敌对生物 |
| atk_player | 允许攻击玩家 |
| allow_ues_crafting_table | 允许使用工作台 |
| allow_ues_furnace | 允许使用熔炉 |
| allow_ues_blast_furnace | 允许使用高炉 |
| allow_ues_smoker | 允许使用火炉 |
| allow_ues_brewing_stand | 允许使用酿造台 |
| allow_ues_enchanting_table | 允许使用附魔台 |
| allow_ues_beacon | 允许操作信标 |
| allow_open_anvil | 允许使用铁砧 |
| allow_open_barrel | 允许打开桶 |
| allow_open_hopper | 允许打开漏斗 |
| allow_open_chest | 允许打开箱 |
| allow_open_dropper | 允许打开投掷器 |
| allow_open_dispenser | 允许打开发射器 |
| allow_open_shulker_box | 允许开潜匿箱 |
| allow_open_firegen | 允许使用打火石 |
| allow_use_projectile | 允许使用弹射物 |
| allow_use_bucket | 允许使用空桶 |
<!-- > 参见 [岛屿权限列表](main/permission.md) -->
> TODO
# 常见问题
## 地狱/末地有岛屿保护怎么办?
在配置文件开放末地
## 为什么我删除了岛屿 , 但岛屿范围内的建筑都还在?
出于玩家误操作的的考虑 , 玩家执行删除岛屿操作后 , 仅会将其岛屿数据删除 , 并不会清空岛屿所在区域的方块
## 插件自带菜单与其他菜单冲突了 , 怎么办 ?
删除 `skyblock\plugins\islandMenu/js`文件 其他功能同理(...)
[/MD]