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.
Quick answer
Which Ryu's Atlas Map release should I use?
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.
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.
This file does not list any required mods. Do not add a library just because a different file uses it.
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.
- 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.
- 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.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 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) orINVENTORY. - 🎨 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.logand 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.20.1
1 loader buildCheck 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
ryus-atlas-map-forge-1.20.1-0.12.1
ryus-atlas-map-forge-1.20.1-0.12.1.jar
20 Nov 2026
ryus-atlas-map-forge-1.20.1-0.11.1
ryus-atlas-map-forge-1.20.1-0.11.1.jar
19 Nov 2026
Looking for an older file? The official CurseForge project page is in Resources.
