explaingit

ramisotti13-eng/farever-minimap

Analysis updated 2026-06-24

15Audience · generalComplexity · 2/5Setup · 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
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

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.

What is it built with?

C++LuaImGuiDirectXJSON

How does it compare?

ramisotti13-eng/farever-minimap13127905/deep-learning-based-air-gesture-text-recognition-6xvl/paralives-plugins-index
Stars151515
LanguagePythonPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

Frequently asked questions

What is farever-minimap?

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.

How hard is farever-minimap to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is farever-minimap for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.