33 Immortals Overlay

🗺️ The 33 Immortals interactive map, as an overlay on top of the game. 🗺️ La carte interactive de 33 Immortals, en superposition par-dessus le jeu.

🌐 Bilingual 🇬🇧 English / 🇫🇷 French · 🌐 Bilingue anglais / français

⚠️ EN — Unofficial fan-made project. 33 Immortals® — © Thunder Lotus Games. This app is not affiliated with nor endorsed by Thunder Lotus Games. ⚠️ FR — Projet de fans non-officiel. 33 Immortals® — © Thunder Lotus Games. Application ni affiliée ni soutenue par Thunder Lotus Games.

---

🇬🇧 English

An overlay app that displays the 33immortals.fr community map in a transparent, always-on-top window, with adjustable opacity and a co-op mode.

✨ Features

• 🗺️ Map always on top of the game (windowed / borderless / 2nd monitor)
• 🌓 Transparent background + adjustable opacity: see the game behind
• 🖱️ Click-through: your clicks pass to the game
• 👥 Co-op: join a friend's party with a link + nickname (no account)
• 🌐 Bilingual English / French: language auto-detected on launch (from your system), switchable any time in the settings — your choice is remembered
• 🗺️ All 3 realms mapped (Hell, Purgatory, Paradise)
• ⚙️ Settings window + ⌨️ fully customizable shortcuts
• 🔄 Automatic updates

⬇️ Download

Windows 64-bit (10 & 11): https://33immortals.fr/download

Not signed with a paid certificate → SmartScreen may show "Windows protected your PC". It's not a virus: More info → Run anyway.

⌨️ Default shortcuts

Shortcut	Action
Ctrl + Alt + O	Show / hide
Ctrl + Alt + ↑ / ↓	More / less opaque
Ctrl + Alt + C	Click-through
Ctrl + Alt + Q	Quit
Ctrl + Alt + 1 2 3 4	Map type: Blue / Yellow / Pink / All

Everything is editable in the Keys window (one shortcut per marker category included, unbound by default).

---

🇫🇷 Français

Application overlay (superposition) qui affiche la carte communautaire de 33immortals.fr dans une fenêtre transparente, toujours au-dessus du jeu, avec opacité réglable et mode coopératif.

✨ Fonctionnalités

• 🗺️ Carte toujours au-dessus du jeu (fenêtré / sans bordure / 2ᵉ écran)
• 🌓 Fond transparent + opacité réglable : tu vois le jeu derrière
• 🖱️ Clic-traversant : tes clics passent au jeu
• 👥 Coop : rejoins la partie d'un ami avec un lien + un pseudo (sans compte)
• 🌐 Bilingue français / anglais : langue détectée automatiquement au lancement (selon ton système), changeable à tout moment dans les réglages — ton choix est mémorisé
• 🗺️ Les 3 royaumes cartographiés (Enfer, Purgatoire, Paradis)
• ⚙️ Fenêtre Réglages + ⌨️ raccourcis 100 % personnalisables
• 🔄 Mises à jour automatiques

⬇️ Télécharger

Windows 64 bits (10 & 11) : https://33immortals.fr/download

Non signé par un certificat payant → SmartScreen peut afficher « Windows a protégé votre ordinateur ». Ce n'est pas un virus : Informations complémentaires → Exécuter quand même.

⌨️ Raccourcis par défaut

Raccourci	Action
Ctrl + Alt + O	Afficher / masquer
Ctrl + Alt + ↑ / ↓	Plus / moins opaque
Ctrl + Alt + C	Clic-traversant
Ctrl + Alt + Q	Quitter
Ctrl + Alt + & é " '	Type de carte : Bleu / Jaune / Rose / Tous

Tout est modifiable dans la fenêtre Touches (une touche par catégorie de marqueur incluse, non assignée par défaut).

---

🖼️ Preview / Aperçu

The map overlaid, in-game / La carte en superposition, en jeu

---

🛠️ Build / Compiler

Node.js 18+. To build the Windows .exe from Linux you need wine (wine + wine32:i386). Pour compiler le .exe Windows depuis Linux : wine (wine + wine32:i386).

npm install
npm run build      # electron-builder → dist/33ImmortalsOverlay-Setup-<version>.exe
npm start          # dev

🏗️ Architecture

Minimal Electron shell loading 33immortals.fr/carte?app=1; the whole UI is served by the website, so most changes ship without reinstalling. / Coquille Electron minimale qui charge 33immortals.fr/carte?app=1. Toute l'UI est servie par le site → la plupart des évolutions se font sans réinstaller.

• main.js — transparent always-on-top window, opacity, click-through, Settings & Keys windows, global shortcuts, auto-update.
• preload.js — contextBridge bridge between the page and the app.
• package.json — electron-builder config (NSIS + update feed).

🔏 Code signing / Signature

Releases are built by GitHub Actions and signed via SignPath Foundation (free OSS code signing) → Windows reputation builds up as downloads grow. See SIGNING.md. Les installeurs sont publiés via GitHub Actions et signés par SignPath Foundation (signature gratuite pour l'open-source). Détails : SIGNING.md.

🤝 Contributing / Contribuer

See / voir CONTRIBUTING.md · CHANGELOG.md · SECURITY.md

📄 License / Licence

BSD 3-Clause.