Hiob : Liens

2026-02-14T08:17:27Z

Liens

← Version précédente		Version du 14 février 2026 à 08:17
Ligne 16 :		Ligne 16 :
	\|docs=https://intellectualsites.gitbook.io/fastasyncworldedit/		\|docs=https://intellectualsites.gitbook.io/fastasyncworldedit/
	\|dépendance=Aucune		\|dépendance=Aucune
	\|compatibilité=[[~~FAVS~~]], [[LuckPerms]]		\|compatibilité=[[Plugin:FastAsyncVoxelSniper\|FastAsyncVoxelSniper]], [[Plugin:LuckPerms\|LuckPerms]]
	}}		}}

Hiob : Hiob a déplacé la page FastAsyncWorldEdit vers Plugin:FastAsyncWorldEdit sans laisser de redirection

2026-02-10T20:31:24Z

Hiob a déplacé la page FastAsyncWorldEdit vers Plugin:FastAsyncWorldEdit sans laisser de redirection

← Version précédente	Version du 10 février 2026 à 20:31
(Aucune différence)

Hiob le 18 octobre 2025 à 12:59

2025-10-18T12:59:23Z

← Version précédente		Version du 18 octobre 2025 à 12:59
Ligne 19 :		Ligne 19 :
	}}		}}

	'''FastAsyncWorldEdit''' ('''FAWE''') est une version améliorée et accélérée de [[WorldEdit]] offrant des performances jusqu'à '''20 fois supérieures''' pour les éditions massives de terrain. Il est conçu pour supporter les modifications extrêmes sans lag ni crash.		'''FastAsyncWorldEdit''' ('''FAWE''') est une version améliorée et accélérée de '''WorldEdit''' offrant des performances jusqu'à '''20 fois supérieures''' pour les éditions massives de terrain. Il est conçu pour supporter les modifications extrêmes sans lag ni crash.

	== Description ==		== Description ==

Hiob le 18 octobre 2025 à 12:55

2025-10-18T12:55:51Z

← Version précédente		Version du 18 octobre 2025 à 12:55
Ligne 4 :		Ligne 4 :
	{{Infobox Plugin		{{Infobox Plugin
	\|nom=FastAsyncWorldEdit		\|nom=FastAsyncWorldEdit
	\|image=FAWE_Logo.~~svg~~		\|image=FAWE_Logo.png
	\|legende=Logo de FastAsyncWorldEdit		\|legende=Logo de FastAsyncWorldEdit
	\|type=Construction		\|type=Construction

Hiob : SVG

2025-10-18T12:50:52Z

SVG

← Version précédente		Version du 18 octobre 2025 à 12:50
Ligne 4 :		Ligne 4 :
	{{Infobox Plugin		{{Infobox Plugin
	\|nom=FastAsyncWorldEdit		\|nom=FastAsyncWorldEdit
	\|image=FAWE_Logo.~~png~~		\|image=FAWE_Logo.svg
	\|legende=Logo de FastAsyncWorldEdit		\|legende=Logo de FastAsyncWorldEdit
	\|type=Construction		\|type=Construction

Hiob : Création

2025-10-18T12:41:32Z

Création

Nouvelle page

{{SHORTDESC:Version optimisée de WorldEdit avec traitement asynchrone, éditions massives sans lag, heightmaps depuis images, brushes avancés et gestion mémoire intelligente}}

{{Infobox Plugin
|nom=FastAsyncWorldEdit
|image=FAWE_Logo.png
|legende=Logo de FastAsyncWorldEdit
|type=Construction
|dev=IntellectualSites (Empire92, N0tMyFaultOG, dordsor21)
|status=
|grade=
|spigot=13932
|modrinth=fastasyncworldedit
|hangar=IntellectualSites/FastAsyncWorldEdit
|sources=https://github.com/IntellectualSites/FastAsyncWorldEdit
|docs=https://intellectualsites.gitbook.io/fastasyncworldedit/
|dépendance=Aucune
|compatibilité=[[FAVS]], [[LuckPerms]]
}}

'''FastAsyncWorldEdit''' ('''FAWE''') est une version améliorée et accélérée de [[WorldEdit]] offrant des performances jusqu'à '''20 fois supérieures''' pour les éditions massives de terrain. Il est conçu pour supporter les modifications extrêmes sans lag ni crash.

== Description ==

FastAsyncWorldEdit est un fork optimisé de WorldEdit qui utilise des algorithmes asynchrones et multi-threadés pour permettre des éditions de terrain massives sans impacter les performances du serveur.

== Fonctionnalités ==

{| class="wikitable"
! Catégorie !! Fonctionnalités
|-
| '''Performance'''
|
* '''Traitement asynchrone''' : éditions en arrière-plan
* '''Multi-threading''' : utilisation de tous les cœurs CPU
* '''Jusqu'à 20x plus rapide''' que WorldEdit vanilla
* '''Pas de lag''' sur éditions massives (millions de blocs)
* '''Mémoire optimisée''' : compression intelligente
* '''Rollback instant''' : annulation sans lag
* '''Disk caching''' : évite les OOM (Out of Memory)
|-
| '''Édition avancée'''
|
* Toutes les commandes WorldEdit standard
* '''Heightmaps''' : terrains depuis images
* '''Schematics''' améliorés (format .schem)
* '''Brushes customisables''' : patterns avancés
* '''Masques complexes''' : combinaisons multiples
* '''Transformations''' : rotate, flip, deform
* '''Expressions mathématiques''' avancées
* '''Biomes''' : modification rapide
|-
| '''Outils supplémentaires'''
|
* '''CFI (Create From Image)''' : terrains depuis images
* '''Voxel Sniper''' intégré
* '''Navigation''' : /jumpto, /thru, /up
* '''Clipboard étendu''' : opérations multiples
* '''History étendue''' : rollback amélioré
* '''Brush visualizer''' : preview en temps réel
* '''Lighting fix''' : correction automatique
|-
| '''Gestion'''
|
* '''Limits configurables''' : par joueur/groupe
* '''Disk/Memory modes''' : selon besoins
* '''Whitelist de blocs''' : sécurité
* '''Preloading''' : génération anticipée chunks
* '''Queue system''' : gestion priorités
* '''Logging''' : traçabilité éditions
* '''API complète''' : intégration plugins
|-
| '''Compatibilité'''
|
* Support [[Paper]], Spigot, Purpur
* Intégration [[PlotSquared]]
* Compatible [[VoxelSniper]]
* Support [[LuckPerms]]
* Schematics [[MCEdit]]/[[WorldEdit]]
* '''Format .schem''' (Sponge Schematic)
* Import/Export '''.schematic''' legacy
|}

