BetterStructures-FAWE
中文
一个专注于性能的 MagmaGuy/BetterStructures 分支,深度适配 Paper + FastAsyncWorldEdit (FAWE) + Terra 生态。
与上游版本的主要差异
1. FAWE 异步放置(零主线程阻塞)
原始插件使用 WorkloadRunnable 在主线程上按帧分批放置方块,这仍然会导致大型结构生成时 TPS 下降。本分支将所有方块放置迁移至 FAWE 异步 EditSession:
- 普通方块、NBT 方块(刷怪笼、发射器等)以及基岩替换均在 FAWE 异步线程上处理
- 移除了
WorkloadRunnable的帧分割系统和 NMS 快速路径 - 实体生成和箱子填充在 FAWE 完成后延迟回主线程执行
percentageOfTickUsedForPasting配置选项现已废弃
依赖变更:硬性依赖从 WorldEdit 变更为 FastAsyncWorldEdit。如果启动时未检测到 FAWE,插件将自动禁用自身。
2. Terra / FAWE 兼容性
解决了在使用 Terra 等异步世界生成器配合 FAWE 时的区块状态问题:
- 新增
ChunkValidationUtil:采样多个位置以检测区块是否已完全生成,防止结构生成在空区块上 - 使用 Paper API
getChunkAtAsync进行异步区块加载,并通过PluginChunkTicket在放置过程中保持区块加载 - 所有世界方块访问操作均确保先将区块加载到内存中
3. PersistentDataContainer 区块标记
原始插件依赖 ChunkLoadEvent.isNewChunk() 来识别新区块,但在服务器重启后,之前已生成但未标记的区块会被重复扫描。本分支使用 Bukkit PersistentDataContainer 持久化标记区块:
- 已处理的区块被标记为
betterstructures:chunk_processed - 重启后不会重复扫描已处理的区块
4. 结构位置持久化
新增 StructureLocationManager 和 StructureLocationData,将所有生成的结构位置持久化保存至 YAML 文件:
- 每个世界的记录独立存储在
structure_locations/目录下 - 记录结构坐标、类型、结构图名称及边界框尺寸
- 采用内存缓存,每分钟自动保存脏数据
- 为怪物追踪系统提供数据基础
5. 怪物追踪与重生系统
新增 MobTrackingManager 和 MobSpawnConfig,用于追踪结构内的怪物并触发重生:
- 记录每个结构的怪物生成配置(位置、类型)
- 支持 Vanilla / EliteMobs / MythicMobs 怪物类型
- 使用空间索引(世界-区块)实现附近结构的快速查找
- 当玩家接近时触发怪物重生检查
- 当结构内所有怪物被击杀时触发
StructureClearedEvent
6. 中文本地化
所有面向用户的日志、命令反馈和菜单文本已在 27 个文件中翻译为中文。
要求
| 组件 | 要求 |
|---|---|
| Minecraft | 1.14+(推荐 1.21+) |
| 服务端 | Paper(或 Purpur 等分支) |
| Java | 21+ |
| FastAsyncWorldEdit | 必需(不支持原版 WorldEdit) |
可选依赖
- EliteMobs - 自定义Boss
- MythicMobs - 自定义怪物
- WorldGuard - 区域保护
- Terra / Terralith / Iris / TerraformGenerator - 自定义世界生成
许可证
GPL-3.0,与上游版本相同。
致谢
- 原作者:MagmaGuy
- 原始仓库:
- Modrinth:
BetterStructures-FAWE
中文
A performance-focused fork of MagmaGuy/BetterStructures, deeply adapted for the Paper + FastAsyncWorldEdit (FAWE) + Terra ecosystem.
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
WorkloadRunnableframe-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
percentageOfTickUsedForPastingconfig 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
getChunkAtAsyncfor async chunk loading, withPluginChunkTicketto 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
StructureClearedEventwhen 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+ |
| FastAsyncWorldEdit | 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:
- Modrinth:
下载 BetterStructures-FAWE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterStructures-FAWE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterStructures-FAWE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterStructures-FAWE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterStructures-FAWE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterStructures-FAWE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterStructures-FAWE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterStructures-FAWE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterStructures-FAWE
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