🧭 Mega Compass

Stop searching blind and track Mega Showdown structures directly.

Mega Compass adds specialized compasses that point to key CobblemonMegaShowdown structures using an async search system with a brand new dynamic 3D rendering system and live HUD feedback.

• 3D Rendering: True 3D compass needles with mathematical rotation.
• Turns random exploration into targeted structure hunts.
• Reduces wasted digging and travel time.
• Adds multiple compass variants for different goals.
• Keeps performance stable with async search workers.
• Multiplayer Ready: Isolated search tracking for every player.

⚡ Quick Start

1. Craft one of the Mega Compass variants.
2. Right-click to start search.
3. Follow the needle and HUD distance.
4. Shift + right-click to reset tracking.

🎯 Main Features

• 3D Dynamic Models: Modern rendering system for realistic needle rotation.
• Dedicated compasses for specific structures.
• Combined compass with target selection GUI.
• Real-time HUD search state, coordinates, and distance info.
• Async spiral search for better server performance.
• Multiplayer optimized (isolated search per player).
• Localization support across multiple languages.

⛏️ Crafting Recipes

Mega Site Compass

Megaroid Compass

Wishing Weald Compass

Combined Mega Compass

For modpacks/datapacks:

• Recipes can be overridden via datapack recipe JSON files.

🎮 Usage Example

Scenario: find a Wishing Weald

• Hold Wishing Weald Compass.
• Right-click to start scan.
• Wait for search completion.
• Move following needle direction until distance drops.

🗺️ Target Structures

• Megaroid (deep underground target)
• Mega Site (shallow underground target)
• Wishing Weald (surface overworld target)

📊 HUD & Search Behavior

HUD can show:

• active search state
• samples/radius progress
• found state with distance
• no-results message when out of radius

🧪 Performance Notes

• Async worker-based search pipeline.
• Spiral sampling strategy to avoid heavy tick spikes.
• Designed for practical multiplayer usage.

📦 Requirements

• Minecraft 1.21.1
• Fabric Loader 0.16.9+
• Fabric API 0.108.0+
• CobblemonMegaShowdown (required)
• Java 21+

🔧 Installation

1. Install Fabric Loader.
2. Install Fabric API.
3. Install CobblemonMegaShowdown.
4. Put Mega Compass jar in mods folder.
5. Launch game/server.

🌐 Client/Server Behavior

• Works in singleplayer and multiplayer.
• Install on server for multiplayer structure tracking.

🤝 Compatibility & Integration

• Built for CobblemonMegaShowdown structure ecosystem.
• Recipe-viewer compatible (JEI/REI/EMI workflows).
• Works alongside standard Cobblemon setups.

❗ Known Limitations

• Structure discovery depends on generated chunks.
• Works in Overworld-focused structure contexts.
• No target found when no valid structure is present in search radius.

🧰 Troubleshooting

Compass keeps saying no structure found

• Explore farther to generate more chunks.
• Retry search from a different area.

Compass does not point correctly

• Ensure target search completed.
• Reset with Shift + right-click and run again.

Multiplayer inconsistencies

• Confirm server has the mod installed.

❓ FAQ

Is this only for Mega Showdown users?

Yes, the mod is designed around Mega Showdown structures.

Is it server-friendly?

Yes, async search is designed to minimize lag spikes.

Can I customize recipes?

Yes, via datapack recipe overrides.

💬 Support & Feedback

When reporting issues include:

• mod version
• Minecraft/Fabric/Mega Showdown versions
• full mod list
• coordinates and dimension
• steps to reproduce
• latest log/crash report

Made for Cobblemon and MegaShowdown players who want fast, targeted structure hunting without blind exploration.