教程/多人联机/ASkyBlock插件配置教程

内容来源于MCBBS,为本人原创内容。

前言

目前空岛插件主要流行于ASkyBlock和BentoBox之间，但是BentoBox插件使用较为复杂
ASkyBolck插件也算是老插件了，较多人使用，加之联机问答板块关于此插件问题较多
但是我看Wiki内联机教程板块的ASKyBlock插件教程缺少，而且自认为此介绍较为粗糙，不足以将此插件介绍完整
便打算写一篇教程来指导一下对ASkyBlock插件使用不太熟悉的服主
附：ASkyBlock支持插件版本已停留在1.12.2，如果想开大于1.12.2版本的空岛服，推荐选择BentoBox，教程在这里。
本教程将会从插件的安装到配置“手把手”的教大家学习ASkyBlock插件

本教程适合哪些人？
- 想要全面学习ASkyBlock但没有相关资料的人
- 想要学习更多插件，丰富自己知识的人

此教程需要的相关工具有哪些？
- 服务端：Spigot/PaperSpigot等支持此插件运行的服务器
- 编辑工具：Notepad++等编辑工具（电脑自带记事本除外）

插件安装

此部分为插件安装教程，将会对ASkyBlock插件的安装过程做一个详细的说明和教学，如果你是大佬可以跳过此部分，但如果你对于此插件的安装过程不太了解，我推荐学习一下

一、下载插件

到原贴内下载此插件（ASkyBlock）
到原贴下载前置插件（Vault）
提示：若未安装Vault插件，空岛奖励内容将会缺失

二、加载插件

将插件放到服务器plugins文件夹中
重启服务器来加载配置文件

三、汉化语言文件

方法一：(推荐)
- 1.将贴中汉化过的config.yml文件替换掉原文件输入/asadmin reload重载配置文件或重启服务器即可汉化完成
方法二：
- 1.加载插件后，进入服务器输入/is lang
- 2.然后输入/is lang 18即可汉化完成
方法三：
- 1.加载插件后，打开plugisn文件夹中的ASkyBlock文件
- 2.用Notepad++打开文件config.yml文件
- 3.找到文件中175行 defaultlanguage: en-US
- 4.将en-US改为zh-CN，保存文件
- 5.输入/asadmin reload重载配置文件或重启服务器即可汉化完成

指令与权限

建议将玩家基本权限全部添加给玩家权限组

玩家指令

/island - 创建一个新的空岛，打开GUI或将玩家传送到他们的空岛，家或团队
/island help - 查看空岛帮助
/island go - 传送到你的空岛
/island go - 传送到编号的家（使用/ sethome设置）
/island biomes - 打开空岛生物群系
/island expel - 从你的空岛中踢出游客
/island reset或者restart - 重启岛屿，它有一个冷却时间和最大限制，最好不要经常使用
/island lang - 方便玩家们使用他们自己国家的语言
/island level - 查看空岛等级
/island level - 查看其它空岛的等级排名
/island lock - 锁定岛屿，不让其他玩家tp到你的岛屿中
/island ms或者minishop - 打开出售或者收购商店的GUI，如果没有钱就禁用
/island top - 在排行榜里展示前十名的排名
/island sethome - 设置自己的家，如果服务器允许更多就可以创建更多的家
/island spawn - 传送到主城
/island warps - 列出可以用的其它玩家空岛传送点的GUI
/island warp - 传送到你创建好的空岛木牌传送点那里

玩家团队指令

/island invite - 邀请玩家加入你的团队，你一次只能邀请一个人
/island accept或者reject - 接受或者拒绝邀请.如果被邀请的玩家已经拥有一个团队，则原先团队将会退出
/island team - 列出团队的成员
/island teamchat - 使团队能够在不打扰他人的情况下相互聊天，必须在config.yml中设置，聊天内容可以被后台查看
/island leave -离开团队并传送到主城
/island kick或者remove - 移除团队成员，如果玩家在线，他们的所有物品都将消失，并且将被会被传送到主城。如果他们处于离线状态，他们会在登录时收到他们被移除的信息
/island makeleader - 将空岛所有权转让给团队成员，只能由所有者给予所有权

管理员指令

（通过 /asadmin 命令查看）

