🏝️ Sky Islands Minecraft 1.20.1 / 1.21.1 · Forge 47.3+ / NeoForge 21.1+ Overwrite the entire Overworld with a skyblock realm filled with floating islands, equipped with comprehensive island and team management systems. Suitable for single-player survival, multiplayer servers and custom modpack development. ✨ Brief Overview Sky Islands reworks Minecraft’s Overworld into a vast skyblock dimension made of countless floating islands. Every player gets a private island of their own—invite friends to build together, or brave the void alone in a solo survival challenge. Version 2.0.0 introduces a brand-new archipelago system. Deep in the distant void, noise-generated massive archipelagos consist of multiple uniquely shaped sub-islands, bringing brand-new exploration goals to your world. Version 2.0.10 further optimizes hub spawn island management, adding the admin command /skydev hubspawn to adjust teleport positions of the hub island in-game. Functionality is fully synchronized between Forge 1.20.1 and NeoForge 21.1.1224+. Core Features 🌍 Grid-based floating world with 3 configurable island sizes: Small / Medium / Large 🏝️ Archipelago System (Added in v2.0.0): Organically shaped noise-generated archipelagos with layered, staggered sub-islands ⛏️ Base ore density multiplied by 1.2 by default to offset resource scarcity on skyblocks 👥 Complete team system: Team creation, member invites, island access control & spawn point management 🏗️ Template Island System: 3 built-in presets (default / two / chushi) + custom NBT support with real-time 3D rotating preview 🎯 Hub Spawn Management (Added in v2.0.10): Admins use /skydev hubspawn to tweak teleport positions; exclusion zones update automatically ⚙️ Highly configurable, ideal for deep modpack customization Basic Controls

Operation Command / Hotkey Open Team GUI Hotkey V or /sky gui Teleport back to your island /sky home Travel to Hub Spawn Island /sky spawn Hot-reload island templates (Admin Only) /skydev template reload Manage hub spawn teleport positions (Admin Only) /skydev hubspawn Global team administration (Admin Only) /skydev manage 📖 Full Documentation Basic Mod Info

Item Content Mod ID skyislands Current Version 2.0.10 Supported MC Versions 1.20.1 (Forge) / 1.21.1 (NeoForge) Loaders Forge 47.3+ / NeoForge 21.1.224+ Java Requirement Java 17+ (Forge) / Java 21+ (NeoForge) Side Compatibility Client + Server Forge and NeoForge builds share identical features, with fully cross-compatible commands, configs and template systems. 🌍 World Generation Sky Islands fully replaces vanilla world generation. The entire Overworld is composed of floating islands boundless empty void stretches between landmasses. Island Distribution The world is split into configurable 800-block grid cells. Each cell randomly generates a standalone island or an archipelago. Island layouts are fully seed-locked; identical seeds produce identical worlds. Island Sizes & Spawn Weights

Type Diameter Range Default Weight Description Small Island 60 ~ 300 blocks 40% Most common; perfect for early-game settlement Medium Island 200 ~ 750 blocks 25% Abundant resources for long-term base building Large Island 750 ~ 1500 blocks 10% Rare, expansive land with diverse terrain Archipelago Radius 550 ~ 750 blocks 25% Clustered organic sub-islands designed for exploration Total combined weights determine spawn ratios; all values are editable in config files. Auto-Generated Connecting Bridges Adjacent medium and large islands with edge gaps under 75 blocks will automatically generate natural connecting bridges for easy inter-island travel. ⛏️ Ore Multiplier All ores spawn at 1.2x base density by default, including Coal, Iron, Copper, Gold, Redstone, Lapis Lazuli, Diamond, Emerald, Quartz and Ancient Debris. The multiplier value can be freely adjusted in configs. Hub Spawn Exclusion Zone Centered on the hub island’s main teleport point, procedural islands and player template islands maintain a safe buffer distance to avoid overlapping the spawn area. Exclusion zones refresh automatically whenever admins edit teleport positions via /skydev hubspawn. 🏝️ Archipelago System (v2.0.0 New Feature) Archipelagos are an independent terrain type introduced in v2.0.0, generated separately from regular sky islands with no overlap conflicts. Generation Pipeline Dual Layer Domain Warp + Simplex Noise ↓ Generate organic terrain masks ↓ BFS connected-region detection to split into distinct sub-islands ↓ Assign unique XYZ offset coordinates to each sub-island ↓ Form layered, three-dimensional archipelago landscapes Sub-Island Traits Naturally tapered conical base shape with tweakable shape parameters Classified into 4 tiers by land area: Tiny / Small / Medium / Large No XZ-plane overlaps; vertical Y-axis stacking creates multi-level scenery Spawn Rules Only generate beyond 4000 blocks from the hub spawn Occupy 25% of all grid cells (shares weight pool with regular islands) Archipelagos take generation priority over standard islands in overlapping grid cells 👥 Team & Island Ownership Every player or player team owns a permanent private island with a seed-locked fixed position in the world. New Player Workflow First world join ↓ Teleported to the hub spawn island ↓ Create team → Select island template → Obtain private island ↓ Invite teammates / Toggle visitor access / Customize team spawns Team Functionalities

Feature Details Member Invites Send invites for other players to join your team and co-develop the island Join Requests Players may submit applications; team owners approve or deny requests Visitor Permissions Allow sightseeing access for outsiders while preventing block destruction Multi-Team Spawns Set multiple directional spawn points (North / South / East / West) Death Teleport Auto-respawn on your team island upon death Teleport Command Table

