Main Configuration (config.toml)

This file contains the main configuration settings for the Myths and Legends mod. It allows customization of various features related to item tracking, spawning, broadcasting, default loot generation parameters, form changes, and more.

Location: `<Your Minecraft Folder>/config/mythsandlegends/config.toml` (Where `<Your Minecraft Folder>` is usually `.minecraft`) Format: TOML (Toml Object Mapping Language)

The file is automatically generated with default values and comments by the mod if it doesn't exist. If the file exists but is missing entries, the mod will attempt to load the existing values and apply defaults for the missing ones when the game starts. Saving the config in-game (if applicable) or restarting the game after manual edits will update the file.

Note: Some settings in this file (like chest chances and item rarity lists) are primarily used to generate the defaults for the Loot Table Modifications config (loot_tables_config_v2.json). Once that JSON file exists, it takes precedence for controlling loot injections.

The configuration is organized into sections for clarity, matching the structure generated by the mod.

These settings control how and when the mod checks player inventories for specific items, potentially triggering events or consuming items based on other configurations.

inventory_check_interval

Key:
```
inventory_check_interval
```
Description: Interval in Minecraft ticks for checking player inventories for items listed in
```
inventory_check_item_list
```
. (20 ticks = 1 second).
Type: Integer
Default:
```
3600
```
(3 minutes)

consume_items_on_successful_spawn

Key:
```
consume_items_on_successful_spawn
```
Description: Determines if items found during the inventory check (from
```
inventory_check_item_list
```
) are consumed when they successfully trigger an associated spawn.
Type: Boolean
Default:
```
true
```

ignore_key_items

Key:
```
ignore_key_items
```
Description: If true, and a spawn condition requires both a specific “key item” (likely used via right-click for force spawning) AND an item found via inventory check, only the item from the inventory check is consumed.
Type: Boolean
Default:
```
true
```

inventory_check_item_list

Key:
```
inventory_check_item_list
```
Description: A list of item identifiers (e.g., “minecraft:diamond”, “cobblemon:metal_coat”) to be checked in player inventories at the specified
```
inventory_check_interval
```
. The specific effect of finding these items depends on other mod features or datapacks using this check.
Type: List of Strings
Default:

    [
      "minecraft:diamond", "minecraft:emerald", "minecraft:nether_star",
      "cobblemon:dragon_scale", "cobblemon:electirizer", "cobblemon:magmarizer",
      "cobblemon:metal_coat", "cobblemon:protector", "cobblemon:leaf_stone",
      "cobblemon:moon_stone", "cobblemon:sun_stone", "cobblemon:shiny_stone",
      "cobblemon:dusk_stone", "cobblemon:dawn_stone", "cobblemon:ice_stone",
      "cobblemon:thunder_stone", "cobblemon:fire_stone", "cobblemon:water_stone",
      "cobblemon:never_melt_ice", "cobblemon:black_augurite", "cobblemon:black_mane_hair",
      "cobblemon:linking_cord", "cobblemon:metal_alloy", "cobblemon:peat_block",
      "cobblemon:razor_claw", "cobblemon:razor_fang", "cobblemon:reaper_cloth",
      "cobblemon:red_chain", "cobblemon:sweet_apple", "cobblemon:tart_apple",
      "cobblemon:upgrade", "cobblemon:dubious_disc", "cobblemon:auspicious_armor",
      "cobblemon:malicious_armor", "cobblemon:masterpiece_teacup", "cobblemon:unremarkable_teacup",
      "cobblemon:galarica_cuff", "cobblemon:galarica_wreath", "cobblemon:griseous_core",
      "cobblemon:adamant_crystal", "cobblemon:lustrous_globe"
    ]

inventory_check_shulker_boxes

Key:
```
inventory_check_shulker_boxes
```
Description: Should the inventory check scan the contents of Shulker Boxes within a player's inventory?
Type: Boolean
Default:
```
true
```

inventory_check_bundles

Key:
```
inventory_check_bundles
```
Description: Should the inventory check scan the contents of Bundles within a player's inventory?
Type: Boolean
Default:
```
true
```

Controls messages sent to players when specific Pokémon spawn naturally.

isBroadcastEnabled

Key:
```
isBroadcastEnabled
```
Description: Master switch to enable or disable all Pokémon spawn broadcast messages configured below.
Type: Boolean
Default:
```
false
```

broadcast_settings