/asadmin reload -重新加载所有配置文件
/asadmin delete <玩家> - 删除玩家的岛屿
/asadmin completechallenge <玩家> <挑战名> - 为玩家完成挑战
/asadmin resetchallenge <玩家> <挑战名> - 重置玩家的挑战
/asadmin resetallchallenges <玩家> - 清除玩家的所有挑战
/asadmin purge [天数] - 将删除超过指定天数未登录玩家的空岛，建议先备份世界，在没有玩家的时候使用
/asadmin info <玩家> - 显示玩家和岛屿的信息
/asadmin info challenges <玩家> - 显示玩家挑战完成状态
/asadmin spy - 监听团队聊天
/asadmin topten - 列出空岛等级前十名
/asadmin unregister <玩家> - 从空岛中删除一个玩家，不删除岛屿
/asadmin clearreset <玩家> - 重置玩家的岛屿重建次数
/asadmin clearresetall - 将游戏中每个玩家的设置更改为config.yml中的设置
/asadmin setbiome <岛主> <群系> - 设定岛主的岛屿生物群系
/asadmin setrange <岛主> <距离> - 将岛主的岛屿保护范围设置为岛屿距离的最大值
/asadmin topbreeders - 列出服务器实体数量最多的10个岛屿

管理员常用指令

/asadmin register <玩家> - 将最近的岛屿注册到指定玩家（请在岛屿上使用此命令）
/asadmin setspawn - 设置空岛世界主城，主城有特殊保护
/asadmin tp <玩家> - 传送到玩家的岛屿
/asadmin unregister - 将此岛屿的岛主驱逐（请在岛上使用此命令）
/asadmin deleteisland confirm - 删除你所在的岛屿
/asadmin info - 提供你所在岛上的信息
/asadmin setrange - 设置你所在岛屿的范围

管理员团队指令

/asadmin team kick <玩家> - 将玩家踢出所在的团队
/asadmin team add <玩家> <岛主> - 添加玩家到岛主的团队

玩家基础权限

askyblock.island.*
askyblock.team.create
askyblock.team.kick
askyblock.team.makeleader
askyblock.team.join
askyblock.intopten

自定义权限

askyblock.island.maxhomes - 房子的数量
askyblock.team.maxsize - 岛屿成员的上限
askyblock.island.range - 初始保护大小

config.yml文件详解

此部分将会对配置文件config.yml文件进行讲解，已重点内容为主，几乎用不到的内容我会稍微提一点，但了解即可。
将会把config.yml分为5部分进行讲解，分别为：空岛设置、常规设置、保护设置、生物群系、岛屿类型。

空岛设置

 distance: 600
 介绍：此项用于设置空岛间距离，如果你想让玩家有充足的空间自行发展，建议设置为600。如果你想让玩家间可以互相看到，建议设置为100。
 提示：必须为偶数，最小设置为50
 
 protectionRange: 500
 介绍：此项用于设置空岛保护范围，建议设置成空间距离的百分之80，如：你空岛距离设置为100，那么空岛保护距离设置为80。
 提示：不能大于空岛距离的数值，最小设置为16
 
 startx: 0
 startz: 0
 介绍：此项用于设置空岛世界的中心，所有创建的空岛将会以此为中心生成
 
 resetlimit: 5
 介绍：此项用于设置重置空岛的最大次数
 
 resetwait: 3600
 介绍：此项用于设置玩家重置岛屿的冷却时间（秒）
 
 resetconfirmwait: 10
 介绍：此项用于设置重置空岛等待确认的时间（秒）
 
 invitetimeout: 60
 介绍：此项用于设置邀请的有效时间（秒）
 
 maxteamsize: 10
 介绍：此项用于设置空岛团队最大成员数量
 也可以对指定玩家使用askyblock.team.maxsize.<number>
 权限设置大小不能小于文件设置大小
 
 levelwait: 60
 介绍：此项用于设置空岛等级计算的时间（秒）
 
 chestItems: 'ICE:2 MELON:1 TORCH:2 BONE:1 LAVA_BUCKET:1 PUMPKIN_SEEDS:1 SUGAR_CANE:1 RED_MUSHROOM:1 BROWN_MUSHROOM:1 CACTUS:1 BREAD:1 WHEAT:1 LEATHER_BOOTS:1    LEATHER_HELMET:1 LEATHER_CHESTPLATE:1 LEATHER_LEGGINGS:1'
 介绍：此项用于设置空岛的箱子物品
 
 companion: COW
 介绍：此项用于设置空岛动物类型
 
 companionnames:
   - "&9[player]'s 的&4傻&l&6牛&l&6牛"
 介绍：此项用于设置空岛动物名称
 
 minnamelength: 0
 maxnamelength: 20
 介绍：此项用于岛屿名称设置最值大小
 
 endermandeathdrop: true
 介绍：此项用于设置末影人死亡后是否掉落它偷的物品
 
 allowcreeperdamage: true
 介绍：此项用于设置苦力怕爆炸后是否产生伤害
 
 allowcreepergriefing: false
 介绍：此项用于设置是否允许访客在到岛屿上引爆苦力怕
 
 allowtntdamage: false
 介绍：此项用于设置是否允许TNT爆炸破坏方块
 
 allowfireextinguish: false
 介绍：此项用于设置是否允许访客灭火
 
 allowchestdamage: false
 介绍：此项用于设置是否允许箱子被TNT或者生物破坏
 
 allowvisitorkeepinvondeath: false
 介绍：此项用于设置是否允许访客在他们死亡后保留他们的物品
 
 allowpistonpush: false
 介绍：此项用于是否允许活塞将物品推到保护区外
 
 allowitemframedamage: false
 介绍：此项用于是否允许生物的投射物破坏物品架