== Installation ==

=== Prérequis ===

* '''Serveur''' : Paper 1.18.2+ (recommandé), Spigot
* '''Java''' : Java 17+ (21 pour Minecraft 1.20.5+)
* '''RAM''' : 4 GB minimum, 8+ GB recommandé
* '''CPU''' : Multi-cœurs recommandé

=== Structure des fichiers ===

<syntaxhighlight lang="text">
plugins/FastAsyncWorldEdit/
├── config.yml # Configuration principale
├── config-legacy.yml # Config WorldEdit legacy
├── limits.yml # Limites par groupe/joueur
├── commands.yml # Personnalisation commandes
├── worldedit-config.yml # Config WorldEdit standard
├── schematics/ # Stockage schematics
│ └── *.schem
├── heightmaps/ # Images pour heightmaps
│ └── *.png
├── brushes/ # Brushes customisées
├── sessions/ # Sessions joueurs (cache)
└── history/ # Historique éditions
</syntaxhighlight>

== Configuration ==

=== Config principale (config.yml) ===

'''Performance optimization :'''
<syntaxhighlight lang="yaml">
# plugins/FastAsyncWorldEdit/config.yml

queue:
# Traitement asynchrone (recommandé)
parallel-threads: 4 # Nombre de threads (cores CPU - 2)

# Mode de stockage
# DISK = lent mais pas de limite mémoire
# MEMORY = rapide mais consomme RAM
type: MEMORY

# Taille max queue avant flush
target-size: 64

limits:
# Max blocs modifiables (0 = illimité pour op)
default:
maximum-blocks: 50000000 # 50 millions
maximum-entities: 1337
maximum-iterations: 1000

# Activer limites strictes
use-disk: true

# Max changements stockés en mémoire
max-memory-percent: 95

history:
# Taille historique (rollback)
size: 15

# Compression (économise RAM)
compress: true

# Stockage sur disque si trop gros
use-disk: true

