ORE DETECTOR DATAPACK
Minecraft 1.21.10+

PURPOSE
Late-game, vanilla-feeling Deep Dark ore detection tool.
Designed to feel official, quiet, and earned.

CORE ITEM DESIGN
- Logical item: minecraft:carrot_on_a_stick
- Visual model: recovery_compass
- Reason: reliable right-click detection, non-placeable
- Must be given via /function src:z/0b2
- Manual /give WILL break functionality

DETECTION LOGIC (DO NOT MODIFY)
- Nearest ore always wins (distance-based, no ore bias)
- Staged scan across ticks to avoid command limits
- Directional particle output
- Actionbar-only feedback (no chat spam)
- Signal strength tiers: LOW / MED / HIGH

ENCHANTMENT: SEEKING
Custom enchant: src:seeking
Range scaling:
- Base: 6 blocks
- Seeking I: 12 blocks
- Seeking II: 18 blocks
- Seeking III: 24 blocks (hard cap)

Cooldown scaling:
- Base: 5 seconds
- Seeking I: 4 seconds
- Seeking II: 3 seconds
- Seeking III: 2 seconds

CRAFTING
- Recipe outputs REAL detector directly (no placeholders)
- Uses modern 1.21+ recipe format
- Recipe unlock gated behind Echo Shard
- Recipe book visibility is intentional

WARDEN LOOT
- Loot-table override only
- Requires Looting
- Detector drop chance scales with Looting
- Fallback drop: Echo Shards
- Vanilla Sculk Catalyst preserved

SAFETY NET (INTENTIONAL)
- Detector self-repairs on right-click
- Fixes stripped or malformed items
- Silent: no chat, sound, or particles
- Do NOT remove; prevents future corruption issues

PACK ICON
- pack.png is intentionally minimal (64x64)
- Kept small to avoid pack bloat

KNOWN SAFE BASELINE
Ore_Detector_STEP17a_safety_net_scaled_cooldowns.zip

VERSIONING NOTES
- Always branch from the last known-good build
- Change ONE system at a time
- Test in single-player before servers
- Avoid adding large assets inside the datapack

DESIGN RULE
If a change makes this feel "datapacky" instead of vanilla,
undo it.

END OF FILE

Guide Book Unlock:
- The Ore Detector Guide recipe now unlocks as soon as the player obtains sculk vein.


Update v1.1.11:
- Ore Detector Guide recipe now outputs a readable written book directly
- Book title/custom name set to "Ore Detector Guide"
- Guide recipe unlocks when player obtains sculk vein


Java 26.1 update notes:
- pack.mcmeta retargeted to Java 26.1 datapack format 101/101.1
- removed stale overlay reference to missing old/ directory
- gameplay logic, recipes, enchantment tag integration, and loot table logic left unchanged
- test on Java 25 runtime for 26.1 servers


26.1 update note: actionbar symbols restored for Seeking tiers; base detector remains simple yes/no; Seeking enchant weight adjusted to 2 for villager trade parity testing.


26.1 librarian Seeking update:
- Seeking is now controlled by custom 26.1 villager_trade entries instead of the generic tradeable enchantment tag.
- Seeking librarian weighting reduced heavily from the parity test build.
- Seeking I now uses one trade entry instead of three.
- Seeking II now uses one trade entry instead of two.
- Seeking III remains one rare master-level entry.
