Configuration

Configuration is divided into multiple files, below is out-lined the most basic usage of each.

config.yml

This holds the primary configuration for uSkyBlock, i.e. the world, the size of islands, etc.

version: '2.0.1 Do not change!'
options:
  general:
    maxPartySize: 4
    worldName: skyworld
    spawnSize: 150
    cooldownInfo: 30
    cooldownRestart: 600
    biomeChange: 3600
  island:
    schematicName: yourschematicname
    distance: 110
    removeCreaturesByTeleport: false
    height: 150
    chestItems: '79:2 360:1 81:1 327:1 40:1 39:1 361:1 338:1 323:1'
    addExtraItems: true
    extraPermissions:
      smallbonus: '4:16 320:5'
      mediumbonus: '50:16 327:1'
      largebonus: '3:5 12:5'
      giantbonus: '2:1 110:1'
      extremebonus: '352:8 263:4'
      donorbonus: '261:1 262:32 272:1'
    worldGuardFlags:
      ALL:
        pvp: 'deny'
        destroy-vehicle: 'deny'
        entity-item-frame-destroy: 'deny'
        entity-painting-destroy: 'deny'
    protectionRange: 105
    allowPvP: deny
    allowIslandLock: true
    useOldIslands: false
    useIslandLevel: true
    useTopTen: true
  extra-menus:
    7:
      title: '§a§lBuy Perks'
      displayItem: CHEST
      commands:
       - 'chestcommands open perks'
      lore:
       - '§fVisit the perk shop to buy'
       - '§fspecial abilities for your'
       - '§fisland and character, as well'
       - '§fas titles and more.'
       - '§e§lClick here to open the shop!'
    16:
      title: '§a§lBuy Donor Perks'
      displayItem: ENDER_CHEST
      commands:
       - '[group.donor]chestcommands open donor'
       - '[!group.donor]donate'
      lore:
       - '§fThis special perk shop is'
       - '§7fonly available to donors!'
       - '[group.donor]§e§lClick here to open the shop!'
       - '[!group.donor]§a§7Click here to become a donor!'
  extras:
    sendToSpawn: false
    obsidianToLava: true

challenges.yml

This file holds all your challenges. Currently, only 4 ranks are supported (see issue X)

Below is some of the most common challenges

version: '2.0.1 Do not change'
allowChallenges: true
broadcastCompletion: true
broadcastText: '§6'
ranks: 'Easy Medium Hard Master'
requirePreviousRank: true
rankLeeway: 1
defaultResetInHours: 144
challengeColor: '§e'
finishedColor: '§2'
repeatableColor: '§a'
enableEconomyPlugin: true
challengeList:
  cobblestonegenerator:
    description: 'Mine from a cobblestone generator.'
    rankLevel: Easy
    type: onPlayer
    requiredItems: '4:64;+2'
    resetInHours: 20
    displayItem: 4
    takeItems: true
    itemReward: '334:3'
    permissionReward: none
    rewardText: 3 leather
    currencyReward: 10
    xpReward: 30
    repeatable: true
    repeatItemReward: '334:1'
    repeatRewardText: 1 leather
    repeatCurrencyReward: 2
    repeatXpReward: 5
  novicebuilder:
    description: 'Reach island level 20.'
    rankLevel: Easy
    type: islandLevel
    requiredItems: 20
    takeItems: false
    itemReward: '257:1 3:5'
    rewardText: 1 iron pickaxe and 5 dirt
    currencyReward: 50
    xpReward: 50
    permissionReward: none
    repeatable: false
  homeowner:
    description: 'Build a house with furnishings.'
    rankLevel: Medium
    type: onIsland
    requiredItems: '26:1 58:1 20:1 64:1 61:1 47:1 50:1'
    takeItems: false
    itemReward: '84:1 2267:1 22:10'
    rewardText: '1 jukebox, 1 music disk and 10 lapis lazuli blocks'
    currencyReward: 100
    xpReward: 100
    permissionReward: none
    repeatable: false