Key:
```
broadcast_settings
```
Description: Configures detailed options for broadcasting messages when specific Pokémon spawn naturally. Requires
```
isBroadcastEnabled = true
```
. This is a list of settings, each with a name and a true/false value.
Type: List of Tables (Objects)
Default Structure & Values:
- BroadcastToAll: (Default:
```
true
```
  ) Broadcast messages to all players online? If false, may broadcast locally or not at all depending on other factors.
- DisplayName: (Default:
```
true
```
  ) Show the name of the spawned Pokémon in the message?
- Legendarys: (Default:
```
true
```
  ) Broadcast when a Legendary Pokémon spawns?
- Mythicals: (Default:
```
true
```
  ) Broadcast when a Mythical Pokémon spawns?
- UltraBeasts: (Default:
```
false
```
  ) Broadcast when an Ultra Beast Pokémon spawns?
- Location: (Default:
```
true
```
  ) Include the coordinates (location) of the spawn in the message?
- Shiny: (Default:
```
false
```
  ) Announce if the spawned Pokémon is Shiny?
- Level: (Default:
```
true
```
  ) Include the level of the spawned Pokémon in the message?
- XaerosMinimapSupport: (Default:
```
false
```
  ) Format the location coordinates to be easily usable as a Xaero's Minimap waypoint? Requires
```
Location = true
```
  .
Default TOML Representation:

    broadcast_settings = [
      { settingName = "BroadcastToAll", settingValue = true }, # Broadcast to all players? Default: true.
      { settingName = "DisplayName", settingValue = true },  # Show Pokemon name? Default: true.
      { settingName = "Legendarys", settingValue = true }, # Broadcast Legendary spawns? Default: true.
      { settingName = "Mythicals", settingValue = true }, # Broadcast Mythical spawns? Default: true.
      { settingName = "UltraBeasts", settingValue = false }, # Broadcast Ultra Beast spawns? Default: false.
      { settingName = "Location", settingValue = true }, # Include spawn location? Default: true.
      { settingName = "Shiny", settingValue = false }, # Announce if shiny? Default: false.
      { settingName = "Level", settingValue = true }, # Include Pokemon level? Default: true.
      { settingName = "XaerosMinimapSupport", settingValue = false } # Add Xaero's Minimap waypoint format if Location is true? Default: false.
    ]

Settings related to the mechanic where players can use specific Key Items (often via right-click) to attempt to spawn associated Pokémon nearby. See also Force Spawn Command.

enable_force_spawning

Key:
```
enable_force_spawning
```
Description: Allow players to trigger the force spawning mechanic by using designated Key Items?
Type: Boolean
Default:
```
true
```

force_spawning_spawn_pool

Key:
```
force_spawning_spawn_pool
```
Description: Specifies which Cobblemon spawn pool rarity category (defined in Cobblemon's spawn data files) the force spawning mechanic should check within when attempting a spawn. Note: This only influences which Pokémon are considered candidates for force spawning, not their natural spawn rates or the success chance of the force spawn itself.
Type: String
Possible Values:
```
"common"
```
,
```
"uncommon"
```
,
```
"rare"
```
,
```
"ultra-rare"
```
Default:
```
"ultra-rare"
```

— Voucher & Cooldown Settings (for Force Spawning) —

These settings manage limits and cooldowns for the force spawning mechanic, acting like a usage limit system.

enable_vouchers

Key:
```
enable_vouchers
```
Description: Master switch for the entire voucher and cooldown system for force spawning. If false, Key Items can be used limitlessly (subject only to spawn conditions), and the settings below are ignored.
Type: Boolean
Default:
```
false
```

force_spawn_item_cooldown

Key:
```
force_spawn_item_cooldown
```
Description: The cooldown period (in seconds) after using a Key Item for force spawning before it can be used again. Only applies if
```
enable_vouchers = true
```
. See also
```
global_item_cooldown
```
.
Type: Integer (>= 0)
Default:
```
20
```

global_item_cooldown

Key:
```
global_item_cooldown
```
Description: If true, the
```
force_spawn_item_cooldown
```
applies globally across all tracked Key Items. Using any tracked item puts all tracked items on cooldown for the player. If false, the cooldown applies individually to each item type. Only applies if
```
enable_vouchers = true
```
.
Type: Boolean
Default:
```
false
```

force_spawning_vouchers

Key:
```
force_spawning_vouchers
```
Description: The maximum number of times Key Items can be successfully used for force spawning before the
```
force_spawn_item_cooldown
```
is triggered. Setting this to 1 means the item goes on cooldown after a single successful use. Only applies if
```
enable_vouchers = true
```
. See also
```
global_item_vouchers
```
.
Type: Integer (>= 1)
Default:
```
1
```

global_item_vouchers

Key:
```
global_item_vouchers
```
Description: If true, the
```
force_spawning_vouchers
```
limit is shared across all tracked Key Items. Players have a total pool of uses before cooldown triggers, regardless of which specific Key Item was used. If false, each Key Item type has its own separate voucher count. Only applies if
```
enable_vouchers = true
```
.
Type: Boolean
Default:
```
false
```

Defines the area around the player checked for valid locations when attempting a force spawn.

force_spawn_check_width

Key:
```
force_spawn_check_width
```
Description: Defines the diameter (distance along X and Z axes) of the square area centered on the player that is checked for valid spawn locations during force spawning. Set to -1 to use Cobblemon's default value (
```
worldSliceDiameter
```
). Larger values may increase server load during checks.
Type: Integer (>= 1 or -1)
Default:
```
100
```

