Mod 1.0.0 · protocole v5 · Minecraft 26.3

#1. Démarrage

#Installation

• Fabric Loader 0.19.5 + Fabric API.
• Copier buildedit-*.jar dans .minecraft/mods.

#Modes de fonctionnement

#Rendu à l'écran

• pos1 = contour magenta · pos2 = contour cyan.
• Sélection = contour jaune (visible à travers les blocs) + fond teinté.
• Après chaque opération : message gris (action, blocs modifiés, compteurs annuler/rétablir).

#2. Aide-mémoire des touches

Toutes modifiables : /be config → Touches (barre de recherche : nom de l'action ou de la touche, sans casse ni accents), ou Options → Commandes → BuildEdit.

#Général

#Mode Editor

#Non assignées par défaut

Touche par outil, par capacité, par élément du menu contextuel · pivot d'orbite · opérations de sélection (agrandir, réduire, lisser, inverser, non-air).

#3. Mode Builder : le 10e slot

Une case supplémentaire apparaît à droite de la hotbar quand BuildEdit est actif. Elle contient l'outil courant.

Sur le 10e slot, les clics vanilla sont remplacés par ceux de l'outil. La sélection (pos1/pos2) est partagée entre tous les outils.

#Outils

#Détails

• Move / Clone / Stack : aperçu en blocs fantômes + cadre vert. Au-delà de la limite de fantômes (20 000 par défaut), cadre seul.
• Smear : ne remplace que l'air ; un bloc solide coupe la traînée.
• Extrude : agit sur les blocs identiques connectés dont la face visée est exposée (max 4096) ; zone en surbrillance verte.
• Symmetry : G = miroir X (rouge) / Z (bleu), R = rotation ×1 → ×2 → ×4 (vert). Nœud jaune = centre, orange = arête.
  • Reste active hors du 10e slot : chaque bloc posé, cassé ou activé (porte, levier…) est reproduit.
  • Blocs doubles gérés (portes, lits, plantes hautes). 1 action = 1 annulation.

#4. Capacités

Activées dans le menu Alt (rangée Capacités, clic = bascule, vert = active), ou depuis le menu Capacités de l'Editor. Elles agissent partout, même hors du 10e slot. Les capacités actives s'affichent à droite du 10e slot.

• Annulables (Ctrl+Z) : Bulldozer, Remplacement, Pose dans le vide, Bricolage.
• Priorité au clic D : Bricolage → Remplacement → Pose dans le vide (Remplacement actif + bloc en main = Pose dans le vide inactive).
• Ctrl+clic molette (créatif, jeu) : copie le bloc visé en main avec ses propriétés (orientation, état… ; sauf la moitié/partie des portes, plantes hautes et lits, pour que la pose reste correcte) en plus de son contenu (coffre, panneau…) (solo + serveur).

#5. Presse-papier & Placement

#Pendant le Placement

Le presse-papier est perdu à la fermeture du jeu.

#6. Mode Editor

Maj droite = entrer / sortir. Le monde reste visible, la souris est libre. À l'entrée : vol + Sans collision activés.

#6.1 Navigation

• ZQSD / Espace / Maj : se déplacer et voler.
• Clic D maintenu : tourner la vue.
• Clic molette maintenu : orbiter autour d'un pivot ; Z/S = rapprocher / éloigner.
• Pivot : bloc visé ou centre de la sélection (menu Affichage).

#6.2 Interface

Barre de menus

Fenêtres

• Déplacer : glisser la barre de titre · Redimensionner : coin bas-droit · Fermer : ×.
• Ancrer : lâcher contre le bord gauche/droit. Glisser le titre = détacher.
• Onglets : lâcher sur le titre d'une fenêtre ancrée. Clic = afficher, glisser = détacher. Onglets et onglet affiché gardés après avoir quitté.
• Croix de visée, hotbar, 10e slot, barres (vie, faim, XP…), barre de localisation (points des joueurs), écran F3 (même persistant) et contour du bloc visé masqués dans l'Editor.
• Hauteur des fenêtres ancrées : glisser la séparation entre deux fenêtres (trait orange au survol) ; sauvegardée.
• Saisie directe : clic sur une valeur (case grise entre le libellé et − / +) = la taper, Entrée ou clic ailleurs = valider, Échap = annuler ; listes ◀ ▶ (biome, tag, profil, forme…) : clic sur le nom = taper le début / une partie du nom. Boutons − / + : Maj = ×10.
• Disposition sauvegardée.

Liste : Outils · Sélection · Presse-papier · Blocs · Opérations · Palette · Terrain · Infos du bloc · Historique · Brosse · Masques · Blueprints · Forme · Chemin · Fichiers · Modelage · Texte · Tampon.

#6.3 Sélection

Outils (Cuboïde, Baguette, Pinceau, Lasso : fenêtre Sélection, avec leurs réglages et le mode de combinaison ; les autres : fenêtre Outils ; clic G dans le monde)

Combinaison : sans touche = remplacer · Maj = ajouter · Ctrl = retirer · Maj+Ctrl = intersection.

Forme libre : sélection bloc par bloc (faces jaunes, max 2 000 000). Toutes les opérations ne touchent que les blocs sélectionnés. pos1/pos2 repassent en cuboïde.

Opérations de sélection : Agrandir / Réduire de N (1–32) · Lisser · Inverser · Non-air uniquement.

#6.4 Gizmos

Mode : menu Gizmo, fenêtre Outils ou Tab. Couleurs : X rouge · Y vert · Z bleu · survol blanc · actif orange.

• Manipuler : glisser au clic G (1 bloc / 15°, Maj = 45°), ou clic sur une poignée puis molette.
• Coller (Ctrl+V) : collage figé à l'endroit visé, ajusté par les gizmos ; Entrée = coller.

#6.5 Blocs & Palette

Blocs — choisir le bloc actif de l'Editor (indépendant de la main).

• Champ Rechercher… (nom ou identifiant ; Entrée/Échap = fin de saisie).
• Grille : clic = bloc actif, molette = défiler. Air en premier.

Palette — groupes nommés de blocs, sauvegardés.

• ◀ ▶ = changer de groupe · champ = renommer · + Groupe · Suppr. · + Actif.
• Grille : clic = bloc actif · Maj+clic = retirer · Ctrl+clic = avancer d'un rang.
• Remplir (mélange) : remplit la sélection au hasard avec le groupe.
• Ordre du groupe = du plus clair au plus sombre (pour Autoshade).

Glisser-déposer

• Blocs → Palette = ajouter (repère bleu).
• Palette → Palette = déplacer · Palette → dehors = retirer.
• Bloc → lignes Source / Actif des Opérations = les régler.

#6.6 Opérations

Source = bloc à remplacer · Actif = bloc posé (⇅ = échanger).

Chaque opération = une entrée d'historique.

#6.7 Terrain

#6.8 Peinture (Brosse & Masques)

Outil Peinture de la fenêtre Outils.

• Survol : fantôme des blocs qui seront peints.
• Clic G maintenu + glisser : tracer (blocs effacés = verre rouge).
• Relâcher = appliquer (1 trait = 1 annulation) · Échap = abandonner.
• Les blocs touchés prennent le bloc actif ou un mélange de la Palette.
• Non-air seul (défaut oui, modes Peintre / Bruit / Dégradé) : sur non, la brosse pose aussi dans l'air.

Fenêtre Brosse (sections, molette = défiler) : Mode (boutons, groupes Peinture / Dessin / Terrain / Manipulation / Fluides), Forme (Sphère / Cube / Cylindre, rayon 0–32, Ctrl+molette, Maj = ±10), Blocs, Réglages du mode, Infos :

Palette vide (ou Gradient Helper non défini) → bloc actif. Les masques s'appliquent à tous les modes.

Images de relief (profil Image) : fichiers .png en niveaux de gris (noir = 0, blanc = hauteur max) dans .minecraft/buildedit/heightmaps ; l'image couvre le carré de la brosse (nord en haut). Boutons Actualiser / Ouvrir le dossier.

Fenêtre Masques — limite les blocs modifiés.

• Activés / Désactivés · combinaison ET (toutes) / OU (une suffit).
• ◀ type ▶ + Ajouter · chaque règle : = / ≠ (inverser), × (supprimer).

Scripts Lua (brosse Script, masque Script) : fichiers .lua de .minecraft/buildedit/scripts (créé avec 4 exemples : bruit_pierre, rayures, degrade_couleur, masque_dessus). Rechargés automatiquement quand le fichier change ; Recharger = relire après une erreur.

• Le fichier entier s'exécute pour chaque bloc. Brosse : renvoyer le bloc à poser, écrit comme dans les commandes ("stone", "oak_log[axis=x]"), ou nil = inchangé. Masque : renvoyer true / false.
• Variables : x, y, z (position), block (identifiant du bloc actuel, ex. "minecraft:stone"). Brosse seulement : dx, dy, dz (décalage depuis le centre), cx, cy, cz (centre), radius.
• Fonctions : getBlock(x,y,z) (identifiant), getState(x,y,z) (avec propriétés), isAir(x,y,z), isSolid(x,y,z), biome(x,y,z), noise(x,y,z[,échelle=8[,graine]]) (0–1), color(r,g,b) (bloc le plus proche de la couleur), active() (bloc actif), palette() (table des blocs de la Palette), print(...) (message à l'écran).
• math.random donne le même tirage pour une position pendant un trait (l'aperçu = le résultat). Pas d'accès aux fichiers ni au système ; un appel de plus de 250 ms est interrompu (erreur affichée).

#6.9 Dessin (Forme, Chemin, Modelage, Texte, Tampon)

Réglages communs : remplissage (Bloc actif / Palette), Écraser les blocs (non = air seul). Les masques s'appliquent. Aperçu en fantômes, Entrée = appliquer (1 annulation).

Ctrl+Z après avoir appliqué une forme, un chemin, un modèle ou un texte : les blocs sont retirés et l'objet revient en édition (même outil, mêmes réglages, mêmes nœuds) · Ctrl+Y le réapplique et referme l'édition.

Outil Forme (fenêtre Forme)

• Clic G = poser le centre (contre la face visée) · un autre clic le replace.
• Gizmo : flèches = déplacer, anneau = tourner (pas de 15°) ; clic sur une poignée puis molette = ±1.
• Échap = abandonner.
• Formes : Sphère, Cuboïde, Cylindre, Cône, Pyramide, Tore, Octaèdre, Prisme, Hélice.
• Réglages : Taille X / Y / Z 1–128, Lacet / Tangage / Roulis (pas de 15°), Creux (épaisseur, 0 = plein), Tube (Tore, Hélice), Côtés (Prisme), Tours (Hélice). Maj + −/+ = pas de 10.

Outil Chemin (fenêtre Chemin)

• Clic G = ajouter un nœud (après le nœud choisi) · clic sur un nœud = le choisir (orange) puis le déplacer au gizmo.
• Retour arrière = retirer le nœud choisi · Échap = tout effacer.
• Courbes : Ligne, Catmull-Rom (passe par les nœuds), Bézier (nœuds = points de contrôle), Caténaire (Affaissement en blocs).
• Rayon 0–16 (0 = 1 bloc).

Outil Modelage (fenêtre Modelage)

• Clic G = ajouter un point (après le point choisi) · clic sur un point = le choisir (orange) puis le déplacer au gizmo · Retour arrière = retirer le point choisi · Échap = tout effacer.
• Surfaces :
  • Enveloppe convexe : volume qui englobe tous les points, Pleine / Creuse (paroi = Épaisseur). Points sur un même plan = polygone plat.
  • Triangles : Bande (chaque point forme un triangle avec les 2 précédents) ou Éventail (triangles autour du 1er point).
  • Surface lisse (Catmull-Rom, passe par les points) / Surface Bézier (points = contrôle) : points rangés en grille dans l'ordre de pose, Points par rangée 2–16 ; les points d'une rangée incomplète sont gris (ignorés).
• Épaisseur 1–8 (surfaces, enveloppe creuse).

Outil Texte (fenêtre Texte)

• Clic G = poser le texte contre la face visée, lisible depuis la caméra · gizmo : flèches = déplacer, anneau = rotation (15°, Maj = 45°) · Entrée = appliquer · Échap = abandonner.
• Champ Texte (clic pour saisir, 64 caractères) · police : Police du jeu (défaut) ou police système (◀ ▶, Maj = ±10 ; champ Rechercher une police).
• Hauteur 1–128 = hauteur des majuscules en blocs (jambages en dessous) · Épaisseur 1–32 · Plan Debout (épaisseur vers la caméra) / Au sol (épaisseur vers le haut) · Horizontale / Verticale (lettres empilées de haut en bas, centrées) · Gras · Italique (polices système).

Outil Tampon (fenêtre Tampon)

• Aperçu sous le curseur · Clic G = poser (centré, posé sur la face visée ; 1 annulation par pose).
• Sources cochées : Presse-papier et fichiers .schem / .nbt du dossier .minecraft/buildedit/schematics (Actualiser, Ouvrir le dossier ; molette = défiler la liste). Plusieurs sources = tirage au hasard à chaque pose.
• Tourner / Autre tirage · Rotation aléatoire (défaut oui) · Miroir aléatoire · Coller l'air du tampon · Écraser les blocs · Décalage Y −32…32 (négatif = enfoncé). Masques respectés.

#6.10 Infos du bloc & Historique

Infos du bloc : nom, identifiant, position, biome, lumière et propriétés du bloc sous le curseur.

Historique

• Annuler / Rétablir + liste des opérations (ligne surlignée = état actuel, grises = annulées).
• Clic sur une ligne = revenir à cet état.

#6.11 Fichiers

Dossier : .minecraft/buildedit/schematics (le même que l'outil Tampon). Blocs seulement (ni entités, ni contenu des coffres / panneaux).

Fenêtre Fichiers (menu Fichier → Importer… ou Fenêtres)

• Importer : liste des .schem / .nbt (molette = défiler, clic = choisir ; taille et nombre de blocs affichés) · Importer (coller) = charge le fichier dans le presse-papier puis lance le collage figé (gizmo, Entrée = coller, Échap = annuler) · Actualiser / Ouvrir le dossier.
• Exporter la sélection : Nom du fichier (clic pour saisir) · format .schem (v3) / .nbt (structure du jeu, pour les blocs de structure) / .csv (x,y,z,bloc relatifs au coin min) · Exporter.
• Fichier déjà présent : message, exporter une 2e fois (dans les 4 s) pour l'écraser.
• Sélection de forme libre : hors forme = air (.schem), vide de structure (.nbt), absent (.csv).

Menu Fichier : Exporter la sélection dans chaque format avec le nom de la fenêtre Fichiers (défaut selection).

#6.12 Blueprints

Bibliothèque de constructions : .minecraft/buildedit/blueprints/[catégorie/]nom.schem + miniature nom.png (vue 3/4 générée à l'enregistrement). Les sous-dossiers sont les catégories. Stockage local ; sur serveur, partage possible (§10).

Fenêtre Blueprints (menu Fichier → Blueprints… ou Fenêtres)

• Rechercher (nom, catégorie ou tag) · Catégorie ◀ ▶ (toutes, racine, sous-dossiers).
• Grille de miniatures (molette = défiler) : clic = collage figé (gizmo, Entrée = coller, Échap = annuler) · glisser vers le monde = collage figé contre le bloc sous la souris.
• Ligne d'info : taille et tags du blueprint choisi · Supprimer (2e clic dans les 4 s pour confirmer).
• Enregistrer : la sélection si elle existe, sinon le presse-papier · Nom (obligatoire), Catégorie (dossier créé si besoin), Tags séparés par des virgules · nom déjà pris = recliquer pour écraser · Ouvrir le dossier.

Outil Tampon : les blueprints apparaissent dans la liste des sources (◆ catégorie/nom).

#6.13 Règle, Annotations, Image de référence

Outil Règle (fenêtre Règle) : clic G = ajouter un point (centre du bloc visé) · longueur de chaque segment + écarts (x, y, z) affichés dans le monde (gros texte sur fond sombre), Total au dernier point · Retour arrière = retirer le dernier point · Échap = tout effacer. Fenêtre : total, écart et taille en blocs du 1er au dernier point, liste des segments, Affichée oui/non.

Outil Annotation (fenêtre Annotation) — types :

• Texte : saisir le texte, clic G = le poser (aperçu sous la souris) · Couleur, Taille.
• Dessin (main levée), Ligne, Flèche : clic-glisser · Cadre : clic-glisser de bloc à bloc · Couleur, Épaisseur.
• Image : clic G sur une face = image centrée sur la face (dessus/dessous : son haut suit la caméra) · Largeur (blocs), Opacité.
• Gomme : clic G sur une annotation = l'effacer · clic G maintenu + glisser = rectangle : efface toutes celles qui ont un point dedans.
• Retour arrière = retirer la dernière · Tout effacer (dimension courante) · Affichées oui/non (aussi menu Affichage). Visibles en jeu et dans l'Editor ; sauvegardées par monde (buildedit/annotations/).

Image de référence (menu Fichier → Image de référence…) : images .png de buildedit/images/ · la fenêtre affiche l'image (redimensionner la fenêtre = l'agrandir) · Opacité · En jeu oui/non + largeur (px) = image en haut à droite hors Editor (aussi menu Affichage) · Poser dans le monde = outil Annotation, type Image.

#6.14 Vues & Propriétés du monde

Vues (menu Vues, fenêtre Vues) : Enregistrer = position + regard actuels (nom vide = « Vue N ») · clic sur une vue = y aller (même dans une autre dimension) · ✎ renommer (Entrée = valider, Échap = annuler) · ↑ ↓ ordre · ✕ supprimer. Menu Vues : liste des vues (clic = y aller), Enregistrer la vue actuelle. Sauvegardées par monde (buildedit/views/).

Propriétés du monde (menu Vues → Propriétés du monde…) :

• Temps : Heure (0–23 h, saisie ou − +) · Matin / Midi / Soir / Nuit · Figer le temps.
• Météo : Clair / Pluie / Orage (● = actuelle) · Figer la météo.
• Joueur : Invulnérable (sauf /kill, vide) · Pas de faim (jauge remplie, régénération conservée).
• Blocs : Pas de drops de blocs · Pas de propagation du feu · Figer pousse, feuilles, fonte (ticks aléatoires à 0) · Pas de piétinement des cultures.
• Temps, météo et blocs = règles du monde (sauvées avec le monde ; serveur : monde où l'on se trouve, permission buildedit.world) ; Invulnérable, Pas de faim, Pas de piétinement = réglages client.

#6.15 Options d'affichage

Menu Affichage (bascules) et Affichage → Options d'affichage… (fenêtre Affichage) :

• Sélection : cadre, coins et forme libre de la sélection visibles ou non.
• Blocs fantômes : aperçus en blocs fantômes on/off (fenêtre Affichage, menu Affichage).
• Fantômes GPU (expérimental) (fenêtre Affichage, défaut non) : maillage des fantômes envoyé une fois à la carte graphique (gros aperçus plus fluides). En cas d'erreur, retour automatique au rendu normal (message dans le journal).
• Biomes : couleur translucide par biome sur la surface (rayon 48 blocs, mise à jour chaque seconde) + légende centrée en bas, au-dessus des touches pressées (biomes les plus présents).
• Touches pressées : cases centrées en bas (à la place de la hotbar dans l'Editor, au-dessus des barres en jeu), estompées après relâchement.
• Luminosité min. (0–100 %) : lumière ambiante plancher (100 % = tout éclairé).
• Opacité fluides (0–100 %) : eau et lave (reconstruit les chunks affichés).
• Échelle Editor (50–200 % de l'échelle du jeu, pas de 5) : taille de l'interface de l'Editor seulement.
• Luminosité, opacité et échelle = curseurs (clic ou glisser) ; opacité et échelle appliquées au relâchement.

#6.16 Entités Display & Markers

Outil Display (fenêtre Display) : type à créer Bloc / Item / Texte / Marker · clic G sur un bloc = créer contre la face (bloc actif ; objet en main sinon bloc actif ; texte « Texte » ; marker) · clic G sur une entité = la choisir (cadres bleus = displays, orange = markers, visibles avec l'outil) · clic dans le vide / Échap = désélectionner · Suppr = supprimer.

• Gizmo : anneaux X/Y/Z toujours affichés = tourner (15°, Maj = 45°) · mode Déplacer : flèches (pas 1/16 de bloc, molette = 1/4) · mode Taille : faces = échelle. Marker : flèches seules. (Tous les anneaux : 15° / Maj 45°.)
• Fenêtre : position (saisie décimale, − + = 1/16, Maj ×10), rotation X/Y/Z (15°), Cadenas (échelles X Y Z liées, proportionnelles), échelle X/Y/Z, Face caméra (non / axe vertical / axe horizontal / oui), Luminosité (monde / 0–15), puis selon le type : Mettre le bloc actif · Mettre l'objet en main + Rendu · texte (\n = retour à la ligne), couleur, fond (curseur), ombre, alignement, largeur de ligne · Marker : nom, données (lecture seule). Dupliquer (+1 en X), Supprimer.
• Création, modifications (un glisser = une entrée) et suppression : Ctrl+Z / Ctrl+Y et fenêtre Historique.

#7. Menu contextuel

Maintenir Alt gauche (n'importe quel slot) → section Menu du menu Alt, sous Outils et Capacités : modes de jeu (Créatif, Survie, Aventure, Spectateur) sur une rangée à part, puis les autres icônes (relâcher = fermer). Le menu rouvre le curseur à sa dernière position.

#Pipette de couleur & dégradés

• Sélecteur : carré + teinte, curseurs R/V/B, champ hexa (#RRGGBB).
• Sur un bloc : clic G = début (vert) · clic D = fin (rouge) · clic molette = dans la main.
• Dégradé : −/+ = 2 à 9 blocs · Mettre dans la hotbar = slots 1 à N.
• Couleurs, début/fin et nombre de blocs gardés.

Hotbars et boîte à outils sont communes à tous les mondes (config/buildedit-storage.dat).

#8. Commandes

Préfixe /be (commandes client).

#9. Configuration & limites

#Écran /be config

Onglet Touches

• Clic sur une touche, puis nouvelle touche ou bouton souris.
• Échap = aucune · rouge = conflit · Défaut / Tout réinitialiser.

Onglet Limites

Appliquer → solo : buildedit-solo.properties · plugin : config serveur (permission buildedit.admin).

#Fichiers

#Bon à savoir

• L'historique est perdu en quittant le monde.
• Aperçu de brosse calculé en arrière-plan (tous les modes sauf Script, Élévation, Pente, Lissage du relief ; pas avec un masque Script) : l'aperçu précédent reste affiché jusqu'au nouveau.
• Grosses opérations (solo et serveur) : appliquées par morceaux (25 ms par tick), le jeu ne gèle plus ; progression en barre d'action au-delà de 20 000 blocs. Les opérations et annulations suivantes attendent leur tour.
• Les blocs des chunks non chargés sont ignorés (message jaune).

#10. Mode plugin (serveur)

• Plugin buildedit-paper-*.jar (Paper 26.3).
• À la connexion : « [BuildEdit] Activé sur ce serveur. » — sinon la raison (version, permission).

Ops par défaut.

Config plugins/BuildEdit/config.yml

Toutes les fonctions du mode solo marchent sur serveur (historique et Ctrl+Z côté serveur, par joueur). Particularités :

• Hotbars / Boîte à outils : stockées chez le joueur (communes à tous les mondes) ; la boîte à outils est prêtée au serveur pendant l'ouverture (créatif).
• Sans collision, vol rapide : le serveur accepte les déplacements du joueur qui vole avec BuildEdit actif.
• Gravité figée, Pas de piétinement : effet global dès qu'un joueur les active.

Partage (serveur uniquement) : vues, annotations et blueprints restent locaux ; chacun peut en publier une copie sur le serveur.

• Vues : ⇪ sur une vue = la partager · section Serveur : clic = y aller, ⤓ = copie locale.
• Annotation : section Serveur → Partager celles d'ici (dimension courante) · Importer un lot.
• Blueprints : Partager (blueprint choisi) · catégorie partagés (serveur) : ⤓ = récupérer dans la catégorie serveur.
• ✕ = supprimer du serveur (buildedit.admin). Stockage : plugins/BuildEdit/shared/.