Mod 1.0 · protocole v9 · Minecraft 26.3

#⬇️ Téléchargement

⬇ Dernière version du mod

Copier le jar dans .minecraft/mods avec Fabric Loader + Fabric API (voir Installation). Seules les versions qui modifient le mod (tag Mod / Protocole) produisent un nouveau jar ; historique depuis la 1.0.60. Les autres commits (doc, plugin, serveur) sont listés en gris.

#1. Démarrage

#Installation

• Fabric Loader 0.19.5 + Fabric API.
• Copier blockedit-*.jar dans .minecraft/mods (dernière version et historique : section Téléchargement du wiki, annoncées sur le Discord).

Langue : l'interface suit la langue du jeu (Options → Langue) : français, sinon anglais.

Licence : BlockEdit by BlockEdit Team — © 2026, tous droits réservés. Usage libre des jars (solo ou serveur) et redistribution sans modification autorisée ; code source, décompilation, modification et revente interdits sans accord.

#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 → BlockEdit.

#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 BlockEdit est actif. Elle contient l'outil courant. Quand elle est active, la main du joueur est masquée.

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 (100 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 (section Capacités ; Gravité figée, Pose forcée, Sans mises à jour : section Monde ; 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…) en plus de son contenu (coffre, panneau…) ; objet marqué « Modifié avec Block Edit ». Sur une porte, une plante haute ou un lit, seule la partie visée (bas/haut, pied/tête) est copiée et posée seule (solo + serveur). L'objet va dans un slot vide de la hotbar ; sa description liste les propriétés modifiées. Le bloc est posé tel quel (torche murale avec son orientation, culture avec son âge — pose forcée si besoin), y compris en Remplacement et Pose dans le vide ; un objet comestible (carotte, baies…) devient seulement posable. Sur une entité : ses données (nom, variante, équipement…) sont copiées dans l'objet (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 (main du joueur masquée), 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

Colonne d'outils (toujours visible à gauche) : une icône par outil ; nom et description au survol. Les outils de sélection (Cuboïde, Polygonale, Convexe, Baguette, Pinceau, Lasso) sont regroupés sous une seule icône en haut (celle du dernier mode choisi, Cuboïde par défaut) : clic G dessus = cet outil + menu déroulant pour choisir le mode.

Icône	Outil / fenêtre	Rôle	Détail
	Cuboïde	Sélection en boîte (clic-glisser)	§6.3
	Polygonale	Polygone de coins vu de dessus (clic G / clic D)	§6.3
	Convexe	Enveloppe 3D des coins (clic G / clic D)	§6.3
	Baguette	Sélectionne les blocs reliés au bloc cliqué	§6.3
	Pinceau	Peint la sélection (molette = rayon)	§6.3
	Lasso	Contour tracé à l'écran	§6.3
	Pipette	Bloc actif (Maj = bloc source)	§6.3
	Peinture	Brosse (peindre, dessiner) + masques	§6.8
	Terrain	Brosse de terrain (Élévation, Pente, Niveler, Autoshade, Neige, Manipulation, Fluides)	§6.7
	Forme	Sphère, cylindre, cube…	§6.9
	Chemin	Courbe par des nœuds	§6.9
	Modelage	Volume ou surface par des points	§6.9
	Texte	Texte en blocs	§6.9
	Tampon	Pose le presse-papier ou un fichier au clic	§6.9
	Déformation	Courber, tordre, effiler, cage, édition proportionnelle de la sélection	§6.9
	Réseau	Copies du presse-papier en ligne, en cercle ou le long d'un Chemin	§6.9
	Arbres	Arbres procéduraux par essence, posés un par un ou à la chaîne	§6.9
	Blueprints (fenêtre)	Bibliothèque de constructions	§6.12
	Importer un modèle 3D (fenêtre)	Modèle 3D (.obj, .stl, .gltf, .glb) → blocs (réglages en direct, molette = taille)	§6.11
	Importer une image (fenêtre)	Image → pixel art (sol / mur) ou map art = cartes sur cadres invisibles (réglages en direct)	§6.11
	Règle	Mesure distances et dimensions	§6.13
	Annotation	Textes, flèches, dessins dans le monde	§6.13
	Display	Entités Display / Marker	§6.16
	Vues (fenêtre)	Points de vue enregistrés	§6.14
	Propriétés du monde (fenêtre)	Heure, météo, règles	§6.14
	Affichage (fenêtre)	Options d'affichage	§6.15
	Historique (fenêtre)	Opérations annulables	§6.10

Clic = choisir l'outil et ouvrir sa fenêtre ancrée du côté de la colonne (gauche par défaut ; les fenêtres déjà ancrées de ce côté se ferment ; Pipette = pas de fenêtre ; Peinture = Brosse + Masques). Blueprints (sous Tampon), puis en bas Vues, Propriétés du monde, Affichage, Historique : clic = fenêtre ancrée du même côté. Désélectionner (A) sans sélection = quitter l'outil actif (aucun outil).

Fenêtres

• Largeur des fenêtres ancrées : glisser leur bord intérieur (surligné au survol).
• Rabattre : petite flèche au bord intérieur des fenêtres ancrées (gauche / droite) = les masquer sans les fermer ; re-clic = les réafficher.
• 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. Par défaut : Sélection ancrée à gauche, Blocs et Palette ancrées à droite, les autres fermées (aussi Fenêtres › Réinitialiser la disposition).

Liste : Sélection (réglages de l'outil, sélection, infos du bloc, opérations ; molette = défiler) · Presse-papier (Copier / Couper / Coller) · Blocs · Palette · Terrain · Historique · Brosse · Masques · Blueprints · Forme · Chemin · Fichiers · Modelage · Texte · Tampon.

#6.3 Sélection

Outils (Cuboïde, Polygonale, Convexe, Baguette, Pinceau, Lasso : icônes de la colonne d'outils ; réglages et mode de combinaison dans la fenêtre Sélection ; 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.

Fenêtre Sélection, section Sélection : pos1 / pos2, taille et volume · Vider (air) · Désélectionner · + / - N blocs (N = 1–32) puis Agrandir / Réduire · Lisser · Inverser · Non-air uniquement.

Synchro WorldEdit (si WorldEdit est installé : plugin sur le serveur, ou mod WorldEdit en solo) : //pos1, //pos2, la baguette //wand… mettent à jour notre sélection (autres formes WorldEdit = boîte englobante) ; notre sélection cuboïde devient la sélection WorldEdit (//set, //copy… marchent dessus). Les formes libres ne sont pas envoyées. //sel cuboid / //sel poly / //sel convex choisissent aussi notre outil Sélection cuboïde / polygonale / convexe (Builder, et Editor si un outil de sélection y est actif). Bouton Synchro WorldEdit : oui/non en bas de la section Sélection (worldedit-sync dans blockedit-client.properties).

Historique commun avec WorldEdit : chaque modification WorldEdit (//set, //paste…) entre dans l'historique BlockEdit (entrée WorldEdit de la fenêtre Historique). //undo, //redo, //z, //y, /be undo, /be redo et Ctrl+Z / Ctrl+Y annulent/rétablissent donc dans l'ordre réel, que l'action vienne de BlockEdit ou de WorldEdit (une entrée WorldEdit est annulée par WorldEdit). Serveur : option worldedit-history du plugin.

#6.4 Gizmos

Mode : menu Gizmo 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 (section Opérations de la fenêtre Sélection) = les régler.

#6.6 Opérations

Section Opérations de la fenêtre Sélection (analyse : tous les types affichés, du plus nombreux au moins nombreux ; molette = défiler). Source = bloc à remplacer · Actif = bloc posé (⇅ = échanger · bouton Actif à côté de Source = Source prend le bloc actif).

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

#6.7 Terrain

Outil Terrain (colonne d'outils) : brosse comme la Peinture (même usage : clic G maintenu + glisser, relâcher = appliquer, Échap = abandonner, molette = rayon, masques), mais avec son propre mode, sa forme et son rayon. Fenêtre Terrain : Mode (groupes Terrain : Élévation, Pente, Niveler, Autoshade, Neige lissée · Manipulation · Fluides, détail des modes en §6.8), Forme, Blocs, Réglages, Infos, puis Sélection.

Le menu Opérations garde aussi Autoshade et Neige lissée sur toute la sélection.

#6.8 Peinture (Brosse & Masques)

Outil Peinture (colonne d'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 = outil Terrain, §6.7), Forme (Sphère / Cube / Cylindre, rayon 0–32, 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/blockedit/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/blockedit/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 : anneaux X/Y/Z = tourner (15°, Maj = 45°) · mode Déplacer : flèches = déplacer · mode Taille (Tab) : faces = déformer (taille ±2 sur l'axe, forme centrée) ; clic sur une poignée puis molette = ±1 cran.
• Échap = abandonner · fenêtre : Appliquer (= Entrée) / Abandonner (= Échap).
• Formes : Sphère, Dôme (demi-sphère, base plate en bas), Cuboïde, Cylindre, Cône, Pyramide, Tore, Octaèdre, Prisme, Hélice.
• Remplissage : Bloc actif / Palette / Autoshade (◀ ▶) — Autoshade = comme celui de l'import de modèle 3D, sur la forme seule : teintes = un groupe de Palette (Teintes ◀ ▶, du clair au sombre, au moins 2), face tournée vers le soleil = clair, dos au soleil ou ombre portée par la forme = sombre ; Soleil et Élévation du soleil partagés avec le Terrain et l'import OBJ.
• Réglages : Taille X / Y / Z 1–384, Lacet / Tangage / Roulis (pas de 15°), bouton Réinitialiser taille et rotation (9 × 9 × 9, 0°), Creux (épaisseur, 0 = plein ; Face de la base : affichée / masquée pour Cuboïde, Cylindre, Cône, Pyramide, Prisme, Dôme), forme choisie dans une liste déroulante (ordre alphabétique), Tube (Tore, Hélice), Côtés (Prisme), Côtés de la base (Pyramide, 3–16 ; 4 = base carrée), 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 (liste déroulante) : Ligne, Catmull-Rom (passe par les nœuds), Bézier (nœuds = points de contrôle), Caténaire (Affaissement en blocs ; négatif = courbe vers le haut).
• Rayon 0–16 (0 = 1 bloc ; molette) · Affaissement (Caténaire).
• Fenêtre : Appliquer (= Entrée), Retirer le nœud choisi, Effacer.
• Mode (liste déroulante) : Tracé (rayon + remplissage : icône du bloc actif ou Palette) / Profil 2D le long du chemin / Volume 3D le long du chemin. Le gabarit suit la courbe : sa largeur reste perpendiculaire au chemin, sa hauteur verticale ; les blocs sont tournés selon la direction du chemin (quart de tour le plus proche) ; l'air n'est jamais posé.
  • Profil 2D : Profil (liste déroulante avec l'aperçu de chaque profil ; aperçu du profil choisi sous les boutons) · Créer un profil 2D · Modifier · Dupliquer · Supprimer (boutons l'un sous l'autre) (fichiers .minecraft/blockedit/profiles/<nom>.profile). La case d'ancrage est posée sur la courbe.
  • Éditeur de profil (fenêtre Profil 2D, plein écran opaque et modale : rien d'autre ne réagit, Échap = fermer) : réglages à gauche (Nom, Largeur / Hauteur 1–64, bloc à poser = Bloc actif, bloc glissé sur la fenêtre ou choisi dans la liste des blocs avec recherche (nom ou identifiant, molette = défiler) sous Bloc actif / Mode, toutes ses propriétés ◀ ▶), grande grille à droite vue en regardant vers l'avant du chemin (droite = droite du chemin) ; chaque case montre les faces du bloc vues de face, textures orientées comme dans le profil ; aperçu du bloc sous le curseur. Orientation selon la partie de la case visée : escalier = coin visé (en haut = à l'envers ; côté gauche / droit = côté haut de la marche), dalle = moitié haute / basse, trappe = bord visé (haut / bas = fermée en partie haute / basse, côté = ouverte contre ce côté), bûche = axe (bord haut / bas = vertical, côtés = couché, centre = vers soi), bloc orientable = bord visé (centre = vers soi). Clic G = poser (glisser = peindre ; Maj = prendre le bloc de la case), clic D = effacer ; Mode : ancrage puis clic = case d'ancrage (cadre jaune) ; Enregistrer / Vider / Fermer.
  • Volume 3D : Volume = presse-papier, schematic ou blueprint (◆) · Rotation +0° / 90° / 180° / 270° · le volume entier est répété sur sa longueur le long de la courbe (côté nord = vers l'avant, milieu de la largeur et bas sur la courbe).

Outil Modelage (fenêtre Modelage)

• Clic G = ajouter un point (après le point choisi) · point survolé = surligné (blanc) · 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).
• Fenêtre : Appliquer (= Entrée), Retirer le point choisi, Effacer.

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 autour du centre du texte (15°, Maj = 45°) · Entrée = appliquer · Échap = abandonner (aussi boutons Appliquer / 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) · Escaliers / dalles (Debout, sans rotation libre) : escaliers et dalles du bloc posé (ou de la Palette) dans les marches des traits obliques et arrondis, orientés pour lisser la police ; bloc sans variante = case laissée vide.

Outil Tampon (fenêtre Tampon)

• Aperçu sous le curseur · Clic G = poser (centré, posé sur la face visée ; 1 annulation par pose).
• Tampon multiple (clic G maintenu) : clic G maintenu en glissant = un tampon (nouveau tirage) chaque fois que le bloc visé est à au moins Espacement minimum (1–128 blocs, à l'horizontale) des autres ; aperçu en fantômes, tous posés au relâchement (1 annulation).
• Sources cochées : Presse-papier et fichiers .schem / .nbt du dossier .minecraft/blockedit/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.

Outil Réseau (fenêtre Réseau) : copies du presse-papier (air ignoré), aperçu en blocs fantômes réglable en direct ; Entrée = poser (1 annulation), Échap = abandonner.

• En ligne : Clic G = origine (1re copie, centrée et posée sur la face visée) · Copies · Pas X / Y / Z entre deux copies (boutons Pas = largeur X / Z).
• En cercle : Clic G = centre · Rayon · Nombre de copies (réparties sur 360°) ou Une copie tous les x° (Angle entre copies, Amplitude max) · Angle de départ · copies tournées vers l'extérieur (le côté nord du presse-papier regarde vers l'extérieur) ou non tournées.
• Le long du Chemin : tracer la courbe avec l'outil Chemin sans l'appliquer, puis revenir au Réseau · Espacement (blocs le long de la courbe) · copies tournées selon la courbe (côté nord du presse-papier vers l'avant) ou non.
• Rotation : +0° / 90° / 180° / 270° ajoutée à toutes les copies.

Outil Déformation (fenêtre Déformation) : déforme les blocs de la sélection (200 000 max) ; aperçu fantôme calculé en arrière-plan, réglages en direct ; Entrée = appliquer (les anciennes positions deviennent de l'air ; 1 annulation), Échap = revenir à la forme d'origine.

• Courber : Axe de la longueur, Vers (direction de la courbure), Angle total (−360 à 360°) ; les blocs sont tournés au quart de tour le plus proche.
• Tordre : Axe (autour du centre de la sélection), Angle total (−720 à 720°), croissant le long de l'axe.
• Effiler : Axe, Échelle au bout (0–400 % ; 100 % au début).
• Cage (Lattice) : Points par axe (2–5) autour de la sélection ; clic G sur un point = le choisir, gizmo = le déplacer (déformation lisse de Bézier).
• Édition proportionnelle : clic G sur un bloc = point ; gizmo = le déplacer, les blocs dans le Rayon (1–64) suivent avec un Fondu lisse ou linéaire.

Outil Arbres (fenêtre Arbres) : arbres procéduraux ; aperçu en blocs fantômes au bloc visé (calculé en arrière-plan, réglages en direct).

• Clic D court (sans tourner la vue) = épingler l'aperçu au bloc visé (re-clic D = le déplacer) ; Échap = le libérer (il suit à nouveau le curseur).
• Clic G = poser l'arbre ; clic G maintenu en glissant = arbres ajoutés à la chaîne, au moins Espacement à la chaîne (1–64 blocs, à l'horizontale) entre deux, affichés en fantômes et posés au relâchement (1 annulation pour le lot) ; Entrée = poser à l'aperçu épinglé. Après chaque pose, l'arbre suivant est retiré au hasard (nouvelle graine, mêmes réglages).
• Molette sur le monde = Hauteur totale (Maj = pas de 5) si Molette = hauteur : oui.
• Essence (préréglage de tous les réglages) : Chêne, Bouleau, Sapin, Jungle, Acacia, Chêne noir, Cerisier, Palétuvier (racines-échasses), Chêne pâle, Palmier (palmes retombantes).
• Aléatoire (réglages R) 0–100 % (défaut 0) : à chaque tirage, les réglages dont le bouton R est allumé varient de ± ce pourcentage de leur valeur.
• Réglages : Hauteur totale (3–96), Épaisseur du tronc (1–6), Inclinaison du tronc (0–60°), Troncs (1–6), Longueur du tronc (part sans branches, 0–95 %), Branches / Palmes (0–32), Longueur des branches / des palmes (20–300 %), Épaisseur des branches (1–4), Inclinaison des branches (−30–90°), Taille, Rondeur (100 % = grappes lisses, 0 % = très déformées) et Densité du feuillage, Racines oui / non / au hasard (1 chance sur 2 par arbre), Types de blocs (liste déroulante à cases à cocher : Escaliers, Dalles, Étagères, Trappes, Barrières ; aucune = blocs pleins seuls) : escaliers / dalles lissent aussi les troncs inclinés et les branches (marches), au pied du tronc, tirage au hasard par arbre (escaliers + dalles dans les coins, étagères, trappes ouvertes contre le tronc, mélange ou rien), barrières au bout des branches ; en mode Essence : blocs de la couleur la plus proche de l'écorce, sinon formes du bloc du tronc. Afficher le feuillage oui/non avec ses types (Feuilles, Herbes = herbe / fougère, Pousses de l'essence) : herbes et pousses posées sur le dessus des feuilles (ou à leur place sans feuilles).
• Tronc / Feuillage : Essence (bois à écorce sur les 6 faces / feuilles de l'essence), Palette (mélange d'un groupe de Palette) ou Autoshade (teintes d'un groupe, clair → sombre, selon le Soleil ; ombre portée par l'arbre). Feuilles posées persistantes (ne se décomposent pas).
• Graine + Autre tirage ; Écraser les blocs (les racines sous le pied remplacent toujours le sol).
• Enregistrer en blueprint / Enregistrer en schematic : enregistre l'arbre de l'aperçu (Blueprints, catégorie Arbres ; ou .schem dans le dossier des schematics).

#6.10 Infos du bloc & Historique

Infos du bloc (section de la fenêtre Sélection) : 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/blockedit/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).

Importer un modèle 3D (icône Importer un modèle 3D de la barre d'outils, menu Fichier → Importer un modèle 3D…, ou bouton Modèle 3D… de la fenêtre Fichiers) : convertit un modèle 3D du dossier .minecraft/blockedit/models en blocs — .obj (avec ses .mtl et textures à côté), .stl (binaire ou texte ; couleurs de faces si présentes), .gltf (avec ses fichiers .bin / images à côté, ou intégrés) ou .glb (scène par défaut, hiérarchie des nœuds, couleur de base : facteur, texture PNG/JPEG/WebP, couleurs de sommets ; modèles compressés Draco / meshopt non pris en charge) —, dans le presse-papier, puis lance le collage figé.

• En direct : pendant ce collage, tout changement de réglage reconvertit le modèle (même point d'origine, rotation gardée) ; molette (hors fenêtres) = hauteur ± 1 (Maj ± 10), aussi en Builder Mode ; clic G sur un bloc = y déplacer le modèle (Editor ; poignées du gizmo prioritaires).
• Liste des modèles (molette = défiler) · Actualiser / Ouvrir le dossier.
• Hauteur (blocs, 1–1024) · Largeur X / Largeur Z (blocs) : avec Proportions liées (défaut), en régler une recalcule les autres (jamais déformé) ; Proportions libres = chaque dimension indépendante (molette : les trois suivent).
• Lacet / Tangage / Roulis (crans de 15°, saisie au clic) : orientation du modèle avant conversion (meilleure qualité que la rotation du collage).
• Réinitialiser : hauteur 64, proportions liées, orientation et rotation du collage à zéro.
• Gizmo en mode Taille de la sélection pendant l'import : poignées de faces et de coins = redimensionner le modèle (côté opposé fixe ; liées → les trois dimensions suivent).
• Fenêtre : molette sur la liste = fichiers, ailleurs = défiler la fenêtre.
• Axe vertical Y / Z (modèle couché → Z).
• Coque (surface) / Plein (intérieur rempli ; parties non fermées du modèle : surface seulement, message).
• Blocs pleins / Toutes formes : dalles (haut/bas), escaliers (endroit/envers, orientés), murets selon la forme réelle de chaque bloc de surface. Forme absente du matériau (ex. muret de stone) → même forme du matériau de couleur la plus proche (palette d'abord).
• Origine du collage (point placé sur le bloc visé) : Centre bas / Centre / Centre haut.
• Matériau unique (choix ◀ ▶, saisie du nom au clic, bouton Bloc actif, ou bloc glissé sur la fenêtre ; défaut stone) / Couleurs du modèle : texture (map_Kd de l'OBJ, couleur de base du glTF) (PNG/JPG/BMP, coordonnées UV), sinon couleurs de sommets, sinon couleur Kd → bloc le plus proche de la palette ; sans couleur → matériau.
• Autoshade (3e choix, après Matériau unique / Couleurs du modèle) : comme l'Autoshade du Terrain, sur le modèle seul — teintes = un groupe de Palette enregistré (Teintes ◀ ▶, du clair au sombre, au moins 2), face tournée vers le soleil = clair, dos au soleil ou ombre portée par le modèle = sombre ; Soleil (direction) et Élévation du soleil partagés avec le Terrain ; l'ombre suit la rotation du collage (gizmo, R, G).
• Palette (couleurs du modèle) : blocs cochés ou un groupe de l'outil Palette (◀ ▶ ; seuls ses blocs pleins servent).
• Blocs cochés (n)… : grille de tous les blocs pleins, clic = cocher/décocher (survol = nom) · Tout / Aucun / Défaut (laines, bétons, terres cuites, planches, pierres courantes…) / Retour. Gardée dans la config.
• Ajouter aux Blueprints (pendant l'import) : le modèle tel qu'affiché (réglages + rotation) → blueprint catégorie OBJ, nom du fichier, tag obj (miniature générée).
• Conversion en arrière-plan (« Conversion… ») ; limite 2048 blocs de côté, 16 M de volume.

Importer une image (icône Importer une image de la barre d'outils) : convertit une image du dossier .minecraft/blockedit/images (.png avec transparence, .jpg, .webp (avec ou sans perte, transparence, animation = 1re image), .svg pixellisé, .tif, .bmp, .gif) en pixel art (blocs, dans le presse-papier, puis collage figé) ou en map art (cartes posées sur des cadres) ; pendant le collage ou le placement, tout changement de réglage reconvertit l'image.

• Liste des images (molette = défiler) · Actualiser / Ouvrir le dossier · taille de l'image en pixels.
• Mode : Pixel art au sol (X × Z, haut de l'image au nord) / Pixel art au mur (X × Y, épaisseur 1) / Map art (cartes sur cadres).
• Pixel art : Largeur et Hauteur (blocs, 1–1024) · Proportions liées (défaut) / libres.
• Map art : cartes verrouillées (128 × 128 pixels, toutes les couleurs de carte en 4 teintes) posées sur des cadres invisibles fixes (ni cassables, ni tournables, ne disparaissent pas) · Cartes en largeur / en hauteur (1–8) · Support : Au mur (image face à soi) / Au sol (haut de l'image = direction regardée) · Proportions de l'image gardées (image entière centrée, le reste transparent sur les cartes) / Image étirée · Ancrage : Coin haut gauche / haut droit / bas gauche / bas droit / Centre.
  • Placer les cartes : aperçu (contour de chaque carte, carte d'ancrage surlignée, flèche du haut de l'image au sol) au bloc visé ; clic G sur une face (mur) ou le dessus d'un bloc (sol) = y amener le point d'ancrage (Editor et Builder) ; Entrée ou Poser = créer les cartes et les cadres (Ctrl+Z annule) ; Échap ou Abandonner.
  • Solo et serveur (plugin : pixels des cartes gardés dans plugins/BlockEdit/maps/).
• Tramage oui / non (Floyd-Steinberg : dégradés plus doux).
• Palette (pixel art) : la même que l'import de modèle 3D (blocs cochés ou groupe de l'outil Palette, bloc le plus proche en Lab).
• Pixels transparents (alpha < 50 %) → air (pixel art) / vide sur la carte (map art).

#6.12 Blueprints

Bibliothèque de constructions : .minecraft/blockedit/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 (bouton Retirer le dernier) · Échap = tout effacer (bouton 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 (boutons les uns sous les autres, avec icône) :

• 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 (bouton Retirer la dernière) · Ouvrir le dossier d'images · Tout effacer (dimension courante) · Affichées oui/non (aussi menu Affichage). Visibles en jeu et dans l'Editor ; sauvegardées par monde (blockedit/annotations/).

Image de référence (menu Fichier → Image de référence…) : images .png de blockedit/images/ (◀ ▶ = choisir, Dossier = l'ouvrir) · 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 (blockedit/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 blockedit.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 (fenêtre Affichage, défaut oui) : 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 et du message d'action en jeu), estompées après relâchement ; le rappel de l'outil (Editor) passe au-dessus.
• 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.
• Barre d'icônes : gauche (défaut) / droite. À droite : la colonne d'icônes passe à droite et les fenêtres ancrées changent de côté (gauche ↔ droite) ; les fenêtres flottantes restent en place.
• 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 · molette (hors poignée du gizmo) = échelle de l'entité choisie (×1,1 par cran, crans rapprochés = une entrée d'historique).

• Gizmo : anneaux X/Y/Z toujours affichés = tourner (15°, Maj = 1°, Maj tenu au début du glisser) · mode Déplacer : flèches (pas 1/16 de bloc, molette = 1/4) · mode Taille : faces = échelle. Marker : flèches seules. (Autres anneaux : 15° / Maj 45°.)
• Recherche (en haut de la fenêtre, sous les types, pour Bloc et Item) : bloc / objet par nom ou identifiant ; suggestions avec icône, suite de l'identifiant en gris ; Tab = compléter, ↑ ↓ = choisir, Entrée ou clic = appliquer, Échap = fermer. Entité choisie → change son contenu ; sinon → contenu des prochaines créations (« À créer : … », clic = revenir au bloc actif / à l'objet en main).
• 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) → menu Alt (relâcher = fermer ; le curseur rouvre à sa dernière position), de haut en bas :

1. Sélection / Édition : les outils du 10e slot (clic = choisir).
2. Capacités : voir § 4.
3. Monde (Gravité figée, Pose forcée, Sans mises à jour, Météo, Horloge) et, à côté, Mode de jeu.
4. Affichage / Navigation / Outils : les autres icônes ci-dessous.

Section Affichage / Navigation / Outils :

#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/blockedit-storage.dat).

#8. Commandes

Préfixe /be (commandes client).

Alias courts (tchat) : renvoient à la commande WorldEdit ; sans WorldEdit sur le serveur, à notre équivalent /be quand il existe.

#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 · champ Rechercher (nom de l'action ou de la touche).

Onglet Limites — chaque réglage : curseur + champ de saisie liés (curseur logarithmique pour Max blocs et Blocs fantômes).

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

#Fichiers

#Bon à savoir

• L'historique est perdu en quittant le monde.
• Aperçu de brosse calculé en arrière-plan (tous les modes, Script et masque Script compris ; Élévation, Pente et Lisser + Relief n'ont pas d'aperçu) : 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 blockedit-paper-*.jar (Paper 26.3 ou dérivé de Paper ; Spigot / CraftBukkit non pris en charge : le plugin se désactive avec un message).
• Permissions gérables avec LuckPerms (blockedit.use, blockedit.world, blockedit.admin).
• À la connexion : « [BlockEdit] Activé sur ce serveur. » — sinon la raison (version, permission).
• Messages du plugin dans la langue du joueur (client en français → français, sinon anglais).

Ops par défaut.

Config plugins/BlockEdit/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 BlockEdit actif.
• Capacités partagées — Gravité figée, Pose forcée, Sans mises à jour : état du monde commun (un joueur avec blockedit.world l'active/désactive pour tous, chacun voit l'icône et un message ; gardé avec le monde). Les autres capacités restent propres à chaque joueur. Pas de piétinement : effet global dès qu'un joueur l'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 (blockedit.admin). Stockage : plugins/BlockEdit/shared/.