==============================================
  FRESH INK  —  v2.0
  Every cartographer map is one of a kind
  Minecraft Java 26.3
  (for 26.1 – 26.2, use Fresh Ink v1.2)
==============================================

WHAT IT DOES
In vanilla, a cartographer draws each explorer map only once,
then keeps selling you copies of that exact same map. With
Fresh Ink, every map you buy (jungle, swamp, all 5 village
types, ocean monument, trial chambers, woodland mansion) is
charted at the moment of purchase, toward a random spot up to
~2,800 blocks around you. Buy two maps, get two different
destinations. Vanilla prices, trade levels and quantities are
fully preserved.

HOW IT WORKS
The cartographer sells a "sealed map" (since 26.3 each explorer
map is its own item, so the sealed map already has the right
icon and name: Jungle Pyramid Map, Swamp Hut Map, Ocean Monument
Map, Buried Trial Chambers Map, Woodland Mansion Map, and the
five village maps). The instant it enters your inventory, the
pack swaps it for a freshly generated explorer map — with a
sound cue and an action bar message.
Sealed maps don't stack, so bulk buying (shift-click) safely
stops when your inventory is full. If no destination can be
found nearby, the sealed map is kept and retried automatically
30 seconds later.
The pack also remembers every destination it has handed out.
Should the game return a destination that was already sold
(this can happen when several maps are bought within the same
second on some modded setups), that map is discarded and
charted again from another spot 2 seconds later (up to 3 times),
so two maps never point to the same place.

LANGUAGE / LANGUE
Map names follow each player's own game language automatically
(vanilla translation keys). The pack's messages are in English
by default; to switch them, run in chat (operator/cheats
required, like /reload):
    /function fresh_ink:lang/fr      -> messages en français
    /function fresh_ink:lang/en      -> messages in English
The choice is saved per world. The sealed map's tooltip is
bilingual (EN + FR) by design.
--
Les noms des cartes suivent automatiquement la langue du jeu
de chaque joueur. Les messages du pack sont en anglais par
défaut ; tapez /function fresh_ink:lang/fr pour les passer en
français (droits opérateur requis). Choix mémorisé par monde.

INSTALLATION
1. Open Minecraft, select your world > "Edit".
2. Click "Open World Folder", then open "datapacks".
3. Drop this .zip inside (do not unzip it).
4. IMPORTANT: quit and re-open the world. A simple /reload is
   NOT enough — trade changes only load at world startup.
5. On loading, Minecraft shows an "experimental settings"
   warning: this is normal (the game classifies any villager
   trade modification this way). Click through to continue.
A cyan chat message confirms activation.

New world: use the "Data Packs" button on the create screen.
Server: put the .zip in world/datapacks/ and restart the server.

EXISTING WORLDS & VILLAGERS
Perfectly safe to add mid-playthrough: no terrain or world
generation is touched. Cartographers that already unlocked map
offers before the pack was active (Expert, Master...) are
converted too: every 5 seconds, any loaded cartographer whose
offer sells an already-charted vanilla explorer map gets that
offer turned into a sealed map. Price, remaining uses and XP of
the offer are kept. So from the moment the pack is active, every
map bought from any cartographer, old or new, is one of a kind.

Upgrading a world from Fresh Ink v1.x (26.1/26.2): nothing to
do. Sealed maps bought under v1.x, whether still in a chest or
still offered by an old cartographer, are recognised and
exchanged for the new 26.3 explorer map items as usual.

TROUBLESHOOTING / DEPANNAGE
When you join the world, a cyan "[Fresh Ink] v2.0 for Minecraft
26.3 is active" message appears once. If you never see it, the
pack is not loaded:
- Make sure only ONE Fresh Ink zip is in the datapacks folder.
  An old v1.x zip cannot load on 26.3 and makes the game offer
  "Safe Mode"; loading in safe mode disables the packs AND
  remembers that choice for the world. Fix: delete the old zip,
  then Edit world > Data Packs and move Fresh Ink back to the
  "Selected" side (or run /datapack enable "file/<zip name>"),
  then quit and re-open the world.
- /datapack list must show the pack as enabled.
- ANY other data pack that fails to load on 26.3 also triggers
  Safe Mode and disables Fresh Ink with it. Look in
  logs/latest.log for "Failed to parse ... from pack file/<name>"
  and update or remove that pack.
- A cartographer's map offers must show a gold star (sealed
  map) within 5 seconds of being near you; the map is replaced
  the moment it enters your inventory (sound + action bar
  message).
--
Un message cyan "[Fresh Ink] v2.0 pour Minecraft 26.3 activé"
apparaît une fois quand vous rejoignez le monde. Sans ce message,
le pack n'est pas chargé : un seul zip Fresh Ink dans le dossier
datapacks (un ancien zip v1.x fait proposer le "mode sans échec",
qui désactive les packs et le mémorise pour le monde : supprimez
l'ancien zip, puis Modifier le monde > Packs de données, remettez
Fresh Ink à droite, quittez et rouvrez le monde). Tout autre datapack
qui échoue à charger en 26.3 déclenche aussi le mode sans échec
(voir logs/latest.log : "Failed to parse ... from pack file/...").
Les offres de cartes d'un cartographe doivent afficher une étoile
dorée (carte scellée) dans les 5 s.

GOOD TO KNOW
- Worlds using this pack cannot be uploaded to Realms (a
  Minecraft rule for any pack that edits villager trades).
- Generating a map may freeze the game for a split second:
  that's the structure search, same as vanilla when a
  cartographer levels up. Bulk purchases convert one map
  per game tick to spread the load.
- Uninstall: delete the .zip from datapacks and restart the
  world. Note: cartographers that unlocked sealed-map offers
  while the pack was active will keep selling an inert
  souvenir map in those slots — harmless, but pointless.

CHANGELOG
v2.0 - Minecraft 26.3 (data pack format 121). Maps are checked
       against the destinations already handed out and re-charted
       if needed (guards against rapid-purchase duplicates on
       modded setups). Cartographers that
       already unlocked vanilla map offers are now converted too
       (offers rewritten as sealed maps, price/uses/XP kept). Added
       a one-time "[Fresh Ink] v2.0 ... active" message when a
       player joins, and a troubleshooting section in this file. Explorer maps are
       now distinct vanilla items (jungle_pyramid_map, swamp_hut_map,
       ocean_monument_map, buried_trial_chambers_map,
       woodland_mansion_map, *_village_map): sealed maps and the
       maps charted by the pack use them, so icons and names match
       vanilla. Loot tables and trade files moved to the 26.3
       format; the ocean monument and trial chambers trade files
       follow the new vanilla names so the vanilla offers are
       properly replaced. Sealed maps from v1.x are still redeemed.
v1.2 - Added language selector for the pack's messages:
       /function fresh_ink:lang/fr and /function fresh_ink:lang/en
       (saved per world). Sealed map tooltip is now bilingual.
v1.1 - Fixed bulk buying: sealed maps no longer stack, can no
       longer turn into regular blank maps, and purchases are
       never lost when the inventory is full (the sealed map
       is refunded and retried automatically).
     - Clarified install steps (world restart required) and
       added notes for existing worlds and villagers.
v1.0 - Initial release.

SUGGESTED DESCRIPTION FOR YOUR PACK PAGE
"Tired of cartographers selling you the same map over and
over? Fresh Ink makes every explorer map one of a kind:
each purchase charts a brand-new destination on the spot.
All 10 map trades supported, vanilla prices untouched,
survival-friendly, zero commands needed. English & French.
Drop it in your datapacks folder and start collecting."

Author: MrReLaX
