EUREKA(6)

💖 EUREKA — a DOOM map editor, bestie 💖

okay so this is eureka(6) from the Games Manual, and it's literally the moment your map-editing era begins. no cap.

---

✨ NAME ✨

Eureka — a DOOM map editor. yes that's it, that's the whole vibe. 💅

---

🦋 SYNOPSIS 🦋

eureka [FILE...]  [OPTION...]

---

🌸 DESCRIPTION 🌸

Eureka is a cross-platform map editor for the classic DOOM games. cross-platform?? we love a queen who works everywhere. 👑

She comes with:

• multiple-level undo and redo (iconic, essential, no notes)
• a 3D preview 🎀
• texture and thing browsers
• a built-in nodes builder
• panels for directly editing the properties of map objects
• a flexible key binding system
• low system requirements — like, a 3D card is not required. she runs on anything. low maintenance queen fr fr 💜

---

🌈 OPTIONS 🌈

bestie, quick heads up: long options are shown here with two dashes, but they may also be used with a single dash for compatibility with the original DOOM binary and various source ports. so --file and -file? both valid. iykyk.

• -f, --file <file>... — Wad file(s) to edit. this one is mainly for compatibility with DOOM command-line syntax, since honestly filenames are way easier to just hand over without this option (i.e. directly after the program name). When no file is specified, Eureka will open the first map in the IWAD (game wad). 🙈
• -w, --warp <map> — Level to edit. this can be the full map name, e.g. "MAP12" or "E3M7", but can also be a single number like "12" or "37", or two separate numbers like "3 7" for compatibility with DOOM 1 and Ultimate DOOM. When absent, the first level found in the edited wad is used. 🗺️
• -i, --iwad <file> — The name of the IWAD (game data). this also determines which game the map is for, e.g. "doom.wad" will mean the map is for DOOM 1, whereas "heretic.wad" will mean we are editing for the game Heretic. she's flexible like that. 💖
• -m, --merge <file>... — Resource file(s) to load. these can be wad files containing textures, flats, sprites (etc) but can also be Eureka definitions files (with .ugh extension). 🧚
• -p, --port <name> — Port (engine) name. the default port is "boom", but some other supported ports are "vanilla" (the original EXE), "odamex", "edge" and "legacy". pick your fighter. 🔥
• -h, --help — Show usage summary 📖
• -v, --version — Show the version 🎀
• -d, --debug — Enable debugging messages 🐛
• -q, --quiet — Quiet mode (no messages on stdout) 🤫

---

💅 CONFIGURATION OPTIONS 💅

these next ones control how Eureka finds some important files and directories. ngl they're not particularly useful per se, but they may be needed for special circumstances. situational icons only. ✨

• --install <dir> — The installation directory where game definition files, default key bindings, etc are stored. this defaults to $PREFIX/share/eureka (see FILES section below...). Specifying "." for the current directory is useful when testing a locally compiled version without doing "make install". In fact Eureka will try it automatically when it cannot find its normal installation directory. she's proactive like that 💜
• --home <dir> — The home directory where user settings, backups, etc are stored. this defaults to the ~/.config/eureka directory on Linux. 🏠
• --log <file> — File where all log messages are written. defaults to "logs.txt" under the home directory. 📝
• --config <file> — The config file which stores the general user settings (but not key bindings). this file will loaded during startup, and also saved to when the user uses the Preferences dialog. 🎀

---

🍓 FILES 🍓

• $PREFIX/share/eureka/ — The installation directory for Eureka. PREFIX is typically /usr or /usr/local, depending on how Eureka was installed. this directory contains the standard key bindings, plus all the definition files (with .ugh extension) for the supported games, ports and mods. 🦋
• ~/.config/eureka/config.cfg — Contains user settings ⚙️
• ~/.config/eureka/bindings.cfg — Contains user key bindings ⌨️
• ~/.config/eureka/logs.txt — The logs from the previous session of Eureka, or the current one if Eureka is currently running. 📜
• ~/.cache/eureka/backups — Whenever a file is saved, Eureka makes a backup of the existing file and stores it here, in a directory based on the filename. Multiple backups are made, up to a configurable limit on number and total size of the files.

bestie if something goes awry with your wad, LOOK HERE. seriously. this folder is your safety net and she ate. 🫶

• ~/.config/eureka/iwads — IWAD files can be placed here and Eureka will find them automatically 🔍

---

🌟 ENVIRONMENT 🌟

• DOOMWADDIR — If set, contains a single directory name where Eureka will look for IWADs. 1️⃣
• DOOMWADPATH — If set, contains a colon-separated list of directories where Eureka will look for IWADs. 🛣️

---

👑 SEE ALSO 👑

glbsp(6), prboom(6), deutex(6), xwadtools(6) — go read those too, they're part of the family. 💖

Eureka site: http://eureka-editor.sourceforge.net/ 🌐

---

okay that's the whole page, you're fully caught up, main character energy unlocked 🔥 this was the EUREKA(6) page from the Games Manual, dated August 2018 — mwah, go make something iconic. 💅✨🎀