explaingit

ramisotti13-eng/farever-minimap

18Audience · generalComplexity · 2/5ActiveSetup · easy

TLDR

Drop-in overlay mod for the PC game Farever, bundling a minimap, a DPS meter, and a sandboxed Lua plugin runtime into a single dinput8.dll.

Mindmap

mindmap
  root((farever-minimap))
    Inputs
      Game memory
      Player hotkeys
      Lua plugin files
    Outputs
      Minimap overlay
      DPS table
      Toast notifications
    Use Cases
      Track collectibles
      Measure skill DPS
      Build boss helpers
    Tech Stack
      C plus plus
      Lua
      ImGui
      DirectX
      JSON

Things people build with this

USE CASE 1

Add a minimap with 821 chest, orb, plant, and ore markers to a Farever playthrough.

USE CASE 2

Measure per-skill DPS in real fights with combat-state and fight history tracking.

USE CASE 3

Write a small Lua plugin that reacts to cast_start and cast_end events for a boss helper.

USE CASE 4

Fall back to the legacy v0.4.15 build on an old AMD card where the v0.5.x DirectComposition path fails.

Tech stack

C++LuaImGuiDirectXJSON

Getting it running

Difficulty · easy Time to first run · 5min

Two parallel release builds exist and the right one depends on your GPU and Windows version, so picking the wrong zip is the main pitfall.

In plain English

Farever Minimap and DPS is an unofficial add-on for the PC game Farever, made by Shiro Games. It bundles three tools into one downloadable file: a minimap overlay, a damage meter, and a plugin system that lets other people write small Lua scripts to extend it. Players install it by dropping a file called dinput8.dll and a data folder next to the game's executable, which on Steam usually lives in Program Files (x86). There is no separate injector and uninstalling is just deleting those files. The minimap is a compass with a heading arrow, a world map underneath, and icons for points of interest the game already tracks like obelisks, respawn points, dungeons, and merchants. On top of that the add-on ships data for 821 collectible spawn points across the first world, split into chests, red orbs, plants, and ore nodes. These are off by default and toggled on from a bezel button. Right-clicking a chest or red orb marks it as done, with a counter showing how many remain, and the done list is saved to a JSON file between sessions. The DPS meter, short for damage per second, shows a live table of how much damage each of your skills is doing in the current fight, with the real in-game icons pulled out of the game files on the fly. It tracks combat state using the game's own flag, keeps a history of the last ten fights, and explicitly filters out damage done to you so the totals reflect only your outgoing damage. The window shrinks responsively, hiding columns as it gets narrower. The README gives two download choices. Version 0.5.5 is the current build with all features. Version 0.4.15 is a frozen older build kept around for users on certain older AMD cards or Windows versions where the newer rendering path does not work. Hotkeys F7 through F12 plus Home control the overlay and can be rebound from a settings window.

Copy-paste prompts

Prompt 1
Walk me through installing ramisotti13-eng/farever-minimap on a Steam install of Farever. List the exact files, the target folder, and how to confirm the overlay loaded.
Prompt 2
Write a Lua plugin for farever-minimap that plays a beep three seconds before any boss cast ends. Use the cast_start and cast_end events.
Prompt 3
I am on an older AMD card and v0.5.5 of farever-minimap does not bring the overlay up. Show me the v0.4.15 install steps and the .reg fix to try first.
Prompt 4
Explain how farever-minimap filters out incoming damage from the DPS meter and how I could extend it to track party damage too.
Prompt 5
Rebuild farever-minimap from source on Windows. List the toolchain, build steps, and where dinput8.dll ends up.
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.