Elden Ring Achievement Mod

Custom in-game achievement overlay — appears directly over Elden Ring. Press F9 (default) to open/close the achievement screen.

---

Build Requirements

• Visual Studio 2022 (Desktop C++ workload)
• CMake 3.20+
• Git

---

Setup: External Libraries

1. ImGui

git clone https://github.com/ocornut/imgui vendor/imgui

2. MinHook (x64 static lib)

• Download from: https://github.com/TsudaKageyu/minhook/releases
• Extract MinHook.x64.lib → vendor/minhook/lib/MinHook.x64.lib
• Copy MinHook.h → vendor/minhook/include/MinHook.h

3. nlohmann/json (header-only)

• Download single header: https://github.com/nlohmann/json/releases
• Place json.hpp → vendor/nlohmann/json.hpp
• Add vendor/nlohmann to include dirs in CMakeLists.txt (already there)

---

Build

mkdir build && cd build
cmake .. -G "Visual Studio 17 2022" -A x64
cmake --build . --config Release

Output: build/Release/dinput8.dll

---

Installation

Option A: Direct (no Mod Engine)

Copy dinput8.dll → <Steam>\steamapps\common\ELDEN RING\Game\

Option B: Mod Engine 2 (recommended — works alongside other mods)

1. Install Mod Engine 2: https://github.com/soulsmods/ModEngine2
2. Copy dinput8.dll → your ModEngine mod folder
3. Add to config_eldenring.toml:

   [[mods]]
   enabled = true
   name = "er_achievement_mod"
   path = "mod/er_achievement_mod"

---

Usage

Key	Action
F9	Toggle achievement screen
In settings tab	Change hotkey, sound, duration

Finding offsets for custom achievements:

1. Launch Elden Ring (offline mode)
2. Press F9 → Diff Tool tab
3. Click 📷 Snapshot
4. Collect the item in-game (wait for auto-save)
5. Press 🔍 Find Changes
6. Click [+] next to the changed byte
7. Assign to an achievement → label it → click Add Condition
8. Repeat for every item in the achievement (e.g. all 28 cookbooks)

Once all conditions are added, the achievement fires automatically whenever the save file updates.

---

Multi-character support

The mod reads all 10 character slots from ER0000.sl2. It detects the active character via the save header's "last played slot" field. You can also manually switch which character to check via the dropdown in the achievement screen.

---

Notes

• Play offline when using mods (EAC bans online)
• The er_achievements.json file (saved next to the DLL) stores your progress and all custom conditions — back it up
• Achievement conditions persist across game restarts

---

File structure after build

ELDEN RING/Game/
├── eldenring.exe
├── dinput8.dll          ← this mod
└── er_achievements.json ← auto-created on first run