ForgeMap

FR · La carte web en direct de ton monde Valheim, en français et en anglais, par ForgeServer.fr. Mod côté serveur uniquement : les joueurs n'installent rien, ils ouvrent un lien dans leur navigateur.

EN · A live web map of your Valheim world, in French and English, by ForgeServer.fr. Server-side only: players install nothing, they open a link in their browser.

ForgeMap is a fork of WebMap (MIT), with ForgeServer's look and a full French translation. Free, for the whole community.

---

Français

Ce que tu vois sur la carte

• La carte du monde avec le brouillard partagé : seulement ce que les joueurs ont exploré.
• Les joueurs en direct avec leur ping (vert, orange, rouge), leurs constructions, les portails, les bateaux, les charrettes, les tombes et les marchands.
• Les noms des lieux (îles, montagnes, lacs, rivières) et les chemins les plus pratiqués.
• Le monde en 3D : pose le petit bonhomme sur un endroit déjà parcouru, comme dans Street View ; Z Q S D sur un clavier français.
• Les pages Monde (records, terres, boss), Portails (l'atlas des portails), Joueurs et Plan (dessiner et partager des itinéraires).
• Le bouton FR / EN en haut à droite change la langue ; par défaut, celle du navigateur. Les objets, créatures et boss portent leurs noms officiels du jeu (« Armure d'écailles de fer », « L'Aîné », « Masse-d'Os »…).

La page Joueurs

• Le personnage en 3D avec son équipement, éclairé comme dans le jeu : tourne-le à la souris, agrandis-le en plein écran (molette pour s'approcher du visage).
• Le panneau d'équipement façon inventaire : pour chaque emplacement, un rendu 3D de l'objet, son nom et ses statistiques (armure, dégâts, blocage, poids, gain par niveau). Les étoiles de niveau réelles des armes, des objets dans le dos et de la cape (le jeu ne transmet pas le niveau des autres pièces au serveur).
• L'arme favorite et le temps passé en main, la classe du joueur (« Architecte rôdeur »…), le pentagone (explorateur, bâtisseur, survivant, tueur, récolteur) et des dizaines de statistiques : morts, distance, cuisine, constructions, danger par biome…
• La fiche joueur à partager : bouton Partager → un lien, le code pour l'intégrer à ton site (iframe) et une image PNG à télécharger. La fiche s'adapte aux petits cadres comme aux grands écrans.

Installation

1. Installe BepInExPack Valheim sur ton serveur dédié.
2. Copie le contenu de l'archive dans BepInEx/plugins/ForgeMap/ : les fichiers ForgeMap.dll et websocket-sharp.dll, et le dossier web.
3. Démarre le serveur, ouvre le port configuré (3000 par défaut) et va sur http://ip_du_serveur:3000.

La configuration est dans BepInEx/config/fr.forgeserver.forgemap.cfg (arrête le serveur avant de la modifier : BepInEx la réécrit à l'arrêt).

Tu es chez ForgeServer.fr ? Rien à faire : la carte s'installe en un clic depuis L'Atelier (onglet Mods, « Carte en direct »).

Tu viens de WebMap (ou de ForgeMap 1.0) ? Rien à faire, c'est automatique. Depuis la 1.1.0, ForgeMap est un mod à part entière (son propre identifiant et ForgeMap.dll). Au premier démarrage, il copie ta configuration WebMap (com.github.h0tw1r3.valheim.webmap.cfg) sous son nouveau nom, et, si son propre dossier map_data est vide, il copie celui de l'ancien WebMap (carte explorée, repères, noms des lieux, statistiques, modèles 3D) et announce.token. Les originaux ne sont pas touchés, et le journal du serveur dit ce qui a été copié. Supprime ensuite l'ancien WebMap.dll : les deux ensemble se disputeraient le port (le journal t'avertit s'il est encore là).

Textures haute qualité (facultatif)

Le serveur dédié n'exporte que la couleur des objets. Si tu possèdes le jeu, l'outil tools/textures-hd.py lit ta propre installation de Valheim (sans rien y modifier) et fabrique les vraies cartes du jeu : relief (normal maps), métal et brillance, lueurs. Copie le dossier obtenu sur le serveur dans map_data/models/hd/ : les ordinateurs affichent alors le personnage, les vignettes d'équipement et le monde 3D avec ces textures ; les téléphones gardent les textures légères. Rien n'est livré avec le mod (les textures appartiennent à Iron Gate) ; sans ce dossier, la carte fonctionne exactement comme avant. Mode d'emploi détaillé (en anglais) : README-WebMap.md, section « Full-quality textures ».

Pour l'admin du serveur

• Ping des joueurs : la carte reçoit le temps d'aller-retour de chaque joueur connecté vers le serveur, en millisecondes, moyenné sur une minute.
• Commandes du chat en français : !repère [type] [texte] pose un repère là où tu es (types : point, feu, mine, maison, grotte), !annulerrepère retire ton dernier repère, !supprrepère <texte> retire celui qui porte ce texte. Avec ou sans accents, majuscules ou non ; !pin, !undoPin et !deletePin marchent toujours.
• Mode léger pour les petits serveurs (2 à 4 Go) : light_mode = true dans la section [Performance] de la configuration (ou sur la page des réglages du site). Il coupe l'export des modèles 3D et la lecture des textures et maillages du jeu (les modèles déjà exportés restent affichés, les autres objets n'apparaissent pas en 3D), n'envoie à la vue 3D que les constructions et les lieux (ni arbres, ni rochers, ni buissons), garde 4 fois moins de terrain 3D en mémoire, limite render_size à texture_size et ne balaie le monde que toutes les 5 minutes au lieu de chaque minute. La carte 2D reste complète (brouillard, constructions, forêt, portails, joueurs, repères) ; ses couches de constructions et de forêt se rafraîchissent simplement moins souvent. Gain attendu : plus de pics de plusieurs centaines de Mo pendant l'extraction des textures et maillages, et quelques dizaines à une centaine de Mo de moins en continu sur un monde bien exploré.

---

English

What the map shows

• The world map with a shared fog of war: only what players have explored.
• Live players with their ping (green, orange, red), their builds, portals, ships, carts, graves and traders.
• Place names (islands, ranges, lakes, rivers) and the most walked trails.
• The world in 3D: drop the little figure on any walked spot, as in Street View.
• The World (records, lands, bosses), Portals (the portal atlas), Players and Plan (draw and share routes) pages.
• The FR / EN switch at the top right changes the language; the browser's by default. Items, creatures and bosses carry the game's own names in both languages.

The Players page

• The player in 3D with their gear, lit like the game: turn it with the mouse, enlarge it full screen (wheel to come closer).
• The gear panel, like an inventory: for each slot, a 3D picture of the item, its name and its stats (armour, damage, block, weight, gain per level), with the real star level of weapons, back items and cape (the game doesn't send the other pieces' level to the server).
• The favourite weapon and its share of hand time, the player's class, the pentagon (explorer, builder, survivor, slayer, harvester) and dozens of stats.
• A shareable player card: Share gives a link, the code to embed it in your site (iframe) and a PNG picture. The card fits small frames and big screens alike.

Install

1. Install BepInExPack Valheim on your dedicated server.
2. Copy the archive's content into BepInEx/plugins/ForgeMap/: ForgeMap.dll, websocket-sharp.dll and the web folder.
3. Start the server, open the configured port (3000 by default) and browse to http://server_ip:3000.

The configuration is BepInEx/config/fr.forgeserver.forgemap.cfg (stop the server before editing it: BepInEx rewrites it on shutdown).

Coming from WebMap (or ForgeMap 1.0)? Nothing to do, it is automatic. Since 1.1.0 ForgeMap is a mod of its own (its own GUID and ForgeMap.dll). On its first start it copies your WebMap configuration (com.github.h0tw1r3.valheim.webmap.cfg) under its new name and, when its own map_data folder is empty, copies the old WebMap's (explored map, pins, place names, stats, 3D models) and announce.token. The originals are left untouched and the server log says what was copied. Then delete the old WebMap.dll: both together would fight over the port (the log warns you while it is still there).

For the server admin

• Player ping: the map gets each connected player's round trip to the server, in milliseconds, averaged over a minute.
• French chat commands: !repère [type] [text] pins where you stand (types point, feu, mine, maison, grotte), !annulerrepère takes up your last pin, !supprrepère <text> the one with that text. Accents and case don't matter; !pin, !undoPin and !deletePin still work.
• Light mode for small servers (2-4 GB): light_mode = true under [Performance] in the config (or on the site's settings page). It turns off the 3D model export and reading the game's textures and meshes (models already exported are still drawn, other objects are left out of the 3D view), sends the 3D view buildings and locations only (no trees, rocks or bushes), keeps a quarter of the 3D ground in memory, caps render_size at texture_size and sweeps the world every 5 minutes instead of every minute. The 2D map stays complete (fog, builds, forest, portals, players, pins); its builds and forest layers just refresh less often. Expected saving: no more peaks of several hundred MB while textures and meshes are extracted, and some tens to a hundred MB less all the time on a well explored world.

The full documentation of every feature, route and setting (English) is in README-WebMap.md.

---

Credits / Crédits

• ForgeMap — French translation, ForgeServer look, player cards, gear, ping, light mode: ForgeServer.fr. Developed with the help of an AI (Claude, by Anthropic) / développé avec l'aide d'une IA.
• Based on WebMap — 1.0 update, structures, forest, portals, 3D and much more by Hunter Boyd; maintained upstream by Jeff Clark; original work by Kyle Paulsen
• The 3D view's model export, asset readers, world objects and sky are ported from f00d4tehg0dz/valheim-webmap (MIT)
• three.js r180 (MIT), vendored under web/vendor/three
• JetBrains Mono (SIL Open Font License 1.1), web/fonts
• websocket-sharp by sta.blockhead (MIT), websocket-sharp.dll
• Earlier WebMap versions' page background (tile.webp, no longer shipped) by webtreats, CC BY 2.0
• Item, creature and build piece names (EN/FR, web/js/lang/noms.js) are Valheim's own. Valheim is a trademark of Iron Gate AB; ForgeMap is a fan project, not affiliated with Iron Gate or Coffee Stain.

MIT licence: see LICENSE.