Back to mods
Ryu's Atlas Map project artwork

CurseForge · Minecraft mod

Ryu's Atlas Map

An RPG atlas book with minimap, full map, markers, upgrades, radar and Explorer's Table to copy and share exploration. Requires Curios.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Ryu's Atlas Map release should I use?

Updated today
Latest stable file ryus-atlas-map-forge-1.20.1-0.12.1
Game version 1.20.1
Loader Forge

Ryu's Atlas Map ryus-atlas-map-forge-1.20.1-0.12.1 targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Ryu's Atlas Map required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Ryu's Atlas Map ryus-atlas-map-forge-1.20.1-0.12.1 need?

ryus-atlas-map-forge-1.20.1-0.12.1. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

Curios API Optional for Ryu's Atlas Map ryus-atlas-map-forge-1.20.1-0.12.1
optional
Matching file found Matched file: curios-forge-5.14.1+1.20.1.jar

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Ryu's Atlas Map without breaking your instance.

Built for Ryu's Atlas Map ryus-atlas-map-forge-1.20.1-0.12.1. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use ryus-atlas-map-forge-1.20.1-0.12.1. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside ryus-atlas-map-forge-1.20.1-0.12.1. It opens that exact file at the source.

About this project

What does Ryu's Atlas Map add?

📖 Ryu's Atlas Map

An RPG atlas book with a minimap, a full-screen map, markers, upgrades and map sharing. Explore, record, trade and never lose your way.

⚙️ Forge 1.20.1 · 🧩 Curios API optional · 🌐 Works on singleplayer and servers (install on both sides)


✨ The idea

A physical Atlas item, not a menu. What you explore is recorded in the book. Lose it and you lose the map; copy it, trade it or merge it with a friend's. Add upgrades to unlock the compass, clock, death tracking and entity radar. Built with performance in mind: it only scans within a time budget per tick.


📘 Module 1 — The Atlas & Upgrades

  • 🛠️ Craft: Book and Quill + Map.
  • 🔧 Upgrades (Atlas + item, any order, each once): 🧭 Compass (coordinates, facing, cursor coordinates), 🕒 Clock (time, day, phase, dawn/dusk notices), 💀 Recovery Compass (last death, Soul Link, Soulbound), 🔭 Spyglass (entity radar).
  • 🎒 Curios slot "atlas" (if Curios is installed). Server option activation: HELD, HELD_OR_EQUIPPED (default) or INVENTORY.
  • 🎨 The book texture shows installed upgrades: the three gems light up (red = compass, gold = clock, cyan = recovery).
  • 🧾 If you carry several atlases, the one with the most upgrades is the active one.

🗺️ Module 2 — Minimap & Full Map

  • 🔍 Minimap in the HUD: size, zoom, shape, opacity, frame, rotation, cardinal points and position are all configurable. Move HUD… editor: drag elements anywhere.
  • 🌍 Full map with <kbd>M</kbd> (or right-click with the atlas): drag to pan, wheel to zoom out to ~10 blocks per pixel, coordinates next to the cursor, clouds over unexplored areas, open/close sounds.
  • 🖌️ Block colors read from the real textures (resource-pack friendly, works with modded blocks) plus biome tint, relief shading and water depth. Styles: PARCHMENT or CLEAN. Themes: CLASSIC / MODERN / RPG.
  • 🕳️ Cave layers: underground you get a separate slice at head height (Auto / Surface / Caves selector). The Nether always uses it.
  • 🌿 Biome display in the HUD (works with any atlas, no upgrade needed).
  • ⚡ Performance: newly loaded chunks first, then a spiral around you. Hard cap by time (timeBudgetMicros), not by chunk count. Manual survey mode available.

📍 Module 3 — Markers

  • ➕ Right-click the map or press <kbd>B</kbd> to place a marker at your position: name, many icons, many colors, edit, delete. Adjustable marker size and icon style.
  • 📋 Marker list panel: click to center, right-click to edit.
  • 💬 Share a marker in chat: it appears as readable text with coordinates and a clickable [Save marker] for the receiver.
  • 🧭 Lodestone compass guide: a linked compass in your hands or Curios shows its target on the map, minimap and bearing bar in a color you choose (default cyan), with its custom name.

☠️ Module 4 — Death Tracking (Recovery upgrade)

  • 💀 Skull marker on your last death (only in the dimension where it happened), edge-pinned on the minimap as a direction arrow.
  • ⏳ Right-click the latest death → delete in 5 minutes (stays visible, can be cancelled).
  • 🧹 "Delete deaths" button on the map removes all old deaths (keeps the latest), with confirmation.
  • 🔗 Soul Link: exploration is stored in your memory — craft a new atlas with the upgrade and get it all back. 🛡️ Soulbound: the atlas stays with you on death. (Server options recovery.memory, recovery.soulbound, recovery.glint.)

🧭 Module 5 — Bearing Bar

  • A compass strip showing nearby markers, entities and teammates by direction.
  • 📐 Free position and size (X, Y, width, height, opacity), or over the XP bar (translucent, level number stays in front). Toggle markers and players in the bar.

