Has all same features as latest SkyGridx, but is optimized for folia specifically.

What is included in the latest update:

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

• 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.

  

  • Roman: Shows numbers as Roman numerals like "I", "II", and so on. (Note: Roman numerals work up to 3999.)

  

  If you don’t choose a style, it will automatically use the Roman style.

• 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 higher migth result in less distrbution if not set up properly.

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.

Here are the updated settings files so that you can see the changes:

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