Changelog

[2.0.0] - 2025-08-17

🚀 Major Release - Complete System Overhaul

This release represents a complete rewrite of the Miner's Compass with massive improvements to modded ore support, user experience, and configuration options.

✨ New Features

Automatic Modded Ore Detection

• Universal mod compatibility - Automatically detects ores from ANY mod
• 80+ built-in ore patterns covering popular mods:
  • Create - Zinc ore
  • Mythic Metals - All 20+ ores (Adamantite, Mythril, Orichalcum, etc.)
  • Immersive Engineering - Aluminum, Lead, Nickel, Silver, Uranium
  • SoulsWeapons - Moonstone, Verglas
  • Blue Skies - Charoite, Diopside, Pyrope, Aquite, Falsite, Horizonite, Ventium
  • Amethyst Imbuement - Tiger's Eye, Crystalline Core
  • Better End - Ender, Amber, Thallasium
  • And more mods supported automatically
• Intelligent fallback patterns for unknown mods
• Future-proof design that adapts to new mods

Smart Ore Grouping System

• Intelligent ore variant grouping (e.g., iron_ore + deepslate_iron_ore = "Iron Ore")
• Proper ore names instead of confusing technical names
• Separate handling for different materials (e.g., SoulsWeapons vs Blue Skies moonstone)
• Color-coded ore types for easy identification

Modern GUI System

• Right-click interface replacing old shift-right-click method
• Visual ore selection screen with clean, organized layout
• Multi-select capability with visual feedback
• "Done" button for confirming selections
• Clear All option for quick reset

Advanced Configuration System

• Ore type exclusions - Hide entire ore categories ("excludedOreTypes": ["coal", "zinc"])
• Specific block exclusions - Fine-grained control ("excludedBlocks": ["minecraft:coal_ore"])
• Custom ore definitions - Add any missing ores with custom colors
• Mod exclusions - Ignore problematic mods entirely
• Force inclusions - Manually include specific blocks

Client-Server Synchronization

• Proper networking - Ore selections sync correctly between client and server
• Survival mode support - Now works perfectly in survival (fixed major bug)
• Multiplayer compatibility - Reliable operation on servers

🔧 Improvements

Performance Enhancements

• Optimized ore detection algorithm
• Configurable hardness filtering to exclude decorative blocks
• Async ore discovery process
• Smart caching of ore data
• Reduced memory usage with efficient data structures

Enhanced User Experience

• Intuitive controls - Right-click for GUI, shift-right-click for quick add/remove
• Better tooltips with detailed information
• Clear feedback when adding/removing ore types
• Informative error messages for troubleshooting

Configuration Improvements

• Self-documenting config with comments explaining each option
• Clean array format - No more comment strings cluttering arrays
• Comprehensive examples and documentation
• Backward compatibility with v1.x configs

🐛 Bug Fixes

Critical Fixes

• Fixed survival mode ore finding - Compass now works correctly in survival
• Fixed client-server desync - Ore selections properly synchronize
• Fixed ore name extraction - No more "Moon Ore" or "Deepslate Ore" confusion
• Fixed decorative block detection - Properly filters out non-ore blocks

Quality of Life Fixes

• Improved ore grouping - Related ores properly grouped together
• Better pattern matching - More reliable ore name extraction
• Fixed config generation - Clean config files without clutter
• Enhanced error handling - Graceful handling of invalid configurations

⚡ Technical Changes

Architecture Overhaul

• New Ore Patterns - Whitelist-based ore detection system
• Enhanced Dynamic Ore Detection - Improved scanning algorithm
• Rewritten Dynamic Ore Type - Better ore type management
• New networking system - Reliable client-server communication

Data Structures

• Efficient ore mapping with exact block ID matching
• Smart caching of discovery results
• Optimized chunk scanning with configurable radius
• Proper NBT synchronization between client and server

Compatibility

• Maintained datapack support - Old datapacks still work
• Backward compatible configs - v1.x configs continue working
• Future-proof design - Easy to add new mods and ore types

🔄 Migration Guide

From v1.x to v2.0

• Automatic migration - Your existing config continues working
• New features available - Add new config options as desired
• GUI changes - Right-click instead of shift-right-click for main interface
• Enhanced functionality - All old features work better with new improvements

Config Migration

// Old v1.x config (still works)
{
  "chunkRadius": 2,
  "maxBlocks": 3
}

// Enhanced v2.0 config (optional upgrades)
{
  "chunkRadius": 2,
  "maxBlocks": 3,
  "enableAutoDiscovery": true,
  "excludedOreTypes": ["coal", "iron"],
  "customOreTypes": ["mythril:AQUA:modname:mythril_ore"]
}

📋 Supported Mods (New in v2.0)

Vanilla: All standard ores + deepslate variants
Create: Zinc
Immersive Engineering: Aluminum, Lead, Nickel, Silver, Uranium, Copper
Mythic Metals: All 20+ ores with full variant support
SoulsWeapons: Moonstone, Verglas
Blue Skies: Aquite, Charoite, Diopside, Pyrope, Falsite, Horizonite, Ventium, Blue Skies Moonstone
Amethyst Imbuement: Tiger's Eye, Crystalline Core
BetterEnd: Ender, Amber, Thallasium
Clutter: Silver, Sulfur, Onyx
Butchery: Sulfur (including non-standard naming)
Expanded Delight: Salt
Things: Gleaming
Werewolves: Silver
Deep Dark Regrowth: Grimstone variants
NetherExp: Fossil, Fossil Fuel
And many more...

---

[1.0.0] - Previous Release

Features

• Basic ore detection for vanilla ores
• Shift-right-click ore selection
• Configurable chunk radius and max blocks
• Datapack support for custom ore addition
• Basic compass functionality

Limitations (Fixed in v2.0)

• Manual ore configuration required for modded ores
• Limited modded ore support
• Survival mode issues
• Complex datapack setup for new ores
• No GUI interface

---

Note: This changelog covers the major v2.0 overhaul. For detailed technical changes and implementation notes, see the commit history and documentation files.