SkyGridx -----
Experience the Latest Blocks, Customize Your SkyGrid, and Enjoy Real-Time, Efficient Generation.Update Overview
This update makes chest loot in the plugin much more customizable and easier to manage. I’ve added new options that let you change how items look and how their enchantments are shown. I’ve also reworked some of the world file settings to improve overall control. Here’s what’s new:
Custom Item Names and Enchantment Options
World File Configuration Rework
ChestSettings.yml
# ------------------------------------------------------------------------------
# Chest Settings
#
# This file configures how chests are populated in specific biomes using a
# weight-based system for random item selection. Each chest configuration
# also respects a global "MaxItemsPerSlot" to control the number of items that
# can appear in any single slot.
#
# New Settings:
# - CustomName:
# Allows you to set a custom display name for an item using Minecraft color codes. For example, "§6HolyDirt" will display the name in gold.
#
# - LevelType (Item-wide):
# * Standard: Displays levels as numbers with a "lvl_" prefix (e.g., "Mending lvl_1", "Fortune lvl_2").
# * Roman: Displays levels as Roman numerals (e.g., "Mending I", "Fortune II"). Note: I have added roman numeral conversion that supports values up to 3999.
# * Default: If omitted or unrecognized, defaults to Roman.
#
# - Enchantments:
# Each enchantment entry now supports:
# * Weight: The chance (in percent) for the enchantment to be applied.
# * MinLevel / MaxLevel: The range for the enchantment level.
# * LoreColor: The color used to display the enchantment in the item's lore. Valid colors include: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE.
#
# Advanced Weighting: Filler Items & Rare Items
# - You can add "filler" items (for example, AIR) with a high weight to reduce the overall odds of rare items appearing. For example, setting AIR to a weight of 90 while giving DIAMOND a weight of 0.3 will make diamonds extremely rare.
#
# ------------------------------------------------------------------------------
#
# 1) MaxItemsPerSlot (Global)
# - Sets a hard limit on how many items of a single type can be placed in one
# slot, regardless of the item’s maxAmount. Default: 2
#
# 2) ChestSettings (Parent Key)
# - Under this key, create one or more named chest configurations (e.g., "Chest1").
#
#
# [Legacy (Compact) Format]
#
# ChestSettings:
# ChestOld:
# Items: [ITEM_NAME:weight:maxAmount]
# Biomes: [BIOME_NAME]
#
# [New Expanded Format]
#
# ChestSettings:
# ChestNew:
# Items:
# -ITEM_NAME: # Use the exact item names from https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# - Weight: <numeric value>
# - MaxAmount: <numeric value>
# - CustomName: <custom display name> # Supports use of Minecraft color codes like "§0" for Black and so on.
# - LevelType: <Standard or Roman> # Item-wide setting for enchantment display
# - Enchantments:
# - ENCHANTMENT_NAME: # Use exact enchantment names from https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html
# - Weight: <numeric chance in percent>
# - MinLevel: <minimum level>
# - MaxLevel: <maximum level>
# - LoreColor: <color> # (Optional) Valid colors: BLACK, DARK_BLUE, DARK_GREEN,DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY,DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE,YELLOW, WHITE.
# Biomes:
# - BIOME_NAME # Use the exact biome names from https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/block/Biome.html
#
#
# 3) How the Code Chooses Items (Weight-Based):
# - The plugin sums all item 'weight' values in a chest config, then picks an item for each empty slot in proportion to those weights.
# Example: With four items each having weight 5, the total weight is 20, and each item has a 25% chance per slot.
#
# 4) Reducing Item Chance (Filler Items):
# - To lower the odds of high-value items appearing, you can add filler items (e.g., AIR) with a high weight to dilute the selection.
# For instance, AIR with weight 90 dilutes the chance of DIAMOND (e.g., weight 0.3) being chosen.
#
# 5) maxAmount vs. MaxItemsPerSlot:
# - maxAmount: The total maximum number of a given item allowed in the entire chest.
# - MaxItemsPerSlot: The maximum number of that item that can be placed in any one slot.
#
# 6) YAML Tips:
# - Use standard YAML naming rules for chest configurations (alphanumeric, underscores,
# or quoted strings for spaces/special characters).
# - Both "compact" and "expanded" list styles are supported.
#
# ------------------------------------------------------------------------------
#
MaxItemsPerSlot : 2
ChestSettings:
Chest1:
Items :
- MYCELIUM:30:5
- RED_MUSHROOM:20:5
- BROWN_MUSHROOM:20:5
- RED_MUSHROOM_BLOCK:10:5
- BROWN_MUSHROOM_BLOCK:10:5
- MUSHROOM_STEM:10:5
Biomes :
- MUSHROOM_FIELDS
# Explanation of the example above (Legacy Format):
# - 'Chest1' is the identifier for this chest configuration.
# - Items are listed using the "MATERIAL:weight:maxAmount" format.
# * MYCELIUM:30:5 => weight = 30, maxAmount = 5
# * RED_MUSHROOM:20:5 => weight = 20, maxAmount = 5
# etc.
#
# The total weight is 30 + 20 + 20 + 10 + 10 + 10 = 100.
# Therefore, MYCELIUM has a 30% chance per slot, RED_MUSHROOM 20%, etc.
#
# Once an item reaches its maxAmount (here, 5), it will no longer be selected.
#
# MaxItemsPerSlot (global, default 2) limits how many of an item can appear in any one slot.
#
# 'Biomes: [MUSHROOM_FIELDS]' indicates that this configuration applies to chests
# generated in the MUSHROOM_FIELDS biome.
#
# ------------------------------------------------------------------------------
#
# New Expanded Format Example:
#
# The example below shows the new options in use.
#
#
# ChestSettings:
# ChestNew:
# Items:
# - MYCELIUM:
# - Weight: 30
# - MaxAmount: 5
# - CustomName: §6HolyDirt
# - LevelType: Standard # Options: Standard (shows levels as "lvl_1") or Roman (shows as "I"); defaults to Roman.
# - Enchantments:
# - FORTUNE:
# - Weight: 100
# - MinLevel: 1
# - MaxLevel: 400
# - LoreColor: RED
# - LOOTING:
# - Weight: 30
# - MinLevel: 1
# - MaxLevel: 300
# - LoreColor: BLUE
# - AIR:
# - Weight: 90
# - MaxAmount: 999 # Filler item to reduce the odds of rare items appearing.
# Biomes:
# - MUSHROOM_FIELDS
#
#
# In this expanded example:
# - 'MYCELIUM' uses a custom name (displayed in gold) and an item-wide LevelType of Standard. All enchantments on this item will display levels as "lvl_x".
# - The FORTUNE enchantment is set to use a LoreColor of RED, while LOOTING uses BLUE.
# - 'AIR' is added as a filler item with a high weight (90) to reduce the chance that rare items (like DIAMOND, if present with a low weight) are chosen.
#
# ------------------------------------------------------------------------------
#
# You can define multiple chest configurations for different biome groups.
#
# Overworld Biomes:
#
Chest2:
Items:
- WOODEN_AXE:
- Weight : 20
- MaxAmount : 1
- Enchantments:
- VANISHING_CURSE:
- Weight : 50
- MinLevel : 1
- MaxLevel : 1
- EFFICIENCY:
- Weight : 70
- MinLevel : 1
- MaxLevel : 4
- UNBREAKING:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- WOODEN_PICKAXE:
- Weight : 20
- MaxAmount : 1
- Enchantments:
- VANISHING_CURSE:
- Weight : 50
- MinLevel : 1
- MaxLevel : 1
- EFFICIENCY:
- Weight : 40
- MinLevel : 1
- MaxLevel : 4
- FORTUNE:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- UNBREAKING:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- CROSSBOW:
- Weight : 20
- MaxAmount : 1
- Enchantments:
- VANISHING_CURSE:
- Weight : 50
- MinLevel : 1
- MaxLevel : 1
- MULTISHOT:
- Weight : 30
- MinLevel : 1
- MaxLevel : 1
- PIERCING:
- Weight : 30
- MinLevel : 1
- MaxLevel : 4
- QUICK_CHARGE:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- UNBREAKING:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- NAME_TAG:20:1
- GOLDEN_APPLE:20:1
- ENCHANTED_GOLDEN_APPLE:20:1
- APPLE:40:2, OAK_LOG:40:2
- DARK_OAK_LOG:40:2
- RAIL:40:2
- DIAMOND:40:2
- STRING:90:5
- ARROW:90:5
- STICK:90:5
- WHEAT:90:5
- IRON_INGOT:90:5
- TORCH:90:5
- ARMADILLO_SCUTE:10:2
- MACE:2:1
- OMINOUS_BOTTLE:10:2
- OMINOUS_TRIAL_KEY:2:1
- TRIAL_KEY:2:1
- BREEZE_ROD:10:2
- RESIN_CLUMP:10:2
Biomes : [BADLANDS, BAMBOO_JUNGLE, BIRCH_FOREST, CHERRY_GROVE, DARK_FOREST, DESERT, DRIPSTONE_CAVES, ERODED_BADLANDS, FLOWER_FOREST, FOREST, GROVE, JAGGED_PEAKS, JUNGLE, LUSH_CAVES, MANGROVE_SWAMP, MEADOW, OLD_GROWTH_BIRCH_FOREST, OLD_GROWTH_PINE_TAIGA, OLD_GROWTH_SPRUCE_TAIGA, PLAINS, SAVANNA, SAVANNA_PLATEAU, SPARSE_JUNGLE, STONY_PEAKS, STONY_SHORE, SUNFLOWER_PLAINS, SWAMP, TAIGA, WINDSWEPT_FOREST, WINDSWEPT_GRAVELLY_HILLS, WINDSWEPT_HILLS, WINDSWEPT_SAVANNA, WOODED_BADLANDS, OCEAN, WARM_OCEAN, LUKEWARM_OCEAN, FROZEN_OCEAN, DEEP_FROZEN_OCEAN, DEEP_LUKEWARM_OCEAN, DEEP_OCEAN, DEEP_COLD_OCEAN, COLD_OCEAN, FROZEN_RIVER, RIVER, BEACH, SNOWY_BEACH, SNOWY_PLAINS, SNOWY_SLOPES, SNOWY_TAIGA, FROZEN_PEAKS, ICE_SPIKES, DEEP_DARK, PALE_GARDEN ]
#
#Nether Biomes:
#
Chest3:
Items : [GOLDEN_APPLE:20:1, ENCHANTED_GOLDEN_APPLE:20:1, GOLD_BLOCK:20:1, GOLDEN_AXE:20:1, IRON_BLOCK:20:1, SNOUT_ARMOR_TRIM_SMITHING_TEMPLATE:20:1, NETHERITE_UPGRADE_SMITHING_TEMPLATE:20:1, IRON_SWORD:20:1, GOLDEN_HELMET:20:1, MUSIC_DISC_PIGSTEP:20:1, DIAMOND:40:2, ANCIENT_DEBRIS:40:2, BONE_BLOCK:40:2, GOLDEN_CARROT:40:2, OBSIDIAN:40:2, CRYING_OBSIDIAN:40:2, IRON_INGOT:90:5, GILDED_BLACKSTONE:90:5, CHAIN:90:5, GOLD_INGOT:90:5, MAGMA_CREAM:90:5, GOLD_NUGGET:90:5, SPECTRAL_ARROW:90:5, STRING:90:5, IRON_NUGGET:90:5, ARROW:90:5, COOKED_PORKCHOP:90:5 ]
Biomes : [BASALT_DELTAS, NETHER_WASTES, CRIMSON_FOREST, SOUL_SAND_VALLEY, WARPED_FOREST ]
#
# End Biomes Example:
#
Chest4:
Items : [ELYTRA:20:1, DRAGON_HEAD:20:1, DRAGON_EGG:20:1, END_CRYSTAL:20:1, ENDER_CHEST:20:1, SHULKER_SHELL:40:2, DIAMOND:40:2, END_ROD:90:5, PURPUR_BLOCK:90:5, MAGENTA_STAINED_GLASS:90:5, GOLD_INGOT:90:5, IRON_INGOT:90:5, OBSIDIAN:90:5 ]
Biomes : [THE_END, END_BARRENS, END_HIGHLANDS, END_MIDLANDS, SMALL_END_ISLANDS ]
#
# Note: To add additional chest configurations (e.g., Chest5, Chest6, etc.),
# simply create a new key under ChestSettings with its own Items and Biomes.
#
world.yml
# SkyGrid World Block Selection Guide:
# This YAML configuration file defines the block distributions for different biomes
# in your SkyGrid world. The configuration is split into two main sections:
#
# 1. biomes: Maps each biome to a specific distribution.
# 2. distributions: Defines the block materials and their respective percentages.
#
# Important Notes:
# - Each biome must be assigned a distribution.
# - Percentages represent the relative chance of each block appearing.
# - The total percentage for each distribution does not need to sum to 100%.
# The system will handle scaling as necessary.
# - Ensure that all block names correspond to valid Bukkit `Material` enums.
# Reference: [Bukkit Material Documentation](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)
#
# Example Usage:
# - To assign the same distribution to multiple biomes, map each biome to the desired distribution.
# - You can define multiple distributions and assign them to different biomes as needed.
#
# Supported Biomes:
# - Refer to [Bukkit Biome Documentation](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/block/Biome.html) for a list of supported biomes.
biomes:
MUSHROOM_FIELDS:
distribution : custom_mushroom_fields
distributions:
custom_mushroom_fields :
# Each block and its chance of appearing.
# Format: BlockID:Percentage
# Example: "STONE:50" means a 50% chance of Stone appearing.
# The total percentage does not need to sum to 100%; the system will scale as needed.
DIRT : 25
RED_MUSHROOM : 20
BROWN_MUSHROOM : 20
RED_MUSHROOM_BLOCK : 10
BROWN_MUSHROOM_BLOCK : 10
MUSHROOM_STEM:
MYCELIUM : 50
STONE : 25
CHEST : 1
SPAWNER : 1
# You can define additional distributions here and assign them to different biomes.
# For example:
# alternate_distribution:
# STONE: 40
# DIRT: 40
# SAND: 20
# To assign this distribution to a biome, add it under the 'biomes' section:
# biomes:
# SOME_OTHER_BIOME:
# distribution: alternate_distribution
# Optional default distribution for biomes not explicitly defined in the 'biomes' section.
# This ensures that a fallback distribution is available.
default_distribution:
ACACIA_LEAVES : 3
ACACIA_LOG : 1
ALLIUM : 2
AMETHYST_BLOCK : 1
AMETHYST_CLUSTER : 1
ANDESITE : 20
AZALEA : 1
AZALEA_LEAVES : 3
AZURE_BLUET : 2
BAMBOO : 2
BEE_NEST : 0.01
BEETROOTS : 1
BELL : 0.001
BIRCH_LEAVES : 3
BIRCH_LOG : 1
BLUE_ORCHID : 1
BONE_BLOCK : 1
BOOKSHELF : 1
BRAIN_CORAL_BLOCK : 0.5
BROWN_MUSHROOM : 2
BUBBLE_CORAL_BLOCK : 0.5
BUDDING_AMETHYST : 0.5
CACTUS : 2
CALCITE : 2
CARROTS : 1
CAVE_VINES : 0.5
CHERRY_LEAVES : 3
CHEST : 1
CHISELED_COPPER : 0.1
CHISELED_STONE_BRICKS : 0.5
CLAY : 20
COAL_ORE : 1.0
COARSE_DIRT : 5
COBBLESTONE : 12
COBWEB : 0.5
COPPER_BULB : 0.1
COPPER_GRATE : 0.1
COPPER_ORE : 0.5
CORNFLOWER : 0.5
CRAFTER : 0.05
CREAKING_HEART : 0.001
CRYING_OBSIDIAN : 0.5
CUT_COPPER : 0.1
DANDELION : 0.5
DARK_OAK_LEAVES : 3
DARK_OAK_LOG : 1
DARK_PRISMARINE : 2
DEAD_BUSH : 0.5
DEEPSLATE : 70
DEEPSLATE_COAL_ORE : 1.0
DEEPSLATE_COPPER_ORE : 0.5
DEEPSLATE_DIAMOND_ORE : 0.1
DEEPSLATE_GOLD_ORE : 0.25
DEEPSLATE_IRON_ORE : 1.0
DEEPSLATE_LAPIS_ORE : 0.25
DEEPSLATE_REDSTONE_ORE : 0.4
DIAMOND_ORE : 0.1
DIORITE : 20
DIRT : 70
DRIPSTONE_BLOCK : 3
FERN : 1
FIRE_CORAL_BLOCK : 0.5
FLOWERING_AZALEA : 0.5
FLOWERING_AZALEA_LEAVES : 3
GLASS : 1
GLOW_LICHEN : 0.5
GOLD_BLOCK : 0.1
GOLD_ORE : 0.25
GRANITE : 20
SHORT_GRASS : 1
GRASS_BLOCK : 70
GRAVEL : 10
HANGING_ROOTS : 0.5
HEAVY_CORE : 0.05
HORN_CORAL_BLOCK : 0.5
ICE : 1
INFESTED_DEEPSLATE : 3
IRON_ORE : 1.0
JUNGLE_LEAVES : 3
JUNGLE_LOG : 1
KELP_PLANT : 1
LAPIS_ORE : 0.25
LARGE_FERN : 0.5
LAVA : 10
LILAC : 0.5
LILY_OF_THE_VALLEY : 0.5
LILY_PAD : 0.5
MANGROVE_LEAVES : 3
MANGROVE_LOG : 1
MANGROVE_ROOTS : 1
MANGROVE_WOOD : 1
MELON : 5
MOSS_BLOCK : 1
MOSSY_COBBLESTONE : 5
MOSSY_STONE_BRICKS : 2
MUD : 8
MUDDY_MANGROVE_ROOTS : 4
MYCELIUM : 10
OAK_LEAVES : 3
OAK_LOG : 1
OBSIDIAN : 5
OPEN_EYEBLOSSOM : 0.05
ORANGE_TULIP : 0.5
OXEYE_DAISY : 0.5
PACKED_ICE : 2
PALE_HANGING_MOSS : 0.5
PALE_MOSS_BLOCK : 0.5
PALE_MOSS_CARPET : 0.5
PALE_OAK_LEAVES : 3
PALE_OAK_LOG : 1
PEONY : 0.5
PINK_PETALS : 0.5
PINK_TULIP : 0.5
PISTON : 0.1
PODZOL : 5
POINTED_DRIPSTONE : 1
POPPY : 0.5
POTATOES : 0.5
PRISMARINE : 1
PUMPKIN : 5
RAW_COPPER_BLOCK : 1.2
RAW_IRON_BLOCK : 1.2
RED_MUSHROOM : 2
RED_SAND : 5
RED_SANDSTONE : 3
RED_TULIP : 0.5
REDSTONE_ORE : 0.4
RESIN_BLOCK : 0.05
ROOTED_DIRT : 4
ROSE_BUSH : 0.5
SAND : 30
SANDSTONE : 10
SCULK : 0.3
SCULK_CATALYST : 0.05
SCULK_SENSOR : 0.05
SCULK_SHRIEKER : 0.02
SCULK_VEIN : 0.3
SEA_LANTERN : 1
SEA_PICKLE : 1
SEAGRASS : 0.5
SMALL_DRIPLEAF : 0.5
SMOOTH_BASALT : 2
SNOW_BLOCK : 10
SPAWNER : 0.001
SPONGE : 0.05
SPORE_BLOSSOM : 0.5
SPRUCE_LEAVES : 3
SPRUCE_LOG : 1
STICKY_PISTON : 0.08
STONE : 140
STONE_BRICKS : 2
SUGAR_CANE : 5
SUNFLOWER : 0.5
SUSPICIOUS_GRAVEL : 5
SWEET_BERRY_BUSH : 0.5
TALL_GRASS : 0.5
TARGET : 0.05
TNT : 0.05
TRIAL_SPAWNER : 0.001
TUBE_CORAL_BLOCK : 0.5
TUFF : 20
VAULT : 0.01
WATER : 10
WHEAT : 1
WHITE_CONCRETE_POWDER : 0.5
WHITE_TULIP : 0.5
WHITE_WOOL : 0.5
WITHER_ROSE : 0.05
This update makes chest loot in the plugin much more customizable and easier to manage. I’ve added new options that let you change how items look and how their enchantments are shown. I’ve also reworked some of the world file settings to improve overall control. Here’s what’s new:
Custom Item Names and Enchantment Options
- Custom Item Names:
You can now give items their own names using Minecraft color codes. For example, you can name an item "§6HolyDirt" to have it appear in gold. This makes your chests look more personalized and fun!
- New Enchantment Display Options:
Instead of setting the display style for each enchantment one by one, you now choose one style for the whole item. With the new LevelType setting, you have two options:- Standard: Shows numbers like "lvl_1", "lvl_2", etc.
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.davids-repo.dev%2Fmc%2Fe-1.webp)
- Roman: Shows numbers as Roman numerals like "I", "II", and so on. (Note: Roman numerals work up to 3999.)
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.davids-repo.dev%2Fmc%2Fe-2.webp)
If you don’t choose a style, it will automatically use the Roman style.
- Standard: Shows numbers like "lvl_1", "lvl_2", etc.
- LoreColor for Enchantments:
Each enchantment can now have its own custom color in the item’s description. This lets you match your server’s theme or simply make items more eye-catching. You can use common color names like RED, BLUE, GREEN, and many more.
- Better Distribution Control:
With these changes, you now have even more control over how items are distributed in chests. The updated settings allow you to manage both how many items appear in each slot and how they are spread out across the chest. So, a lower MaxItemsPerSlot means more distributed items in the chest, while a higher value might result in less distribution if not set up properly. - Visit the Chest Settings Documentation page for more details.
World File Configuration Rework
- World Files in YAML:
I have updated the format for the world configuration files. Material text files have been converted to YAML, and the way biomes are set up has changed. If you use custom world settings, you will need to update them according to the new format. - Visit the Biome-Specific Block Generation page and SkyGrid World Block Selection Guide page for more details.
ChestSettings.yml
Code (YAML):
# ------------------------------------------------------------------------------
# Chest Settings
#
# This file configures how chests are populated in specific biomes using a
# weight-based system for random item selection. Each chest configuration
# also respects a global "MaxItemsPerSlot" to control the number of items that
# can appear in any single slot.
#
# New Settings:
# - CustomName:
# Allows you to set a custom display name for an item using Minecraft color codes. For example, "§6HolyDirt" will display the name in gold.
#
# - LevelType (Item-wide):
# * Standard: Displays levels as numbers with a "lvl_" prefix (e.g., "Mending lvl_1", "Fortune lvl_2").
# * Roman: Displays levels as Roman numerals (e.g., "Mending I", "Fortune II"). Note: I have added roman numeral conversion that supports values up to 3999.
# * Default: If omitted or unrecognized, defaults to Roman.
#
# - Enchantments:
# Each enchantment entry now supports:
# * Weight: The chance (in percent) for the enchantment to be applied.
# * MinLevel / MaxLevel: The range for the enchantment level.
# * LoreColor: The color used to display the enchantment in the item's lore. Valid colors include: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE.
#
# Advanced Weighting: Filler Items & Rare Items
# - You can add "filler" items (for example, AIR) with a high weight to reduce the overall odds of rare items appearing. For example, setting AIR to a weight of 90 while giving DIAMOND a weight of 0.3 will make diamonds extremely rare.
#
# ------------------------------------------------------------------------------
#
# 1) MaxItemsPerSlot (Global)
# - Sets a hard limit on how many items of a single type can be placed in one
# slot, regardless of the item’s maxAmount. Default: 2
#
# 2) ChestSettings (Parent Key)
# - Under this key, create one or more named chest configurations (e.g., "Chest1").
#
#
# [Legacy (Compact) Format]
#
# ChestSettings:
# ChestOld:
# Items: [ITEM_NAME:weight:maxAmount]
# Biomes: [BIOME_NAME]
#
# [New Expanded Format]
#
# ChestSettings:
# ChestNew:
# Items:
# -ITEM_NAME: # Use the exact item names from https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# - Weight: <numeric value>
# - MaxAmount: <numeric value>
# - CustomName: <custom display name> # Supports use of Minecraft color codes like "§0" for Black and so on.
# - LevelType: <Standard or Roman> # Item-wide setting for enchantment display
# - Enchantments:
# - ENCHANTMENT_NAME: # Use exact enchantment names from https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html
# - Weight: <numeric chance in percent>
# - MinLevel: <minimum level>
# - MaxLevel: <maximum level>
# - LoreColor: <color> # (Optional) Valid colors: BLACK, DARK_BLUE, DARK_GREEN,DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY,DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE,YELLOW, WHITE.
# Biomes:
# - BIOME_NAME # Use the exact biome names from https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/block/Biome.html
#
#
# 3) How the Code Chooses Items (Weight-Based):
# - The plugin sums all item 'weight' values in a chest config, then picks an item for each empty slot in proportion to those weights.
# Example: With four items each having weight 5, the total weight is 20, and each item has a 25% chance per slot.
#
# 4) Reducing Item Chance (Filler Items):
# - To lower the odds of high-value items appearing, you can add filler items (e.g., AIR) with a high weight to dilute the selection.
# For instance, AIR with weight 90 dilutes the chance of DIAMOND (e.g., weight 0.3) being chosen.
#
# 5) maxAmount vs. MaxItemsPerSlot:
# - maxAmount: The total maximum number of a given item allowed in the entire chest.
# - MaxItemsPerSlot: The maximum number of that item that can be placed in any one slot.
#
# 6) YAML Tips:
# - Use standard YAML naming rules for chest configurations (alphanumeric, underscores,
# or quoted strings for spaces/special characters).
# - Both "compact" and "expanded" list styles are supported.
#
# ------------------------------------------------------------------------------
#
MaxItemsPerSlot : 2
ChestSettings:
Chest1:
Items :
- MYCELIUM:30:5
- RED_MUSHROOM:20:5
- BROWN_MUSHROOM:20:5
- RED_MUSHROOM_BLOCK:10:5
- BROWN_MUSHROOM_BLOCK:10:5
- MUSHROOM_STEM:10:5
Biomes :
- MUSHROOM_FIELDS
# Explanation of the example above (Legacy Format):
# - 'Chest1' is the identifier for this chest configuration.
# - Items are listed using the "MATERIAL:weight:maxAmount" format.
# * MYCELIUM:30:5 => weight = 30, maxAmount = 5
# * RED_MUSHROOM:20:5 => weight = 20, maxAmount = 5
# etc.
#
# The total weight is 30 + 20 + 20 + 10 + 10 + 10 = 100.
# Therefore, MYCELIUM has a 30% chance per slot, RED_MUSHROOM 20%, etc.
#
# Once an item reaches its maxAmount (here, 5), it will no longer be selected.
#
# MaxItemsPerSlot (global, default 2) limits how many of an item can appear in any one slot.
#
# 'Biomes: [MUSHROOM_FIELDS]' indicates that this configuration applies to chests
# generated in the MUSHROOM_FIELDS biome.
#
# ------------------------------------------------------------------------------
#
# New Expanded Format Example:
#
# The example below shows the new options in use.
#
#
# ChestSettings:
# ChestNew:
# Items:
# - MYCELIUM:
# - Weight: 30
# - MaxAmount: 5
# - CustomName: §6HolyDirt
# - LevelType: Standard # Options: Standard (shows levels as "lvl_1") or Roman (shows as "I"); defaults to Roman.
# - Enchantments:
# - FORTUNE:
# - Weight: 100
# - MinLevel: 1
# - MaxLevel: 400
# - LoreColor: RED
# - LOOTING:
# - Weight: 30
# - MinLevel: 1
# - MaxLevel: 300
# - LoreColor: BLUE
# - AIR:
# - Weight: 90
# - MaxAmount: 999 # Filler item to reduce the odds of rare items appearing.
# Biomes:
# - MUSHROOM_FIELDS
#
#
# In this expanded example:
# - 'MYCELIUM' uses a custom name (displayed in gold) and an item-wide LevelType of Standard. All enchantments on this item will display levels as "lvl_x".
# - The FORTUNE enchantment is set to use a LoreColor of RED, while LOOTING uses BLUE.
# - 'AIR' is added as a filler item with a high weight (90) to reduce the chance that rare items (like DIAMOND, if present with a low weight) are chosen.
#
# ------------------------------------------------------------------------------
#
# You can define multiple chest configurations for different biome groups.
#
# Overworld Biomes:
#
Chest2:
Items:
- WOODEN_AXE:
- Weight : 20
- MaxAmount : 1
- Enchantments:
- VANISHING_CURSE:
- Weight : 50
- MinLevel : 1
- MaxLevel : 1
- EFFICIENCY:
- Weight : 70
- MinLevel : 1
- MaxLevel : 4
- UNBREAKING:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- WOODEN_PICKAXE:
- Weight : 20
- MaxAmount : 1
- Enchantments:
- VANISHING_CURSE:
- Weight : 50
- MinLevel : 1
- MaxLevel : 1
- EFFICIENCY:
- Weight : 40
- MinLevel : 1
- MaxLevel : 4
- FORTUNE:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- UNBREAKING:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- CROSSBOW:
- Weight : 20
- MaxAmount : 1
- Enchantments:
- VANISHING_CURSE:
- Weight : 50
- MinLevel : 1
- MaxLevel : 1
- MULTISHOT:
- Weight : 30
- MinLevel : 1
- MaxLevel : 1
- PIERCING:
- Weight : 30
- MinLevel : 1
- MaxLevel : 4
- QUICK_CHARGE:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- UNBREAKING:
- Weight : 30
- MinLevel : 1
- MaxLevel : 3
- NAME_TAG:20:1
- GOLDEN_APPLE:20:1
- ENCHANTED_GOLDEN_APPLE:20:1
- APPLE:40:2, OAK_LOG:40:2
- DARK_OAK_LOG:40:2
- RAIL:40:2
- DIAMOND:40:2
- STRING:90:5
- ARROW:90:5
- STICK:90:5
- WHEAT:90:5
- IRON_INGOT:90:5
- TORCH:90:5
- ARMADILLO_SCUTE:10:2
- MACE:2:1
- OMINOUS_BOTTLE:10:2
- OMINOUS_TRIAL_KEY:2:1
- TRIAL_KEY:2:1
- BREEZE_ROD:10:2
- RESIN_CLUMP:10:2
Biomes : [BADLANDS, BAMBOO_JUNGLE, BIRCH_FOREST, CHERRY_GROVE, DARK_FOREST, DESERT, DRIPSTONE_CAVES, ERODED_BADLANDS, FLOWER_FOREST, FOREST, GROVE, JAGGED_PEAKS, JUNGLE, LUSH_CAVES, MANGROVE_SWAMP, MEADOW, OLD_GROWTH_BIRCH_FOREST, OLD_GROWTH_PINE_TAIGA, OLD_GROWTH_SPRUCE_TAIGA, PLAINS, SAVANNA, SAVANNA_PLATEAU, SPARSE_JUNGLE, STONY_PEAKS, STONY_SHORE, SUNFLOWER_PLAINS, SWAMP, TAIGA, WINDSWEPT_FOREST, WINDSWEPT_GRAVELLY_HILLS, WINDSWEPT_HILLS, WINDSWEPT_SAVANNA, WOODED_BADLANDS, OCEAN, WARM_OCEAN, LUKEWARM_OCEAN, FROZEN_OCEAN, DEEP_FROZEN_OCEAN, DEEP_LUKEWARM_OCEAN, DEEP_OCEAN, DEEP_COLD_OCEAN, COLD_OCEAN, FROZEN_RIVER, RIVER, BEACH, SNOWY_BEACH, SNOWY_PLAINS, SNOWY_SLOPES, SNOWY_TAIGA, FROZEN_PEAKS, ICE_SPIKES, DEEP_DARK, PALE_GARDEN ]
#
#Nether Biomes:
#
Chest3:
Items : [GOLDEN_APPLE:20:1, ENCHANTED_GOLDEN_APPLE:20:1, GOLD_BLOCK:20:1, GOLDEN_AXE:20:1, IRON_BLOCK:20:1, SNOUT_ARMOR_TRIM_SMITHING_TEMPLATE:20:1, NETHERITE_UPGRADE_SMITHING_TEMPLATE:20:1, IRON_SWORD:20:1, GOLDEN_HELMET:20:1, MUSIC_DISC_PIGSTEP:20:1, DIAMOND:40:2, ANCIENT_DEBRIS:40:2, BONE_BLOCK:40:2, GOLDEN_CARROT:40:2, OBSIDIAN:40:2, CRYING_OBSIDIAN:40:2, IRON_INGOT:90:5, GILDED_BLACKSTONE:90:5, CHAIN:90:5, GOLD_INGOT:90:5, MAGMA_CREAM:90:5, GOLD_NUGGET:90:5, SPECTRAL_ARROW:90:5, STRING:90:5, IRON_NUGGET:90:5, ARROW:90:5, COOKED_PORKCHOP:90:5 ]
Biomes : [BASALT_DELTAS, NETHER_WASTES, CRIMSON_FOREST, SOUL_SAND_VALLEY, WARPED_FOREST ]
#
# End Biomes Example:
#
Chest4:
Items : [ELYTRA:20:1, DRAGON_HEAD:20:1, DRAGON_EGG:20:1, END_CRYSTAL:20:1, ENDER_CHEST:20:1, SHULKER_SHELL:40:2, DIAMOND:40:2, END_ROD:90:5, PURPUR_BLOCK:90:5, MAGENTA_STAINED_GLASS:90:5, GOLD_INGOT:90:5, IRON_INGOT:90:5, OBSIDIAN:90:5 ]
Biomes : [THE_END, END_BARRENS, END_HIGHLANDS, END_MIDLANDS, SMALL_END_ISLANDS ]
#
# Note: To add additional chest configurations (e.g., Chest5, Chest6, etc.),
# simply create a new key under ChestSettings with its own Items and Biomes.
#
Code (YAML):
# SkyGrid World Block Selection Guide:
# This YAML configuration file defines the block distributions for different biomes
# in your SkyGrid world. The configuration is split into two main sections:
#
# 1. biomes: Maps each biome to a specific distribution.
# 2. distributions: Defines the block materials and their respective percentages.
#
# Important Notes:
# - Each biome must be assigned a distribution.
# - Percentages represent the relative chance of each block appearing.
# - The total percentage for each distribution does not need to sum to 100%.
# The system will handle scaling as necessary.
# - Ensure that all block names correspond to valid Bukkit `Material` enums.
# Reference: [Bukkit Material Documentation](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)
#
# Example Usage:
# - To assign the same distribution to multiple biomes, map each biome to the desired distribution.
# - You can define multiple distributions and assign them to different biomes as needed.
#
# Supported Biomes:
# - Refer to [Bukkit Biome Documentation](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/block/Biome.html) for a list of supported biomes.
biomes:
MUSHROOM_FIELDS:
distribution : custom_mushroom_fields
distributions:
custom_mushroom_fields :
# Each block and its chance of appearing.
# Format: BlockID:Percentage
# Example: "STONE:50" means a 50% chance of Stone appearing.
# The total percentage does not need to sum to 100%; the system will scale as needed.
DIRT : 25
RED_MUSHROOM : 20
BROWN_MUSHROOM : 20
RED_MUSHROOM_BLOCK : 10
BROWN_MUSHROOM_BLOCK : 10
MUSHROOM_STEM:
MYCELIUM : 50
STONE : 25
CHEST : 1
SPAWNER : 1
# You can define additional distributions here and assign them to different biomes.
# For example:
# alternate_distribution:
# STONE: 40
# DIRT: 40
# SAND: 20
# To assign this distribution to a biome, add it under the 'biomes' section:
# biomes:
# SOME_OTHER_BIOME:
# distribution: alternate_distribution
# Optional default distribution for biomes not explicitly defined in the 'biomes' section.
# This ensures that a fallback distribution is available.
default_distribution:
ACACIA_LEAVES : 3
ACACIA_LOG : 1
ALLIUM : 2
AMETHYST_BLOCK : 1
AMETHYST_CLUSTER : 1
ANDESITE : 20
AZALEA : 1
AZALEA_LEAVES : 3
AZURE_BLUET : 2
BAMBOO : 2
BEE_NEST : 0.01
BEETROOTS : 1
BELL : 0.001
BIRCH_LEAVES : 3
BIRCH_LOG : 1
BLUE_ORCHID : 1
BONE_BLOCK : 1
BOOKSHELF : 1
BRAIN_CORAL_BLOCK : 0.5
BROWN_MUSHROOM : 2
BUBBLE_CORAL_BLOCK : 0.5
BUDDING_AMETHYST : 0.5
CACTUS : 2
CALCITE : 2
CARROTS : 1
CAVE_VINES : 0.5
CHERRY_LEAVES : 3
CHEST : 1
CHISELED_COPPER : 0.1
CHISELED_STONE_BRICKS : 0.5
CLAY : 20
COAL_ORE : 1.0
COARSE_DIRT : 5
COBBLESTONE : 12
COBWEB : 0.5
COPPER_BULB : 0.1
COPPER_GRATE : 0.1
COPPER_ORE : 0.5
CORNFLOWER : 0.5
CRAFTER : 0.05
CREAKING_HEART : 0.001
CRYING_OBSIDIAN : 0.5
CUT_COPPER : 0.1
DANDELION : 0.5
DARK_OAK_LEAVES : 3
DARK_OAK_LOG : 1
DARK_PRISMARINE : 2
DEAD_BUSH : 0.5
DEEPSLATE : 70
DEEPSLATE_COAL_ORE : 1.0
DEEPSLATE_COPPER_ORE : 0.5
DEEPSLATE_DIAMOND_ORE : 0.1
DEEPSLATE_GOLD_ORE : 0.25
DEEPSLATE_IRON_ORE : 1.0
DEEPSLATE_LAPIS_ORE : 0.25
DEEPSLATE_REDSTONE_ORE : 0.4
DIAMOND_ORE : 0.1
DIORITE : 20
DIRT : 70
DRIPSTONE_BLOCK : 3
FERN : 1
FIRE_CORAL_BLOCK : 0.5
FLOWERING_AZALEA : 0.5
FLOWERING_AZALEA_LEAVES : 3
GLASS : 1
GLOW_LICHEN : 0.5
GOLD_BLOCK : 0.1
GOLD_ORE : 0.25
GRANITE : 20
SHORT_GRASS : 1
GRASS_BLOCK : 70
GRAVEL : 10
HANGING_ROOTS : 0.5
HEAVY_CORE : 0.05
HORN_CORAL_BLOCK : 0.5
ICE : 1
INFESTED_DEEPSLATE : 3
IRON_ORE : 1.0
JUNGLE_LEAVES : 3
JUNGLE_LOG : 1
KELP_PLANT : 1
LAPIS_ORE : 0.25
LARGE_FERN : 0.5
LAVA : 10
LILAC : 0.5
LILY_OF_THE_VALLEY : 0.5
LILY_PAD : 0.5
MANGROVE_LEAVES : 3
MANGROVE_LOG : 1
MANGROVE_ROOTS : 1
MANGROVE_WOOD : 1
MELON : 5
MOSS_BLOCK : 1
MOSSY_COBBLESTONE : 5
MOSSY_STONE_BRICKS : 2
MUD : 8
MUDDY_MANGROVE_ROOTS : 4
MYCELIUM : 10
OAK_LEAVES : 3
OAK_LOG : 1
OBSIDIAN : 5
OPEN_EYEBLOSSOM : 0.05
ORANGE_TULIP : 0.5
OXEYE_DAISY : 0.5
PACKED_ICE : 2
PALE_HANGING_MOSS : 0.5
PALE_MOSS_BLOCK : 0.5
PALE_MOSS_CARPET : 0.5
PALE_OAK_LEAVES : 3
PALE_OAK_LOG : 1
PEONY : 0.5
PINK_PETALS : 0.5
PINK_TULIP : 0.5
PISTON : 0.1
PODZOL : 5
POINTED_DRIPSTONE : 1
POPPY : 0.5
POTATOES : 0.5
PRISMARINE : 1
PUMPKIN : 5
RAW_COPPER_BLOCK : 1.2
RAW_IRON_BLOCK : 1.2
RED_MUSHROOM : 2
RED_SAND : 5
RED_SANDSTONE : 3
RED_TULIP : 0.5
REDSTONE_ORE : 0.4
RESIN_BLOCK : 0.05
ROOTED_DIRT : 4
ROSE_BUSH : 0.5
SAND : 30
SANDSTONE : 10
SCULK : 0.3
SCULK_CATALYST : 0.05
SCULK_SENSOR : 0.05
SCULK_SHRIEKER : 0.02
SCULK_VEIN : 0.3
SEA_LANTERN : 1
SEA_PICKLE : 1
SEAGRASS : 0.5
SMALL_DRIPLEAF : 0.5
SMOOTH_BASALT : 2
SNOW_BLOCK : 10
SPAWNER : 0.001
SPONGE : 0.05
SPORE_BLOSSOM : 0.5
SPRUCE_LEAVES : 3
SPRUCE_LOG : 1
STICKY_PISTON : 0.08
STONE : 140
STONE_BRICKS : 2
SUGAR_CANE : 5
SUNFLOWER : 0.5
SUSPICIOUS_GRAVEL : 5
SWEET_BERRY_BUSH : 0.5
TALL_GRASS : 0.5
TARGET : 0.05
TNT : 0.05
TRIAL_SPAWNER : 0.001
TUBE_CORAL_BLOCK : 0.5
TUFF : 20
VAULT : 0.01
WATER : 10
WHEAT : 1
WHITE_CONCRETE_POWDER : 0.5
WHITE_TULIP : 0.5
WHITE_WOOL : 0.5
WITHER_ROSE : 0.05
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.toolsnexus.com%2Fmc%2Fcrop-bug-fix.png)
- Fixed bug preventing `WHEAT, CARROTS, POTATOES, BEETROOTS, MELON_STEM, PUMPKIN_STEM` from growing.
- Added an event check for `CAVE_VINES, CAVE_VINES_PLANT` to prevent growth unless attached to a solid block.
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.toolsnexus.com%2Fmc%2Fchest.jpg)
- Resolved an issue where custom mob spawners weren't applying your configuration settings correctly after updating to the 1.21.4 API. They will now function as intended instead of using the hardcoded defaults.
- Further enhanced both the chest and spawner systems. You can now increase chest counts without issues; I tested it with 100% chest density, and it didn't crash (though I don't recommend this). For example, use 5% instead of 0.05% if you want more chests in the Overworld. The same applies to spawners.
Chest Settings
Spawner Settings
Overworld Skygrid Materials
- Added `RESIN_CLUMP` as a possible chest loot item for the overworld.
Spawner Settings
- Added the `CREAKING` mob as a possible selection for overworld spawners
Overworld Skygrid Materials
- `RESIN_BLOCK`
- `PALE_HANGING_MOSS`
- `PALE_MOSS_BLOCK`
- `PALE_MOSS_CARPET`
- `PALE_OAK_LOG`
- `PALE_OAK_LEAVES`
- `OPEN_EYEBLOSSOM`
- `CREAKING_HEART`
- Changed the default `processDelay` to be zero instead of 10.
- Paper check added to fist boot for force loaded async chunks while initial generation.
- Moved to 1.21.4 API for Paper and Spigotmc
- Resolved an issue where ore replacement for stone blocks failed when generated by water sources, as the plugin previously only handled lava-based generation.
- Fixed a bug that caused chest item max limits set in configuration files to be exceeded.
- Updated to improve performance and memory efficiency and migrated to the 1.21.3 API.
- Updated the beehive handling to directly place bees into beehives, leveraging new options available in the latest API.
- Removed the Pregenerator functionality and spun it off into a standalone plugin, offering more settings and customizations like autorun when server is empty and more. It can be found here: Chunker
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.toolsnexus.com%2Fmc%2Fbig.png)
New:
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.toolsnexus.com%2Fmc%2Foregen-basalt.gif)
Bug Fix:
- Basalt Ore Generation: Added support for generating ores in basalt blocks when basalt is formed.
Bug Fix:
- Fixed an issue with the BlockFromToEvent where the plugin was incorrectly checking adjacent blocks of the destination block. This prevented liquids from flowing as they should when updated by any blocks touching the source block. The event handler now correctly checks the adjacent blocks of the source block, ensuring proper event cancellation when necessary.
- Updated ores.yml: Added default ores/block generation configurations for basalt.
- If you just want normal basalt generation, you can set it up like this:
Code (YAML):
BASALT:
BASALT : 100
BASALT : 100
- If not here is the new default file
Code (YAML):
# Ore Replacement Chances
# This file is used to specify the chances of different ores being chosen for replacement
# when lava or water generates stone blocks in the world. The stone generate in the world can be replaced by any block you want as long as its in the bukkit materials list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# Format: Material_Name:Percentage
# The percentage represents the chance (in whole numbers) of the ore being chosen
# for replacement out of the total replacements when lava or water generates stone.
# Each line represents one ore with its corresponding replacement chance.
# Lines starting with '#' are considered comments and will be ignored by the code.
# Example:
# DIAMOND_ORE:5
# This means that there is a 5% chance of a diamond ore block being chosen
# when lava or water generates a stone block.
# The total sum of percentages should be less than or equal to 100.
# If the sum exceeds 100, the probabilities will be scaled down proportionally
# to fit within the 0-100 range.
# For example, if the total sum of percentages exceeds 100 as follows:
# DIAMOND_ORE:40
# COAL_ORE:60
# IRON_ORE:30
# GOLD_ORE:20
# The total sum is 40 + 60 + 30 + 20 = 150, which exceeds 100.
# To fit within the 0-100 range, the probabilities will be scaled down proportionally:
# DIAMOND_ORE: 40 * (100 / 150) = 26 (approximately 27)
# COAL_ORE: 60 * (100 / 150) = 40
# IRON_ORE: 30 * (100 / 150) = 20
# GOLD_ORE: 20 * (100 / 150) = 13 (approximately 13)
# The adjusted probabilities now add up to 26 + 40 + 20 + 13 = 99, which is within the 0-100 range.
#For if the block generated is stone
STONE:
STONE : 98
COAL_ORE : 0.3
COPPER_ORE : 0.4
DIAMOND_ORE : 0.1
EMERALD_ORE : 0.1
GOLD_ORE : 0.2
IRON_ORE : 0.4
LAPIS_ORE : 0.2
REDSTONE_ORE : 0.3
#For if the block generated cobblestone
COBBLESTONE:
DEEPSLATE : 98
DEEPSLATE_COAL_ORE : 0.3
DEEPSLATE_COPPER_ORE : 0.4
DEEPSLATE_DIAMOND_ORE : 0.1
DEEPSLATE_EMERALD_ORE : 0.1
DEEPSLATE_GOLD_ORE : 0.2
DEEPSLATE_IRON_ORE : 0.4
DEEPSLATE_LAPIS_ORE : 0.2
DEEPSLATE_REDSTONE_ORE : 0.3
#For if the block generated is basalt
BASALT:
ANCIENT_DEBRIS : 0.1
BASALT : 44.9
BLACKSTONE : 20
GILDED_BLACKSTONE : 3.0
NETHER_GOLD_ORE : 3.0
NETHER_QUARTZ_ORE : 5.0
POLISHED_BASALT : 12
POLISHED_BLACKSTONE : 12
# This file is used to specify the chances of different ores being chosen for replacement
# when lava or water generates stone blocks in the world. The stone generate in the world can be replaced by any block you want as long as its in the bukkit materials list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# Format: Material_Name:Percentage
# The percentage represents the chance (in whole numbers) of the ore being chosen
# for replacement out of the total replacements when lava or water generates stone.
# Each line represents one ore with its corresponding replacement chance.
# Lines starting with '#' are considered comments and will be ignored by the code.
# Example:
# DIAMOND_ORE:5
# This means that there is a 5% chance of a diamond ore block being chosen
# when lava or water generates a stone block.
# The total sum of percentages should be less than or equal to 100.
# If the sum exceeds 100, the probabilities will be scaled down proportionally
# to fit within the 0-100 range.
# For example, if the total sum of percentages exceeds 100 as follows:
# DIAMOND_ORE:40
# COAL_ORE:60
# IRON_ORE:30
# GOLD_ORE:20
# The total sum is 40 + 60 + 30 + 20 = 150, which exceeds 100.
# To fit within the 0-100 range, the probabilities will be scaled down proportionally:
# DIAMOND_ORE: 40 * (100 / 150) = 26 (approximately 27)
# COAL_ORE: 60 * (100 / 150) = 40
# IRON_ORE: 30 * (100 / 150) = 20
# GOLD_ORE: 20 * (100 / 150) = 13 (approximately 13)
# The adjusted probabilities now add up to 26 + 40 + 20 + 13 = 99, which is within the 0-100 range.
#For if the block generated is stone
STONE:
STONE : 98
COAL_ORE : 0.3
COPPER_ORE : 0.4
DIAMOND_ORE : 0.1
EMERALD_ORE : 0.1
GOLD_ORE : 0.2
IRON_ORE : 0.4
LAPIS_ORE : 0.2
REDSTONE_ORE : 0.3
#For if the block generated cobblestone
COBBLESTONE:
DEEPSLATE : 98
DEEPSLATE_COAL_ORE : 0.3
DEEPSLATE_COPPER_ORE : 0.4
DEEPSLATE_DIAMOND_ORE : 0.1
DEEPSLATE_EMERALD_ORE : 0.1
DEEPSLATE_GOLD_ORE : 0.2
DEEPSLATE_IRON_ORE : 0.4
DEEPSLATE_LAPIS_ORE : 0.2
DEEPSLATE_REDSTONE_ORE : 0.3
#For if the block generated is basalt
BASALT:
ANCIENT_DEBRIS : 0.1
BASALT : 44.9
BLACKSTONE : 20
GILDED_BLACKSTONE : 3.0
NETHER_GOLD_ORE : 3.0
NETHER_QUARTZ_ORE : 5.0
POLISHED_BASALT : 12
POLISHED_BLACKSTONE : 12
Update:
- The pregen command's default radius now adapts to the world's border instead of being hardcoded to 29999984, ensuring compatibility with custom world borders.
- you can use this if set your world border manually using /worldborder set #
- Usage: /pregen <ParallelTasksMultiplier> <PrintUpdateDelayin(Seconds/Minutes/Hours)> <world> <Radiusin(Blocks/Chunks/Regions) or default>
Command Examples:
/pregen 6 5s world 1000b
/pregen 2 2m world_nether 500c
/pregen 1 12h world_the_end 100r
/pregen 4 10s world default
- The pregen command's default radius now adapts to the world's border instead of being hardcoded to 29999984, ensuring compatibility with custom world borders.
- you can use this if set your world border manually using /worldborder set #
- Usage: /pregen <ParallelTasksMultiplier> <PrintUpdateDelayin(Seconds/Minutes/Hours)> <world> <Radiusin(Blocks/Chunks/Regions) or default>
Command Examples:
/pregen 6 5s world 1000b
/pregen 2 2m world_nether 500c
/pregen 1 12h world_the_end 100r
/pregen 4 10s world default
1.21 Update:
Added chest items for Overworld:
For VAULT and TRIAL_SPAWNER there is a 50% chance applied to determine if it will be set Ominous.
Note: These blocks where added to the default files, you can still add any other blocks from the available in the materials page.
https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
Pre-generator Rework:
- Usage: /pregen <ParallelTasksMultiplier> <PrintUpdateDelayin(Seconds/Minutes/Hours)> <world> <Radiusin(Blocks/Chunks/Regions)>
For more information you can check out the page here.
Bug Fixed
- Fixed some issues with pregenerator unloading chunks to soon,
- Extend unloading until chunk is entity ticking to ensure chunks are fully generated
Made my own simple data pack Void-Biomes-1.21, currently Void Worldgen has not been updated to 1.21 yet, so in the future if you want you can use that instead.
- The data pack only generate the biome data for the Minecraft worlds, the only structure is the end portal and pillars
- The Void-Biomes-1.21 data pack should improve performance (~20%) if used in place of the old Void Worldgen data pack since it is not generating structure boundary boxes for any structures.
- You can get the simple data pack here, Void-Biomes-1.21
Added chest items for Overworld:
- MACE
- OMINOUS_BOTTLE
- OMINOUS_TRIAL_KEY
- TRIAL_KEY
- BREEZE_ROD
- BREEZE
- BOGGED
- CHISELED_COPPER
- COPPER_BULB
- COPPER_GRATE
- VAULT
- TRIAL_SPAWNER
- HEAVY_CORE
For VAULT and TRIAL_SPAWNER there is a 50% chance applied to determine if it will be set Ominous.
Note: These blocks where added to the default files, you can still add any other blocks from the available in the materials page.
https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
Pre-generator Rework:
- Usage: /pregen <ParallelTasksMultiplier> <PrintUpdateDelayin(Seconds/Minutes/Hours)> <world> <Radiusin(Blocks/Chunks/Regions)>
For more information you can check out the page here.
Bug Fixed
- Fixed some issues with pregenerator unloading chunks to soon,
- Extend unloading until chunk is entity ticking to ensure chunks are fully generated
Made my own simple data pack Void-Biomes-1.21, currently Void Worldgen has not been updated to 1.21 yet, so in the future if you want you can use that instead.
- The data pack only generate the biome data for the Minecraft worlds, the only structure is the end portal and pillars
- The Void-Biomes-1.21 data pack should improve performance (~20%) if used in place of the old Void Worldgen data pack since it is not generating structure boundary boxes for any structures.
- You can get the simple data pack here, Void-Biomes-1.21
- Boosted pregenerator performance by up to 25%.
- Enhanced generator, custom chest, spawner, and related utility classes to utilize the fastutil library, yielding a performance increase of up to 3-7% and significantly reducing memory usage (observed differences of up to 1.5GB in certain scenarios).
- Optimized the custom chest class by minimizing the number of times the chest block is accessed. Used a "fake" chest represented by an array for item placement calculations, accessed the chest instance only twice, and implemented multithreading to significantly reduce processing time to get random chest items.
- Improved material loading by adopting a new alias, resulting in more balanced loading between materials with and without biomes. Fetching random materials for both world and biome is now notably faster, reducing thread blocking during operations like /tpr. Additionally, precomputing wherever feasible and implementing caching mechanisms have been employed to further reduce fetch times for random materials. CPU usage during /tpr decreased from consistently hitting 100% across all cores for 2-3 seconds to a range of 80-90% for less than a second (test done with simulation-distance=8 and view-distance=8).
Note: Many main classes have been almost fully overhauled to use the fastutil library. If you encounter any issues, please submit them on the GitHub issue page. I tried my best to test every scenario I can think of, but I can't always catch every issue.
Updated Command:
TPR Command Settings:
Generator Update:
Thank you for your continued support! Please report any bugs/issues/feature suggestions on my GitHub
https://github.com/DavidS-Repo/SkyGridx/issues
- /gclogs(on)/(off): Updated to /eclogs(on)/(off). This change comes as the more general event control has been introduced and it's no longer just growth control.
- gc.gclogson: Updated to ec.gclogson:. Grants permission to enable event control logging using /eclogson. (Default OP)
- gc.gclogsoff: Updated to ec.gclogsoff. Grants permission to disable event control logging using /eclogsoff. (Default OP)
TPR Command Settings:
- Added a new option for the server to randomly teleport players on first join, onFirstJoin by default is false, this provides servers without a spawn the option to random teleport the player only the first time they connect to the server.
- Added a new delay option for usage of /tpr commands, b2bDelay adds a fourth timer to prevent players from using the /tpr command back-to-back. Players must wait for this duration before they can use any /tpr commands again.
- Moved the list of blocks considered unsafe to teleport to settings file, under DANGEROUSBLOCKS, this list is used by the code to determine what materials you do not want the player to be teleported on top of when they use the /tpr command.
- EventControl: Lets you turn off and on all the newly added grid integrity checks, these monitor server events to prevent the following: BlockIgniteEvent, BlockFadeEvent, BlockFromToEvent, StructureGrowEvent, BlockSpreadEvent, BlockGrowEvent, BlockFormEvent, and EntityChangeBlock.
- There is also a new list of materials in GRAVITY_AFFECTED_BLOCKS which is used to determine what blocks you do not want snow to form on in the grid or general gravity-affected blocks that you do not want to fall due to server overload.
Code (YAML):
# Configuration
# Generator settings
generator :
# Delay in ticks before processing chunks after chunk load event.
# A shorter delay increases server load, while a longer delay may affect player immersion.
processDelay : 5
# Max and Min height for blocks placed in the Grids for all Environments.
# Keep within increments of 4 starting from the current min or max.
# i.e. 0, 4, 8, 12, 16 ... or 128, 124, 120, 116, 112 ...
# Exceeding max heights for worlds will result in errors.
# Nether settings (min 0, max 128)
nether:
minY : 0
maxY : 128
# End settings (min 0, max 128)
end:
minY : 0
maxY : 128
# Normal world settings (min -64, max 256)
normal:
minY : -64
maxY : 64
# Default settings for unspecified environments (min and max depend on your custom environment)
default:
minY : 0
maxY : 128
# TPR Command settings
tprCommand :
# Randomly teleports the player using /tpr when they first join.
# Set to true to enable.
onFirstJoin : false
# The delay in seconds to prevent players from using the /tpr command back-to-back.
# Players must wait for this duration before they can use the /tpr command again.
b2bDelay : 10
# Delay in seconds before teleporting in the overworld
tprDelay : 30
# Delay in seconds before teleporting in the nether
tprNetherDelay : 30
# Delay in seconds before teleporting in the end
tprEndDelay : 30
# Maximum X coordinate for random teleport (max 29999983)
maxX : 29999983
# Maximum Z coordinate for random teleport (max 29999983)
maxZ : 29999983
# Minimum X coordinate for random teleport (max -29999983)
minX : -29999983
# Minimum Z coordinate for random teleport (max -29999983)
minZ : -29999983
# Default Y coordinate for teleport destination (min -64, max 256, try to get it somewhere in between all your environments)
destinationY : 64
# These are materials that the tpr command considers dangerous and will prevent players from being placed on them when /tpr is used.
DANGEROUSBLOCKS:
Materials :
- AIR
- ALLIUM
- AZURE_BLUET
- BEETROOTS
- BIG_DRIPLEAF
- BLUE_ORCHID
- BROWN_MUSHROOM
- CACTUS
- CAMPFIRE
- CARROTS
- CAVE_VINES_PLANT
- COBWEB
- CORNFLOWER
- CRIMSON_FUNGUS
- CRIMSON_ROOTS
- DANDELION
- DEAD_BUSH
- FERN
- FIRE
- GLOW_LICHEN
- HANGING_ROOTS
- KELP
- KELP_PLANT
- LARGE_FERN
- LAVA
- LAVA_CAULDRON
- LILAC
- LILY_OF_THE_VALLEY
- MAGMA_BLOCK
- MELON_STEM
- NETHER_SPROUTS
- NETHER_WART
- ORANGE_TULIP
- OXEYE_DAISY
- PEONY
- PINK_TULIP
- PITCHER_PLANT
- POINTED_DRIPSTONE
- POPPY
- POTATOES
- POWDER_SNOW
- PUMPKIN_STEM
- RED_MUSHROOM
- RED_TULIP
- ROSE_BUSH
- SCULK_VEIN
- SEAGRASS
- SHORT_GRASS
- SMALL_DRIPLEAF
- SNOW
- SOUL_FIRE
- SPORE_BLOSSOM
- SUGAR_CANE
- SUNFLOWER
- SWEET_BERRY_BUSH
- TALL_GRASS
- TALL_SEAGRASS
- TORCHFLOWER
- TORCHFLOWER_CROP
- TWISTING_VINES
- VINE
- VOID_AIR
- WARPED_FUNGUS
- WARPED_ROOTS
- WATER
- WEEPING_VINES
- WHEAT
- WHITE_TULIP
- WITHER_ROSE
# Fog settings
fog :
# Auto-enable fog setting
# Set to true to automatically enable fog when the plugin starts.
autoEnable : false
# Event Control settings
EventControl :
# (true to enable event check, false to disable)
# BlockIgniteEvent - Prevents lava from causing fires to near by flammable grid blocks
BlockIgniteEvent : true
# BlockFadeEvent - Prevents ice from melting if it's in the grid and fire from burning out
BlockFadeEvent : true
# BlockFromToEvent - Prevents lava and water from flowing due to server overload
BlockFromToEvent : true
# StructureGrowEvent - Prevents saplings in floating in grid from growing
StructureGrowEvent : true
# BlockSpreadEvent - Prevents bamboo sapling from growing since it does not trigger with StructureGrowEvent
BlockSpreadEvent : true
# BlockGrowEvent is used for KELP_PLANT, SUGAR_CANE, CACTUS, and TWISTING_VINES_PLANT (not logged in /eclogson, to much spam)
BlockGrowEvent : true
# BlockFormEvent - Prevents block updates that mess up the grid in snow biomes, snow forming on top of blocks
BlockFormEvent : true
# EntityChangeBlock - Prevents gravity-affected blocks from randomly falling due to overload
EntityChangeBlockEvent : true
# This list is for blocks that you want to monitor the BlockFormEvent and EntityChangeBlock events.
GRAVITY_AFFECTED_BLOCKS:
Materials :
- SAND
- RED_SAND
- GRAVEL
- KELP_PLANT
- ANVIL
- SUSPICIOUS_SAND
- SUSPICIOUS_GRAVEL
- DRAGON_EGG
- BLACK_CONCRETE_POWDER
- BLUE_CONCRETE_POWDER
- BROWN_CONCRETE_POWDER
- CYAN_CONCRETE_POWDER
- GRAY_CONCRETE_POWDER
- GREEN_CONCRETE_POWDER
- LIGHT_BLUE_CONCRETE_POWDER
- LIGHT_GRAY_CONCRETE_POWDER
- LIME_CONCRETE_POWDER
- MAGENTA_CONCRETE_POWDER
- ORANGE_CONCRETE_POWDER
- PINK_CONCRETE_POWDER
- PURPLE_CONCRETE_POWDER
- RED_CONCRETE_POWDER
- WHITE_CONCRETE_POWDER
- YELLOW_CONCRETE_POWDER
# Generator settings
generator :
# Delay in ticks before processing chunks after chunk load event.
# A shorter delay increases server load, while a longer delay may affect player immersion.
processDelay : 5
# Max and Min height for blocks placed in the Grids for all Environments.
# Keep within increments of 4 starting from the current min or max.
# i.e. 0, 4, 8, 12, 16 ... or 128, 124, 120, 116, 112 ...
# Exceeding max heights for worlds will result in errors.
# Nether settings (min 0, max 128)
nether:
minY : 0
maxY : 128
# End settings (min 0, max 128)
end:
minY : 0
maxY : 128
# Normal world settings (min -64, max 256)
normal:
minY : -64
maxY : 64
# Default settings for unspecified environments (min and max depend on your custom environment)
default:
minY : 0
maxY : 128
# TPR Command settings
tprCommand :
# Randomly teleports the player using /tpr when they first join.
# Set to true to enable.
onFirstJoin : false
# The delay in seconds to prevent players from using the /tpr command back-to-back.
# Players must wait for this duration before they can use the /tpr command again.
b2bDelay : 10
# Delay in seconds before teleporting in the overworld
tprDelay : 30
# Delay in seconds before teleporting in the nether
tprNetherDelay : 30
# Delay in seconds before teleporting in the end
tprEndDelay : 30
# Maximum X coordinate for random teleport (max 29999983)
maxX : 29999983
# Maximum Z coordinate for random teleport (max 29999983)
maxZ : 29999983
# Minimum X coordinate for random teleport (max -29999983)
minX : -29999983
# Minimum Z coordinate for random teleport (max -29999983)
minZ : -29999983
# Default Y coordinate for teleport destination (min -64, max 256, try to get it somewhere in between all your environments)
destinationY : 64
# These are materials that the tpr command considers dangerous and will prevent players from being placed on them when /tpr is used.
DANGEROUSBLOCKS:
Materials :
- AIR
- ALLIUM
- AZURE_BLUET
- BEETROOTS
- BIG_DRIPLEAF
- BLUE_ORCHID
- BROWN_MUSHROOM
- CACTUS
- CAMPFIRE
- CARROTS
- CAVE_VINES_PLANT
- COBWEB
- CORNFLOWER
- CRIMSON_FUNGUS
- CRIMSON_ROOTS
- DANDELION
- DEAD_BUSH
- FERN
- FIRE
- GLOW_LICHEN
- HANGING_ROOTS
- KELP
- KELP_PLANT
- LARGE_FERN
- LAVA
- LAVA_CAULDRON
- LILAC
- LILY_OF_THE_VALLEY
- MAGMA_BLOCK
- MELON_STEM
- NETHER_SPROUTS
- NETHER_WART
- ORANGE_TULIP
- OXEYE_DAISY
- PEONY
- PINK_TULIP
- PITCHER_PLANT
- POINTED_DRIPSTONE
- POPPY
- POTATOES
- POWDER_SNOW
- PUMPKIN_STEM
- RED_MUSHROOM
- RED_TULIP
- ROSE_BUSH
- SCULK_VEIN
- SEAGRASS
- SHORT_GRASS
- SMALL_DRIPLEAF
- SNOW
- SOUL_FIRE
- SPORE_BLOSSOM
- SUGAR_CANE
- SUNFLOWER
- SWEET_BERRY_BUSH
- TALL_GRASS
- TALL_SEAGRASS
- TORCHFLOWER
- TORCHFLOWER_CROP
- TWISTING_VINES
- VINE
- VOID_AIR
- WARPED_FUNGUS
- WARPED_ROOTS
- WATER
- WEEPING_VINES
- WHEAT
- WHITE_TULIP
- WITHER_ROSE
# Fog settings
fog :
# Auto-enable fog setting
# Set to true to automatically enable fog when the plugin starts.
autoEnable : false
# Event Control settings
EventControl :
# (true to enable event check, false to disable)
# BlockIgniteEvent - Prevents lava from causing fires to near by flammable grid blocks
BlockIgniteEvent : true
# BlockFadeEvent - Prevents ice from melting if it's in the grid and fire from burning out
BlockFadeEvent : true
# BlockFromToEvent - Prevents lava and water from flowing due to server overload
BlockFromToEvent : true
# StructureGrowEvent - Prevents saplings in floating in grid from growing
StructureGrowEvent : true
# BlockSpreadEvent - Prevents bamboo sapling from growing since it does not trigger with StructureGrowEvent
BlockSpreadEvent : true
# BlockGrowEvent is used for KELP_PLANT, SUGAR_CANE, CACTUS, and TWISTING_VINES_PLANT (not logged in /eclogson, to much spam)
BlockGrowEvent : true
# BlockFormEvent - Prevents block updates that mess up the grid in snow biomes, snow forming on top of blocks
BlockFormEvent : true
# EntityChangeBlock - Prevents gravity-affected blocks from randomly falling due to overload
EntityChangeBlockEvent : true
# This list is for blocks that you want to monitor the BlockFormEvent and EntityChangeBlock events.
GRAVITY_AFFECTED_BLOCKS:
Materials :
- SAND
- RED_SAND
- GRAVEL
- KELP_PLANT
- ANVIL
- SUSPICIOUS_SAND
- SUSPICIOUS_GRAVEL
- DRAGON_EGG
- BLACK_CONCRETE_POWDER
- BLUE_CONCRETE_POWDER
- BROWN_CONCRETE_POWDER
- CYAN_CONCRETE_POWDER
- GRAY_CONCRETE_POWDER
- GREEN_CONCRETE_POWDER
- LIGHT_BLUE_CONCRETE_POWDER
- LIGHT_GRAY_CONCRETE_POWDER
- LIME_CONCRETE_POWDER
- MAGENTA_CONCRETE_POWDER
- ORANGE_CONCRETE_POWDER
- PINK_CONCRETE_POWDER
- PURPLE_CONCRETE_POWDER
- RED_CONCRETE_POWDER
- WHITE_CONCRETE_POWDER
- YELLOW_CONCRETE_POWDER
- Auto populates BEEHIVE and BEE_NEST, currently only 2 are added to reduce the use of resources.
- Updated generator to improve efficiency, offloading some of the work off the main thread when possible.
- Grid and Block Pallets: New block pallet changes for more variety and better distribution.
- The chest loading has been simplified and optimized. Improved method for filling chests with items to increase performance.
- Updated FirstBootChecker to consider any missing files as a first boot not just the world.txt file in the SkygridBlocks folder
- Reduced the chunks preloaded in the initial check on first boot to 4 chunk distance instead of 16.
- Update chest settings to add the missing biome THE_END to the end chest settings.
Thank you for your continued support! Please report any bugs/issues/feature suggestions on my GitHub
https://github.com/DavidS-Repo/SkyGridx/issues
New Features and Commands:
New Commands:
Updated Command:
Permissions:
Added Permissions for Every Command:
sg.tpr: Allows teleportation to Overworld, Nether, and End using the /tpr [world] command. (Default all)
sg.tpr.overworld: Grants permission to use the /tpro command for teleportation in the Overworld. (Default all)
sg.tpr.nether: Grants permission to use the /tprn command for teleportation in the Nether. (Default all)
sg.tpr.end: Enables usage of the /tpre command for teleportation in the End. (Default all)
sg.tpr.*: Provides access to all teleportation commands. (Default OP)
sg.fogon: Allows enabling fog using the /fogon command. (Default OP)
sg.fogoff: Allows disabling fog with the /fogoff command. (Default OP)
sg.gclogson: Grants permission to enable GrowthControl logging using /gclogson. (Default OP)
sg.gclogsoff: Grants permission to disable GrowthControl logging using /gclogsoff. (Default OP)
sg.pregen: Grants permission to use the pre-generation command with customizable parameters. (Default OP)
sg.pregenoff: Grants permission to disable pre-generation using the /pregenoff command. (Default OP)
sg.patch: Allows patching files to update materials and entities to another version. (Default OP)
sg.regen: Grants permission to regenerate all loaded chunks using the /regen command. (Default OP)
sg.*: Provides access to all SkyGrid commands. (Default OP)
Configuration:
New Configuration File: settings.yml
Generator Settings:
Performance Improvements:
I hope you enjoy the new features, performance improvements, and added flexibility with configurations! Feel free to reach out with any feedback or issues
https://github.com/DavidS-Repo/SkyGridx/issues
New Commands:
- /tpro: Random teleport in the Overworld.
- /tprn: Random teleport in the Nether.
- /tpre: Random teleport in the End.
- These are shorthand versions of the previous /tpr [world] command with the advantage of being able to set the permissions individually.
Updated Command:
- /tpr [world]: Random teleport in the Overworld, Nether, or End. Updated to add overworld to the autocomplete. Using /tpr with no arguments still defaults to overworld.
Permissions:
Added Permissions for Every Command:
sg.tpr: Allows teleportation to Overworld, Nether, and End using the /tpr [world] command. (Default all)
sg.tpr.overworld: Grants permission to use the /tpro command for teleportation in the Overworld. (Default all)
sg.tpr.nether: Grants permission to use the /tprn command for teleportation in the Nether. (Default all)
sg.tpr.end: Enables usage of the /tpre command for teleportation in the End. (Default all)
sg.tpr.*: Provides access to all teleportation commands. (Default OP)
sg.fogon: Allows enabling fog using the /fogon command. (Default OP)
sg.fogoff: Allows disabling fog with the /fogoff command. (Default OP)
sg.gclogson: Grants permission to enable GrowthControl logging using /gclogson. (Default OP)
sg.gclogsoff: Grants permission to disable GrowthControl logging using /gclogsoff. (Default OP)
sg.pregen: Grants permission to use the pre-generation command with customizable parameters. (Default OP)
sg.pregenoff: Grants permission to disable pre-generation using the /pregenoff command. (Default OP)
sg.patch: Allows patching files to update materials and entities to another version. (Default OP)
sg.regen: Grants permission to regenerate all loaded chunks using the /regen command. (Default OP)
sg.*: Provides access to all SkyGrid commands. (Default OP)
Configuration:
New Configuration File: settings.yml
Generator Settings:
- processDelay: Delay in ticks before processing chunks after chunk load event (default: 10).
- Environment-specific grid generation height minY and maxY settings for Nether, End, and Normal worlds.
- Delay in seconds before using the /tpr commands again (default: 30). You can change it individually for each environment.
- Max and Min coordinates for random teleportation.
- Default Y coordinate for teleport destination.
- autoEnable: Automatically enable fog when the plugin starts (default: false).
Code (YAML):
# Configuration
# Generator settings
generator :
# Delay in ticks before processing chunks after chunk load event.
# A shorter delay increases server load, while a longer delay may affect player immersion.
processDelay : 10
# Max and Min height for blocks placed in the Grids for all Environments.
# Keep within increments of 4 starting from the current min or max.
# i.e. 0, 4, 8, 12, 16 ... or 128, 124, 120, 116, 112 ...
# Exceeding max heights for worlds will result in errors.
# Nether settings (min 0, max 128)
nether:
minY : 0
maxY : 128
# End settings (min 0, max 128)
end:
minY : 0
maxY : 128
# Normal world settings (min -64, max 256)
normal:
minY : -64
maxY : 64
# Default settings for unspecified environments (min and max depend on your custom environment)
default:
minY : 0
maxY : 128
# TPR Command settings
tprCommand :
# Delay in seconds before teleporting in the overworld
tprDelay : 30
# Delay in seconds before teleporting in the nether
tprNetherDelay : 30
# Delay in seconds before teleporting in the end
tprEndDelay : 30
# Maximum X coordinate for random teleport (max 29999983)
maxX : 29999983
# Maximum Z coordinate for random teleport (max 29999983)
maxZ : 29999983
# Minimum X coordinate for random teleport (max -29999983)
minX : -29999983
# Minimum Z coordinate for random teleport (max -29999983)
minZ : -29999983
# Default Y coordinate for teleport destination (min -64, max 256, try to get it somewhere in between all your environments)
destinationY : 64
# Fog settings
fog :
# Auto-enable fog setting
# Set to true to automatically enable fog when the plugin starts.
autoEnable : false
# Generator settings
generator :
# Delay in ticks before processing chunks after chunk load event.
# A shorter delay increases server load, while a longer delay may affect player immersion.
processDelay : 10
# Max and Min height for blocks placed in the Grids for all Environments.
# Keep within increments of 4 starting from the current min or max.
# i.e. 0, 4, 8, 12, 16 ... or 128, 124, 120, 116, 112 ...
# Exceeding max heights for worlds will result in errors.
# Nether settings (min 0, max 128)
nether:
minY : 0
maxY : 128
# End settings (min 0, max 128)
end:
minY : 0
maxY : 128
# Normal world settings (min -64, max 256)
normal:
minY : -64
maxY : 64
# Default settings for unspecified environments (min and max depend on your custom environment)
default:
minY : 0
maxY : 128
# TPR Command settings
tprCommand :
# Delay in seconds before teleporting in the overworld
tprDelay : 30
# Delay in seconds before teleporting in the nether
tprNetherDelay : 30
# Delay in seconds before teleporting in the end
tprEndDelay : 30
# Maximum X coordinate for random teleport (max 29999983)
maxX : 29999983
# Maximum Z coordinate for random teleport (max 29999983)
maxZ : 29999983
# Minimum X coordinate for random teleport (max -29999983)
minX : -29999983
# Minimum Z coordinate for random teleport (max -29999983)
minZ : -29999983
# Default Y coordinate for teleport destination (min -64, max 256, try to get it somewhere in between all your environments)
destinationY : 64
# Fog settings
fog :
# Auto-enable fog setting
# Set to true to automatically enable fog when the plugin starts.
autoEnable : false
Performance Improvements:
- Made the plugin faster and more efficient by using better data handling methods.
- Reduced unnecessary code execution to improve speed.
- Fixed the problem with empty chunks in the spawn chunk region. Spawn chunks are now force-loaded using Paperlib async operations before the player connects, then regenerated to prevent the issue or fix it if present.
I hope you enjoy the new features, performance improvements, and added flexibility with configurations! Feel free to reach out with any feedback or issues
https://github.com/DavidS-Repo/SkyGridx/issues
New Features:
/regen Command
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.toolsnexus.com%2Fmc%2Fregen.gif)
Performance Improvements:
Material Manager Enhancements
Separated Loaders
Teleportation Cooldown
Updated Descriptions
Feel free to reach out with any feedback or issues
/regen Command
- Introducing the /regen command, allowing you to refresh all currently loaded areas with new materials from your configuration file. This is useful for those who modify biomes in the files after install and helps fix any bugged areas with empty chunks.
Performance Improvements:
Material Manager Enhancements
- Made the plugin run faster and handle large amounts of data more efficiently.
- Reading files is now quicker, making the plugin respond faster.
- Optimized how materials are loaded and distributed to improve overall performance.
Separated Loaders
- The process of loading materials is now divided into two types:
- Basic Material Loader:
- For simpler setups without specific biomes.
- Ensures materials are evenly distributed across all biomes.
- Advanced Material Loader:
- For setups that include specific biomes.
- Uses a system that distributes materials based on their specified weights.
- Requires all biomes to be listed in the configuration file to prevent missing areas in the game.
- Basic Material Loader:
- You can play around with using either one or see what works best for you, all the biomes are listed in the world text files.
Teleportation Cooldown
- Fixed an issue where players could bypass the cooldown for teleportation by disconnecting and reconnecting. Now, cooldowns are enforced properly.
Updated Descriptions
- Improved world text file descriptions to better explain the new material loaders, making it easier to understand and use all the features.
Feel free to reach out with any feedback or issues
What’s New:
- Updated generator to add randomly sized bamboo leaves when bamboo is picked.
- Fixed a bug where the first boot message was displayed after first boot.
- Other general improvements to generator performance.
Resolved an issue where spawn chunks were not generating properly in experimental versions of 1.20.6 for Paper.
Fixed issues with block distribution logic, Updated world files to explain how to use the generation features.
When using 1.20.6 paper there might be issues cause by the experimental build. If you get any errors in console, send them over.
When using 1.20.6 paper there might be issues cause by the experimental build. If you get any errors in console, send them over.
What’s New:
- Armadillo Scuttles in Chest Loot Tables
- I've temporarily added Armadillo Scuttles to the chest loot tables for the overworld, giving players quick access to new update items.
- Armadillos in Overworld Spawner Settings
- Armadillos have been permanently added to the Overworld entity list in Spawner Settings.
- Introducing the /patch Command
- The new /patch command allows for the forced patching of files to their new versions, ideal for servers with default settings. It replaces old files with new ones containing updated materials or entities. For heavily modified files, manual updating is recommended.
- New Items and Entities
- The new items introduced are ARMADILLO_SCUTE and WOLF_ARMOR, while the ARMADILLO entity has been added as well.
What’s New:
- Pre-Generator Feature:
- Built in async pregenerator feature that allows for efficient world generation. This feature is accessible through the /pregen command, with customizable parameters for chunks per cycle and print update delay.
- Works best on paper servers, on none paper servers the async functionality will not be used. Recommend you go into your paper server paper-global.yml and update these.
Code (Text):chunk-system:
gen-parallelism: 'true'
io-threads: 12
worker-threads: 12- Adjust io-threads and worker-threads to match your CPU’s thread count. Default settings utilize only half.
- Usage: /pregen chunksPerCycle PrintUpdate(DelayinMinutes)
- For "chunksPerCycle" It’s recommended to match the number of threads your system has. For example, 12 threads yielded 50-80 chunks per second on a 5600x CPU, depending on server activity and other system tasks.
- I left some headroom on CPU usage to decrease the likelihood of unintended block updates. I don't recommend playing while the pregeneration is happening, you can just let it run for a while if you don't want to play in a server and just want to generate the world, about 24 hours should be good enough.
- Command Updates:
- Removed the "/sgon" command, eliminating the need for user-triggered commands to turn on SkyGrid generation. It now starts automatically during the first boot or subsequent server restarts/reloads. This modification improves the user experience by providing a more user-friendly and automated approach to SkyGrid generation, making the plugin more intuitive for server administrators.
Updated Generator for enhanced biome generation, Fog feature Improvements and performance improvements
- Added support for multiple biomes: Modified the code to support multiple biomes in the header of the material files. You can now specify multiple biomes separated by commas.
Code (Text):
-OCEAN,COLD_OCEAN,DEEP_COLD_OCEAN,DEEP_FROZEN_OCEAN,DEEP_LUKEWARM_OCEAN,DEEP_OCEAN,FROZEN_OCEAN,LUKEWARM_OCEAN-
SAND:80
SANDSTONE:9.0
SEA_PICKLE:1.0
TUBE_CORAL:1.0
TUBE_CORAL_FAN:1.0
HORN_CORAL:1.0
HORN_CORAL_FAN:1.0
FIRE_CORAL:1.0
FIRE_CORAL_FAN:1.0
BUBBLE_CORAL:1.0
BUBBLE_CORAL_FAN:1.0
BRAIN_CORAL:1.0
BRAIN_CORAL_FAN:1.0
-WARM_OCEAN-
SAND:80
SANDSTONE:20
SAND:80
SANDSTONE:9.0
SEA_PICKLE:1.0
TUBE_CORAL:1.0
TUBE_CORAL_FAN:1.0
HORN_CORAL:1.0
HORN_CORAL_FAN:1.0
FIRE_CORAL:1.0
FIRE_CORAL_FAN:1.0
BUBBLE_CORAL:1.0
BUBBLE_CORAL_FAN:1.0
BRAIN_CORAL:1.0
BRAIN_CORAL_FAN:1.0
-WARM_OCEAN-
SAND:80
SANDSTONE:20
- Updated Generator: Previously, the biome generation was done once per chunk, but it has been updated to check the biome for every block generated in the grid. This change ensures more accurate biome-specific generation and avoids issues where biomes don't extend all the way underground.
- Generator optimizations: Optimized to improve performance. Changes include storing constant values in local variables, minimizing block data modifications inside the loop, and reducing exception handling to enhance efficiency.
- Updates to Fog feature: Improved user experience by changing how the resource pack is installed. Previously, the resource pack was installed every time a player joined the server while the plugin was enabled. Now, the resource pack is only asked to be installed when the fogon command is used. This change provides a better experience for users who do not use the fog feature but were previously asked to install the resource pack every time they joined.
New Feature and Improvements
Check out the updated installation Instructions
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.toolsnexus.com%2Fmc%2FFog.png)
Check out the updated installation Instructions
- Generator Overhaul: Completely revamped the generator for a 2x efficiency boost. Eliminated unnecessary chunk clearing checks, relying entirely on the datapack for smoother operation. Moved away from reliance on files to keep track of data, the only files now needed are in the OreGenBlock folder and SkygridBlocks folder.
- Introduction of GrowthControl Class: Ensures regulated growth of sugarcane and cactus generated by the system. Includes optional log commands (toggleable with 'gclogson' and 'gclogsoff') for tracking controlled plants, enhancing server management. This maintains the integrity of the skygrid over time with minimal performance impact. Even under simulated heavy loads, such as a high 'randomtickspeed' for 300 players, no discernible TPS drop occurred.
- Built-in Fog Feature: Added a new fog feature accompanied by a texture pack. Admins can enable it using '/fogon' and disable with '/fogoff'. This feature allows lower render distances without disrupting immersion. Upon server connection, users will receive a prompt to install a datapack for the fog; failure to install may result in a white bar at the top when the fog feature is activated. The texture pack conceals this UI change, crucial for the feature to function properly, as it cannot be implemented directly into the server's datapack files due to its nature.
- Reworked Ore Generation: Enhanced control allowing customization of stone and cobblestone generation via a new yml format. Preserves existing txt files for those with modifications, enabling an easy port-over to the new format.
Code (YAML):
# Ore Replacement Chances
# This file is used to specify the chances of different ores being chosen for replacement
# when lava or water generates stone blocks in the world. The stone generate in the world can be replaced by any block you want as long as its in the bukkit materials list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# Format: Material_Name:Percentage
# The percentage represents the chance (in whole numbers) of the ore being chosen
# for replacement out of the total replacements when lava or water generates stone.
# Each line represents one ore with its corresponding replacement chance.
# Lines starting with '#' are considered comments and will be ignored by the code.
# Example:
# DIAMOND_ORE:5
# This means that there is a 5% chance of a diamond ore block being chosen
# when lava or water generates a stone block.
# The total sum of percentages should be less than or equal to 100.
# If the sum exceeds 100, the probabilities will be scaled down proportionally
# to fit within the 0-100 range.
# For example, if the total sum of percentages exceeds 100 as follows:
# DIAMOND_ORE:40
# COAL_ORE:60
# IRON_ORE:30
# GOLD_ORE:20
# The total sum is 40 + 60 + 30 + 20 = 150, which exceeds 100.
# To fit within the 0-100 range, the probabilities will be scaled down proportionally:
# DIAMOND_ORE: 40 * (100 / 150) = 26 (approximately 27)
# COAL_ORE: 60 * (100 / 150) = 40
# IRON_ORE: 30 * (100 / 150) = 20
# GOLD_ORE: 20 * (100 / 150) = 13 (approximately 13)
# The adjusted probabilities now add up to 26 + 40 + 20 + 13 = 99, which is within the 0-100 range.
#For if the block generated though water and lava is stone
STONE:
STONE : 98
COAL_ORE : 0.3
COPPER_ORE : 0.4
DIAMOND_ORE : 0.1
EMERALD_ORE : 0.1
GOLD_ORE : 0.2
IRON_ORE : 0.4
LAPIS_ORE : 0.2
REDSTONE_ORE : 0.3
#For if the block generated though water and lava is cobblestone
COBBLESTONE:
DEEPSLATE : 98
DEEPSLATE_COAL_ORE : 0.3
DEEPSLATE_COPPER_ORE : 0.4
DEEPSLATE_DIAMOND_ORE : 0.1
DEEPSLATE_EMERALD_ORE : 0.1
DEEPSLATE_GOLD_ORE : 0.2
DEEPSLATE_IRON_ORE : 0.4
DEEPSLATE_LAPIS_ORE : 0.2
DEEPSLATE_REDSTONE_ORE : 0.3
# This file is used to specify the chances of different ores being chosen for replacement
# when lava or water generates stone blocks in the world. The stone generate in the world can be replaced by any block you want as long as its in the bukkit materials list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# Format: Material_Name:Percentage
# The percentage represents the chance (in whole numbers) of the ore being chosen
# for replacement out of the total replacements when lava or water generates stone.
# Each line represents one ore with its corresponding replacement chance.
# Lines starting with '#' are considered comments and will be ignored by the code.
# Example:
# DIAMOND_ORE:5
# This means that there is a 5% chance of a diamond ore block being chosen
# when lava or water generates a stone block.
# The total sum of percentages should be less than or equal to 100.
# If the sum exceeds 100, the probabilities will be scaled down proportionally
# to fit within the 0-100 range.
# For example, if the total sum of percentages exceeds 100 as follows:
# DIAMOND_ORE:40
# COAL_ORE:60
# IRON_ORE:30
# GOLD_ORE:20
# The total sum is 40 + 60 + 30 + 20 = 150, which exceeds 100.
# To fit within the 0-100 range, the probabilities will be scaled down proportionally:
# DIAMOND_ORE: 40 * (100 / 150) = 26 (approximately 27)
# COAL_ORE: 60 * (100 / 150) = 40
# IRON_ORE: 30 * (100 / 150) = 20
# GOLD_ORE: 20 * (100 / 150) = 13 (approximately 13)
# The adjusted probabilities now add up to 26 + 40 + 20 + 13 = 99, which is within the 0-100 range.
#For if the block generated though water and lava is stone
STONE:
STONE : 98
COAL_ORE : 0.3
COPPER_ORE : 0.4
DIAMOND_ORE : 0.1
EMERALD_ORE : 0.1
GOLD_ORE : 0.2
IRON_ORE : 0.4
LAPIS_ORE : 0.2
REDSTONE_ORE : 0.3
#For if the block generated though water and lava is cobblestone
COBBLESTONE:
DEEPSLATE : 98
DEEPSLATE_COAL_ORE : 0.3
DEEPSLATE_COPPER_ORE : 0.4
DEEPSLATE_DIAMOND_ORE : 0.1
DEEPSLATE_EMERALD_ORE : 0.1
DEEPSLATE_GOLD_ORE : 0.2
DEEPSLATE_IRON_ORE : 0.4
DEEPSLATE_LAPIS_ORE : 0.2
DEEPSLATE_REDSTONE_ORE : 0.3
Synchronized Chunk Clearing:
Performance Optimization:
These adjustments aim to enhance synchronization between the plugin and the data pack, ensuring smoother block generation while optimizing server performance for a better user experience.
- Resolved an issue with out-of-sync chunk clearing between the Void Worldgen Data pack and the plugin's block placement, preventing blocks from being placed in chunks not yet processed by the data pack. Increased delay for chunk processing after loading to minimize potential conflicts, particularly during high server loads. Despite this mitigation, during periods of extreme overload, the generator and datapack may still go out of sync intermittently. To further reduce the chance of chunk errors during high loads, consider reducing player render distance. Typically, a reasonable distance is around 6 chunks, but further reduction may be necessary on less capable servers to maintain stability and prevent chunk-related issues.
Performance Optimization:
- Adjusted generator settings to optimize performance on less capable servers. Previously, block placements for the overworld covered a range from -64 to 256, while the nether and end were limited to 0 to 128. Modified block placements to unify the height across all dimensions, reducing load by restricting overworld block placements from -64 to 64, resulting in uniform grids of 128 blocks in height across all dimensions. This adjustment aims to alleviate server load, particularly in environments with higher user activity.
These adjustments aim to enhance synchronization between the plugin and the data pack, ensuring smoother block generation while optimizing server performance for a better user experience.
New Feature: Chest Support Added
Key Features:
How to Use:
Example with Expanded Formatting:
Example with Compact Formatting:
Sample of 10 chest from the Overworld, Nether, and End with the included Pre-Configuration.
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.toolsnexus.com%2Fmc%2FTCO.webp)
Key Features:
- Flexible Loot Customization: Tailor chest loot settings with precision, specifying the items, percentages, and amounts.
- Tiered Loot Distribution: Items are distributed into tiers, adding variety and complexity to the loot. Each tier has its own set of items with different probabilities.
- Biome-Specific Chests: Customize chest loot for specific biomes, allowing for a more immersive and thematic distribution of items based on the environment.
- Easy Configuration: Edit the ChestSettings.yml file located in the SkygridBlocks folder to define the loot settings for each chest. Use compact or expanded formatting for easy customization.
How to Use:
- Update your plugin to the latest version.
- Configure Chests: Open the ChestSettings.yml file located in the plugin's SkygridBlocks folder.
- Customize Loot Settings: Define the loot settings for each chest in the configuration file. Use the provided examples as a guide.
Code (YAML):
# The available items for use can be found at https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# The available biomes can be found here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/block/Biome.html
# In YAML, identifiers or keys (such as "Chest1" in your example) are subject to certain rules.
# - Do's -
# Alphanumeric Characters: Identifiers can contain letters (both uppercase and lowercase) and numbers. For example, "Chest1" is a valid identifier.
# Underscores: You can use underscores (_) in identifiers. For instance, "my_chest" is a valid identifier.
# Hyphens in Quoted Strings: If an identifier contains special characters or spaces, you can enclose it in single or double quotes. For example, "'Special Chest'" or "\"Special Chest\"" are valid.
# - Don'ts -
# Special Characters: Avoid using special characters like !, @, #, $, %, etc., in identifiers without enclosing them in quotes. For example, "Chest@123" should be written as "'Chest@123'" if you want to use special characters.
# Leading Spaces: Identifiers should not have leading spaces. For instance, " MyChest" with a space at the beginning is not a valid identifier.
# Trailing Spaces: Similarly, identifiers should not have trailing spaces. "MyChest " with a space at the end is not valid.
# Spaces in the Middle: While you can use spaces within identifiers if they are enclosed in quotes, it's generally a good practice to avoid spaces within identifiers for clarity. For example, "My Chest" is valid, but "MyChest" is more commonly used.
# Reserved Keywords: Avoid using YAML reserved keywords as identifiers. These keywords have special meaning in YAML and should not be used as keys. For example, "true," "false," and "null" are reserved keywords.
# Case Sensitivity: YAML is case-sensitive. "myChest" and "MyChest" would be considered as two different identifiers.
# ChestSettings: This is the top-level section of the YAML configuration and acts as the main container for all chest settings.
# Chest1: This represents the first chest configuration, which we'll be using as an example. The code will look for a chest configuration with the key "Chest1." The key can be whatever you want; it serves as an identifier.
# Items: Under the "Chest1" configuration, there is an "Items" section. The code will process the items listed here to determine what should be placed in the chest's inventory. Formatting: "- ITEM_NAME:PERCENTAGE:MAX_AMOUNT"
# Biomes: This section lists the biomes in which the chest's item configuration will apply. Formatting: "- BIOME_NAME"
# The available biomes can be found here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/block/Biome.html
# In YAML, identifiers or keys (such as "Chest1" in your example) are subject to certain rules.
# - Do's -
# Alphanumeric Characters: Identifiers can contain letters (both uppercase and lowercase) and numbers. For example, "Chest1" is a valid identifier.
# Underscores: You can use underscores (_) in identifiers. For instance, "my_chest" is a valid identifier.
# Hyphens in Quoted Strings: If an identifier contains special characters or spaces, you can enclose it in single or double quotes. For example, "'Special Chest'" or "\"Special Chest\"" are valid.
# - Don'ts -
# Special Characters: Avoid using special characters like !, @, #, $, %, etc., in identifiers without enclosing them in quotes. For example, "Chest@123" should be written as "'Chest@123'" if you want to use special characters.
# Leading Spaces: Identifiers should not have leading spaces. For instance, " MyChest" with a space at the beginning is not a valid identifier.
# Trailing Spaces: Similarly, identifiers should not have trailing spaces. "MyChest " with a space at the end is not valid.
# Spaces in the Middle: While you can use spaces within identifiers if they are enclosed in quotes, it's generally a good practice to avoid spaces within identifiers for clarity. For example, "My Chest" is valid, but "MyChest" is more commonly used.
# Reserved Keywords: Avoid using YAML reserved keywords as identifiers. These keywords have special meaning in YAML and should not be used as keys. For example, "true," "false," and "null" are reserved keywords.
# Case Sensitivity: YAML is case-sensitive. "myChest" and "MyChest" would be considered as two different identifiers.
# ChestSettings: This is the top-level section of the YAML configuration and acts as the main container for all chest settings.
# Chest1: This represents the first chest configuration, which we'll be using as an example. The code will look for a chest configuration with the key "Chest1." The key can be whatever you want; it serves as an identifier.
# Items: Under the "Chest1" configuration, there is an "Items" section. The code will process the items listed here to determine what should be placed in the chest's inventory. Formatting: "- ITEM_NAME:PERCENTAGE:MAX_AMOUNT"
# Biomes: This section lists the biomes in which the chest's item configuration will apply. Formatting: "- BIOME_NAME"
Code (YAML):
ChestSettings:
Chest1:
Items :
- MYCELIUM:30:5
- RED_MUSHROOM:20:5
- BROWN_MUSHROOM:20:5
- RED_MUSHROOM_BLOCK:10:5
- BROWN_MUSHROOM_BLOCK:10:5
- MUSHROOM_STEM:10:5
Biomes :
- MUSHROOM_FIELDS
# The YAML above will be interpreted as follows:
# For a chest located in the "MUSHROOM_FIELDS" biome, the code will use the specified item settings to randomly populate the chest's inventory. The percentage chances and amount ranges for each item will be considered when filling the chest.
# MYCELIUM:30:5 - This line specifies an item with the name "MYCELIUM" with a chance of 30% (percentage) of being placed in the chest, and the max amount of this item is 5. The code will randomly select a value between 1 and 5 for the number of MYCELIUM to place in the chest.
Chest1:
Items :
- MYCELIUM:30:5
- RED_MUSHROOM:20:5
- BROWN_MUSHROOM:20:5
- RED_MUSHROOM_BLOCK:10:5
- BROWN_MUSHROOM_BLOCK:10:5
- MUSHROOM_STEM:10:5
Biomes :
- MUSHROOM_FIELDS
# The YAML above will be interpreted as follows:
# For a chest located in the "MUSHROOM_FIELDS" biome, the code will use the specified item settings to randomly populate the chest's inventory. The percentage chances and amount ranges for each item will be considered when filling the chest.
# MYCELIUM:30:5 - This line specifies an item with the name "MYCELIUM" with a chance of 30% (percentage) of being placed in the chest, and the max amount of this item is 5. The code will randomly select a value between 1 and 5 for the number of MYCELIUM to place in the chest.
Code (YAML):
ChestSettings:
Chest1:
Items : [WOODEN_AXE:20:1, WOODEN_PICKAXE:20:1, CROSSBOW:20:1, ... ]
Biomes : [BADLANDS, BAMBOO_JUNGLE, BIRCH_FOREST, ... ]
# This is a more compact way of formatting the above. Both versions are valid.
# How to format item entries: [ITEM_NAME:PERCENTAGE:MAX_AMOUNT]. If there is more than one item, you can do [ITEM_NAME:PERCENTAGE:MAX_AMOUNT, ITEM_NAME:PERCENTAGE:MAX_AMOUNT].
# If you are doing multiple biomes, this is also a more compact way of formatting it.
# How to format biome entries: [BIOME_NAME]. If there is more than one biome, you can do [BIOME_NAME, BIOME_NAME].
Chest1:
Items : [WOODEN_AXE:20:1, WOODEN_PICKAXE:20:1, CROSSBOW:20:1, ... ]
Biomes : [BADLANDS, BAMBOO_JUNGLE, BIRCH_FOREST, ... ]
# This is a more compact way of formatting the above. Both versions are valid.
# How to format item entries: [ITEM_NAME:PERCENTAGE:MAX_AMOUNT]. If there is more than one item, you can do [ITEM_NAME:PERCENTAGE:MAX_AMOUNT, ITEM_NAME:PERCENTAGE:MAX_AMOUNT].
# If you are doing multiple biomes, this is also a more compact way of formatting it.
# How to format biome entries: [BIOME_NAME]. If there is more than one biome, you can do [BIOME_NAME, BIOME_NAME].
New Feature: Customize Mob Spawner Settings
Elevate your Skygrid adventures with the new Spawner Support feature, offering complete control over mob spawner settings. Customize spawner attributes, including the types of entities, spawn rates, and other parameters.
Key Features:
How to Use:
Example with Expanded Formatting:
Example with Compact Formatting:
In these examples, "Spawner1" can spawn both SKELETON and ZOMBIE entities with equal chances.
Random Entity Selection: Create a list of entities with associated spawn weights to add unpredictability to your spawners.
In this example, "SKELETON" and "ZOMBIE" have higher chances of being chosen for the spawner than "CREEPER."
With Spawner Support, you have the freedom to tailor your spawner settings to your liking. Enjoy the flexibility to customize spawners for all biomes across all world dimensions, making your Skygrid experience truly unique. Stay tuned for more updates, as I am working on additional features such as chest support. Your feedback and suggestions are highly valued as we continue to improve the plugin.
Elevate your Skygrid adventures with the new Spawner Support feature, offering complete control over mob spawner settings. Customize spawner attributes, including the types of entities, spawn rates, and other parameters.
Key Features:
- Fine-Tune Spawner Settings: Precisely adjust the spawner settings, specifying the entity, delay, max nearby entities, and more.
- Random Entity Selection: Set the spawn weights for entities to add unpredictability to your gameplay. The plugin will select entities randomly based on these weights.
- Worldwide Customization: Customize spawners for all biomes across all world dimensions, ensuring a seamless and immersive experience.
- Grid Block Inclusion: To enable the Spawner Support feature, be sure to add the SPAWNER block to your world.txt, world_nether.txt, or world_the_end.txt configuration in the SkygridBlocks folder. The Spawner code won't be called unless the SPAWNER block is added.
- Biome-Specific Spawners: Customize spawners for specific biomes at the block level, adding a new layer of customization. For example, if you specify the biome as "DEEP_DARK," you can configure spawners to spawn WARDEN entities exclusively in that biome.
How to Use:
- Update your plugin to the latest version.
- Configure Spawners: Open the SpawnerSettings.yml file located in the plugin's folder.
- Customize Settings: Define the settings for each spawner in the configuration file, specifying the entity, delay, max nearby entities, and more. You can use either of the following YML formatting styles, and they will both be read the same by the YML parser:
Code (YAML):
# The available entities for use can be found at https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
# The available biomes can be found here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/block/Biome.html
# Entities - Define entities and their chances of being chosen for the spawner. Formatting "- DOLPHIN:33.33"
# Biomes - List the biomes where this spawner will spawn. Formatting "- BEACH"
# Delay: - Set the spawner's delay. If set to -1, the delay will be randomized (randomly choose a delay between min and max spawn delays).
# MaxNearbyEntities - Set the maximum nearby entities (of the same type) allowed. Default value is 16.
# MaxSpawnDelay - The maximum spawn delay amount (in ticks). This value must be greater than 0 and less than or equal to MaxSpawnDelay. Default value is 800 ticks.
# MinSpawnDelay - The minimum spawn delay amount (in ticks). Default value is 200 ticks.
# PlayerRange - Set the range for player activation (given that there are players online). Default value is 16.
# SpawnCount - Set how many mobs attempt to spawn. Default value is 4.
# SpawnRange - Set the radius around which the spawner will attempt to spawn mobs in. Default value is 4.
# The available biomes can be found here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/block/Biome.html
# Entities - Define entities and their chances of being chosen for the spawner. Formatting "- DOLPHIN:33.33"
# Biomes - List the biomes where this spawner will spawn. Formatting "- BEACH"
# Delay: - Set the spawner's delay. If set to -1, the delay will be randomized (randomly choose a delay between min and max spawn delays).
# MaxNearbyEntities - Set the maximum nearby entities (of the same type) allowed. Default value is 16.
# MaxSpawnDelay - The maximum spawn delay amount (in ticks). This value must be greater than 0 and less than or equal to MaxSpawnDelay. Default value is 800 ticks.
# MinSpawnDelay - The minimum spawn delay amount (in ticks). Default value is 200 ticks.
# PlayerRange - Set the range for player activation (given that there are players online). Default value is 16.
# SpawnCount - Set how many mobs attempt to spawn. Default value is 4.
# SpawnRange - Set the radius around which the spawner will attempt to spawn mobs in. Default value is 4.
Code (YAML):
SpawnerSettings:
Spawner1:
Entities :
- SKELETON:100
- ZOMBIE:100
Biomes :
- FOREST
- PLAINS
Delay : -1
MaxNearbyEntities : 16
MaxSpawnDelay : 800
MinSpawnDelay : 200
PlayerRange : 16
SpawnCount : 4
SpawnRange : 4
Spawner1:
Entities :
- SKELETON:100
- ZOMBIE:100
Biomes :
- FOREST
- PLAINS
Delay : -1
MaxNearbyEntities : 16
MaxSpawnDelay : 800
MinSpawnDelay : 200
PlayerRange : 16
SpawnCount : 4
SpawnRange : 4
Example with Compact Formatting:
Code (YAML):
SpawnerSettings:
Spawner1:
Entities : [SKELETON:100, ZOMBIE:100 ]
Biomes : [FOREST, PLAINS ]
Delay : -1
MaxNearbyEntities : 16
MaxSpawnDelay : 800
MinSpawnDelay : 200
PlayerRange : 16
SpawnCount : 4
SpawnRange : 4
Spawner1:
Entities : [SKELETON:100, ZOMBIE:100 ]
Biomes : [FOREST, PLAINS ]
Delay : -1
MaxNearbyEntities : 16
MaxSpawnDelay : 800
MinSpawnDelay : 200
PlayerRange : 16
SpawnCount : 4
SpawnRange : 4
Random Entity Selection: Create a list of entities with associated spawn weights to add unpredictability to your spawners.
Code (YAML):
Entities
:
[SKELETON:10, ZOMBIE:10, CREEPER:5
]
With Spawner Support, you have the freedom to tailor your spawner settings to your liking. Enjoy the flexibility to customize spawners for all biomes across all world dimensions, making your Skygrid experience truly unique. Stay tuned for more updates, as I am working on additional features such as chest support. Your feedback and suggestions are highly valued as we continue to improve the plugin.
New Feature: Biome-Specific Block Generation
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.toolsnexus.com%2Fmc%2Fout.jpg)
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.toolsnexus.com%2Fmc%2Fin.jpg)
I hope this new feature adds a layer of depth to your Skygrid adventures. As always, we value your feedback and suggestions to further improve the plugin. Feel free to reach out with any questions or comments. Next features being worked on right now is spawner and chest support, no ETA.
- Customize the block generation in your world based on different biomes.
- Specify unique block materials and percentages for each biome in the world.
- Enjoy a more immersive and dynamic Skygrid experience with biome-specific block generation.
- Update your plugin to the latest version.
- Configure Biome-Specific Blocks:
- Open the text files for each world dimension (e.g., world.txt, world_nether.txt, world_the_end.txt) located in the plugin's folder.
- Specify block materials and their respective percentages for each biome in your world.
For example:
DIRT:20
STONE:20
GRASS_BLOCK:20
-OCEAN-
SAND:50
WATER:50
-DESERT-
SAND:100
DIRT:20
STONE:20
GRASS_BLOCK:20
-OCEAN-
SAND:50
WATER:50
-DESERT-
SAND:100
- In this example, when generating chunks in the "OCEAN" biome, there's a 50% chance of generating "SAND" blocks and a 50% chance of generating "WATER" blocks. In the "DESERT" biome, only "SAND" blocks will be generated. For the blocks above they will be generated on all biomes not specified in the file for that dimension. So, if you only want to have 1 custom biome with the rest having another variety of blocks you can do that.
- Biomes are signified by the -BIOME_NAME-, everything under the biome header will generate only in that biome, unless there is another biome under it like in the example above.
Here is another example,
-OCEAN-
SAND:80
SANDSTONE:9
SEA_PICKLE:1
TUBE_CORAL:1
TUBE_CORAL_FAN:1
HORN_CORAL:1
HORN_CORAL_FAN:1
FIRE_CORAL:1
FIRE_CORAL_FAN:1
BUBBLE_CORAL:1
BUBBLE_CORAL_FAN:1
BRAIN_CORAL:1
BRAIN_CORAL_FAN:1
-OCEAN-
SAND:80
SANDSTONE:9
SEA_PICKLE:1
TUBE_CORAL:1
TUBE_CORAL_FAN:1
HORN_CORAL:1
HORN_CORAL_FAN:1
FIRE_CORAL:1
FIRE_CORAL_FAN:1
BUBBLE_CORAL:1
BUBBLE_CORAL_FAN:1
BRAIN_CORAL:1
BRAIN_CORAL_FAN:1
- Supported biomes can be found here: Biomes
I hope this new feature adds a layer of depth to your Skygrid adventures. As always, we value your feedback and suggestions to further improve the plugin. Feel free to reach out with any questions or comments. Next features being worked on right now is spawner and chest support, no ETA.
Issues:
- Fixed an issue were server desync while using /TPR would result in the player teleporting to the void resulting in them falling to their death.
- Introduced more safety mechanism to detect desync and prevent players from being teleported to unsafe places.
Issues:
- Warning spam when players used /tpr command
- Example: [99:99:99 WARN]: Go0fy_Go0ber moved too quickly! 999,999,999
- Resolved the issue of "moved too quickly" warnings spam by enhancing the block identification system, ensuring players are less likely to be teleported onto dangerous blocks.
Issues:
- Thread Safety: The original code was not thread-safe, which could lead to data inconsistency when multiple threads access and modify the clearedChunks set simultaneously.
- Saving Chunks: The plugin needed to save cleared chunks periodically, but there was no mechanism to do so at regular intervals.
- Chunk Clearing: The code clears chunks in response to the ChunkLoadEvent, but it was necessary to ensure that the chunks were not cleared repeatedly.
- Thread Safety: Used a ConcurrentHashMap.newKeySet() for the clearedChunks set to make it thread-safe. Additionally, I added the synchronized keyword to the saveClearedChunks method to ensure that the saving process is thread-safe.
- Saving Chunks: Implemented a scheduled task using Bukkit's scheduler to call the saveClearedChunks method at regular intervals (e.g., every 5 seconds) to save cleared chunks.
- Chunk Clearing: Introduced a check in the clearChunk method to ensure that chunks are not cleared again if they have already been cleared. This helps prevent repeated clearing of chunks in the same session.
Resource Information
Author:
----------
Total Downloads:
1,845
First Release:
Oct 12, 2023
Last Update:
Feb 17, 2025
Category:
---------------
All-Time Rating:
Find more info at www.davids-repo.dev...
5 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings