一个现代、跨平台的区域保护插件。
[](https://discord.gg/fh62mxU)
### Orbis 仍处于开发早期阶段。
可能会存在区域绕过和其他错误。
请向 [GitHub](https://github.com/EmpireWar/Orbis/issues) 报告任何错误或问题。
如果您希望看到某个功能，请打开一个 [issue](https://github.com/EmpireWar/Orbis/issues/new/choose)。
Orbis 是一个现代的 Minecraft 区域保护插件，支持最新的版本和大多数平台：Paper、Fabric、NeoForge 和 Sponge。 它与 Spigot 不兼容；请使用 Paper 代替。
## Orbis 有何不同？
以下是 Orbis 与其他类似插件相比的重点特性：
- 现代化、用户友好的界面/命令。
- 支持 Cuboids、Polygons、Polyhedrons 和 球形区域类型的区域。
- 使用粒子可视化所有区域类型的区域和选择。
- 对 Paper、Fabric、NeoForge 和 Sponge 的跨平台支持。
- 允许您对世界或区域执行一系列查询的高级 API。
- 没有外部依赖。
### 从其他插件迁移？
Orbis 内置了一个迁移工具，允许您从其他插件迁移您的区域。
只需在安装了 Orbis 和其他插件的服务器上运行 `/orbis migrate
`，您的区域即可迁移到 Orbis（尽可能）。
更多信息，请查看 [迁移 wiki 页面](https://github.com/EmpireWar/Orbis/wiki/Migration-from-another-plugin) 并找到与您要迁移的插件对应的部分。
## 📆 支持的版本
Orbis 旨在使用最新的 Minecraft 版本。
对于 modded 版本，我们始终针对最新版本，目前为 1.21.8。
对于 Paper 和 Sponge 我们针对 1.21.4-1.21.8 (Sponge API 14-16)。
较新或较旧的版本可能有效，但未经过测试。
## 🚀 快速开始
1. **⬇️ 下载** 适用于您平台的插件。
2. **📂 放置** `.jar` 文件到您服务器的 `plugins` 或 `mods` 文件夹。
3. **🔄 重新启动** 您的服务器。 Orbis 将生成其配置并准备就绪！
### 创建区域
查看 [分步教程 wiki 页面](https://github.com/EmpireWar/Orbis/wiki/Tutorial%3A-Creating-a-Region)。
### 设置标志
要查看所有当前可用标志的列表，请查看 wiki 页面：https://github.com/EmpireWar/Orbis/wiki/Flags。
- 防止在区域内破坏方块：
- `/rg flag set spawn orbis:can_break false`
- 仅允许伤害僵尸和枯萎生物：
- `/rg flag set arena orbis:damageable_entities ["minecraft:zombie","minecraft:husk"]`
- 自定义进入/退出消息：
- `/rg flag set plaza orbis:entry_message "欢迎来到广场！"`
- `/rg flag set plaza orbis:exit_message "离开广场..."`
- 在区域内使玩家无敌：
- `/rg flag set lobby orbis:invulnerability true`
- 将时间锁定在中午：
- `/rg flag set museum orbis:time 6000`
### 进一步设置
更多信息，请查看 wiki 内容：https://github.com/EmpireWar/Orbis/wiki.
## 📚 API & 集成
将 `PLATFORM` 替换为您的服务器类型（例如，`paper`、`fabric`、`sponge`）。
将 `VERSION` 替换为最新的 Orbis 版本。 对于快照，使用 `/snapshots` 代码库并附加 `-SNAPSHOT`。
```kts
repositories {
maven("https://repo.empirewar.org/releases")
}
dependencies {
compileOnly("org.empirewar.orbis:PLATFORM-api:VERSION")
}
```
### 使用 API
要了解如何使用 API，请查看 wiki 页面：https://github.com/EmpireWar/Orbis/wiki/API.
### 事件
Orbis 为每个平台触发事件：
- **RegionEnterEvent**
- **RegionLeaveEvent**
### 📖 Javadocs
完整的文档可在：
[Orbis Javadocs](https://repo.empirewar.org/javadoc/releases/org/empirewar/orbis/common/latest)