常规设置

 worldName: ASkyBlock
 介绍：此项用于设置空岛世界生存时的名称
 
 defaultlanguage: zh-CN
 介绍：此项用于选择语言文件
 
 checkupdates: false
 介绍：此项用于设置是否开启检测更新（关闭即可，作者已停止更新）
 
 maxIslands: 0
 介绍：此项用于设置空岛世界最大岛屿数量
 
 createnether: true
 介绍：此项用于设置是否允许开启空岛地狱
 
 newnether: true
 介绍：此项用于是否开启新型地狱空岛
 
 nethertrees: true
 介绍：此项用于是否开启萤石树
 
 aciddamage: 0
 介绍：此项用于设置每秒酸雨的伤害
 0=无伤害，20=瞬间死亡
 
 mobaciddamage: 10
 介绍：此项用于设置怪物受到酸雨每秒的伤害
 
 raindamage: 0
 介绍：此项用于设置雨每秒的伤害（默认为0）
 
 animaldamage: 0
 介绍：此项用于设置动物受到酸雨每秒的伤害
 
 villagerlimit: 10
 介绍：此项用于设置最大村民数量
 提示：至少需要10个村民才能建造一个刷铁场，设置为0意味着不限制
 
 entitylimits:
  CHICKEN: 10
 介绍：此项用于设置实体数量限制
 格式：生物ID:最大数量
 
 resetinventory: true
 介绍：此项用于设置领取岛屿后背包是否清空
 
 respawnonisland: false
 介绍：此项用于设置玩家死亡后是否出生在空岛
 
 usemagiccobblegen: false
 介绍：此项用于设置是否开启刷石机生成矿石
 
 magiccobblegenchances:
     default:
       COBBLESTONE: 75.0
       STONE: 20.0
       COAL_ORE: 1.0
       IRON_ORE: 1.0
       DIAMOND_ORE: 0.2
       EMERALD_ORE: 0.1
       REDSTONE_ORE: 2.7
 介绍：此项用于设置不同高度矿物生成的几率
 默认几率 原石：75.0   石头：10.0  煤矿：7.5  铁矿：5.0  钻石矿：2.0  绿宝石矿：0.5
     500:
       COBBLESTONE: 75.0
       STONE: 20.0
       COAL_ORE: 1.0
       IRON_ORE: 1.0
       REDSTONE_ORE: 2.7
       DIAMOND_ORE: 0.2
       EMERALD_ORE: 0.1
 介绍：此项用于设置不同高度矿物生成的几率

保护设置

 ACID_DAMAGE: true
 介绍：此项用于设置是否开启酸雨会导致海平面以上生物受到伤害
 
 ENTER_EXIT_MESSAGES: true
 介绍：此项用于设置是否开启岛屿加入/离开信息
 
 FIRE: true
 介绍：此项用于设置是否允许用火
 
 DOOR: false
 介绍：此项用于设置是否允许访客使用活板门或门
 
 FURNACE: false
 介绍：此项用于设置是否允许访客使用熔炉
 
 GATE: false
 介绍：此项用于设置是否允许使用门
 
 ANVIL: true
 介绍：此项用于设置是否允许访客使用铁站
 
