AnyARES (Advanced Regional Editing Suite)

AnyARES 是一款专为 PaperMC 服务器设计的现代、高性能、异步世界编辑套件,从底层构建以确保卓越的性能和可扩展性。
受 WorldEdit 和 FAWE 等经典巨头的启发,AnyARES 旨在为服务器管理员和高级建造者提供一套强大、直观且无卡顿的工具集,用于处理大规模的区域操作。其核心理念基于一个精简而强大的核心插件以及丰富的可选插件生态系统,允许服务器所有者仅安装所需的功能。
服务器要求
服务器软件
Paper(或其下游分支如 Purpur)。由于该插件依赖 Paper 的高级异步 API 以实现性能优化,因此不支持 Spigot。
Minecraft 版本
1.21.x。该插件基于 1.21 API 构建,无法在 1.20.x 等旧版本上运行。建议始终使用对应 Minecraft 版本的最新 Paper 版本。
Java 版本
Java 21。这是 Minecraft 1.21+ 本身的要求,因此如果您的服务器正在运行,则已满足此要求。
✨ 核心功能
AnyARES-Core 插件为所有世界编辑任务提供了必要的基础。
异步设计:所有方块操作均通过稳健的异步任务引擎进行处理,最大限度地减少对服务器性能(TPS)的影响。
多形状选择系统:原生支持除简单长方体之外的多种选择形状。
- 长方体 (Cuboid):经典的框选模式。
- 球体 (Sphere):由中心和半径定义的完美球形选择。
- 圆柱体 (Cylinder):垂直或任意方向的圆柱体。
- 2D 多边形 (Extruded):定义自定义平面形状并沿垂直方向拉伸以创建复杂棱柱。
强大的图案解析器:超越单一方块。使用复杂的图案,如 50%stone,30%dirt,20%gravel,并指定方块状态,如 oak_log[axis=y]。
完整的历史记录系统:为每项操作提供无限次的撤销 (/undo) 和重做 (/redo),数据按玩家存储。
玩家剪贴板:强大的 /copy、/cut 和 /paste 系统,兼容所有选择形状。
可扩展 API:清晰定义的 API (AnyAresAPI),旨在让开发者轻松创建和集成自己的插件。
实时可视化:通过轻量级的基于粒子的可视化器实时查看您的选择区域,勾勒出所选形状的轮廓。
? 插件生态
AnyARES 采用模块化设计。核心插件本身已具备强大功能,但其真正的潜力需要通过插件来释放。
AnyARES-Selections (Included):官方提供的插件,用于高级选择区域的操作命令。
? 计划中的功能与路线图
AnyARES 的旅程才刚刚开始!以下是未来计划的核心功能增强和新插件预览。
核心增强
性能优化迭代:持续对方块迭代器、任务引擎和内存使用进行剖析和优化。
画笔系统 API:核心的 API,用于将操作绑定到物品,从而在插件中创建强大的绘画和雕塑工具。
掩码系统 API:用于源和目标掩码的 API,允许操作仅影响特定方块(例如 //replace stone dirt -m !air)。
变换 API:用于对玩家剪贴板应用几何变换(如旋转和翻转)的框架。
未来插件
AnyARES-Clipboard:
完整支持 .schem 结构文件 (/schem load, /schem save, /schem list)。
支持玩家之间共享剪贴板内容。
AnyARES-Operations:
常见的 WorldEdit 命令,如 //walls、//outline、//overlay。
高级操作,如 //smooth 和 //regen。
AnyARES-BrushesAddon:
一系列标准画笔:球形画笔、平滑画笔、粘贴画笔等。
AnyARES-Tools:
“魔法杖” / 连通方块选择工具。
信息工具(例如 /tool info 获取方块数据)。
AnyARES-Scripting:
集成脚本引擎,允许用户编写自己复杂的操作逻辑。
?️ 面向开发者
AnyARES 的设计考虑到了开发者需求。要创建您自己的插件:
-
在您的 pom.xml 中将 AnyARES-Core 添加为 provided 依赖项。
-
在您的插件的 plugin.yml 中添加 depend: [AnyARES-Core]。
-
使用 com.anynom39.anyares.api.AnyAresAPI 类安全地与所有核心管理器和功能进行交互。
❓ 为什么需要另一个世界编辑器?
AnyARES 的目标不仅仅是克隆现有工具,而是通过专注于以下方面的现代架构重新构想它们:
性能:充分利用 PaperMC 的异步能力。
模块化:提供稳定的核心,并让服务器所有者通过插件选择他们想要的功能集。
可扩展性:尽可能降低其他开发者在此基础上构建平台的难度。
我们相信这种方法将为现代 Minecraft 服务器带来更稳定、高效且多功能的工具。
AnyARES (Advanced Regional Editing Suite)

AnyARES is a modern, high-performance, asynchronous world editing suite for PaperMC servers, built from the ground up for performance and extensibility.
Inspired by giants like WorldEdit and FAWE, AnyARES aims to provide server administrators and advanced builders with a powerful, intuitive, and lag-free toolset for large-scale region manipulation. Its core philosophy is based on a lean, powerful core plugin and a rich ecosystem of optional addon plugins, allowing server owners to install only the features they need.
Server Requirements
Server Software
Paper (or a downstream fork like Purpur). Spigot is not supported due to the plugin's reliance on Paper's advanced asynchronous APIs for performance.
Minecraft Version
1.21.x. The plugin is built against the 1.21 API and will not work on older versions like 1.20.x. It is always recommended to use the latest version of Paper for the corresponding Minecraft release.
Java Version
Java 21. This is a requirement for Minecraft 1.21+ itself, so if your server is running, you already meet this requirement.
✨ Core Features
The AnyARES-Core plugin provides the essential foundation for all world editing tasks.
Asynchronous by Design: All block operations are processed through a robust, asynchronous task engine, minimizing impact on server performance (TPS).
Multi-Shape Selection System: Natively supports a variety of selection shapes beyond simple cuboids.
Cuboid: The classic box selection.
Sphere: Perfect spherical selections defined by a center and radius.
Cylinder: Vertical or arbitrarily oriented cylinders.
2D Polygon (Extruded): Define custom flat shapes and extrude them vertically to create complex prisms.
Powerful Pattern Parser: Go beyond single blocks. Use complex patterns like 50%stone,30%dirt,20%gravel and specify block states like oak_log[axis=y].
Full History System: Unlimited undo (/undo) and redo (/redo) for every operation, stored per-player.
Player Clipboard: A powerful /copy, /cut, and /paste system that works with all selection shapes.
Extensible API: A clean, well-defined API (AnyAresAPI) designed for developers to easily create and integrate their own addons.
Live Visualizations: See your selection in real-time with a lightweight, particle-based visualizer that outlines your selected shape.
? Addon Ecosystem
AnyARES is designed to be modular. The core plugin is powerful on its own, but its true potential is unlocked through addons.
AnyARES-Selections (Included): The official addon providing advanced selection manipulation commands.
? Planned Features & Roadmap
The journey for AnyARES has just begun! Here is a look at what's planned for the future, both for the Core and for new addons.
Core Enhancements
Performance Optimization Pass: Continuous profiling and optimization of block iterators, the task engine, and memory usage.
Brush System API: A core API for binding operations to items, allowing for the creation of powerful painting and sculpting tools in addons.
Masking System API: An API for source and destination masks, allowing operations to only affect specific blocks (e.g., //replace stone dirt -m !air).
Transformation API: A framework for applying geometric transforms (like rotate and flip) to the player clipboard.
Future Addons
AnyARES-Clipboard:
Full .schem schematic file support (/schem load, /schem save, /schem list).
Support for sharing clipboards between players.
AnyARES-Operations:
Common WorldEdit commands like //walls, //outline, //overlay.
Advanced operations like //smooth and //regen.
AnyARES-BrushesAddon:
A suite of standard brushes: sphere brush, smooth brush, paste brush, etc.
AnyARES-Tools:
"Magic Wand" / Contiguous block selection tools.
Information tools (e.g., /tool info to get block data).
AnyARES-Scripting:
Integration with a scripting engine to allow users to write their own complex operations.
?️ For Developers
AnyARES is built with developers in mind. To create your own addon:
-
Add AnyARES-Core as a provided dependency in your pom.xml.
-
Add depend: [AnyARES-Core] to your addon's plugin.yml.
-
Use the com.anynom39.anyares.api.AnyAresAPI class to safely interact with all core managers and functionality.
❓ Why Another World Editor?
The goal of AnyARES is not just to clone existing tools, but to re-imagine them with a modern architecture focused on:
Performance: Leveraging PaperMC's asynchronous capabilities to their fullest.
Modularity: Providing a stable core and letting server owners choose which feature sets they want via addons.
Extensibility: Making it as easy as possible for other developers to build upon the platform.
We believe this approach will lead to a more stable, efficient, and versatile tool for the modern Minecraft server.
评论 0
登录后参与评分
还没有评论,来抢沙发吧