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.

Welcome to SuperiorSkyblock2

SuperiorSkyblock2 is a feature-packed Skyblock core plugin for Minecraft Spigot/Paper servers. Built with performance and customization in mind, it provides everything you need to run a professional Skyblock server.

Installation Guide

Get started by installing SuperiorSkyblock2 on your server

Quick Start

Create your first island and learn essential commands

API Documentation

Integrate SuperiorSkyblock2 into your custom plugins

Configuration

Configure islands, permissions, and advanced features

Key Features

Island Management

  • Custom Island Sizes: Configurable island sizes with default 20x20 starting size, expandable up to 200x200
  • Multiple Worlds: Support for Normal, Nether, and End dimensions with individual unlock controls
  • Island Roles: Four-tier permission system (Member, Moderator, Admin, Leader) with customizable permissions
  • Co-op System: Invite temporary members to your island without permanent membership

Economy & Progression

  • Island Bank: Shared economy system with configurable limits and deposit/withdrawal mechanics
  • Island Worth & Levels: Automatic calculation based on block counts and values
  • Island Upgrades: Rankup system for crop growth, spawner rates, mob drops, and more
  • Block & Entity Limits: Customizable limits (default: 8 hoppers, 4 minecarts per island)

Advanced Systems

  • Custom Generators: Configure cobblestone generator percentages by world (default: 95% cobblestone, 5% coal ore)
  • Stacked Blocks: Performance-optimized block stacking system with whitelisting
  • Island Missions: Custom mission system for player progression
  • Warp System: Public and private island warps with categories (default: 3 warps per island)

Performance Optimization

  • Automatic Block Tracking: Real-time worth and level calculations on block placement/breaking
  • Offline Redstone Disable: Automatically disables redstone when island members are offline
  • AFK Integration: Redstone and spawning optimizations for AFK players (Essentials/CMI support)
  • Configurable Calculations: Adjustable calc-interval to balance performance vs accuracy

Team Features

  • Team Limits: Configurable member limits (default: 4 members, 8 co-op players)
  • Role Management: Promote/demote system with granular permission control
  • Team Chat: Built-in island team chat system
  • Invite System: Accept/deny island invitations with optional teleportation

Protection & Settings

  • World Borders: Per-player world borders with toggleable colors (Blue, Green, Red)
  • Island Settings: 11+ toggleable settings including mob spawning, explosions, crop growth, fire spread
  • Permission System: 60+ island-specific permissions for granular control
  • Ban System: Prevent specific players from entering your island

Integrations

  • Economy: Vault integration for money management
  • Placeholders: PlaceholderAPI support for custom displays
  • Spawners: Support for WildStacker, EpicSpawners, MergedSpawner, RoseStacker, and more
  • World Management: FastAsyncWorldEdit, SlimeWorldManager compatibility

Database Support

Choose between SQLite (local) or MySQL/MariaDB (remote) for data storage:
database:
  type: SQLite  # or MySQL/MariaDB
  backup: true
  # Remote database settings
  address: 'localhost'
  port: 3306
  db-name: 'SuperiorSkyblock'

Default Island Configuration

New islands are created with these defaults (fully customizable):
  • Size: 20x20 (expandable to 200x200)
  • Height: y=100
  • Team Limit: 4 members + 8 co-op players
  • Generator: 95% Cobblestone, 5% Coal Ore
  • Biome: Plains (Normal), Nether Wastes (Nether), The End (End)
  • Multipliers: 1.0x crop growth, spawner rates, and mob drops
SuperiorSkyblock2 is actively maintained and supports Minecraft 1.13+ with API version 1.13.

Command Structure

The plugin uses a unified command system with the main command /island (aliases: /is, /islands):
  • Player Commands: 50+ commands for island management
  • Admin Commands: 70+ administrative commands for server management
  • Custom Aliases: Define your own command aliases in config.yml

Next Steps

Install the Plugin

Follow our installation guide to get SuperiorSkyblock2 running

Create Your First Island

Learn the basics and create your first island

Build docs developers (and LLMs) love