# BetterStructures-FAWE<\/p>\n
# \u4e2d\u6587<\/p>\n
A performance-focused fork of MagmaGuy\/BetterStructures, deeply adapted for the **Paper + FastAsyncWorldEdit (FAWE) + Terra** ecosystem.<\/p>\n
> Original plugin: GitHub | Modrinth<\/p>\n
—<\/p>\n
## Key Differences from Upstream<\/p>\n
### 1. FAWE Async Pasting (Zero Main-Thread Blocking)<\/p>\n
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`:<\/p>\n
– Normal blocks, NBT blocks (spawners, dispensers, etc.), and bedrock replacement are all handled on FAWE async threads
\n– The `WorkloadRunnable` frame-splitting system and NMS fast paths have been removed
\n– Entity spawning and chest filling are deferred back to the main thread after FAWE completes
\n– The `percentageOfTickUsedForPasting` config option is now obsolete<\/p>\n
**Dependency change**: Hard dependency changed from `WorldEdit` to `FastAsyncWorldEdit`. The plugin will automatically disable itself if FAWE is not detected on startup.<\/p>\n
### 2. Terra \/ FAWE Compatibility<\/p>\n
Resolves chunk state issues when using async world generators like Terra with FAWE:<\/p>\n
– Added `ChunkValidationUtil`: samples multiple positions to detect whether a chunk is fully generated, preventing structures from being placed on empty chunks
\n– Uses Paper API `getChunkAtAsync` for async chunk loading, with `PluginChunkTicket` to keep chunks loaded during pasting
\n– All world block access operations ensure chunks are loaded into memory first<\/p>\n
### 3. PersistentDataContainer Chunk Marking<\/p>\n
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:<\/p>\n
– Processed chunks are tagged with `betterstructures:chunk_processed`
\n– No duplicate scanning of already-processed chunks after restart<\/p>\n
### 4. Structure Location Persistence<\/p>\n
Added `StructureLocationManager` and `StructureLocationData` to persist all generated structure locations to YAML files:<\/p>\n
– Each world is stored independently under `structure_locations\/`
\n– Records structure coordinates, type, schematic name, and bounding box dimensions
\n– In-memory cache with automatic dirty-data saving every minute
\n– Provides the data foundation for the mob tracking system<\/p>\n
### 5. Mob Tracking & Respawn System<\/p>\n
Added `MobTrackingManager` and `MobSpawnConfig` for tracking and respawning mobs within structures:<\/p>\n
– Records mob spawn configurations (position, type) for each structure
\n– Supports Vanilla \/ EliteMobs \/ MythicMobs mob types
\n– Spatial index (world-chunk) for fast nearby structure lookups
\n– Triggers mob respawn checks when players approach
\n– Fires `StructureClearedEvent` when all mobs in a structure are killed<\/p>\n
### 6. Chinese Localization<\/p>\n
All user-facing logs, command feedback, and menu text have been translated to Chinese across 27 files.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
| Component | Requirement |
\n|———–|————-|
\n| Minecraft | 1.14+ (1.21+ recommended) |
\n| Server | Paper (or forks like Purpur) |
\n| Java | 21+ |
\n| **FastAsyncWorldEdit** | **Required** (vanilla WorldEdit is not supported) |<\/p>\n
### Optional Dependencies<\/p>\n
– EliteMobs – Custom bosses
\n– MythicMobs – Custom mobs
\n– WorldGuard – Region protection
\n– Terra \/ Terralith \/ Iris \/ TerraformGenerator – Custom world generation<\/p>\n
## License<\/p>\n
GPL-3.0, same as upstream.<\/p>\n
## Credits<\/p>\n
– Original author: MagmaGuy
\n– Original repository: https:\/\/github.com\/MagmaGuy\/BetterStructures
\n– Modrinth: https:\/\/modrinth.com\/plugin\/betterstructures<\/p>\n","protected":false},"excerpt":{"rendered":"
Based on the improved branch of MagmaGuy\/BetterStructures, made deep adaptations and performance optimizations for Paper + FastAsyncWorldEdit (FAWE).<\/p>\n","protected":false},"featured_media":30356,"template":"","meta":{"_minecraft_slug":"betterstructures-fawe","_minecraft_project_id":"1JHdsCoL","_minecraft_author":"yeahnangua","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":226,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"betterstructures-fawe.zip","_minecraft_size_bytes":39024292,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T12:22:53.841860Z","_minecraft_date_created":"2026-02-07T10:16:02.249075Z","_minecraft_date_modified":"2026-02-24T12:05:49.342232Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/betterstructures-fawe","_minecraft_icon_attachment_id":30356,"_minecraft_imported_at":"2026-06-01T12:53:58+00:00","_minecraft_import_hash":"b5cf24a8cb22c32355e33b987cb31ced","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,127,128,92,159],"mod_loader":[132,133],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-30355","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-paper","mod_category-purpur","mod_category-utility","mod_category-worldgen","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n