🇬🇧 English version

🗺️ SharedAtlasJM

JourneyMap Add-on — Shared Exploration for NeoForge 1.21.1

Explore together and see the areas discovered by other players directly on your JourneyMap.

SharedAtlasJM is a JourneyMap add-on that shares explored chunks between players on the same server.

When a player discovers an area, the server stores the chunk and sends the information to the other players. On JourneyMap, explored areas appear as colored chunks, with a different color for each explorer.

✨ Features

🟩 Shared exploration
Chunks explored by one player can be seen by other players using the mod.

🎨 Different color for each player
Each player receives a unique color, making it easy to identify who explored an area.

🖱️ Hover information
Hover over a colored chunk to see:

Explored by: PlayerName

🔘 JourneyMap add-on button
A button in the JourneyMap add-on controls lets players enable or disable the colored chunk overlay.

🌫️ Adjustable opacity
Change the overlay transparency to keep the map clear and readable.

🌍 Dimension support
Exploration data is separated by dimension: Overworld, Nether, End, and modded dimensions.

⚡ Lightweight synchronization
The mod only shares:

dimension;
chunk coordinates;
explorer name;
assigned player color.

No map images, JourneyMap cache files, or screenshots are transferred.

🚀 Optimized for reduced lag
Data is sent in batches and the overlay refresh is limited to reduce client and server lag, especially after teleports.

📦 Required Dependencies

SharedAtlasJM is an add-on and does not work by itself.

Required on clients

Every player needs:

Minecraft 1.21.1
NeoForge 21.1.x
JourneyMap for NeoForge 1.21.1
JourneyMap API for NeoForge 1.21.1
SharedAtlasJM

Required on servers

The server needs:

NeoForge 21.1.x
SharedAtlasJM

⚠️ JourneyMap is not required on the server. It is required on clients to display the map and overlay.

📥 Installation

Server

Place the SharedAtlasJM .jar file in:

server/mods/

Players

Every player must place the required mods in:

.minecraft/mods/

Example:

mods/
├── journeymap-neoforge-1.21.1.jar
├── journeymap-api-neoforge-1.21.1.jar
└── sharedatlasjm.jar

⚠️ Every player must use the same SharedAtlasJM version as the server.

🎮 How It Works

A player enters a chunk.
The server records the chunk as explored.
The server shares the information with other players.
JourneyMap displays the chunk as a colored overlay.
Players can hover over the chunk to see who explored it.

⚙️ JourneyMap Options

From the JourneyMap Add-ons section, players can:

🔘 enable or disable the SharedAtlasJM overlay;
🌫️ change the colored chunk opacity;
🖱️ see the explorer’s name by hovering over a chunk.

ℹ️ Important

SharedAtlasJM displays a shared exploration overlay on JourneyMap.

It does not transfer terrain images or JourneyMap’s internal cache. This keeps the mod lightweight, stable, and suitable for multiplayer servers.

🗺️ SharedAtlasJM

Add-on JourneyMap — Exploration partagée pour Minecraft NeoForge 1.21.1

Explorez ensemble. Voyez les zones découvertes par les autres joueurs directement sur votre carte JourneyMap.

SharedAtlasJM est un add-on pour JourneyMap qui permet de partager l’exploration des chunks entre tous les joueurs d’un serveur.

Quand un joueur découvre une zone, le serveur l’enregistre puis l’envoie aux autres joueurs. Sur JourneyMap, les zones apparaissent sous forme de chunks colorés, avec une couleur différente selon le joueur qui les a explorés.

✨ Fonctionnalités

🟩 Exploration partagée
Les chunks visités par un joueur sont visibles par les autres joueurs équipés du mod.

🎨 Couleur différente par joueur
Chaque joueur possède une couleur propre pour identifier rapidement qui a exploré chaque zone.

🖱️ Informations au survol
Passez la souris sur un chunk coloré pour voir :

Exploré par : NomDuJoueur

🔘 Bouton directement dans JourneyMap
Un bouton dans les add-ons JourneyMap permet d’activer ou désactiver l’affichage des chunks colorés.

🌫️ Opacité réglable
Modifiez la transparence de l’overlay selon vos préférences afin de garder la carte lisible.

🌍 Compatible avec les dimensions
L’exploration est séparée selon les dimensions : Overworld, Nether, End et dimensions ajoutées par les mods.

⚡ Synchronisation légère
Le mod partage uniquement :

la dimension ;
les coordonnées du chunk ;
le joueur qui l’a exploré ;
la couleur associée.

Aucune image de carte, aucun cache JourneyMap et aucune capture d’écran ne sont envoyés sur le serveur.

🚀 Optimisé pour limiter le lag
Les données sont envoyées par groupes et l’overlay est rafraîchi de façon limitée pour réduire les ralentissements, notamment après les téléportations.

📦 Dépendances requises

SharedAtlasJM est un add-on, il ne fonctionne pas seul.

Obligatoire côté client

Les joueurs doivent avoir :

Minecraft 1.21.1
NeoForge 21.1.x
JourneyMap pour NeoForge 1.21.1
JourneyMap API pour NeoForge 1.21.1
SharedAtlasJM

Obligatoire côté serveur

Le serveur doit avoir :

NeoForge 21.1.x
SharedAtlasJM

⚠️ JourneyMap n’est pas obligatoire sur le serveur. Il est nécessaire sur les clients pour afficher la carte et l’overlay.

📥 Installation

Serveur

Placez le fichier .jar de SharedAtlasJM dans :

serveur/mods/

Joueurs

Chaque joueur doit placer les mods requis dans :

.minecraft/mods/

Exemple :

mods/
├── journeymap-neoforge-1.21.1.jar
├── journeymap-api-neoforge-1.21.1.jar
└── sharedatlasjm.jar

⚠️ Tous les joueurs doivent utiliser la même version de SharedAtlasJM que le serveur.

🎮 Comment ça fonctionne ?

Un joueur entre dans un chunk.
Le serveur enregistre ce chunk comme exploré.
Le serveur partage cette information avec les autres joueurs.
JourneyMap affiche le chunk sous forme de zone colorée.
En survolant la zone, les joueurs peuvent voir qui l’a explorée.

⚙️ Options JourneyMap

Depuis la section Add-ons de JourneyMap, vous pouvez :

🔘 activer ou désactiver l’overlay SharedAtlasJM ;
🌫️ modifier l’opacité des chunks colorés ;
🖱️ afficher le nom du joueur ayant exploré une zone en passant la souris dessus.

ℹ️ Important

SharedAtlasJM affiche une overlay d’exploration partagée sur JourneyMap.

Il ne partage pas les images de terrain ni le cache interne de JourneyMap. Cela permet de conserver un fonctionnement beaucoup plus léger, stable et adapté aux serveurs avec plusieurs joueurs.