force_spawn_check_height

Key:
```
force_spawn_check_height
```
Description: Defines the total height (distance along the Y axis) of the area centered on the player that is checked for valid spawn locations during force spawning. Set to -1 to use Cobblemon's default value (
```
worldSliceHeight
```
). Larger values may increase server load during checks.
Type: Integer (>= 1 or -1)
Default:
```
50
```

These lists categorize item identifiers (e.g., “mythsandlegends:azure_flute”) by perceived rarity. These lists might be used by various mod features. Crucially, they are used to assign default item weights when initially generating the loot_tables_config_v2.json file.

ULTRA_RARE_ITEMS

Key:
```
ULTRA_RARE_ITEMS
```
Description: List of item IDs considered “Ultra Rare”. Used for default loot weight 1.
Type: List of Strings
Default:

    [
      "mythsandlegends:aurora_ticket", "mythsandlegends:azure_flute",
      "mythsandlegends:eon_ticket", "mythsandlegends:gs_ball",
      "mythsandlegends:liberty_pass", "mythsandlegends:member_card",
      "mythsandlegends:oaks_letter", "mythsandlegends:old_sea_map",
      "mythsandlegends:dr_fujis_diary", "mythsandlegends:mystery_box",
      "mythsandlegends:reveal_glass", "mythsandlegends:dna_splicer",
      "mythsandlegends:lunar_feather", "mythsandlegends:magma_stone",
      "mythsandlegends:diancies_crown", "mythsandlegends:genesect_drive",
      "mythsandlegends:hoopa_ring", "mythsandlegends:meloetta_headset",
      "mythsandlegends:necro_prism", "mythsandlegends:prison_bottle",
      "mythsandlegends:sacred_sword", "mythsandlegends:type_null_mask",
      "mythsandlegends:antique_pokeball", "mythsandlegends:marshadow_hood",
      "mythsandlegends:scroll_of_water", "mythsandlegends:soul_heart",
      "mythsandlegends:zarudes_cape", "mythsandlegends:zeraoras_thunderclaw",
      "mythsandlegends:ancient_tablet", "mythsandlegends:mythical_pecha_berry",
      "mythsandlegends:scroll_of_darkness", "mythsandlegends:cavern_shield",
      "mythsandlegends:binding_mochi", "mythsandlegends:clear_bell",
      "mythsandlegends:steam_valve", "mythsandlegends:zygarde_cube"
    ]

RARE_ITEMS

Key:
```
RARE_ITEMS
```
Description: List of item IDs considered “Rare”. Used for default loot weight 5.
Type: List of Strings
Default:

    [
      "mythsandlegends:adamant_orb", "mythsandlegends:lustrous_orb",
      "mythsandlegends:griseous_orb", "mythsandlegends:blue_orb",
      "mythsandlegends:red_orb", "mythsandlegends:rusted_shield",
      "mythsandlegends:rusted_sword", "mythsandlegends:dark_stone",
      "mythsandlegends:light_stone", "mythsandlegends:sun_flute",
      "mythsandlegends:moon_flute", "mythsandlegends:rainbow_wing",
      "mythsandlegends:silver_wing", "mythsandlegends:jade_orb",
      "mythsandlegends:eternatus_core", "mythsandlegends:reins_of_unity",
      "mythsandlegends:iceroot_carrot", "mythsandlegends:shaderoot_carrot",
      "mythsandlegends:scarlet_book", "mythsandlegends:violet_book",
      "mythsandlegends:cocoon_of_destruction", "mythsandlegends:sapling_of_life",
      "mythsandlegends:tidal_bell", "mythsandlegends:lillies_bag",
      "mythsandlegends:zygarde_core", "mythsandlegends:prismatic_shell",
      "mythsandlegends:kubfus_band"
    ]