=== 生物群系 ===
 defaultcost: 100
 介绍：此项用于设置每次玩家换生物群系时的花费
 
 defaultbiome: PLAINS
 介绍：此项用于设置默认的生物群系
 
 biomes:
  COLD_BEACH:
    icon: SAPLING
    friendlyname: "&b雪山"
    description: "&b下雪且异常寒冷"
  DESERT:
    icon: DEAD_BUSH
    friendlyname: "&e沙漠"
    description: "&e一个干燥的沙漠.|&e注意这里没有雨和雪."
  MUTATED_FOREST:
    icon: RED_ROSE
    friendlyname: "&a花森林"
    description: "树和花并存的森林!"
  HELL:
    icon: LAVA_BUCKET
    cost: 1000
    permission: askyblock.biomes.hell
    friendlyname: "&c地狱"
    description: "&e警告所有雪、水、冰都不存在"
  JUNGLE:
    icon: VINE
    friendlyname: "&2丛林"
    description: "&a葱葱郁郁的丛林|注意这里没有雨和雪"
    #permission: any.perm.you.want
  MUSHROOM_ISLAND:
    icon: RED_MUSHROOM
    permission: askyblock.biomes.mushroom_island
    friendlyname: "&c蘑菇岛"
    description: "&c蘑菇岛"
  PLAINS:
    icon: GRASS
    description: "免费的普通生物群系"
    cost: 0
  SWAMPLAND:
    icon: WATER_LILY
    friendlyname: "&e沼泽"
    description: "&2史莱姆的生产地.|&e注意这里没有雨和雪."
  MESA:
    icon: HARD_CLAY
    friendlyname: "&e贫瘠地"
    description: " &4单调而干燥，人见人厌.|&4注意没有雨雪冰"
    cost: 500
  SAVANNA:
    icon: LONG_GRASS
    friendlyname: "&e大草原"
    description: "&e单调而干燥.|&e注意这里没有雨和雪"
  ROOFED_FOREST:
    icon: LOG
    friendlyname: "&l&e黑森林"
    description: "&6木和树"
 介绍：此项用于设置玩家可选的生物群系

岛屿类型

 show: true
 介绍：此项用于设置选择空岛时此空岛类型是否显示
 
 icon: DIRT
 介绍：此项用于设置选择空岛时此类型显示的物品
 
 name: "&c&l>>>&e&l普通空岛&c&l<<<"
 介绍：此项用于设置选择空岛类型时此类型显示的空岛名称
 
 description: "&a&l>>>  &7少量的资源|&a&l>>>  &7无限的可能！"
 介绍：此项用于设置选择空岛类型时此类型显示的空岛介绍
 
 filename: island.schematic
 介绍：此项用于设置选择空岛的模板
 
 cost: 0
 介绍：此项用于设置选择此空岛时的花费

controlpanel.yml文件详解

controlpanel.yml文件为空岛的帮助菜单，菜单内包含了常用的空岛指令，如：挑战，传送空岛，查看空岛等级等。
你也可以对菜单进行自定义更改。
此部分将会对菜单格式进行讲解，方便有需要的服主进行更改。

菜单格式如下：

default:
  panelname: '菜单名'
  buttons:
    位置:
      material: 物品ID
      description: '物品显示名'
      command: '执行指令'
      nextsection: '物品显示Lore'

default: 无需更改
panelname：' ' 设置菜单名称，支持颜色
buttons: 下面写菜单内容
位置: 这里从0开始往下写，按照0.1.2.3的顺序
material: 菜单中位置展示的物品，支持填写数字ID
description: ' ' 点击时物品显示的物品名
command: ' ' 点击时执行的指令。格式为 [参数1] 参数二，举个栗子：回到空岛指令 [island] go
nextsection: ' ' 点击物品时显示的Lore

实例：

 default:
  panelname: '&1空岛帮助菜单'
  buttons:
    0:
      material: 2
      description: '&7回到你的空岛'
      command: '[island] go'
      nextsection: ''
    1:
      material: 264
      description: '&9打开迷你商店'
      command: '[island] ms'
      nextsection: ''

challenges.yml文件详解

challenges.yml为空岛的任务系统。
你也可以对任务系统进行自定义更改。
添加更多的任务。
此部分将会对任务格式进行讲解，方便有需要的服主进行更改。

挑战系统格式如下：

 任务名:
  friendlyname: '任务名'
  description: '任务内容'
  icon: 显示物品ID
  level: '等级'
  type: inventory
  requiredItems: '需要的物品ID:数量'
  takeItems: true
  itemReward: '奖励物品ID:数量'
  rewardText: '奖励物品内容'
  moneyReward: 给予金币数量
  expReward: 给予经验数量
  permissionReward: '给予的权限'
  repeatable: 是否可重复完成
  repeatItemReward: '需要的物品ID:数量'
  repeatRewardText: '奖励物品内容'
  repeatMoneyReward: 给予的金币数量
  repeatExpReward: 给予的经验数量
  maxtimes: 最多可重复完成的次数

