Skip to content

About

Unofficial companion for Hell Is Us on PC: minimap, quest guide, puzzle answers and single-player cheats — in the game's 12 languages, no game files modified

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

hiumod — a companion for Hell Is Us

▶ The 31-second introduction: the world becomes a minimap, the quest tracker follows the story, a vault answer is revealed, twelve languages

▶ Watch the introduction (WebM, 31 s, silent) · MP4

A live minimap, a quest tracker and story guide, every vault and puzzle answer, and collectible checklists for Hell Is Us on PC — plus a few single-player cheats. It runs beside the game and reads its memory. No game files are modified.

CI Release Steam build Languages License

Website · Download · Changelog

Read about it in your language: 한국어 · 日本語 · 简体中文 · Deutsch · Français · Español · Italiano · Polski · Português (Brasil) · Русский · Türkçe

Unofficial fan-made tool. Not affiliated with or endorsed by Rogue Factor or Nacon. Requires a legitimately purchased copy of the game; this repository contains no game code, text or assets. Steam achievements are not blocked. Cheats can corrupt your save, so back it up first. Provided as is, with no warranty. See NOTICE.

Quick start

  1. Download hiumod-<version>.zip from Releases and unzip it anywhere. It only ever writes to <game folder>\Mods\.
  2. Run hiumod.exe. It starts the game through Steam if needed, attaches once you are in, and closes when the game does. Play windowed or borderless.
  3. Press ` (left of 1) for the panel. The first time you control the hero, it reads the game's maps and text by itself (about two minutes). That needs the .NET 8 runtime; if it's missing, the panel offers to install it — through winget, or without administrator rights into the game's Mods folder if winget can't.

Status: attaches to Steam build 24045435, where doctor passes every check. Twelve cheats are verified in play; the three not yet tried say unverified in the panel until someone confirms them (see CHEATS.md).

What it does

Hell Is Us has no map, no compass and no quest markers by design. hiumod puts them back for the nights you want them — and every answer starts hidden.

Minimap and big map Walls and floors from the level's geometry, shaded terrain and contours, floors above and below faded, your trail, 26 kinds of icons and 24 kinds of pins you place yourself
Compass and guide Works the next goal out from what your save knows and what each place still holds, then routes there along the game's own navmesh, with distance and height
Quest tracker Main quests, good deeds, mysteries and timeloops by their real names; what the followed quest still needs; good deeds you can still miss, and before when
Vaults and puzzles Every dial, keypad and item placement, and the six Vaults of Forbidden Knowledge drawn as the game's own symbols — each behind Show answer
Collect Collectibles per region, enemy groups left for the every-Hollow achievement, NPCs with more to tell, Steam achievements with progress
Saves Each game save copied to Mods\backups (the last 20)
Cheats Health, stamina, Lymbic energy, speed, time scale, frail enemies, no fall damage, consumables, weapon XP, saved positions — off until switched on, put back when switched off
Filming The hero walked along the guide's route, your points, a recording of your own walk or a tour of the world, or the camera flown alone as a drone — directed shot by shot, the hero kept out of the frame and put back after

Every overlay hides while a game menu is open.

Keys

Key
` show or hide the panel
Ctrl + ` open or close the console (for checking things)
F2 minimap → big map → off
F3 compass
F4 guide to the next goal
F5 place or remove a pin
F8 start or stop a take (filming)
Ctrl + F8 add or remove a filming point where you stand
Ctrl + Shift + F8 start or stop recording your own way

The function keys can be changed on the panel's Map page. The game's own F1 (HUD) and F7 (photo mode) and Steam's F12 (screenshot) are left to them: the panel does not offer them.

Languages

The mod speaks the game's language. It follows the game's own text setting in all twelve languages the game ships — English, Korean, Japanese, Simplified Chinese, German, French, Spanish, Italian, Polish, Brazilian Portuguese, Russian and Turkish — and takes the names of places, people and items from the game's translations on your machine. Each language had a native-speaker pass against the game's own terms.

Command line

hiumod doctor          # checks everything, writes nothing — load a save first
hiumod doctor survey   # the guide's data from your game files (the panel does this itself)
hiumod hold god stamina speed=1200  # until Ctrl+C, then puts things back
hiumod restore         # if a hold or a take was killed rather than stopped
hiumod rescue          # the hero out of the ground after a take that ended badly
hiumod help            # every command

The same commands work in the panel's console.

How it finds its way in

The tool stores no offsets. Each time it attaches:

  1. It scans the game image's writable data for the engine's name pool and for GEngine. Each must turn up exactly once.
  2. It reads the engine's own reflection to learn the path to the player: GameInstance → LocalPlayers[0] → PlayerController → Pawn, then the pawn's AbilitySystemComponent → SpawnedAttributes.
  3. It finds each attribute by the game's own name, such as EnduranceCap or LymbicEnergy.

So a Steam patch only breaks something when it renames something, and doctor says which name went missing.

Safety rules the code keeps

  • The hero gate. Nothing is written unless the controlled pawn is the hero, a CharlieCharacterHero. Loading screens, menus and cinematics close the gate; held cheats pause while it is closed rather than being dropped.
  • Every write lands on an attribute or nowhere. An attribute must be declared 16 bytes (an FGameplayAttributeData) and start with the vtable all attributes share, inside the game image.
  • Originals go to disk first. originals.txt is written before anything is overwritten. Switching off, closing the panel or running restore puts them back.

Building

cargo test                       # unit and integration tests, no game needed
cargo build --release
powershell tools/package.ps1     # dist\hiumod-<version>.zip: the exe, the survey tool, the documents
python tools/site/build.py       # the website in docs/ (GitHub Pages: main /docs)

The survey tool (tools/survey, C# with CUE4Parse) needs the .NET 8 SDK to build.

Releasing. Rename the newest CHANGELOG.md heading from Unreleased — X.Y.Z to X.Y.Z, set the same version in Cargo.toml, then git tag vX.Y.Z && git push origin vX.Y.Z. release.yml checks that the three agree, builds the zip on Windows, checks that nothing from the game is in it, and publishes it with the verified Steam build, install steps, the changelog section and a SHA-256.

Documentation

Document What it settles
CHANGELOG.md what each release changed, and the game build it was verified on
.spec/PLAN.md what this is, the phases, and what each one attaches to
.spec/ANCHORS.md how the tool finds its way in, and what a game update can break
.spec/CHEATS.md the cheats, what each writes, and what "verified" means
.spec/ handoff documents in Korean: status, procedures, structure, decisions, research, the website

FAQ

Is there a map in Hell Is Us? No. By design the game has no map, compass or quest markers. hiumod adds an optional minimap overlay and a quest tracker on PC.

Can I get banned? Hell Is Us is single-player with no anti-cheat and no online play, and hiumod changes no game files. As with any third-party tool, use it at your own discretion.

The game updated and something broke. Run hiumod doctor; it names anything that moved. Run doctor survey again for the guide's data, and open an issue with the doctor output if it stays broken.

License

Code under the MIT license; bundled third-party material in THIRD-PARTY.md. Hell Is Us is a trademark of its owners.

About

Unofficial companion for Hell Is Us on PC: minimap, quest guide, puzzle answers and single-player cheats — in the game's 12 languages, no game files modified

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages