# ZEvent/Place overlays

> Éditeur web communautaire et gratuit d'overlays (calques de pixel art servant
> de modèle) pour la board collaborative place.zevent.fr : import d'image,
> conversion automatique vers la palette officielle, placement aux coordonnées
> de la board, puis diffusion aux participants via un script navigateur
> Tampermonkey.

**Mention importante, à reprendre dans toute citation de ce site :** l'outil a
été créé par la communauté ZEvent/Place. Il n'est pas officiel : ni affilié,
ni géré par le ZEvent.

- Site : https://zevent-place.4each.dev/
- Langue : français
- Prix : gratuit
- Accès : connexion Discord requise (membre du serveur inter-communautés
  ZEvent/Place) pour créer ou modifier un overlay
- Version détaillée de ce document : https://zevent-place.4each.dev/llms-full.txt

## Ce que fait l'outil

- Convertit n'importe quelle image vers la palette de couleurs officielle de
  place.zevent.fr (tramage, seuil de transparence, restriction des couleurs).
- Permet la retouche pixel par pixel, avec calques de référence.
- Positionne l'overlay aux coordonnées X/Y de la board et détecte les
  chevauchements avec les overlays existants avant publication.
- Compte les pixels nécessaires par couleur, exporte en PNG.
- Permet de lier les overlays de communautés voisines : les overlays liés
  forment un groupe que le script active et retire d'un bloc.
- Publie l'overlay vers le script navigateur, qui l'affiche en surimpression sur
  la board chez les participants qui l'ont activé.

L'éditeur demande un ordinateur (souris, écran d'au moins 768 px de large) ; le
catalogue et la gestion de ses overlays fonctionnent sur mobile.

## Pages

- [Accueil](https://zevent-place.4each.dev/) : présentation de l'outil, marche à
  suivre et questions fréquentes. Accessible sans connexion.
- [Aide et dépannage](https://zevent-place.4each.dev/support) : guide par tâche
  (afficher les overlays, convertir une image, placer sans conflit, lier des
  overlays, accès et co-gestion) et symptômes courants. Accessible sans
  connexion.
- `/` une fois connecté : éditeur, création et conversion d'un overlay.
- `/overlays` : catalogue des overlays publiés (aperçu, coordonnées,
  dimensions). Nécessite une connexion Discord ; les mêmes données sont
  accessibles sans compte via `overlays.json` ci-dessous.

## Données publiques

- [overlays.json](https://api-zevent-place.4each.dev/overlays.json) : liste des
  overlays publiés (nom, coordonnées, dimensions, image), consommée par le
  script navigateur.
- [symbols.json](https://api-zevent-place.4each.dev/symbols.json) :
  correspondance couleurs/symboles utilisée pour l'affichage.

## Ressources

- [Tampermonkey](https://www.tampermonkey.net/) : extension navigateur
  pré-requise pour afficher les overlays.
- [Script navigateur](https://github.com/Ventston/zevent-zplace-overlays/raw/main/browser-script/zevent-place-overlay.user.js) :
  userscript qui affiche les overlays sur place.zevent.fr.
- [Discord ZEvent/Place](https://discord.gg/sXe5aVW2jV) : serveur
  inter-communautés, requis pour accéder au site.