任务名: 可随意更改，不可以重复
friendlyname: ' ' 显示的任务名
description: ' ' 显示任务内容，通常写任务介绍和完成任务所需物品
repeatable: 是否可重复完成
repeatItemReward: ' ' 下次完成时需要的物品ID:数量
repeatRewardText: ' ' 下次完成时奖励物品内容
repeatMoneyReward: 下次完成时给予的金币数量
repeatExpReward: 下次完成时给予的经验数量
maxtimes: 最多可重复完成的次数

实例：

 breadmaker:
  friendlyname: '面包师'
  description: '制作64个面包'
  icon: BREAD
  level: '新手'
  type: inventory
  requiredItems: 'BREAD:64'
  takeItems: true
  itemReward: 'DIRT:5'
  rewardText: '5个泥土'
  moneyReward: 10
  expReward: 30
  permissionReward: ''
  repeatable: true
  repeatItemReward: 'DIRT:1'
  repeatRewardText: '1个泥土'
  repeatMoneyReward: 5
  repeatExpReward: 10
  maxtimes: 100

minishop.yml文件详解

minishop.yml为空岛迷你菜单，可以出售一些基本物品
不推荐使用，建议使用一些专属的商店插件
你也可以对商店内容进行自定义更改。
此部分将会对商店进行讲解，方便有需要的服主进行更改。

商店格式如下：

 商品名称:
   material: 出售物品ID
   quantity: 数量
   price: 价格
   description: '物品显示名'

商品名称: 随意设置，必须英文，不可以重复
material: 出售的物品ID，支持数字ID
quantity: 购买后给予的物品数量
price: 出售的价格
description: 点击物品时显示的物品名,支持颜色

实例：

 item4:
   material: GRASS
   quantity: 1
   price: 150
   description: '&a草方块'

常见问题

此部分将会对服主们使用ASkyBlock插件时遇到的问题进行详细的总结，每个问题都给出了正确的解答。

如何在岛屿设置传送点

解决方法：

在你想要传送的地方放置一个告示牌
告示牌内容填：
第一行 [传送点]
第二行 自定义内容
如果你发现告示牌文字变绿，说明传送点创建成功

如何防止玩家通过活塞将方块推到岛外

解决方法：

打开plugins/ASkyBlock/config.yml文件，找到allowpistonpush:true，将其改为fasle
输入/asadmin reload重载配置文件或重启服务器即可完成

如何防止玩家创建空岛后背包清空

解决方法：

打开plugins/ASkyBlock/config.yml文件，找到resetinventory:true，将其改为fasle
输入/asadmin reload重载配置文件或重启服务器即可完成

怎么修复领取的挑战奖励内容缺少

解决方法：

对此情况有两种情况
情况一：你在配置challenges.yml文件时出现错误，如：物品ID错误，格式错误等
情况二：确实前置插件（Vault）

怎么修复玩家没有权限使用火

解决方法：

打开plugins/ASkyBlock/config.yml文件，找到FIRE: false，将其改为true
之后在游戏中输入指令/asadmin settingsreset all即可解决
若还未解决，那应该是其他插件导致的。
如：Essentials、CMI等。
以Essentials举例子，打开plugins/Essentials/config.yml
找到flint-fire: true 改为false
输入/ess reload重载配置文件或重启服务器即可完成

心得分享

因为个人开空岛服两年，积累了一点经验，想分享给各位学习者，希望对各位有所帮助
首先，尽量不要给玩家飞行权限，因为空岛的游戏难度就是因为虚空，如果给予了玩家飞行权限，那么被给予权限的人过不了多久可能会感觉到无聊，而那些没有权限的人，会感觉到*不公平，这导致游戏的平衡度不法保持
其次，初期不要给玩家太多物品，尤其是空岛MOD的服务器，可能你给玩家的物品，玩家的发展将会有质的提升，但这导致游戏的耐玩性极大地减少
然后，服务器中OP或者服主不要太多的干涉玩家的发展，让玩家靠自己，从中获得成就感，便可以激发对服务器的热情
最后，希望你看到这里，已经对ASkyBlock插件有了一定的了解，希望你继续学习，提高自己的技术能力，共同推动国内服务器发展。

教程/多人联机/ASkyBlock插件配置教程

WIKI功能

目录

前言

插件安装

指令与权限

玩家指令

玩家团队指令

管理员指令

管理员常用指令

管理员团队指令

玩家基础权限

自定义权限

config.yml文件详解

空岛设置

常规设置

保护设置

岛屿类型

controlpanel.yml文件详解

challenges.yml文件详解

minishop.yml文件详解

常见问题

推荐搭配插件

心得分享