Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/BG-Software-LLC/SuperiorSkyblock2/llms.txt

Use this file to discover all available pages before exploring further.

The upgrade system allows islands to progressively enhance their capabilities by purchasing upgrades. Each upgrade has multiple levels with increasing costs and benefits.

​
Opening the Upgrades Menu

Access the upgrades interface: 
/island upgrade
This displays all available upgrades, showing:
  • Current level
  • Next level cost
  • Benefits of upgrading
  • Maximum level
The upgrades menu is fully customizable through configuration files. Server administrators can create unlimited upgrade types with custom effects.

​
Purchasing Upgrades

1

Open the upgrades menu

Use /island upgrade to view available upgrades.
2

Select an upgrade

Click on the upgrade you want to purchase. Each upgrade shows its requirements and benefits.
3

Confirm purchase

If you meet the requirements, confirm the upgrade. Money will be withdrawn from the island bank.
Alternatively, use the rankup command: 
/island rankup
This levels up an upgrade directly (if configured). Requirements:
  • superior.island.rankup permission
  • RANKUP island privilege (Member role and above by default)
  • Sufficient funds in island bank
  • Previous upgrade level completed (if applicable)

​
Available Upgrade Types

SuperiorSkyblock2 includes several built-in upgrade types:

​
Island Size

Expands the boundaries of your island, giving you more space to build. Benefits:
  • Larger build area
  • More room for farms and structures
  • Increased block placement capacity

​
Team Limit

Increases the number of members that can join your island. Benefits:
  • More players can collaborate
  • Greater workforce for projects
  • Enhanced community experience

​
Warps Limit

Allows you to create more island warps for visitors. Benefits:
  • More teleport locations
  • Better visitor navigation
  • Showcase multiple areas

​
Block Limits

Increases the limit for specific blocks (like hoppers). Benefits:
  • Place more valuable blocks
  • Build larger automated farms
  • Reduce placement restrictions

​
Entity Limits

Increases the limit for specific entities (like minecarts, animals). Benefits:
  • More mob farms
  • Larger animal pens
  • Enhanced automation

​
Crop Growth Multiplier

Speeds up crop growth rates on your island. Benefits:
  • Faster farming
  • Increased production
  • Better efficiency

​
Spawner Rates Multiplier

Increases the spawn rate of mob spawners. Benefits:
  • More mob spawns
  • Better mob farms
  • Increased drops

​
Mob Drops Multiplier

Increases the drops from killed mobs. Benefits:
  • More resources from mobs
  • Better loot rates
  • Increased economy income

​
Generator Rates

Customizes the cobblestone generator percentages. Benefits:
  • Generate valuable ores
  • Custom generator compositions
  • Better resource generation

​
Island Effects

Applies potion effects to all island members while on the island. Benefits:
  • Speed, Haste, Jump Boost, etc.
  • Permanent effects while on island
  • Enhanced gameplay experience

​
Bank Limit

Increases the maximum money that can be stored in the island bank. Benefits:
  • Store more money
  • Save for expensive upgrades
  • Better economy management

​
Upgrade Costs

Each upgrade level can require:
  • Money: Withdrawn from island bank
  • Items: Removed from player inventory
  • Permissions: Custom permission checks
  • Commands: Executed on upgrade
Upgrade costs are fully configurable and can include multiple requirement types. Failed upgrades do not consume resources.

​
Upgrade Commands

Player commands: 
# Open upgrades menu
/island upgrade

# Rankup an upgrade
/island rankup
Admin commands: 
# Set upgrade level for an island
/admin setupgrade <player> <upgrade> <level>

# Rankup an upgrade for an island
/admin rankup <player> <upgrade>

# Sync upgrade values
/admin syncupgrades <player>

​
Upgrade Configuration

Upgrades are configured in the upgrades module folder. Each upgrade is defined with: 
upgradeName:
  '1':  # Level 1
    cost:
      money: 10000
      items:
        - DIAMOND:64
    commands:
      - 'broadcast {0} upgraded their island!'
    island-effects:
      SPEED: 1
  '2':  # Level 2
    cost:
      money: 25000
    island-effects:
      SPEED: 2
      JUMP: 1
Upgrade values can override default island values. For example, setting generator rates in an upgrade will replace the default generator configuration.

​
Built-in Value Synchronization

Certain upgrades have “built-in values” that automatically sync:
  • Crop growth multipliers
  • Spawner rates
  • Mob drops
  • Block limits
  • Entity limits
  • Generator rates
  • Island effects
  • Island size
These values override the defaults set in config.yml and apply immediately upon upgrade.

​
Admin Management

1

Set specific upgrade level

Use /admin setupgrade <player> <upgrade> <level> to set any upgrade to a specific level.
2

Force rankup

Use /admin rankup <player> <upgrade> to upgrade without checking requirements.
3

Sync values

Use /admin syncupgrades <player> to recalculate and apply all upgrade values.
Permissions:
  • superior.admin.setupgrade
  • superior.admin.rankup
  • superior.admin.syncupgrades

Build docs developers (and LLMs) love

Get started for freeTalk to us