lighting:
# Fix lighting automatique (recommandé OFF pour perfs)
mode: 0 # 0=off, 1=server, 2=client

# Async lighting
async: true

clipboard:
# Compression clipboard
compression-level: 1

# Disque si trop gros
use-disk: true
</syntaxhighlight>

'''Optimisation pour gros serveurs :'''
<syntaxhighlight lang="yaml">
# Pour serveurs avec beaucoup de joueurs
queue:
parallel-threads: 8 # Plus de threads
type: DISK # Éviter OOM

limits:
max-memory-percent: 80 # Laisser RAM au serveur

history:
size: 5 # Moins d'historique
use-disk: true # Toujours sur disque
</syntaxhighlight>

=== Limites par groupe (limits.yml) ===

<syntaxhighlight lang="yaml">
# plugins/FastAsyncWorldEdit/limits.yml

# Groupes LuckPerms
groups:
default:
maximum-blocks: 100000 # 100k blocs
maximum-entities: 50
maximum-iterations: 500
max-changes: 5 # 5 rollbacks

builder:
maximum-blocks: 5000000 # 5M blocs
maximum-entities: 200
maximum-iterations: 2000
max-changes: 10

admin:
maximum-blocks: 50000000 # 50M blocs
maximum-entities: 1000
maximum-iterations: 5000
max-changes: 50

# Permissions individuelles
users:
Notch:
maximum-blocks: 999999999 # Illimité
</syntaxhighlight>

=== Integration avec permissions ===

'''Permissions LuckPerms :'''
<syntaxhighlight lang="bash">
# Accès WorldEdit de base
/lp group builder permission set worldedit.* true

# Limites spécifiques
/lp group builder permission set fawe.limit true

# Commandes avancées
/lp group admin permission set fawe.admin true

# Bypass toutes limites
/lp group owner permission set fawe.bypass true

# Permissions spécifiques
/lp group builder permission set worldedit.region.* true
/lp group builder permission set worldedit.selection.* true
/lp group builder permission set worldedit.clipboard.* true
</syntaxhighlight>

== Commandes ==

=== Commandes de base (WorldEdit standard) ===

{| class="wikitable"
! Commande !! Description !! Exemple
|-
| <code>//wand</code> || Obtenir l'outil de sélection || <code>//wand</code>
|-
| <code>//pos1</code> || Définir position 1 || <code>//pos1</code>
|-
| <code>//pos2</code> || Définir position 2 || <code>//pos2</code>
|-
| <code>//set <block></code> || Remplir sélection || <code>//set stone</code>
|-
| <code>//replace <from> <to></code> || Remplacer blocs || <code>//replace dirt grass_block</code>
|-
| <code>//copy</code> || Copier sélection || <code>//copy</code>
|-
| <code>//cut</code> || Couper sélection || <code>//cut</code>
|-
| <code>//paste</code> || Coller clipboard || <code>//paste</code>
|-
| <code>//undo</code> || Annuler dernière action || <code>//undo</code>
|-
| <code>//redo</code> || Refaire action annulée || <code>//redo</code>
|}

=== Commandes FAWE spécifiques ===

{| class="wikitable"
! Commande !! Description !! Exemple
|-
| <code>//fast</code> || Toggle mode rapide || <code>//fast</code>
|-
| <code>//>pos1</code> || Pos1 asynchrone || <code>//>pos1</code>
|-
| <code>//fixlighting</code> || Corriger lumière || <code>//fixlighting</code>
|-
| <code>//cfi</code> || Create From Image || <code>//cfi</code>
|-
| <code>//cancel</code> || Annuler action en cours || <code>//cancel</code>
|-
| <code>//queue</code> || Info sur la queue || <code>//queue</code>
|-
| <code>//gtexture</code> || Texture depuis bloc || <code>//gtexture</code>
|-
| <code>//replaceall</code> || Replace dans tout le monde || <code>//replaceall dirt stone</code>
|-
| <code>//count</code> || Compter blocs sélection || <code>//count stone</code>
|-
| <code>//distr</code> || Distribution des blocs || <code>//distr</code>
|}

=== Sélections avancées ===

<syntaxhighlight lang="bash">
# Sélection chunk entier
//chunk

# Sélection par région (avec WorldGuard)
//region <nom>

# Expansion sélection
//expand 10 up # 10 blocs vers le haut
//expand vert # Jusqu'à bedrock et sky
//expand 20 north # 20 blocs au nord