COMMON_ITEMS

Key:
```
COMMON_ITEMS
```
Description: List of item IDs considered “Common”. Used for default loot weight 30.
Type: List of Strings
Default:

    [
      "mythsandlegends:azelf_fang", "mythsandlegends:mesprit_plume",
      "mythsandlegends:uxie_claw", "mythsandlegends:ironwill_sword",
      "mythsandlegends:grassland_blade", "mythsandlegends:koko_totem",
      "mythsandlegends:lele_totem", "mythsandlegends:bulu_totem",
      "mythsandlegends:fini_totem", "mythsandlegends:teal_mask",
      "mythsandlegends:cornerstone_mask", "mythsandlegends:hearthflame_mask",
      "mythsandlegends:wellspring_mask", "mythsandlegends:plasma_tablet",
      "mythsandlegends:scaly_tablet", "mythsandlegends:stone_tablet",
      "mythsandlegends:ice_tablet", "mythsandlegends:steel_tablet",
      "mythsandlegends:zygarde_cell"
    ]

These settings do not directly control loot. Instead, they provide the default values used only when generating the loot_tables_config_v2.json file if it doesn't exist. Once that file exists, the values within it take precedence.

common_chest_chances

Key:
```
common_chest_chances
```
Description: Defines the default chance (0.0 to 1.0) for the mod's loot pool to activate in various “common” loot tables when generating the default `loot_tables_config_v2.json`.
Type: Map (Table) String → Float
Default: (See TOML representation for specific default chances)

    [common_chest_chances]
      "minecraft:chests/simple_dungeon" = 0.08
      "minecraft:chests/abandoned_mineshaft" = 0.06
      # ... and many more default entries ...

  //Note: Refer to the generated config file for the complete default list.//

rare_chest_chances

Key:
```
rare_chest_chances
```
Description: Defines the default chance (0.0 to 1.0) for the mod's loot pool to activate in various “rare” loot tables when generating the default `loot_tables_config_v2.json`.
Type: Map (Table) String → Float
Default: (See TOML representation for specific default chances)

    [rare_chest_chances]
      "minecraft:chests/end_city_treasure" = 0.2
      "minecraft:chests/bastion_treasure" = 0.18
      # ... and many more default entries ...

  //Note: Refer to the generated config file for the complete default list.//

zygarde_cell_min_count

Key:
```
zygarde_cell_min_count
```
Description: Sets the default `minCount` for Zygarde Cells in the generated `loot_tables_config_v2.json`.
Type: Integer
Default:
```
1
```

zygarde_cell_max_count

Key:
```
zygarde_cell_max_count
```
Description: Sets the default `maxCount` for Zygarde Cells in the generated `loot_tables_config_v2.json`.
Type: Integer
Default:
```
16
```

zygarde_core_min_count

Key:
```
zygarde_core_min_count
```
Description: Sets the default `minCount` for Zygarde Cores in the generated `loot_tables_config_v2.json`.
Type: Integer
Default:
```
1
```

zygarde_core_max_count

Key:
```
zygarde_core_max_count
```
Description: Sets the default `maxCount` for Zygarde Cores in the generated `loot_tables_config_v2.json`.
Type: Integer
Default:
```
3
```

Miscellaneous configuration options.

form_changes

Key:
```
form_changes
```
Description: Enables or disables form-changing mechanics handled by this mod, such as those potentially defined in transformations.json (e.g., DNA Splicers, Griseous Orb interacting with Pokémon).
Type: Boolean
Default:
```
true
```

debug_mode

Key:
```
debug_mode
```
Description: Enables extensive, verbose logging output and potentially other debugging features. This should generally be left disabled (
```
false
```
) unless you are diagnosing problems or asked to enable it by a developer. Enabling this can significantly spam the game logs.
Type: Boolean
Default:
```
false
```