================================================================================
                      SOL'S RELIC SYSTEM
                    Configuration Guide
================================================================================

This mod adds an artifact-style stat system to Minecraft!
Requires: Sol's Item Rarity Mod

[1] QUICK COMMANDS
  /srs reload   Reload all JSON configs and regenerate instructions.txt
  /srs info     Show mod info
  /srs stats    Show held relic stats
  /srs recycle  Recycle held relic

[2] CONFIG FILES
  - solsrelicsystem-common.toml
  - aster_core_mobs.json
  - dust_of_enlightenment_mobs.json
  - relic_blacklist.json
  - relic_whitelist.json
  - set_bonuses.json

[3] DUST DROP CONFIGURATION
  Dust mob drop rates are configured in dust_of_enlightenment_mobs.json.
  Dust chest rates are configured per category under chestLoot in the common TOML.

[4] ASTER CORE MOBS (aster_core_mobs.json)
  Purpose: choose which entities can drop Aster Cores.
  Default file is prefilled with common hostile mobs as reference.
  Aster Core tier chances are still controlled in common.toml:
    tier1DropChance, tier2DropChance, tier3DropChance
  File format:
    {
      "_config_version": 6,
      "allowed_entities": [
        "minecraft:zombie",
        "minecraft:blaze",
        "minecraft:wither",
        "mineminenomi:marine",
        "uuid:12345678-1234-1234-1234-123456789abc"
      ]
    }

[5] DUST MOBS (dust_of_enlightenment_mobs.json)
  Purpose: set per-entity Dust mob drop rates (in %).
  Key types: exact entity, namespace, or uuid.
  Set a value to 0.0 to disable Dust drops for that specific key.
  File format:
    {
      "_config_version": 3,
      "entity_drop_chances": {
        "minecraft:ender_dragon": 1.0,
        "minecraft:wither": 0.65,
        "minecraft:warden": 1.0,
        "minecraft:elder_guardian": 0.4,
        "minecraft:ravager": 0.35,
        "minecraft:piglin_brute": 0.35,
        "minecraft:vindicator": 0.35
      }
    }

[6] RELIC BLACKLIST (relic_blacklist.json)
  - Use 'modid' to block all items from a mod
  - Use 'modid:item_name' to block one item
  Example blacklist: ["someweaponmod", "minecraft:wooden_sword"]

[7] RELIC WHITELIST (relic_whitelist.json)
  - Whitelisted entries bypass normal weapon/armor detection
  - Use 'modid' to force all items from a mod to be relic-eligible
  - Use 'modid:item_name' to force one item to be relic-eligible
  - Blacklist entries take priority over whitelist entries
  - Prefer item IDs: whole-mod entries also include blocks, materials, and food
  Example whitelist: ["someweaponmod", "anothermod:custom_blade"]

[8] SET BONUSES (set_bonuses.json)
  - material_sets = armor material bonuses
  - custom_sets = explicit item list bonuses
  - Custom set entries need name, items, and piece bonus stats

[9] AUTO MIGRATION
  - Old Dust/Aster entity lists are converted automatically on reload/start.
  - Legacy entries are preserved to reduce manual migration work.
  - No backup files are created for this migration path.

================================================================================
                  Made by solmochi - Enjoy!
================================================================================