Destination Command Default Cooldown Personal Island /sky home 3 minutes Hub Spawn Island /sky spawn 3 minutes Other Players’ Islands /sky visit <TeamName> 3 minutes Each teleport cooldown can be configured independently. An optional toggle removes fall damage after teleportation. 🏗️ Template Island System Built-In Presets 3 starter templates ship with the mod: default, two, chushi. Files auto-copy to the config directory on first launch. The hub spawn island uses a separate template file moban.nbt. Custom Template Support Place .nbt or .snbt structure files into this directory: config/skyislands/templates/islands/ Configure spawn coordinates and facing directions inside templates.json5. Run /skydev template reload for live hot-reloading—no server restart required. Real-Time 3D Preview When creating a team, the GUI renders a rotatable real-time 3D preview of your selected template for visual previews before confirmation. Multiplayer Sync Template assets auto-sync from server to client with local caching; previews render normally while offline. Hub Spawn Island Setup Define the global spawn island via mainSpawnIsland in templates.json5. All new players spawn here on their first login. Admins can fine-tune in-game teleport positions with /skydev hubspawn—changes save to world data only and do not alter global template files. 📋 Full Command List All commands work under both /sky and /skyislands aliases. Player Commands

Command Description /sky gui Open team management main menu /sky create [TeamName] Create a new team and claim a private island /sky leave Exit your current team /sky home Teleport to your team island /sky spawn Travel to the global hub spawn island /sky visit <TeamName> Visit another team’s island /sky invite <PlayerName> Send a team join invite to a player /sky accept <TeamName> Accept a pending team invite /sky decline <TeamName> Reject a pending team invite /sky join <TeamName> Submit a join request to a team /sky team rename <NewName> Rename your team /sky team toggle visits Toggle visitor access permission /sky team toggle requests Toggle public join request function /sky team accept <Player> Approve a player’s join request /sky team deny <Player> Reject a player’s join request /sky team spawns add <x> <y> <z> Add a custom team spawn point /sky team spawns remove <x> <y> <z> Delete a specific team spawn point /sky team spawns reset Revert spawn points to template defaults Admin Commands (/skydev, Permission Level 4 Required) Template Administration

Command Description /skydev template reload Hot-reload all template configs and sync updates to all online players Hub Spawn Island Management (v2.0.10 New) Adjust teleport locations for the global hub island; edits save to world save data only and do not modify template files. 表格 Command Description /skydev hubspawn here [south/north/east/west] Overwrite all spawn points with your current standing position /skydev hubspawn set <x> <y> <z> [Direction] Set a single main spawn coordinate, replacing all existing points /skydev hubspawn add <x> <y> <z> [Direction] Append an extra spawn point while preserving existing ones /skydev hubspawn remove <x> <y> <z> Delete a spawn point at the target coordinate /skydev hubspawn list List hub island center, exclusion zone data and all active teleport positions /skydev hubspawn reset Restore spawn points to the default values in moban.nbt /skydev hubspawn tp Instantly teleport to the hub spawn island Exclusion zones recalculate automatically around the primary spawn coordinate after any edits. Global Team Administration 表格 Command Description /skydev manage create <TeamName> Create a team with the specified name /skydev manage create <TeamName> join Create a team and automatically add the executing admin as a member /skydev manage delete <TeamName> Permanently delete a team and its island data /skydev manage clear <TeamName> Remove all members from a target team /skydev manage add <TeamName> <Players...> Force-add specified players to a team /skydev manage remove <TeamName> <Players...> Force-kick specified players from a team ⚙️ Configuration Files Main world settings file: config/skyislands-common.toml Auto-generated on first mod launch, all parameters include native Chinese comments. toml [island_sizes]

Island diameter range (blocks)

small_min = 60 small_max = 300 medium_min = 200 medium_max = 750 large_min = 750 large_max = 1500

[island_weights]

Total weight sum controls spawn probability ratios

small_weight = 40 # Small Islands ~40% medium_weight = 25 # Medium Islands ~25% large_weight = 10 # Large Islands ~10% archipelago_weight = 25 # Archipelagos ~25%

[world]

ore_multiplier = 1.2 # Ore spawn density multiplier (1.0 = vanilla rate) island_spacing = 800 # Grid cell spacing between islands (blocks)

[teleports]

spawn_cooldown = 3600 # Teleport cooldown (ticks; 3600 ticks = 3 minutes) home_cooldown = 3600 visit_cooldown = 3600 negate_fall_damage = false # Disable fall damage after teleportation

[archipelago_carving]

arch_max_depth_large = 55 # Maximum base depth for large sub-islands (blocks) arch_mid_threshold = 0.55 # Base tapering threshold; lower values create thicker island bottoms Template layout config: config/skyislands/templates.json5 Structure file storage path: config/skyislands/templates/islands/ 📦 Modpack Customization Guide Sky Islands offers extensive tweak options for modpack creators: Customization Demand Implementation Method Custom starting islands Add custom NBT structures and configure spawns in template files Adjust world island density Modify spawn weight values in config Balance resource generation Tweak the global ore density multiplier Alter teleport pacing Set individual cooldowns for all teleport types Restrict server permissions Configure command permission levels (0–4) Live template edits Use /skydev template reload without server restarts Instant hub spawn adjustments Use /skydev hubspawn for real-time in-game edits 🔧 Installation Requirements Forge 1.20.1 ✅ Minecraft 1.20.1 ✅ Forge 47.3 or newer ✅ Java 17+ NeoForge 1.21.1 ✅ Minecraft 1.21.1 ✅ NeoForge 21.1.224 or newer ✅ Java 21+ Single-player: Install the mod only on your client Multiplayer Servers: Mod must be installed on both client and server; loader and Minecraft versions must match exactly