FastAsyncWorldEdit - (FAWE) - 极速世界编辑

💡简介

FAWE（FastAsyncWorldEdit）是一款专为高效世界编辑而设计的插件。它易于设置和使用，同时具备极高的可配置性，能在极低的 CPU 和内存占用下，安全地支持大量玩家进行超高速的编辑操作。如果你使用其他依赖 WorldEdit 的插件，仅需安装 FAWE 即可显著提升它们的性能。

💡核心特性

• 性能卓越：采用异步处理，提供多种放置模式，默认的区块放置模式远超其他同类插件。
• 功能强大：提供超过 200 个命令，支持无限次 //undo、跨服务器剪贴板、可视化编辑、高级玩家限制等。
• 高度兼容：完全兼容 WorldEdit API，并支持与 WorldGuard、PlotSquared 等主流保护插件联动。
• 易于集成：无需额外配置即可提升依赖 WorldEdit 的插件的运行效率。

🎮安装与要求

下载与版本

• 最新版本：支持 Minecraft 1.20.2-1.21.2 及 1.21.4-1.21.11。
• 旧版支持：对于 1.20.1 及更早的未支持版本，可访问 此链接 获取。请注意，这些旧版本不提供任何技术支持。
• Java 要求：遵循 Mojang 政策，所有插件均需要 Java 21 或更高版本。

安装指南

• 从 SpigotMC 下载适用于你服务器版本的 FAWE。
• 将 .jar 文件放入服务器的 plugins 文件夹。
• 重启服务器即可完成安装。

🔧编辑模式与性能

FAWE 提供多种编辑模式，均支持异步处理，性能依次递增：

• 方块模式 (Bukkit-API)：仅在区块模式不支持时使用，速度仍远超其他 Spigot 插件。
• 区块模式 (NMS)：直接放置整个区块区域，这是默认模式。
• 世界模式 (CFI)：用于生成新世界或大型区域，性能最高。

✨主要功能一览

编辑与操作

• 支持 //lazycopy 即时复制任意大小的区域。
• 提供大量强大的新 //brushes（笔刷）和 //tools（工具）。
• 增强的遮罩和图案功能，包括新语法和表达式。
• 支持编辑变换（例如在 //paste 时应用变换）。
• 支持新格式（如结构方块）。

实用工具

• 剪贴板网页集成。
• 自动修复部分损坏的 schematic 文件。
• 生物群系混合、游戏内地形绘制、动态视距、图像导入、洞穴生成、多剪贴板、交互式消息、示意图可视化等。

日志与回滚

• 默认可使用 //inspect 和 //history rollback 来查找和恢复更改。
• 使用 //fast 命令可以绕过日志记录以提升速度。
• 可通过调整压缩级别和缓冲区大小来减少磁盘占用。

⭐插件兼容与保护

FAWE 与以下保护插件良好兼容（基于 Bukkit）：

• WorldGuard
• PlotSquared

❓开发者 API

FAWE 保持了与 WorldEdit 的 API 兼容性，你可以正常使用 WorldEdit 的 API 进行异步操作。此外，FAWE 还提供了一些针对 Bukkit API 的异步封装。

• API 文档：请访问 https://intellectualsites.gitbook.io/fastasyncworldedit/
• Wiki 示例：包含读取 NBT、修改世界文件、粘贴 schematic、拆分任务、光照处理等多种示例。
• 获取帮助：如需开发帮助，请加入我们的 Discord（链接见下文）。

🔧获取支持与反馈

• Discord 社区：如有任何问题，请加入我们的 Discord 服务器 获取帮助。
• 问题反馈：建议将问题提交至 GitHub 的 Issue 追踪器，以便贡献者处理。
• 重要提示：Spigot 资源页的评论区不受我们管理，无法在那里提供有效支持。
• 支持我们：可以通过 GitHub Sponsors 支持项目发展。

> 免责声明：本文档内容基于官方信息翻译整理，功能与支持范围可能随版本更新而改变，请以官方最新文档为准。

FastAsyncWorldEdit（FAWE）是一款高性能的 WorldEdit 分支插件，专为大型服务器和复杂编辑任务设计。它在保留 WorldEdit 所有功能的基础上，通过异步处理大幅提升了操作速度，并增加了许多高级功能与优化。

