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+)

Minecraft	NeoForge	Forge	Fabric
1.21.1	✅	✅	⚠️ chat-only
1.20.1	—	✅	⚠️ chat-only

✅ = 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

Mod	Support	Notes
Explorer's Compass	optional	Structure detection host
Nature's Compass	optional	Biome detection host (v2.0+)
JourneyMap	optional (CLIENT only)	Waypoint target

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)

Compass to Map: JourneyMap & Explorer's Compass & Nature's Compass Addon