Lost Sky Islands

# Overview The "Lost Sky Islands" datapack (also available as a mod) adds clusters of sky islands to your Minecraft world. These sky islands are generated as Minecraft structures and can vary in size. You can find ruins of some lost civilization on these islands, some of which may hold valuable treasures. If you ever feel bored living on the ground, you can also use the islands to start a sky base. This datapack is balanced against vanilla progression. The block palettes are also chosen to better fit vanilla worlds (e.g., wool blocks are only used in building parts where they make sense, not in general terrain texturing). Therefore, adding this datapack shouldn't break the vanilla experience. This datapack is also designed to allow easy customization, so you can tweak it to fit your play style, or to better integrate it in a modpack. # Installation ## Datapack File (`.zip`) Installation * For single-player worlds, simply add the datapack during world creation and enable it just like installing other datapacks. * For servers, put the datapack in the `datapack` folder within your world folder. ## Mod File (`.jar`) Installation You can easily install it like other mods by putting the `.jar` file under your Minecraft instance's `mods` folder. Supported mod loaders include Forge, NeoForge, and Fabric. **IMPORTANT: For Fabric, you also need to install Fabric API.** # Compatibility ## Minecraft Compatibility This datapack should be compatible with all Minecraft versions between 1.21.10 and 26.2, including 1.21.10 and 26.2. ## Mod Compatibility Since this datapack only adds new structures in the sky, it should be compatible with common worldgen mods. Although the sky islands may look a bit small if you use mods like Tectonic, because they are designed around vanilla scale. If you use another mod/datapack that also adds structures in the sky, there is a small chance of overlapping structures. # Permission Feel free to include this mod/datapack in your modpacks. Although the license is ARR, you're permitted to customize the behaviors of this datapack **without directly modifying the original .jar or .zip file** by creating another datapack or use tweaker mods. See the "Customization" section below for more details. # Customization To customize the behaviors of this datapack, you can create a new datapack to override JSON definitions in this datapack (you need to make sure it loads after this datapack/mod), or use more advanced tools like KubeJS. When not explicitly stated, all JSON or structure NBT file paths below are relative to the `data` folder in the datapack. **IMPORTANT:** Overlays are used to support multiple Minecraft versions. Depending on the Minecraft version you are using, you may need to use files from the corresponding overlay for reference. For example, if you want to override `lostskyislands/worldgen/placed_feature/cave_ore_rare_1.json`, for Minecraft 1.21.10, you can simply refer to the file under the root `data` directory as the baseline. However, for Minecraft 26.1, you will need to refer to the same named file under the overlay directory `patch_26_1` as the baseline. <details> <summary>Expand to View Technical Details</summary> ## Structure Placement To change the biomes in which sky islands can generate, override the following biome tag: `lostskyislands/tags/worldgen/biome/has_structure/sky_islands_plain.json`. To change the spacing or separation of the sky island structures, override `lostskyislands/worldgen/structure_set/sky_islands.json`. By default, sky islands have a slightly larger separation than villages, so they don't clutter the sky view. To customize each individual sky island structure's properties (e.g., height range, spawn overrides, etc.), override the structure definitions files under `lostskyislands/worldgen/structure`. ## Loot Tables All loot tables for chests, barrels, decorated pots can be found under `lostskyislands/loot_table/chests`, allowing detailed controls of loot generation. For common chests, barrels, decorated pots on any island: * `lostskyislands/loot_table/chests/barrel_supplies.json` * `lostskyislands/loot_table/chests/common_pot_standard.json` For chests, barrels, decorated pots on specific islands: * `lostskyislands/loot_table/chests/barrel_garden.json` - On some flower garden islands. * `lostskyislands/loot_table/chests/barrel_ladder.json` - On vertical connector islands with ladders. * `lostskyislands/loot_table/chests/barrel_mill.json` - On islands with windmill ruins. * `lostskyislands/loot_table/chests/common_pot_animal_pen.json` - On islands with animal pens. * `lostskyislands/loot_table/chests/common_pot_cave_supplies.json` - On islands with caves. * `lostskyislands/loot_table/chests/common_pot_treasure.json` - On islands with fancy shrines. * `lostskyislands/loot_table/chests/sky_doc_chest.json` - On islands with sky docks. For chests, barrels, decorated pots hanging below islands: * `lostskyislands/