💡核心特性

• 异步操作：核心编辑任务在独立线程运行，避免阻塞主服务器线程，显著提升性能和响应速度。
• 极高的性能：针对大量方块更改进行了深度优化，编辑速度远超原版 WorldEdit。
• 完整的功能继承：完全兼容 WorldEdit 的所有指令、刷子和脚本功能。
• 扩展功能：在 WorldEdit 基础上，增加了如大型剪贴板操作、更强大的图案与遮罩、直接世界历史操作等高级功能。
• 支持多种 Minecraft 版本：持续更新以支持较新的 Minecraft 版本。

🎮指令与权限

FAWE 继承了 WorldEdit 的全部指令，并新增了一些自有指令。常用指令结构与 WorldEdit 一致。

基础编辑指令

• //set ：将选区设置为指定方块。
• //copy、//cut、//paste：复制、剪切和粘贴选区。
• //undo、//redo：撤销和重做你的编辑操作。
• //replace ：替换选区内的特定方块。
• //walls ：用指定方块生成选区的墙壁。
• //outline ：用指定方块生成选区的外壳。

刷子工具指令

• //brush sphere ：创建一个球形刷子。
• //brush cylinder [高度]：创建一个圆柱形刷子。
• //brush smooth [迭代次数]：创建一个地形平滑刷子。

FAWE 增强指令示例

• //lazacopy / //lazapaste：执行异步的复制/粘贴操作，适用于极大区域。
• //count ：快速统计选区中特定方块的数量。
• //distr：查看选区中方块的分布统计。

权限节点

主要权限节点继承自 WorldEdit（如 worldedit.），FAWE 特有的权限通常以 fastasyncworldedit. 或 fawe.* 开头。安装后可通过权限管理插件查看完整列表。

🔧安装与配置

要求

• 服务器软件：Paper、Folia、Purpur 或其衍生服务端（强烈推荐以获得最佳性能）。Spigot 可能功能受限。
• Java：推荐使用 Java 17 或更高版本。
• 前置插件：必须安装 WorldEdit。FAWE 作为其扩展运行。

安装步骤

• 确保服务器已安装并运行着 WorldEdit。
• 从官方下载页面获取与你的 Minecraft 服务器版本兼容的 FAWE jar 文件。
• 将 FAWE 的 jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 启动后，FAWE 会自动生成其配置文件夹 (plugins/FastAsyncWorldEdit) 和配置文件。

基础配置

主要的配置文件是 config.yml。你可以根据服务器需求调整以下常见设置：

• max-changes-per-iteration：控制每次操作允许的最大方块更改数，影响单次操作规模。
• queue：配置编辑任务的队列系统，可以设置并行处理数量。
• history：控制历史记录的大小和保存方式。
• region-restrictions：设置世界或区域的编辑限制。

✨高级功能与技巧

剪贴板与原理图

• FAWE 支持超大的剪贴板操作，并优化了 .schematic 和 .schem（Sponge 格式）文件的保存与加载速度。
• 可以使用 //schem load、//schem save 等指令管理原理图。

图案与遮罩

• 提供了比原版更强大的图案（Patterns）和遮罩（Masks）语法，允许进行更复杂的条件性编辑。
• 例如：//replace dirt (stone,grass_block) 可以将泥土替换为石头或草方块的随机组合。

世界编辑历史

• //undo 和 //redo 可以跨会话工作，历史记录保存在磁盘上。
• 管理员可以使用 //butcher 等指令的增强版本来高效清理实体。

性能提示

• 对于超大规模编辑（如数百万方块），建议使用 //lazacopy 等异步指令。
• 合理配置 config.yml 中的队列和限制参数，以平衡编辑速度与服务器负载。
• 在操作前使用 //count 预估影响范围。

❓常见问题

FAWE 和 WorldEdit 能同时安装吗？

• 可以，且必须。FAWE 作为 WorldEdit 的替换/扩展，两者 jar 文件需同时存在于 plugins 文件夹。FAWE 会在启动时接管 WorldEdit 的功能。

**为什么安装后...