An interactive map of The Lands Between and the Realm of Shadow that updates itself while you play. Rest at a new Site of Grace and it lights up. Kill a boss and it gets a checkmark. Turn on real-time mode and your character becomes a dot that moves with you.
Everything runs on your own PC. Nothing is uploaded, and there is no account.
Everything you see is built from your own copy of the game: the map is the real in-game map art, and the markers come from the game's own data files. No map tiles or marker data ship with this repository — you generate them once during setup, in about two minutes.
- Four map layers — The Lands Between, the Underground (Siofra / Ainsel / Deeproot), the Realm of Shadow, and the DLC underground.
- 3,500 markers that track themselves — 418 Sites of Grace, 208 boss arenas, 289 points of interest, 165 unnamed landmarks, 34 map fragments, and 2,389 item pickups: Golden Seeds, Sacred Tears, talismans, cookbooks, bell bearings, whetblades, weapons and armour.
- The game's own map icons — graces, catacombs, caves, churches and the rest are drawn with the real sprites lifted out of the game, not coloured dots.
- Live progress. Found markers turn green, and a popup names whatever you just discovered. Progress bars per category.
- Your character — level, playtime, deaths, all eight stats, runes.
- Real-time position (optional) — a dot that moves as you move.
- English and Russian, using the game's own text for every marker name.
- Search, marker clustering, manual check-off, and a "hide found" filter.
- Categories toggle independently, so you can show just Golden Seeds, or just what you haven't picked up yet.
| OS | Windows 10/11, or Linux with Steam/Proton |
| Elden Ring | installed — the map art is read out of your install |
| Node.js | 18 or newer (LTS is fine) |
| Python | 3.9 or newer — tick "Add Python to PATH" in the installer |
About 65 MB of disk for the generated map tiles and icons.
1. Get the files
git clone https://github.com/egormagurin/EldenRingMap.git
cd EldenRingMap2. Run Setup.bat
Double-click it. It finds your Elden Ring install, installs a few Python packages, extracts the map tiles and icons, builds the marker list, and reads all 864 of the game's map files to find where every item is. You only need to do this again after a game update.
If it can't find your install, open Setup.bat in Notepad and set the path
by hand near the top:
set GAMEDIR=D:\Games\Steam\steamapps\common\ELDEN RING\GameThat must be the folder containing eldenring.exe and regulation.bin. In
Steam: right-click Elden Ring → Manage → Browse local files, then open the
Game subfolder and copy the address bar.
For a loose-file mod such as Elden Ring Reforged, set its mod directory too:
set MODDIR=D:\Games\ELDEN RING Reforged\modThe setup then uses the mod's regulation.bin, MapStudio files, messages, and
map-icon atlases over the base archives. Base map tiles are still extracted
from the game unless the mod supplies replacements.
Run the native setup and launcher:
ER_MOD_DIR="/path/to/ERR/mod" ./setup-linux.sh
./start-map.shThe Linux setup builds a native Oodle-compatible decoder and applies loose mod
files over the installed game archives. ER_GAME_DIR, ER_STEAM_ROOT,
ER_MOD_DIR, ER_PREFIX, and ER_SAVE can override auto-detected paths.
start-map.sh reads the running Proton game through /proc for real-time
position; it does not depend on a particular Proton build.
Double-click Start Map.bat. Your browser opens at
http://localhost:8099. Leave the black console window open while you play —
closing it stops the map.
Your save is found automatically. The sidebar has separate selectors for save
extension (.sl2, .err, and other installed variants) and Steam-account save
file. Start the game, play, and the map keeps up on its own.
| Control | |
|---|---|
| Drag | pan |
| Scroll / double-click | zoom |
| Click a marker | details, plus a manual check-off button |
/ |
jump to search |
Esc |
close popups |
| ◎ button | centre on your character |
The EN / RU buttons at the top switch language. Marker names are the game's own translations, so they read exactly as they do in-game.
Run "Start Map.bat" --lan. It prints a second address:
open http://localhost:8099
LAN http://192.168.1.42:8099
Open that one on any device on the same Wi-Fi. Windows will ask about the firewall the first time — allow it for private networks only.
Start Map.bat updates whenever the game saves, which Elden Ring does
constantly, so progress stays current within a few seconds. The one thing it
can't do is move your dot smoothly — it jumps once per save.
Start Map LIVE.bat fixes that by reading the running game, giving a dot
that moves at 20 fps with a facing arrow. It asks for administrator rights,
because Elden Ring itself runs elevated.
Read-only. The reader opens the game with read-only access. It cannot modify the game, and it never touches your save.
Offline play only. Anti-cheat objects to anything reading game memory. If you play online through
start_protected_game.exe, use the normalStart Map.bat. Real-time mode is for offline or modded setups where EAC isn't running.
Check Live Mode.bat tests whether it can attach to your game.
Almost always another copy is still running and holding the port. The
launcher checks for this and names the process, but if the window closes too
fast to read, open a terminal in the folder and run npm start to see the
message.
Fix: close the other console window, or end node.exe in Task Manager.
They aren't on your PATH. Reinstall and make sure "Add to PATH" is ticked — Python's installer has this as a checkbox on the first page, easy to miss. Then open a new console; PATH changes don't reach already-open windows.
Setup hasn't been run, or it failed partway. Run Setup.bat and read its output.
Auto-detection scans your Steam libraries. If your copy lives somewhere unusual,
set GAMEDIR near the top of Setup.bat. It needs the Game subfolder — the
one with eldenring.exe in it, not the folder above.
Run it by hand to see the real error:
python -m pip install zstandard pycryptodome pillow texture2ddecoder numpyIf pip itself is missing: python -m ensurepip --upgrade.
The save normally lives at %APPDATA%\EldenRing\<your steam id>\ER0000.sl2. If
yours is elsewhere:
npm start -- --save "C:\path\to\ER0000.sl2"In live mode, the running character is matched to the save slot by its current map position. Without a running game, use the save-type and save-file selectors in the sidebar to choose the correct save container.
The map updates when the game writes a save. Rest at a grace, or open and close a menu, to force one. The console window prints a line for every update:
[watch] save changed: Tarnished lv57 207/949
Elden Ring runs elevated, so the reader must too. Use Start Map LIVE.bat,
which requests elevation itself, rather than starting the server by hand.
A patch can move the internal structures the reader looks for. Run
Check Live Mode.bat — if it reports NOT FOUND for CSMenuManImp, the byte
signatures in tools/live_memory.py need updating for the new version.
Everything else keeps working meanwhile; only the moving dot is affected.
Re-run Setup.bat. Patches occasionally change the map textures and the game
data the markers come from.
Some lots are shared between several placements. If one is picked up, the flag is set for all of them. This is uncommon.
They're best-effort. The game's data has boss positions and defeat flags but no usable name field, so each boss borrows the name of the nearest landmark. That's usually right — a grace beside an arena is normally named after its boss — but not always.
- Only the first occupied save slot is shown.
- Not every item is placed. 2,389 pickups come from the game's map files; some others are spawned by event scripts and aren't covered. Enemy drops are not included either.
- Shadow of the Erdtree items are missing. The base game ships the DLC's map art and text, so the DLC map layer and its graces/bosses do appear — but the DLC's own map files are only present if you own and have installed it.
- Boss names are derived, as above.
- A few interior areas the game itself never places on the world map (Roundtable Hold, some arenas) are skipped.
The normal mode is completely passive. It opens your save file for reading, never writes to it, never touches the game process, and never talks to the internet. There is nothing for anti-cheat to see.
Real-time mode reads the running game's memory. That is read-only and cannot modify anything, but anti-cheat systems object to memory reading on principle. Use it offline only — the same advice that applies to any Elden Ring mod, FPS unlocker, or speedrun timer.
The code is free to copy and modify. The map tiles and marker names are not — those are FromSoftware's artwork and text, which is why setup generates them from your own installation instead of shipping them.
If you fork this, keep web/tiles/, cache/ and the generated files in data/
out of your commits. The included .gitignore already handles that.
Hosting a working copy as a public website isn't possible in any case: a page on a web server can't read a save file on your PC, which is the whole point of the tool.
This fork adds native Linux support and a Map-for-Goblins integration layer. Everything below the "upstream" divider is from this fork; everything above it in the version history (1.2, 1.1, 1.0) is the upstream project.
Replaces the coarse item categories (weapon / armor / misc) with Map for Goblins' 47 item categories — Armaments, Armour, Ashes of War, Spirit Ashes, Talismans, Cookbooks, Crystal Tears, Smithing Stones (by tier), Golden Runes (by tier), Rune Arcs, Gloveworts, Incantations, Sorceries, Deathroot, Reforged-exclusive items (Ember Pieces, Rune Pieces, Fortunes, Sealed Curios), and more. Each category carries Map for Goblins' own icon (MIT-licensed), so markers draw with real sprites instead of coloured dots.
The classifier is ported from the open-source
ERR-MapForGoblins-DLL
LOOT_CATEGORIES (itemId-based, not name heuristics), bundled as
tools/erlib/mfg_categories.py with its data files under data/mfg/.
Adds 1,135 Rune Pieces and 316 Ember Pieces — ERR collectibles placed
as MSB entities (AEG099_821 / AEG099_822), handled by a dedicated
tools/extract_pieces.py since they are not loot lots. Total markers on an ERR
install: ~6,360 (up from 4,909).
The ◎ centre-on-player button is now a toggle: click once to continuously auto-centre the map on your character as position updates arrive (~20 Hz in live mode, or per save write otherwise), click again (or drag the map) to release. Wheel-zoom does not disengage. Cross-map travel auto-switches the map layer. Gold highlight when engaged.
Every sidebar section — Character, Progress, Search, Map, Categories, Options — collapses via its title header, and the whole sidebar collapses to a floating expand tab so the map can use the full width.
The save-file dropdown now lists each save's character names and levels (e.g. "Alyssa · Lv 134 / PeePeeLord · Lv 145") instead of raw Steam account IDs, and a new Character dropdown below it lets you manually pick which slot's progress is displayed, overriding the automatic live-position match. The auto-match itself was hardened to re-evaluate continuously (3-sample hysteresis) instead of locking to the first sample.
setup-linux.sh and start-map.sh run the map natively on Linux, building a
linoodle Oodle shim against the game's own oo2core_6_win64.dll (no Wine
needed for extraction) and reading the live Proton process via /proc.
All paths derive from $USER/$HOME — no hard-coded username — and auto-detect
the canonical ERR mod directory only when a mod-loader DLL is present and the
mod's regulation.bin differs from the game's. server/index.js also detects
the ERR .err save extension, not just vanilla .sl2.
Markers now draw with the game's own map sprites — the golden grace ring, catacomb arches, cave mouths, churches — instead of coloured dots. 89 icons are extracted from the menu texture sheets; the directional ones (grace rays, summoning-pool flames) are rotated the way the game draws them. A sidebar toggle switches back to dots.
Also reads all eight text slots per map point instead of only the first, which recovers 8 real place names that were showing as "Landmark near X".
+2,394 item markers, each tracking its own pickup flag: Golden Seeds, Sacred
Tears, talismans, cookbooks, bell bearings, whetblades, Ashes of War, weapons
and armour. Found by parsing all 864 of the game's MSB map files and joining
them to ItemLotParam_map.
+157 unnamed landmarks that were previously being dropped — real, flagged places the game labels with an icon and no text.
Marker total: 949 → 3,508. "Other items" (crafting materials) starts hidden so it doesn't bury the map.
Fixes: overworld LOD tiers were projected at the wrong scale, throwing 17 markers thousands of pixels off the map; Ashes of War resolved against the wrong name table and silently vanished. The extractor now fails loudly if anything lands outside the map.
Live map of The Lands Between and the Realm of Shadow, syncing with your save file as you play. Four map layers extracted from your own install, 1,114 markers built from the game's param tables, English and Russian, and an optional real-time player dot read from the running game.
Start Map.bat |
start the map |
Start Map LIVE.bat |
start with real-time position (asks for admin) |
Check Live Mode.bat |
test whether real-time mode can attach |
Setup.bat |
one-time setup, and after game updates |
npm start -- --lan |
also serve to your local network |
node server/index.js --help |
every server option |
docs/HOW-IT-WORKS.md covers the interesting parts: how
the save file is decoded, how the map tiles come out of the game archives, and
how world coordinates become map pixels.
The game ships 13 locales. To add one, e.g. German:
- Add
"de": "gerde"toLOCALESintools/build_markers.py, then re-runpython tools/build_markers.py. - Add a matching
deblock toSTRINGSand an entry inLANGSinweb/js/i18n.js.
Marker names come free from the game — only the UI strings need translating.
Available codes: jpnjp, frafr, gerde, itait, korkr, polpl, porbr,
spaar, spaes, thath, zhocn, zhotw.
Built on format documentation from ER-Save-Lib, SoulsFormats, Paramdex, EROverlay and elden-ring-compass.
Elden Ring is © FromSoftware / Bandai Namco. This is an unaffiliated fan tool.