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.

​
Quick Start Guide

This guide will walk you through creating your first island and using the essential commands in SuperiorSkyblock2.

​
Creating Your First Island

1

Join Your Server

Connect to your Minecraft server and spawn in the default world.
2

Create Your Island

Use the create command to start your island:
/island create MyIsland
Or use the short alias:
/is create MyIsland
If island names are not required in your config (island-names.required-for-creation: false), you can simply use /is create
If schematics are available, you’ll see a GUI menu to select your starting island type:
  • Normal: Classic skyblock island
  • Desert: Desert-themed island
  • Mycel: Mushroom island
Or specify a schematic directly:
/is create MyIsland normal
3

Explore Your Island

You’ll be teleported to your new island automatically (if teleport-on-create: true).Your island includes:
  • Starting platform at y=100
  • Default biome (Plains)
  • 20x20 protected area
  • Personal world border (toggle with /is toggle border)

​
Essential Player Commands

​
Island Navigation

/is teleport
/is tp
/is home

​
Team Management

1

Invite Players

Invite someone to join your island:
/is invite <player>
They’ll receive an invitation they can accept:
/is accept <player>
2

Manage Roles

Promote members to give them more permissions:
/is promote <player>
Island roles (in order):
  • Member: Basic permissions
  • Moderator: Can invite, kick, and manage warps
  • Admin: Can change settings and manage co-op
  • Leader: Full control (you)
Demote members:
/is demote <player>
Or set a specific role:
/is setrole <player> <role>
3

Remove Members

Kick a player from your island:
/is kick <player>
Leave someone else’s island:
/is leave
Kicking members requires the KICK_MEMBER permission (Moderator+ by default).

​
Co-op System

Temporarily allow players to build without making them full members: 
# Add co-op player (max 8 by default)
/is coop <player>

# Remove co-op access
/is uncoop <player>

# View all co-op players
/is coops
Co-op players have build permissions but can’t invite others or change island settings. Co-op access is perfect for allowing friends to help without full membership.

​
Island Management

​
Settings & Permissions

# Open interactive settings GUI
/is settings
Common settings you can toggle:
  • PvP - Player vs Player combat
  • NATURAL_MONSTER_SPAWN - Natural mob spawning
  • CREEPER_EXPLOSION - Creeper damage
  • FIRE_SPREAD - Fire spreading
  • LAVA_FLOW & WATER_FLOW - Liquid flow

​
Island Privacy

# Open island to public
/is open

# Close island to visitors
/is close

# Expel (kick) a visitor
/is expel <player>

# Ban a player from entering
/is ban <player>

# Unban a player
/is pardon <player>

# View banned players
/is bans

​
Warps

Create teleport points on your island: 
# Create a warp (default limit: 3)
/is setwarp <name>

# Delete a warp
/is delwarp <name>

# Teleport to a warp
/is warp <player> <warp>

# List all warps
/is warps
Warps can be made public or private. Public warps appear in /is warps for all players.

​
Island Economy

​
Island Bank

Share money with your team: 
# View bank balance
/is balance
/is bank

# Deposit money
/is deposit <amount>

# Withdraw money (requires WITHDRAW_MONEY permission)
/is withdraw <amount>

​
Worth & Levels

# Recalculate island worth
/is recalc

# View block counts
/is counts

# Check specific block value
/is value <block>

# Open values menu
/is values
Your island level is calculated from:
  • Block worth values (defined in blockValues.yml)
  • Block counts (tracked automatically)
  • Formula: level = worth / 2 (configurable)

​
Upgrades & Progression

​
Island Upgrades

# Open upgrades menu
/is upgrade

# Rank up an upgrade
/is rankup <upgrade>
Common upgrades:
  • Island Size: Expand your build area
  • Crop Growth: Increase crop growth speed
  • Spawner Rates: Boost spawner spawn rates
  • Mob Drops: Multiply mob drop amounts
  • Team Limit: Add more member slots
  • Island Effects: Add potion effects (Speed, Jump Boost, etc.)

​
Missions

# View available missions
/is missions

# Complete a mission
/is mission <mission>

​
Advanced Features

​
Island Customization

# Change island biome
/is biome <biome>
# Example: /is biome JUNGLE

​
Island Chest

Shared storage for your team: 
# Open island chest
/is chest
Default configuration:
  • Pages: 0 (upgradeable)
  • Size: 3 rows (upgradeable to 6)
  • Access: Requires ISLAND_CHEST permission

​
Fly Mode

Enable creative-style flying on your island: 
# Toggle island fly
/is fly
Flying is automatically disabled when you leave your island boundaries.

​
Team Chat

# Toggle team chat mode
/is teamchat
/is tc
When enabled, all messages go to island members only.

​
Tips & Best Practices

​
For Island Owners

  1. Set Clear Permissions: Use /is permissions to define what each role can do
  2. Protect Valuables: Only give Moderator+ the VALUABLE_BREAK permission
  3. Regular Backups: Admins should regularly backup the database
  4. Monitor Worth: Use /is recalc periodically to update your island ranking

​
For Team Members

  1. Respect Boundaries: Don’t build outside the island limits
  2. Communicate: Use /is teamchat to coordinate with your team
  3. Check Permissions: Ask your leader if you can’t perform an action
  4. Contribute: Deposit money with /is deposit to help fund upgrades

​
Island Organization

  • Create Zones: Use warps to mark different areas (farms, shops, builds)
  • Expand Wisely: Upgrade size before hitting the border
  • Track Limits: Monitor block limits with /is counts (default: 8 hoppers, 4 minecarts)
  • Optimize Worth: Focus on high-value blocks to climb /is top

​
Common Issues

​
Can’t Create Island

  • Already in Island: Leave your current island with /is leave
  • Invalid Name: Names must be 3-16 characters (configurable)
  • Name Taken: Choose a unique island name
  • Disband Limit: Check remaining disbands (default: 5 per player)

​
Can’t Build

  • Not on Your Island: Only build on your own island or where you have co-op
  • Outside Border: Enable border with /is toggle border to see boundaries
  • No Permission: Ask the island leader for the required permission
  • Protected Spawn: You’re in the spawn region

​
Commands Not Working

  • No Permission: Ask admin for superior.island.* permission
  • Wrong Syntax: Use /is help to see correct command format
  • Cooldown Active: Some commands have cooldowns (e.g., recalc: 30 seconds)
  • Island Required: Create an island first with /is create

​
Help & Resources

# View all commands
/is help
/is help <page>

# Get information about your team
/is team

# View current members and visitors
/is panel

# Check your language setting
/is lang

Configuration Guide

Learn about advanced configuration options

API Documentation

Develop custom integrations and plugins

​
Next Steps

Now that you’ve created your first island, explore:
  • Build Your Base: Expand and customize your island
  • Invite Friends: Grow your island team
  • Complete Missions: Progress through challenges
  • Upgrade Your Island: Unlock new features and bonuses
  • Compete: Climb the /is top leaderboard
For a complete command reference, use /is help in-game or check the permissions list in plugin.yml.

Build docs developers (and LLMs) love

Get started for freeTalk to us