# Contraction
//contract 5 down

# Sélection polygonale
//sel poly

# Sélection sphérique
//sel sphere
</syntaxhighlight>

=== Patterns avancés ===

<syntaxhighlight lang="bash">
# Pattern simple
//set stone

# Multiple blocs (random)
//set stone,dirt,grass_block

# Avec pourcentages
//set 70%stone,20%dirt,10%cobblestone

# Pattern depuis clipboard
//set #clipboard

# Pattern gradient
//set stone,grass_block:#gradient

# Pattern depuis image
//set #imageheight:image.png

# Expressions
//set %x%y%z # Pattern mathématique
</syntaxhighlight>

=== Masques avancés ===

<syntaxhighlight lang="bash">
# Masque simple
//gmask stone # Affecter uniquement stone

# Masque inverse
//gmask !stone # Tout sauf stone

# Masque multiple
//gmask stone,dirt,grass_block

# Masque par hauteur
//gmask >60 # Au-dessus Y=60

# Masque par biome
//gmask $jungle

# Masque combiné
//gmask stone,dirt >60 !#existing # Stone/dirt, Y>60, sans blocs existants

# Désactiver masque
//gmask
</syntaxhighlight>

=== Brushes ===

<syntaxhighlight lang="bash">
# Brush sphère
//br sphere stone 5 # Rayon 5

# Brush cylindre
//br cylinder grass_block 5 3 # Rayon 5, hauteur 3

# Brush smooth
//br smooth 3 # Adoucir terrain

# Brush clipboard
//br copy # Coller clipboard en brush

# Taille brush
/size 10

# Masque brush
/mask grass_block # N'affecter que l'herbe

# Désactiver brush
//br none
</syntaxhighlight>

== Exemples d'utilisation ==

=== Terrain depuis image ===

<syntaxhighlight lang="bash">
# 1. Placer image dans plugins/FastAsyncWorldEdit/heightmaps/
# Format: PNG, blanc=haut, noir=bas

# 2. Lancer CFI
//cfi

# 3. Suivre le menu interactif
# Ou en une commande:
//cfi heightmap.png
</syntaxhighlight>

=== Construction massive ===

<syntaxhighlight lang="bash">
# Pyramide géante
//pyramid stone 100 # Base 100x100

# Sphère creuse
//hsphere glass 50

# Cylindre
//cyl stone 30 50 # Rayon 30, hauteur 50

# Forêt aléatoire
//forest 1000 # 1000 arbres
</syntaxhighlight>

=== Terraforming ===

<syntaxhighlight lang="bash">
# Adoucir terrain
//sel convex # Sélection convexe
//smooth 5 # Lisser 5 itérations

# Élever terrain
//raise 10

# Abaisser terrain
//lower 5

# Déformer
//deform y+=0.2*sin(x*5)
</syntaxhighlight>

=== Schematics ===

<syntaxhighlight lang="bash">
# Sauvegarder
//copy
//schem save maison

# Charger
//schem load maison
//paste

# Lister
//schem list

# Avec rotation
//rotate 90
//paste
</syntaxhighlight>

== Intégrations ==

=== PlotSquared ===

FAWE s'intègre parfaitement avec [[PlotSquared]] :

<syntaxhighlight lang="yaml">
# plugins/PlotSquared/settings/worlds.yml
worlds:
plotworld:
fawe:
# Limites par plot
max-blocks: 1000000
max-entities: 500
</syntaxhighlight>

=== WorldGuard ===

<syntaxhighlight lang="bash">
# Sélectionner région WorldGuard
//region spawn

# Éditer dans région uniquement
//gmask $spawn # Masque par région
</syntaxhighlight>

=== API pour développeurs ===

<syntaxhighlight lang="java">
// Dépendance Maven
<dependency>
<groupId>com.fastasyncworldedit</groupId>
<artifactId>FastAsyncWorldEdit-Core</artifactId>
<version>2.9.2</version>
<scope>provided</scope>
</dependency>

// Utilisation
import com.fastasyncworldedit.core.FaweAPI;
import com.sk89q.worldedit.EditSession;
import com.sk89q.worldedit.WorldEdit;
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldedit.math.BlockVector3;
import com.sk89q.worldedit.world.World;
import com.sk89q.worldedit.world.block.BlockTypes;

