Tu jest cała dokumentacja, pokaż mi realne przykłady uzycia z wyjaśnieniem czym są dane klasy abym lepiej to zrozumiał na przyszłość
📄
pasted-code-1769705177143.txt
txt
1154 lines
▶
# 🎓 WorldEdit & WorldGuard API - Kompletny Przewodnik
## 📚 Spis treści
1. [Setup & Dependencies](#setup)
2. [WorldEdit API - Podstawy](#worldedit-basics)
3. [WorldEdit API - Zaawansowane](#worldedit-advanced)
4. [WorldGuard API - Podstawy](#worldguard-basics)
5. [WorldGuard API - Zaawansowane](#worldguard-advanced)
6. [Praktyczne przykłady](#examples)
---
## 🔧 Setup & Dependencies {#setup}
### Maven Dependencies
```xml
enginehub-maven
https://maven.enginehub.org/repo/
com.sk89q.worldedit
worldedit-core
7.3.0
provided
com.sk89q.worldedit
worldedit-bukkit
7.3.0
provided
com.sk89q.worldguard
worldguard-core
7.0.9
provided
com.sk89q.worldguard
worldguard-bukkit
7.0.9
provided
```
### plugin.yml
```yaml
name: YourPlugin
version: 1.0
main: com.example.YourPlugin
api-version: 1.21
depend: [WorldEdit, WorldGuard] # Wymaga obu pluginów
```
---
## 🌍 WorldEdit API - Podstawy {#worldedit-basics}
### 1. Inicjalizacja WorldEdit
```java
import com.sk89q.worldedit.WorldEdit;
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldedit.world.World;
public class WorldEditHelper {
private final WorldEdit worldEdit;
public WorldEditHelper() {
this.worldEdit = WorldEdit.getInstance();
}
// Konwersja Bukkit World -> WorldEdit World
public World getWorld(org.bukkit.World bukkitWorld) {
return BukkitAdapter.adapt(bukkitWorld);
}
}
```
### 2. Konwersje między Bukkit a WorldEdit
```java
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldedit.math.BlockVector3;
import com.sk89q.worldedit.world.block.BlockState;
import org.bukkit.Location;
import org.bukkit.Material;
import org.bukkit.block.Block;
public class Conversions {
// Bukkit Location -> WorldEdit BlockVector3
public BlockVector3 toBlockVector(Location location) {
return BlockVector3.at(location.getX(), location.getY(), location.getZ());
}
// WorldEdit BlockVector3 -> Bukkit Location
public Location toLocation(BlockVector3 vector, org.bukkit.World world) {
return new Location(world, vector.getX(), vector.getY(), vector.getZ());
}
// Bukkit Material -> WorldEdit BlockState
public BlockState toBlockState(Material material) {
return BukkitAdapter.adapt(material.createBlockData());
}
// WorldEdit BlockState -> Bukkit Material
public Material toMaterial(BlockState blockState) {
return BukkitAdapter.adapt(blockState).getMaterial();
}
// Bukkit Block -> WorldEdit BlockState
public BlockState getBlockState(Block block) {
return BukkitAdapter.adapt(block.getBlockData());
}
}
```
### 3. Podstawowe operacje na blokach
```java
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.BlockState;
import com.sk89q.worldedit.world.block.BlockTypes;
public class BasicBlockOperations {
// Ustaw pojedynczy blok
public void setBlock(org.bukkit.World bukkitWorld, int x, int y, int z, Material material) {
World world = BukkitAdapter.adapt(bukkitWorld);
BlockVector3 pos = BlockVector3.at(x, y, z);
BlockState blockState = BukkitAdapter.adapt(material.createBlockData());
try (EditSession editSession = WorldEdit.getInstance().newEditSession(world)) {
editSession.setBlock(pos, blockState);
} catch (Exception e) {
e.printStackTrace();
}
}
// Pobierz blok
public Material getBlock(org.bukkit.World bukkitWorld, int x, int y, int z) {
World world = BukkitAdapter.adapt(bukkitWorld);
BlockVector3 pos = BlockVector3.at(x, y, z);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(world)) {
BlockState blockState = editSession.getBlock(pos);
return BukkitAdapter.adapt(blockState).getMaterial();
} catch (Exception e) {
e.printStackTrace();
return Material.AIR;
}
}
}
```
### 4. Wypełnianie regionów
```java
import com.sk89q.worldedit.EditSession;
import com.sk89q.worldedit.WorldEdit;
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldedit.function.pattern.BlockPattern;
import com.sk89q.worldedit.math.BlockVector3;
import com.sk89q.worldedit.regions.CuboidRegion;
import com.sk89q.worldedit.world.World;
import com.sk89q.worldedit.world.block.BlockState;
public class RegionFilling {
/**
* Wypełnia prostopadłościan jednym materiałem
*/
public void fillCuboid(org.bukkit.World bukkitWorld,
BlockVector3 pos1,
BlockVector3 pos2,
Material material) {
World world = BukkitAdapter.adapt(bukkitWorld);
BlockState blockState = BukkitAdapter.adapt(material.createBlockData());
CuboidRegion region = new CuboidRegion(world, pos1, pos2);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(world)) {
editSession.setBlocks(region, new BlockPattern(blockState));
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* Wypełnia warstwę (płaski poziom Y)
*/
public void fillLayer(org.bukkit.World bukkitWorld,
int minX, int minZ,
int maxX, int maxZ,
int y,
Material material) {
BlockVector3 pos1 = BlockVector3.at(minX, y, minZ);
BlockVector3 pos2 = BlockVector3.at(maxX, y, maxZ);
fillCuboid(bukkitWorld, pos1, pos2, material);
}
/**
* Czyści region (zamienia wszystko na AIR)
*/
public void clearRegion(org.bukkit.World bukkitWorld,
BlockVector3 pos1,
BlockVector3 pos2) {
fillCuboid(bukkitWorld, pos1, pos2, Material.AIR);
}
}
```
---
## 🚀 WorldEdit API - Zaawansowane {#worldedit-advanced}
### 1. Schematics - Zapisywanie i ładowanie struktur
```java
import com.sk89q.worldedit.EditSession;
import com.sk89q.worldedit.WorldEdit;
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldedit.extent.clipboard.BlockArrayClipboard;
import com.sk89q.worldedit.extent.clipboard.Clipboard;
import com.sk89q.worldedit.extent.clipboard.io.*;
import com.sk89q.worldedit.function.operation.ForwardExtentCopy;
import com.sk89q.worldedit.function.operation.Operation;
import com.sk89q.worldedit.function.operation.Operations;
import com.sk89q.worldedit.math.BlockVector3;
import com.sk89q.worldedit.regions.CuboidRegion;
import com.sk89q.worldedit.world.World;
import java.io.*;
public class SchematicManager {
/**
* Zapisuje region do pliku schematic
*/
public void saveSchematic(org.bukkit.World bukkitWorld,
BlockVector3 pos1,
BlockVector3 pos2,
File file) throws IOException {
World world = BukkitAdapter.adapt(bukkitWorld);
CuboidRegion region = new CuboidRegion(world, pos1, pos2);
BlockArrayClipboard clipboard = new BlockArrayClipboard(region);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(world)) {
ForwardExtentCopy copy = new ForwardExtentCopy(
editSession, region, clipboard, region.getMinimumPoint()
);
Operations.complete(copy);
}
try (ClipboardWriter writer = BuiltInClipboardFormat.SPONGE_SCHEMATIC
.getWriter(new FileOutputStream(file))) {
writer.write(clipboard);
}
}
/**
* Wczytuje schematic z pliku
*/
public Clipboard loadSchematic(File file) throws IOException {
ClipboardFormat format = ClipboardFormats.findByFile(file);
if (format == null) {
throw new IOException("Nieznany format schematic!");
}
try (ClipboardReader reader = format.getReader(new FileInputStream(file))) {
return reader.read();
}
}
/**
* Wkleja schematic w danej lokalizacji
*/
public void pasteSchematic(org.bukkit.World bukkitWorld,
Clipboard clipboard,
BlockVector3 position) {
World world = BukkitAdapter.adapt(bukkitWorld);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(world)) {
Operation operation = new ClipboardHolder(clipboard)
.createPaste(editSession)
.to(position)
.ignoreAirBlocks(false)
.build();
Operations.complete(operation);
} catch (Exception e) {
e.printStackTrace();
}
}
}
```
### 2. Patterns - Wzory wypełniania
```java
import com.sk89q.worldedit.function.pattern.*;
import com.sk89q.worldedit.world.block.BlockState;
import com.sk89q.worldedit.world.block.BlockTypes;
public class PatternExamples {
// Jeden blok
public Pattern singleBlock(BlockState block) {
return new BlockPattern(block);
}
// Losowy mix bloków
public Pattern randomPattern() {
RandomPattern pattern = new RandomPattern();
pattern.add(BlockTypes.STONE.getDefaultState(), 50); // 50% szansy
pattern.add(BlockTypes.COBBLESTONE.getDefaultState(), 30); // 30%
pattern.add(BlockTypes.GRAVEL.getDefaultState(), 20); // 20%
return pattern;
}
// Wzór szachownicy
public Pattern checkerboard(BlockState block1, BlockState block2) {
return new CheckerboardPattern(
new BlockPattern(block1),
new BlockPattern(block2),
1, 1, 1 // Rozmiar kwadratów
);
}
}
```
### 3. Masks - Maski selekcji
```java
import com.sk89q.worldedit.function.mask.*;
import com.sk89q.worldedit.world.block.BlockTypes;
public class MaskExamples {
// Tylko określone bloki
public Mask onlyStone() {
return new BlockTypeMask(null, BlockTypes.STONE);
}
// Wszystko oprócz powietrza
public Mask noAir() {
return new InverseSingleBlockTypeMask(null, BlockTypes.AIR);
}
// Połączenie masek (AND)
public Mask combined() {
Mask mask1 = new BlockTypeMask(null, BlockTypes.STONE);
Mask mask2 = new RegionMask(someRegion);
return Masks.and(mask1, mask2);
}
}
```
### 4. Operacje zaawansowane
```java
import com.sk89q.worldedit.EditSession;
import com.sk89q.worldedit.WorldEdit;
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldedit.function.operation.Operations;
import com.sk89q.worldedit.function.visitor.RegionVisitor;
import com.sk89q.worldedit.math.BlockVector3;
import com.sk89q.worldedit.regions.CuboidRegion;
import com.sk89q.worldedit.world.World;
import com.sk89q.worldedit.world.block.BlockTypes;
public class AdvancedOperations {
/**
* Zamienia wszystkie bloki danego typu w regionie
*/
public void replaceBlocks(org.bukkit.World bukkitWorld,
BlockVector3 pos1,
BlockVector3 pos2,
Material from,
Material to) {
World world = BukkitAdapter.adapt(bukkitWorld);
CuboidRegion region = new CuboidRegion(world, pos1, pos2);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(world)) {
int replaced = editSession.replaceBlocks(
region,
new BlockTypeMask(editSession,
BukkitAdapter.asBlockType(from)),
BukkitAdapter.adapt(to.createBlockData())
);
System.out.println("Zamieniono " + replaced + " bloków");
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* Tworzy ściany wokół regionu (pusta kostka)
*/
public void createWalls(org.bukkit.World bukkitWorld,
BlockVector3 pos1,
BlockVector3 pos2,
Material material) {
World world = BukkitAdapter.adapt(bukkitWorld);
CuboidRegion region = new CuboidRegion(world, pos1, pos2);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(world)) {
editSession.makeWalls(
region,
new BlockPattern(BukkitAdapter.adapt(material.createBlockData()))
);
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* Smoothing - wygładza teren
*/
public void smoothTerrain(org.bukkit.World bukkitWorld,
BlockVector3 pos1,
BlockVector3 pos2,
int iterations) {
World world = BukkitAdapter.adapt(bukkitWorld);
CuboidRegion region = new CuboidRegion(world, pos1, pos2);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(world)) {
HeightMap heightMap = new HeightMap(editSession, region);
heightMap.applyFilter(HeightMapFilter.MEDIAN, iterations);
} catch (Exception e) {
e.printStackTrace();
}
}
}
```
---
## 🛡️ WorldGuard API - Podstawy {#worldguard-basics}
### 1. Inicjalizacja WorldGuard
```java
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldguard.WorldGuard;
import com.sk89q.worldguard.protection.managers.RegionManager;
import com.sk89q.worldguard.protection.regions.RegionContainer;
public class WorldGuardHelper {
/**
* Pobierz RegionManager dla danego świata
*/
public RegionManager getRegionManager(org.bukkit.World world) {
RegionContainer container = WorldGuard.getInstance()
.getPlatform()
.getRegionContainer();
return container.get(BukkitAdapter.adapt(world));
}
}
```
### 2. Tworzenie regionów
```java
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldedit.math.BlockVector3;
import com.sk89q.worldguard.protection.managers.RegionManager;
import com.sk89q.worldguard.protection.regions.ProtectedCuboidRegion;
import com.sk89q.worldguard.protection.regions.ProtectedRegion;
public class RegionCreation {
/**
* Tworzy prostopadłościenny region
*/
public void createCuboidRegion(org.bukkit.World world,
String regionName,
BlockVector3 pos1,
BlockVector3 pos2) {
RegionManager regionManager = getRegionManager(world);
// Twórz region
ProtectedRegion region = new ProtectedCuboidRegion(regionName, pos1, pos2);
// Dodaj do managera
regionManager.addRegion(region);
}
/**
* Usuwa region
*/
public void removeRegion(org.bukkit.World world, String regionName) {
RegionManager regionManager = getRegionManager(world);
regionManager.removeRegion(regionName);
}
/**
* Sprawdza czy region istnieje
*/
public boolean regionExists(org.bukkit.World world, String regionName) {
RegionManager regionManager = getRegionManager(world);
return regionManager.hasRegion(regionName);
}
/**
* Pobiera region
*/
public ProtectedRegion getRegion(org.bukkit.World world, String regionName) {
RegionManager regionManager = getRegionManager(world);
return regionManager.getRegion(regionName);
}
}
```
### 3. Flagi regionów
```java
import com.sk89q.worldguard.protection.flags.Flags;
import com.sk89q.worldguard.protection.flags.StateFlag;
import com.sk89q.worldguard.protection.regions.ProtectedRegion;
public class RegionFlags {
/**
* Ustawia podstawowe flagi regionu
*/
public void setBasicFlags(ProtectedRegion region) {
// PvP
region.setFlag(Flags.PVP, StateFlag.State.DENY);
// Niszczenie bloków
region.setFlag(Flags.BLOCK_BREAK, StateFlag.State.DENY);
// Stawianie bloków
region.setFlag(Flags.BLOCK_PLACE, StateFlag.State.DENY);
// Damage od mobów
region.setFlag(Flags.MOB_DAMAGE, StateFlag.State.DENY);
// Wejście
region.setFlag(Flags.ENTRY, StateFlag.State.ALLOW);
// Wyjście
region.setFlag(Flags.EXIT, StateFlag.State.ALLOW);
}
/**
* Region areny buildowania
*/
public void setBuildArenaFlags(ProtectedRegion region) {
region.setFlag(Flags.BLOCK_BREAK, StateFlag.State.ALLOW);
region.setFlag(Flags.BLOCK_PLACE, StateFlag.State.ALLOW);
region.setFlag(Flags.PVP, StateFlag.State.DENY);
region.setFlag(Flags.MOB_DAMAGE, StateFlag.State.DENY);
region.setFlag(Flags.MOB_SPAWNING, StateFlag.State.DENY);
region.setFlag(Flags.CREEPER_EXPLOSION, StateFlag.State.DENY);
region.setFlag(Flags.TNT, StateFlag.State.DENY);
}
/**
* Safe zone (lobby)
*/
public void setSafeZoneFlags(ProtectedRegion region) {
region.setFlag(Flags.BLOCK_BREAK, StateFlag.State.DENY);
region.setFlag(Flags.BLOCK_PLACE, StateFlag.State.DENY);
region.setFlag(Flags.PVP, StateFlag.State.DENY);
region.setFlag(Flags.MOB_DAMAGE, StateFlag.State.DENY);
region.setFlag(Flags.INVINCIBILITY, StateFlag.State.ALLOW);
region.setFlag(Flags.FALL_DAMAGE, StateFlag.State.DENY);
}
}
```
### 4. Właściciele i członkowie regionów
```java
import com.sk89q.worldguard.domains.DefaultDomain;
import com.sk89q.worldguard.protection.regions.ProtectedRegion;
import org.bukkit.entity.Player;
import java.util.UUID;
public class RegionMembers {
/**
* Dodaje gracza jako właściciela regionu
*/
public void addOwner(ProtectedRegion region, Player player) {
DefaultDomain owners = region.getOwners();
owners.addPlayer(player.getUniqueId());
region.setOwners(owners);
}
/**
* Dodaje gracza jako członka regionu
*/
public void addMember(ProtectedRegion region, Player player) {
DefaultDomain members = region.getMembers();
members.addPlayer(player.getUniqueId());
region.setMembers(members);
}
/**
* Usuwa gracza z właścicieli
*/
public void removeOwner(ProtectedRegion region, UUID playerUUID) {
DefaultDomain owners = region.getOwners();
owners.removePlayer(playerUUID);
region.setOwners(owners);
}
/**
* Usuwa gracza z członków
*/
public void removeMember(ProtectedRegion region, UUID playerUUID) {
DefaultDomain members = region.getMembers();
members.removePlayer(playerUUID);
region.setMembers(members);
}
/**
* Sprawdza czy gracz jest właścicielem
*/
public boolean isOwner(ProtectedRegion region, Player player) {
return region.getOwners().contains(player.getUniqueId());
}
/**
* Sprawdza czy gracz jest członkiem
*/
public boolean isMember(ProtectedRegion region, Player player) {
return region.getMembers().contains(player.getUniqueId());
}
}
```
---
## 🏆 WorldGuard API - Zaawansowane {#worldguard-advanced}
### 1. Sprawdzanie czy lokalizacja jest w regionie
```java
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldedit.math.BlockVector3;
import com.sk89q.worldguard.protection.ApplicableRegionSet;
import com.sk89q.worldguard.protection.managers.RegionManager;
import com.sk89q.worldguard.protection.regions.ProtectedRegion;
import org.bukkit.Location;
public class RegionChecks {
/**
* Sprawdza czy lokalizacja jest w danym regionie
*/
public boolean isInRegion(Location location, String regionName) {
RegionManager regionManager = getRegionManager(location.getWorld());
ProtectedRegion region = regionManager.getRegion(regionName);
if (region == null) return false;
BlockVector3 vector = BlockVector3.at(
location.getX(),
location.getY(),
location.getZ()
);
return region.contains(vector);
}
/**
* Pobiera wszystkie regiony w danej lokalizacji
*/
public ApplicableRegionSet getRegionsAt(Location location) {
RegionManager regionManager = getRegionManager(location.getWorld());
BlockVector3 vector = BlockVector3.at(
location.getX(),
location.getY(),
location.getZ()
);
return regionManager.getApplicableRegions(vector);
}
/**
* Sprawdza czy gracz może budować w lokalizacji
*/
public boolean canBuild(Player player, Location location) {
ApplicableRegionSet regions = getRegionsAt(location);
return regions.testState(
BukkitAdapter.adapt(player),
Flags.BLOCK_PLACE
);
}
}
```
### 2. Region Events - Wejście/Wyjście z regionu
```java
import com.sk89q.worldguard.protection.ApplicableRegionSet;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.player.PlayerMoveEvent;
import java.util.HashSet;
import java.util.Set;
import java.util.UUID;
public class RegionListener implements Listener {
private final Map> playerRegions = new HashMap<>();
@EventHandler
public void onPlayerMove(PlayerMoveEvent event) {
// Sprawdź czy gracz zmienił blok
if (event.getFrom().getBlockX() == event.getTo().getBlockX() &&
event.getFrom().getBlockY() == event.getTo().getBlockY() &&
event.getFrom().getBlockZ() == event.getTo().getBlockZ()) {
return;
}
Player player = event.getPlayer();
UUID uuid = player.getUniqueId();
// Pobierz regiony w nowej lokalizacji
ApplicableRegionSet newRegions = getRegionsAt(event.getTo());
Set newRegionNames = new HashSet<>();
for (ProtectedRegion region : newRegions) {
newRegionNames.add(region.getId());
}
// Pobierz stare regiony gracza
Set oldRegionNames = playerRegions.getOrDefault(uuid, new HashSet<>());
// Sprawdź wejścia do nowych regionów
for (String regionName : newRegionNames) {
if (!oldRegionNames.contains(regionName)) {
onRegionEnter(player, regionName);
}
}
// Sprawdź wyjścia ze starych regionów
for (String regionName : oldRegionNames) {
if (!newRegionNames.contains(regionName)) {
onRegionExit(player, regionName);
}
}
// Zaktualizuj mapę
playerRegions.put(uuid, newRegionNames);
}
private void onRegionEnter(Player player, String regionName) {
player.sendMessage("§aWszedłeś do regionu: " + regionName);
// Twoja logika
}
private void onRegionExit(Player player, String regionName) {
player.sendMessage("§cWyszedłeś z regionu: " + regionName);
// Twoja logika
}
}
```
### 3. Priorytety regionów
```java
public class RegionPriorities {
/**
* Ustawia priorytet regionu
* Wyższy priorytet = ważniejszy region
*/
public void setPriority(ProtectedRegion region, int priority) {
region.setPriority(priority);
}
/**
* Tworzy hierarchię regionów
* child dziedziczy flagi od parent
*/
public void setParent(ProtectedRegion child, ProtectedRegion parent) {
try {
child.setParent(parent);
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* Przykład: Lobby (priorytet 100) > Arena (priorytet 50) > spawn (priorytet 10)
*/
public void setupHierarchy(org.bukkit.World world) {
RegionManager rm = getRegionManager(world);
ProtectedRegion lobby = rm.getRegion("lobby");
ProtectedRegion arena1 = rm.getRegion("arena1");
ProtectedRegion spawn = rm.getRegion("spawn");
lobby.setPriority(100);
arena1.setPriority(50);
spawn.setPriority(10);
// Arena dziedziczy flagi od lobby
try {
arena1.setParent(lobby);
} catch (Exception e) {
e.printStackTrace();
}
}
}
```
---
## 💡 Praktyczne przykłady {#examples}
### Przykład 1: System aren BuildBattle
```java
import com.sk89q.worldedit.bukkit.BukkitAdapter;
import com.sk89q.worldedit.math.BlockVector3;
import com.sk89q.worldguard.protection.flags.Flags;
import com.sk89q.worldguard.protection.flags.StateFlag;
import com.sk89q.worldguard.protection.managers.RegionManager;
import com.sk89q.worldguard.protection.regions.ProtectedCuboidRegion;
import com.sk89q.worldguard.protection.regions.ProtectedRegion;
public class BuildBattleArenaSystem {
/**
* Tworzy arenę BuildBattle z odpowiednimi flagami
*/
public void createBuildArena(org.bukkit.World world,
String arenaName,
BlockVector3 pos1,
BlockVector3 pos2,
List teamPlayers) {
RegionManager rm = getRegionManager(world);
// Utwórz region
ProtectedRegion arena = new ProtectedCuboidRegion(arenaName, pos1, pos2);
// Ustaw flagi
arena.setFlag(Flags.BLOCK_BREAK, StateFlag.State.ALLOW);
arena.setFlag(Flags.BLOCK_PLACE, StateFlag.State.ALLOW);
arena.setFlag(Flags.PVP, StateFlag.State.DENY);
arena.setFlag(Flags.MOB_DAMAGE, StateFlag.State.DENY);
arena.setFlag(Flags.MOB_SPAWNING, StateFlag.State.DENY);
arena.setFlag(Flags.FIRE_SPREAD, StateFlag.State.DENY);
arena.setFlag(Flags.LEAF_DECAY, StateFlag.State.DENY);
// Dodaj graczy jako członków (mogą budować)
DefaultDomain members = new DefaultDomain();
for (Player player : teamPlayers) {
members.addPlayer(player.getUniqueId());
}
arena.setMembers(members);
// Zapisz region
rm.addRegion(arena);
}
/**
* Czyści arenę po rundzie
*/
public void clearArena(org.bukkit.World world, String arenaName) {
RegionManager rm = getRegionManager(world);
ProtectedRegion arena = rm.getRegion(arenaName);
if (arena == null) return;
// Pobierz granice
BlockVector3 min = arena.getMinimumPoint();
BlockVector3 max = arena.getMaximumPoint();
// Wyczyść używając WorldEdit
World weWorld = BukkitAdapter.adapt(world);
CuboidRegion region = new CuboidRegion(weWorld, min, max);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(weWorld)) {
editSession.setBlocks(region, BlockTypes.AIR.getDefaultState());
} catch (Exception e) {
e.printStackTrace();
}
}
}
```
### Przykład 2: Safe Zone (Lobby)
```java
public class SafeZoneManager {
/**
* Tworzy bezpieczną strefę lobby
*/
public void createSafeZone(org.bukkit.World world,
String zoneName,
BlockVector3 pos1,
BlockVector3 pos2) {
RegionManager rm = getRegionManager(world);
ProtectedRegion safeZone = new ProtectedCuboidRegion(zoneName, pos1, pos2);
// Maksymalna ochrona
safeZone.setFlag(Flags.BLOCK_BREAK, StateFlag.State.DENY);
safeZone.setFlag(Flags.BLOCK_PLACE, StateFlag.State.DENY);
safeZone.setFlag(Flags.PVP, StateFlag.State.DENY);
safeZone.setFlag(Flags.MOB_DAMAGE, StateFlag.State.DENY);
safeZone.setFlag(Flags.DAMAGE_ANIMALS, StateFlag.State.DENY);
safeZone.setFlag(Flags.FALL_DAMAGE, StateFlag.State.DENY);
safeZone.setFlag(Flags.FIRE_SPREAD, StateFlag.State.DENY);
safeZone.setFlag(Flags.LAVA_FLOW, StateFlag.State.DENY);
safeZone.setFlag(Flags.WATER_FLOW, StateFlag.State.DENY);
safeZone.setFlag(Flags.TNT, StateFlag.State.DENY);
safeZone.setFlag(Flags.CREEPER_EXPLOSION, StateFlag.State.DENY);
safeZone.setFlag(Flags.INTERACT, StateFlag.State.DENY); // Nie można używać przedmiotów
// Najwyższy priorytet
safeZone.setPriority(1000);
rm.addRegion(safeZone);
}
}
```
### Przykład 3: Kopiowanie i wklejanie struktur
```java
public class StructureManager {
/**
* Kopiuje arenę i wkleja ją w innym miejscu
*/
public void copyAndPasteArena(org.bukkit.World world,
BlockVector3 sourcePos1,
BlockVector3 sourcePos2,
BlockVector3 targetPosition) {
World weWorld = BukkitAdapter.adapt(world);
CuboidRegion sourceRegion = new CuboidRegion(weWorld, sourcePos1, sourcePos2);
// Kopiuj do clipboardu
BlockArrayClipboard clipboard = new BlockArrayClipboard(sourceRegion);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(weWorld)) {
ForwardExtentCopy copy = new ForwardExtentCopy(
editSession, sourceRegion, clipboard, sourceRegion.getMinimumPoint()
);
Operations.complete(copy);
} catch (Exception e) {
e.printStackTrace();
return;
}
// Wklej w nowej lokalizacji
try (EditSession editSession = WorldEdit.getInstance().newEditSession(weWorld)) {
Operation operation = new ClipboardHolder(clipboard)
.createPaste(editSession)
.to(targetPosition)
.ignoreAirBlocks(false)
.build();
Operations.complete(operation);
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* Zapisuje template areny do pliku
*/
public void saveArenaTemplate(org.bukkit.World world,
BlockVector3 pos1,
BlockVector3 pos2,
File file) {
SchematicManager manager = new SchematicManager();
try {
manager.saveSchematic(world, pos1, pos2, file);
System.out.println("Zapisano template areny do: " + file.getName());
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* Ładuje i wkleja template areny
*/
public void loadArenaTemplate(org.bukkit.World world,
File file,
BlockVector3 position) {
SchematicManager manager = new SchematicManager();
try {
Clipboard clipboard = manager.loadSchematic(file);
manager.pasteSchematic(world, clipboard, position);
System.out.println("Wklejono template areny z: " + file.getName());
} catch (IOException e) {
e.printStackTrace();
}
}
}
```
### Przykład 4: Integracja z Twoim BuildBattle
```java
public class BuildBattleIntegration {
/**
* Tworzy i konfiguruje rundę z WorldGuard
*/
public void setupRoundWithWorldGuard(int roundNumber,
org.bukkit.World world,
BlockVector3 pos1,
BlockVector3 pos2,
List teamPlayers) {
String regionName = "buildbattle_round" + roundNumber + "_" + System.currentTimeMillis();
// Utwórz region WorldGuard
RegionManager rm = getRegionManager(world);
ProtectedRegion region = new ProtectedCuboidRegion(regionName, pos1, pos2);
// Flagi dla budowania
region.setFlag(Flags.BLOCK_BREAK, StateFlag.State.ALLOW);
region.setFlag(Flags.BLOCK_PLACE, StateFlag.State.ALLOW);
region.setFlag(Flags.PVP, StateFlag.State.DENY);
region.setFlag(Flags.INTERACT, StateFlag.State.ALLOW);
// Tylko członkowie drużyny mogą budować
DefaultDomain members = new DefaultDomain();
for (Player player : teamPlayers) {
members.addPlayer(player.getUniqueId());
}
region.setMembers(members);
rm.addRegion(region);
// Wyczyść arenę WorldEdit
World weWorld = BukkitAdapter.adapt(world);
CuboidRegion weRegion = new CuboidRegion(weWorld, pos1, pos2);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(weWorld)) {
// Wyczyść wszystko
editSession.setBlocks(weRegion, BlockTypes.AIR.getDefaultState());
// Stwórz podłogę
int floorY = pos1.getY();
for (int x = pos1.getX(); x <= pos2.getX(); x++) {
for (int z = pos1.getZ(); z <= pos2.getZ(); z++) {
editSession.setBlock(
BlockVector3.at(x, floorY, z),
BlockTypes.GRASS_BLOCK.getDefaultState()
);
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* Usuwa region po zakończeniu rundy
*/
public void cleanupRound(org.bukkit.World world, String regionName) {
RegionManager rm = getRegionManager(world);
ProtectedRegion region = rm.getRegion(regionName);
if (region != null) {
// Wyczyść arenę
BlockVector3 min = region.getMinimumPoint();
BlockVector3 max = region.getMaximumPoint();
World weWorld = BukkitAdapter.adapt(world);
CuboidRegion weRegion = new CuboidRegion(weWorld, min, max);
try (EditSession editSession = WorldEdit.getInstance().newEditSession(weWorld)) {
editSession.setBlocks(weRegion, BlockTypes.AIR.getDefaultState());
} catch (Exception e) {
e.printStackTrace();
}
// Usuń region
rm.removeRegion(regionName);
}
}
}
```
---
## 📝 Podsumowanie - Best Practices
### ✅ DO:
1. **Zawsze używaj try-with-resources dla EditSession**
```java
try (EditSession editSession = WorldEdit.getInstance().newEditSession(world)) {
// operacje
}
```
2. **Konwertuj między Bukkit a WorldEdit używając BukkitAdapter**
```java
World weWorld = BukkitAdapter.adapt(bukkitWorld);
BlockVector3 vec = BlockVector3.at(x, y, z);
```
3. **Ustawiaj odpowiednie flagi WorldGuard dla różnych celów**
4. **Używaj priorytetów regionów do zarządzania nakładającymi się obszarami**
5. **Zapisuj schematics dla ponownego użycia struktur**
### ❌ DON'T:
1. **Nie zapominaj zamknąć EditSession** (memory leak!)
2. **Nie wykonuj dużych operacji WorldEdit bez async** (lag)
3. **Nie twórz zbyt wielu regionów WorldGuard** (obciążenie serwera)
4. **Nie używaj WorldEdit do pojedynczych bloków** (używaj Bukkit API)
---
Gotowy do kodzenia! Masz pytania o konkretne przypadki użycia? 🚀
Stworzę dla Ciebie projekt demonstracyjny pokazujący realne użycie WorldEdit i WorldGuard API z wyjaśnieniami kluczowych klas.
Wyjaśnienie kluczowych klas:
WorldEdit - Główne klasy:
EditSession - Główna klasa do operacji na blokach. Automatycznie zarządza historią zmian (undo/redo) i limitami bloków. ZAWSZE używaj try-with-resources!
BlockVector3 - Reprezentuje pozycję bloku (x, y, z) w świecie WorldEdit. Immutable (niemodyfikowalna).
BukkitAdapter - Konwerter między obiektami Bukkit a WorldEdit (World, Location, Material itp.)
CuboidRegion - Prostopadłościenny obszar (od punktu A do punktu B)
Clipboard - “Schowek” przechowujący skopiowane bloki. Używany do zapisywania/ładowania struktur.
Pattern - Wzór wypełniania (np. losowy mix bloków, szachownica)
Mask - Maska określająca które bloki mogą być modyfikowane
WorldGuard - Główne klasy:
RegionManager - Zarządza wszystkimi regionami w danym świecie
ProtectedRegion - Reprezentuje chroniony obszar z flagami i członkami
ProtectedCuboidRegion - Konkretny typ regionu (prostopadłościan)
Flags - Zawiera wszystkie dostępne flagi (PVP, BLOCK_BREAK, itp.)
DefaultDomain - Zbiór właścicieli/członków regionu (UUID graczy)
ApplicableRegionSet - Zbiór regionów w danej lokalizacji (uwzględnia priorytety i hierarchię)
Teraz stworzę działający przykład:
Podsumowanie - Co każda klasa robi:
WorldEditHelper
Odpowiada za wszystkie operacje WorldEdit:
setBlock() - ustawia pojedynczy blok (prosty przykład)
fillCuboid() - wypełnia prostopadłościan jednym materiałem
fillRandomPattern() - wypełnia losowym mixem bloków (40% stone, 30% cobble, etc.)
createWalls() - tworzy puste ściany (wnętrze puste)
replaceBlocks() - zamienia jeden blok na drugi w regionie
saveSchematic() / loadSchematic() / pasteSchematic() - zapisywanie/ładowanie struktur
RegionHelper
Odpowiada za operacje WorldGuard:
createRegion() / deleteRegion() - tworzenie/usuwanie regionów
setBuildArenaFlags() - flagi dla areny buildowania (można stawiać/niszczyć, nie ma PvP)
setSafeZoneFlags() - maksymalna ochrona (nic nie można)
addOwner() / addMember() - zarządzanie właścicielami/członkami
isInRegion() - sprawdza czy lokalizacja jest w regionie
canBuild() - sprawdza czy gracz może budować w danej lokalizacji
ArenaManager
Łączy WorldEdit + WorldGuard w praktyczne funkcje:
createBuildArena() - tworzy arenę z regionem WG + czyści teren WE + dodaje podłogę
clearArena() - czyści arenę po rundzie
saveArenaTemplate() - zapisuje arenę jako schematic
loadArenaTemplate() - wczytuje zapisaną arenę
RegionEventListener
Wykrywa wejście/wyjście z regionów:
Śledzi w jakich regionach są gracze
Wywołuje onRegionEnter() gdy gracz wchodzi
Wywołuje onRegionLeave() gdy gracz wychodzi
Jak to przetestować:
/wetest fill- Wypełni 5x5x5 kostki kamieniem/wetest random- Wypełni losowym wzorem/wgtest create testregion- Stworzy region/wgtest check- Sprawdzi w jakich regionach jesteś/arena create myarena- Stworzy arenę z ochroną WG/arena save template1- Zapisze arenę jako templateWejdź/wyjdź z regionu - zobaczysz wiadomości o wejściu/wyjściu
Plugin jest gotowy do testowania! Wszystkie przykłady pokazują realne użycie API z praktycznymi scenariuszami.
The compilation failed with this error:
Validation failed for compilation: Compilation failed with 24 error(s):
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 39: class, interface, enum, or record expected
</thinking>
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 44: class, interface, enum, or record expected
import com.sk89q.worldedit.EditSession;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 45: class, interface, enum, or record expected
import com.sk89q.worldedit.WorldEdit;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 46: class, interface, enum, or record expected
import com.sk89q.worldedit.bukkit.BukkitAdapter;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 47: class, interface, enum, or record expected
import com.sk89q.worldedit.extent.clipboard.BlockArrayClipboard;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 48: class, interface, enum, or record expected
import com.sk89q.worldedit.extent.clipboard.Clipboard;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 49: class, interface, enum, or record expected
import com.sk89q.worldedit.extent.clipboard.io.*;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 50: class, interface, enum, or record expected
import com.sk89q.worldedit.function.operation.ForwardExtentCopy;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 51: class, interface, enum, or record expected
import com.sk89q.worldedit.function.operation.Operation;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 52: class, interface, enum, or record expected
import com.sk89q.worldedit.function.operation.Operations;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 53: class, interface, enum, or record expected
import com.sk89q.worldedit.function.pattern.BlockPattern;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 54: class, interface, enum, or record expected
import com.sk89q.worldedit.function.pattern.RandomPattern;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 55: class, interface, enum, or record expected
import com.sk89q.worldedit.math.BlockVector3;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 56: class, interface, enum, or record expected
import com.sk89q.worldedit.regions.CuboidRegion;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 57: class, interface, enum, or record expected
import com.sk89q.worldedit.session.ClipboardHolder;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 58: class, interface, enum, or record expected
import com.sk89q.worldedit.world.World;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 59: class, interface, enum, or record expected
import com.sk89q.worldedit.world.block.BlockState;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 60: class, interface, enum, or record expected
import com.sk89q.worldedit.world.block.BlockTypes;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 61: class, interface, enum, or record expected
import org.bukkit.Location;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 62: class, interface, enum, or record expected
import org.bukkit.Material;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 64: class, interface, enum, or record expected
import java.io.File;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 65: class, interface, enum, or record expected
import java.io.FileInputStream;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 66: class, interface, enum, or record expected
import java.io.FileOutputStream;
^
ERROR in src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java at line 67: class, interface, enum, or record expected
import java.io.IOException;
^
=== COMPILATION ERROR ANALYSIS ===
SYNTAX ERRORS:
- Line 39: class, interface, enum, or record expected
- Line 44: class, interface, enum, or record expected
- Line 45: class, interface, enum, or record expected
- Line 46: class, interface, enum, or record expected
- Line 47: class, interface, enum, or record expected
- Line 48: class, interface, enum, or record expected
- Line 49: class, interface, enum, or record expected
- Line 50: class, interface, enum, or record expected
- Line 51: class, interface, enum, or record expected
- Line 52: class, interface, enum, or record expected
- Line 53: class, interface, enum, or record expected
- Line 54: class, interface, enum, or record expected
- Line 55: class, interface, enum, or record expected
- Line 56: class, interface, enum, or record expected
- Line 57: class, interface, enum, or record expected
- Line 58: class, interface, enum, or record expected
- Line 59: class, interface, enum, or record expected
- Line 60: class, interface, enum, or record expected
- Line 61: class, interface, enum, or record expected
- Line 62: class, interface, enum, or record expected
- Line 64: class, interface, enum, or record expected
- Line 65: class, interface, enum, or record expected
- Line 66: class, interface, enum, or record expected
- Line 67: class, interface, enum, or record expected
ACTION: Check for missing semicolons or brackets
FILES TO INVESTIGATE:
- src/main/java/com/example/worldeditguard/WorldEditGuardExamples.java
exceeds maximum
Please fix this error by creating a new artifact with the corrected code.
I need to read the corrupted file to see what’s causing the syntax error. The error message shows </thinking> at line 39, which is clearly not valid Java code.
I can see the issue - there’s a stray </thinking> XML tag in the WorldEditGuardExamples.java file at line 39, which is breaking the Java syntax. I need to fix this file and create the missing WorldEditHelper.java class.
Fixed! The issue was a stray </thinking> XML tag that got accidentally inserted into the WorldEditGuardExamples.java file. I’ve cleaned up the main plugin class and created the missing WorldEditHelper.java with all WorldEdit utility methods.
The compilation failed with this error:
Validation failed for compilation: Compilation failed with 6 error(s):
ERROR in src/main/java/com/example/worldeditguard/managers/WorldEditHelper.java at line 107: no suitable method found for replaceBlocks(CuboidRegion,BlockType,BlockState)
int replaced = session.replaceBlocks(region,
^
ERROR in src/main/java/com/example/worldeditguard/managers/RegionHelper.java at line 145: incompatible types: BukkitPlayer cannot be converted to RegionAssociable
return regions.testState(BukkitAdapter.adapt(player), Flags.BLOCK_PLACE);
^
ERROR in src/main/java/com/example/worldeditguard/managers/WorldEditHelper.java at line 107: no suitable method found for replaceBlocks(CuboidRegion,BlockType,BlockState)
int replaced = session.replaceBlocks(region,
^
ERROR in src/main/java/com/example/worldeditguard/managers/RegionHelper.java at line 145: incompatible types: BukkitPlayer cannot be converted to RegionAssociable
return regions.testState(BukkitAdapter.adapt(player), Flags.BLOCK_PLACE);
^
ERROR in src/main/java/com/example/worldeditguard/managers/WorldEditHelper.java at line 107: no suitable method found for replaceBlocks(CuboidRegion,BlockType,BlockState)
int replaced = session.replaceBlocks(region,
^
ERROR in src/main/java/com/example/worldeditguard/managers/RegionHelper.java at line 145: incompatible types: BukkitPlayer cannot be converted to RegionAssociable
return regions.testState(BukkitAdapter.adapt(player), Flags.BLOCK_PLACE);
^
=== COMPILATION ERROR ANALYSIS ===
TYPE MISMATCHES:
- incompatible types: BukkitPlayer cannot be converted to RegionAssociable
- incompatible types: BukkitPlayer cannot be converted to RegionAssociable
- incompatible types: BukkitPlayer cannot be converted to RegionAssociable
ACTION: Fix variable types or casting
FILES TO INVESTIGATE:
- src/main/java/com/example/worldeditguard/managers/WorldEditHelper.java
- src/main/java/com/example/worldeditguard/managers/RegionHelper.java
- src/main/java/com/example/worldeditguard/managers/WorldEditHelper.java
- src/main/java/com/example/worldeditguard/managers/RegionHelper.java
exceeds maximum
Please fix this error by creating a new artifact with the corrected code.
package com.example.worldeditguard;
import com.example.worldeditguard.commands.ArenaCommand;
import com.example.worldeditguard.commands.WorldEditTestCommand;
import com.example.worldeditguard.commands.WorldGuardTestCommand;
import com.example.worldeditguard.listeners.RegionEventListener;
import com.example.worldeditguard.managers.ArenaManager;
import com.example.worldeditguard.managers.RegionHelper;
import com.example.worldeditguard.managers.WorldEditHelper;
import lombok.Getter;
import org.bukkit.plugin.java.JavaPlugin;
public class WorldEditGuardExamples extends JavaPlugin {
@Getter
private WorldEditHelper worldEditHelper;
@Getter
private RegionHelper regionHelper;
@Getter
private ArenaManager arenaManager;
@Override
public void onEnable() {
worldEditHelper = new WorldEditHelper();
regionHelper = new RegionHelper();
arenaManager = new ArenaManager(this);
getCommand("wetest").setExecutor(new WorldEditTestCommand(this));
getCommand("wgtest").setExecutor(new WorldGuardTestCommand(this));
getCommand("arena").setExecutor(new ArenaCommand(this));
getServer().getPluginManager().registerEvents(new RegionEventListener(), this);
getLogger().info("WorldEdit & WorldGuard Examples loaded!");
}
}