🔭 Module 6 — Entity Radar (Spyglass upgrade)

  • 🔴 Hostile · 🟢 Neutral · ⚪ Passive · 🟡 Players · 🔵 Teammates · ⚫ Items — each type can be toggled; configurable radius.
  • 🖱️ Open the map and point at a mob to see its name, type (if renamed) and health. Player names on the big map.
  • 👥 Teammate arrows on the minimap edge (vanilla scoreboard teams; needs the mod on the server).
  • 🪶 Zero cost when off or without the upgrade; it only uses entities your client already knows.

🛠️ Module 7 — Explorer's Table

New block. Recipe: planks ×3 (top), map + lodestone + map (middle), smooth stone ×3 (bottom). Slots: Source → Target → Result.

Source Target Result
🗺️ Map with destinations or banners 📘 Atlas Adds them as markers (the map is consumed). Banners become flag markers with the banner's color and name.
🗺️ Map with destination 🧭 Compass Links the compass to that point (the map is kept).
🧭 Linked compass 📘 Atlas Copies the lodestone point as a marker. The compass is not consumed and the marker stays even if you unlink the compass.
📘 Atlas (source) 📘 Atlas (target) The target receives the source's explored area (only fills empty pixels, never overwrites). The source is unchanged.
— 📘 Atlas / 🧭 Compass Rename (type a name in the box).
  • 🤝 Sharing exploration: if the source atlas' data isn't on your PC, the server asks connected players and whoever has it sends it (you must physically hold that atlas).
  • 🧱 Also works by right-clicking a Cartography Table with the atlas in one hand and a map in the other.

📚 Module 8 — Copies & Blank Atlases

  • ⚪ Blank atlas: Atlas + White Dye → keeps upgrades, wipes exploration. A blank atlas does nothing until you equip or open it.
  • 📑 Copy: [Atlas] [Slime Ball] [Blank Atlas] in a row. The original is kept; the copy receives the explored data and keeps the blank's upgrades. You choose to keep or discard the original's markers.
  • 🪨 Optional cheap Lodestone recipe (8 chiseled stone bricks + iron ingot; common config cheapLodestone).

⚙️ Configuration

In-game: Mods → Ryu's Atlas Map → Config, or the Settings button on the full map (changes apply immediately). Pages: HUD · Look · Frames · Map · Radar.

File What it controls
ryus_atlas-client.toml HUD toggles (minimap, markers, biome, coordinates, time, day/phase, facing, notices, 24h clock, latest death), minimap size/zoom/shape/opacity/rotation, theme/style/colors/pointer/marker size, frames, cardinal colors, clouds, sounds, cave mode and solid-rock level, exploration mode (auto/manual), data mode (ATLAS or WORLD), scan radius, time budget, bearing bar (position, size, opacity, XP mode), lodestone guide (general, on map, on minimap, color), radar (radius, entity types, names, hover), teammate arrows, optional share-exploration button.
ryus_atlas-server.toml (a default copy is written to defaultconfigs/ on first launch, so you can edit it before creating a world or server) atlas.activation, recovery.memory (Soul Link), recovery.soulbound, recovery.glint, death marker mode, teammate sync and its interval.
ryus_atlas-common.toml mapMode (ATLAS / FREE_MAP), the free-map upgrades, and the cheapLodestoneRecipe toggle. Edit before creating the world.

⌨️ Keys (Controls → Ryu's Atlas Map): Open map <kbd>M</kbd> · Add marker here <kbd>B</kbd> · Toggle atlas HUD · Toggle manual survey (both unbound by default).

🎛️ Module 9 — Free Map mode (optional)

Don't want the atlas gameplay? Set [mode] mapMode = "FREE_MAP" in config/ryus_atlas-common.toml (or use the Map mode button in the in-game settings, singleplayer): the minimap and full map are always on with all their features, no item to carry, craft or equip. Atlas recipes and creative items are removed and the Curios slot is not created, so the mod works without Curios. Choose which upgrades count as installed with freeCompass, freeClock, freeRecovery and freeRadar. The default is ATLAS, exactly the behavior described above. On servers, the server's config decides and clients receive the mode when they join.


⚡ Module 10 — Performance profile

The Performance button (Settings → Map) switches between Normal (default, nothing changes) and Performance: smaller scan radius and time budget, no clouds, clean style, no caves, lighter minimap, no teammate arrows. Switching back to Normal restores the defaults.


📦 Compatibility & notes

  • ✅ Minecraft 1.20.1 · Forge 47+ · Curios API optional (not needed in Free Map mode). Install on server and clients.
  • 🧩 Independent: it does not need or use Xaero's or any other map mod. Modded blocks are read from their textures.
  • 💾 Exploration is stored on the player's PC (.minecraft/ryus_atlas/<world>/atlas_<id>/) with the atlas id, so what's recorded travels with the book.
  • ⚠️ Known limits: teams use vanilla scoreboard teams only; radar sees only entities your client already knows; markers are not merged between atlases; cave layers are not shared by the Explorer's Table; merging huge atlases runs in one go and may stutter briefly.
  • 🐛 Report bugs with your latest.log and the mod version.

📜 License

All Rights Reserved.

Made with 💛

Project description from CurseForge.

Pick your setup

Ryu's Atlas Map by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Ryu's Atlas Map versions and loaders

2 of 2 releases match

Looking for an older file? The official CurseForge project page is in Resources.