public void setBlockAsync(org.bukkit.World world, int x, int y, int z) {
World weWorld = BukkitAdapter.adapt(world);

try (EditSession editSession = WorldEdit.getInstance()
.newEditSessionBuilder()
.world(weWorld)
.fastMode(true) // Mode FAWE rapide
.build()) {

BlockVector3 pos = BlockVector3.at(x, y, z);
editSession.setBlock(pos, BlockTypes.STONE.getDefaultState());
}
}
</syntaxhighlight>

== Dépannage ==

=== Problèmes courants ===

'''OutOfMemoryError :'''
<syntaxhighlight lang="yaml">
# config.yml
queue:
type: DISK # Utiliser disque au lieu de RAM

limits:
max-memory-percent: 80
use-disk: true

history:
use-disk: true
</syntaxhighlight>

<syntaxhighlight lang="bash">
# Augmenter RAM serveur
java -Xmx8G -jar server.jar
</syntaxhighlight>

'''Lag lors d'éditions :'''
<syntaxhighlight lang="yaml">
# config.yml
queue:
parallel-threads: 2 # Réduire threads

lighting:
mode: 0 # Désactiver lighting auto
</syntaxhighlight>

'''Actions annulées automatiquement :'''
<syntaxhighlight lang="bash">
# Augmenter les limites
/lp group builder permission set fawe.limit.2000000
# 2M blocs max
</syntaxhighlight>

'''Lighting cassée après édition :'''
<syntaxhighlight lang="bash">
# Corriger manuellement
//fixlighting

# Ou activer auto-fix
# config.yml: lighting.mode: 1
</syntaxhighlight>

'''Conflit avec WorldEdit :'''
<syntaxhighlight lang="bash">
# Supprimer WorldEdit
rm plugins/WorldEdit*.jar

# Ne garder que FAWE
plugins/
└── FastAsyncWorldEdit-Bukkit-*.jar
</syntaxhighlight>

=== Commandes de diagnostic ===

<syntaxhighlight lang="bash">
# Info version
/version FastAsyncWorldEdit

# État de la queue
//queue

# Mémoire utilisée
/fawe debugpaste

# Annuler action bloquée
//cancel
</syntaxhighlight>

== Performance ==

=== Benchmarks ===

Tests sur serveur Paper 1.20.1, CPU 8 cores, 16GB RAM :

{| class="wikitable"
! Opération !! WorldEdit !! FAWE !! Gain
|-
| //set 1M blocs || ~45s || ~2.5s || '''18x plus rapide'''
|-
| //copy structure 500k blocs || ~30s || ~1.8s || '''16x plus rapide'''
|-
| //smooth région 200x200 || ~60s || ~4s || '''15x plus rapide'''
|-
| //replace 5M blocs || ~3min || ~8s || '''22x plus rapide'''
|-
| Schematic load+paste 1M || ~25s || ~1.5s || '''16x plus rapide'''
|}

=== Optimisation maximale ===

<syntaxhighlight lang="yaml">
# config.yml - Configuration performance extrême
queue:
parallel-threads: 8 # Tous les cores
type: MEMORY # RAM si disponible
target-size: 128 # Grande queue

limits:
use-disk: false # Tout en RAM
max-memory-percent: 90

history:
size: 2 # Minimal
compress: true
use-disk: false

lighting:
mode: 0 # OFF
async: true

clipboard:
compression-level: 0 # Pas de compression
use-disk: false
</syntaxhighlight>

== Voir aussi ==

* [[WorldEdit]]
* [[PlotSquared]]
* [[WorldGuard]]
* [[VoxelSniper]]
* [[GoPaint]]

== Liens externes ==

* [https://www.spigotmc.org/resources/13932/ Page SpigotMC]
* [https://modrinth.com/plugin/fastasyncworldedit Page Modrinth]
* [https://github.com/IntellectualSites/FastAsyncWorldEdit GitHub]
* [https://intellectualsites.gitbook.io/fastasyncworldedit/ Documentation officielle]
* [https://discord.gg/intellectualsites Discord IntellectualSites]
* [https://www.youtube.com/watch?v=VIDEO Tutoriels vidéo]

== Références ==
<references />

Plugin:FastAsyncWorldEdit - Historique des versions

Hiob : Liens

Hiob : Hiob a déplacé la page FastAsyncWorldEdit vers Plugin:FastAsyncWorldEdit sans laisser de redirection