Compass to Map (C2M)

Stop manually copying coordinates from your compass to JourneyMap.

When you find a structure or biome with Explorer's Compass or Nature's Compass, this mod automatically registers a waypoint on JourneyMap — color-coded, named, and ready for one-click teleport (OP only).

Features

• Auto-waypoint on compass discovery — no manual coord copying
• Category-coded colors — village=yellow, fortress=orange, jungle=dark green, ocean=blue, etc.
• Hash colors for modded structures/biomes — every modpack structure gets a unique color
• OP-only /tp suggestion — survival players see plain coords, no fake teleport hint
• 22 language localization — en/ja manually translated, others machine-based
• Either compass works — install just EC, just NC, or both

Supported Loaders / Versions (v2.0.2+)

• ✅ = Full JourneyMap integration (auto waypoint)
• ⚠️ chat-only = Fabric builds have JM integration disabled, chat notification only (see Known Limitations below)
• — = No NeoForge 1.20.1 release exists upstream

Fabric users also need Forge Config API Port.

Compatibility

You need at least one of EC/NC for the mod to do anything. JM is required to actually see waypoints, but the mod won't crash without it.

Configuration

Open the in-game Mods menu → Compass to Map → Config:

• feature.enabled — master switch
• feature.enableStructure / feature.enableBiome — toggle each compass type
• notification.notifyOnFound — chat notification on discovery
• appearance.colorByCategory — category colors (off = solid purple)
• appearance.persistentWaypoints — keep waypoints across sessions

Technical Notes

• No Mixin / AccessTransformer / reflection — pure Event subscription
• Server → Client payload only — zero attack surface
• Inner class isolation — works without JM, EC, or NC installed (graceful degradation)
• LRU dedupe with per-player history Set (no memory leaks on long sessions)

Known Limitations

Fabric builds: JourneyMap integration disabled

On 1.20.1 / 1.21.1 Fabric builds, JourneyMap waypoint registration is currently disabled, with chat notification as fallback.

Reason: the JourneyMap Fabric jar requires Loom 1.14, which is still unreleased. The current Loom 1.10-SNAPSHOT cannot link the JM API.

Fallback behavior: structure / biome discoveries still send chat messages with coordinates (clickable /tp for OPs).

Future plan: JM v1.1 / v2.1 reflection bridge to bypass the dependency. Will land when either Loom 1.14 ships or the bridge is implemented.

No NeoForge 1.20.1 build

NeoForge forked off after 1.21, so 1.20.1 NeoForge builds simply don't exist. Use Forge 1.20.1 instead.

License

MIT License — modpack inclusion welcome, no credit required.

Issues / Feature Requests

GitHub Issues: https://github.com/KURONAMI333/compass-to-map/issues

Credits

• Author: KURONAMI
• Built on:
  • Explorer's Compass by ChaosTheDude / MattCzyr
  • Nature's Compass by ChaosTheDude / MattCzyr
  • JourneyMap by TeamJM
• Sister mod: Ping to Map (Ping-Wheel × JM addon)