BetterStructures-FAWE

BetterStructures-FAWE

中文

A performance-focused fork of Paper + FastAsyncWorldEdit (FAWE) + Terra, deeply adapted for the Paper + FastAsyncWorldEdit (FAWE) + Terra ecosystem.

> Original plugin: GitHub | Modrinth

---

Key Differences from Upstream

1. FAWE Async Pasting (Zero Main-Thread Blocking)

The original plugin uses `WorkloadRunnable` to place blocks on the main thread in frame-split batches, which still causes TPS drops for large structures. This fork migrates all block pasting to FAWE asynchronous `EditSession`:

- Normal blocks, NBT blocks (spawners, dispensers, etc.), and bedrock replacement are all handled on FAWE async threads - The `WorkloadRunnable` frame-splitting system and NMS fast paths have been removed - Entity spawning and chest filling are deferred back to the main thread after FAWE completes - The `percentageOfTickUsedForPasting` config option is now obsolete

Dependency change: Hard dependency changed from `WorldEdit` to `FastAsyncWorldEdit`. The plugin will automatically disable itself if FAWE is not detected on startup.

2. Terra / FAWE Compatibility

Resolves chunk state issues when using async world generators like Terra with FAWE:

- Added `ChunkValidationUtil`: samples multiple positions to detect whether a chunk is fully generated, preventing structures from being placed on empty chunks - Uses Paper API `getChunkAtAsync` for async chunk loading, with `PluginChunkTicket` to keep chunks loaded during pasting - All world block access operations ensure chunks are loaded into memory first

3. PersistentDataContainer Chunk Marking

The original plugin relies on `ChunkLoadEvent.isNewChunk()` to identify new chunks, but after a server restart, previously generated but unmarked chunks get scanned again. This fork uses Bukkit `PersistentDataContainer` to persistently mark chunks:

- Processed chunks are tagged with `betterstructures:chunk_processed` - No duplicate scanning of already-processed chunks after restart

4. Structure Location Persistence

Added `StructureLocationManager` and `StructureLocationData` to persist all generated structure locations to YAML files:

- Each world is stored independently under `structure_locations/` - Records structure coordinates, type, schematic name, and bounding box dimensions - In-memory cache with automatic dirty-data saving every minute - Provides the data foundation for the mob tracking system

5. Mob Tracking & Respawn System

Added `MobTrackingManager` and `MobSpawnConfig` for tracking and respawning mobs within structures:

- Records mob spawn configurations (position, type) for each structure - Supports Vanilla / EliteMobs / MythicMobs mob types - Spatial index (world-chunk) for fast nearby structure lookups - Triggers mob respawn checks when players approach - Fires `StructureClearedEvent` when all mobs in a structure are killed

6. Chinese Localization

All user-facing logs, command feedback, and menu text have been translated to Chinese across 27 files.

---

Requirements

| Component | Requirement | |-----------|-------------| | Minecraft | 1.14+ (1.21+ recommended) | | Server | Paper (or forks like Purpur) | | Java | 21+ | | Required | Required (vanilla WorldEdit is not supported) |

Optional Dependencies

- EliteMobs - Custom bosses - MythicMobs - Custom mobs - WorldGuard - Region protection - Terra / Terralith / Iris / TerraformGenerator - Custom world generation

License

GPL-3.0, same as upstream.

Credits

- Original author: MagmaGuy - Original repository: https://github.com/MagmaGuy/BetterStructures - Modrinth: https://modrinth.com/plugin/betterstructures