☢️ UltOrbitals
适用于 Paper 与 Folia 1.21+ 的高性能轨道打击系统
海量可配置轨道武器 • 管理员 GUI • 公共开发者 API • 兼容 Folia
? 概述
UltOrbitals 为玩家提供了可作为轨道打击武器使用的钓鱼竿。右键点击会以准星为目标进行瞄准(在配置的最大射程范围内),经过所需次数的拉拽后,有效载荷将从天空坠落。每根鱼竿均为一次性使用——发射后立即损坏。
内置六种武器类型:
| 武器 |
描述 |
| 核弹 (Nuke) |
从上方落下的同心圆 TNT 爆炸 |
| 穿刺 (Stab) |
从最大高度垂直降落的爆炸柱 |
| 炸弹 (Bomb) |
一个巨大的中央陨石坑伴随散射爆炸 |
| 狗炮 (Dog Cannon) |
在目标点部署装甲强化狼群 |
| 区块吞噬者 (Chunk Eater) |
清除整个区块直至基岩层 |
| 凋灵炮 (Wither Cannon) |
以环形图案从天空发射的充能凋灵骷髅 |
? 预览
✨ 特性
- ☢️ 六种独特的轨道武器
- ? 基于钓鱼竿的瞄准机制
- ⚙️ 完全可配置的单一武器参数
- ? 可配置的合成配方系统
- ?️ 完整的管理员仪表盘 GUI
- ? 玩家独立的库存管理
- ? 世界白名单限制
- ? 全服同时打击次数上限
- ? 实时配置编辑 (
/orbital reload)
- ? 支持 Paper + Folia
- ? 供其他插件使用的公共开发者 API
⚡ 安装
- 将
UltOrbitals-1.0.0.jar 放入你的 plugins/ 文件夹中。
- 启动或重启服务器。
- 根据需要编辑
plugins/UltOrbitals/config.yml。
- 运行
/orbital reload 应用更改而无需重启服务器。
要求: Paper 或 Folia 1.21.x,Java 21。
? 命令
玩家命令 — /orbital
| 指令 |
权限 |
描述 |
/orbital nuke [数量] |
ultorbitals.nuke |
给予自己核弹杆(s) |
/orbital stab [数量] |
ultorbitals.stab |
给予自己穿刺杆(s) |
/orbital bomb [数量] |
ultorbitals.bomb |
给予自己炸弹杆(s) |
/orbital dogs [数量] |
ultorbitals.dogs |
给予自己犬炮杆(s) |
/orbital chunk [数量] |
ultorbitals.chunk |
给予自己区块吞噬者杆(s) |
| /orbital wither [数量] | ultorbitals.wither | 给予自己凋零加农炮棒 |
| /orbital give <玩家> <类型> [数量] | ultorbitals.give | 向其他玩家发放武器 |
| /orbital remove <玩家> <类型> [数量] | ultorbitals.remove | 从玩家处移除武器 |
| /orbital reload | ultorbitals.reload | 实时重载 config.yml |
/orbital disable |
ultorbitals.disable |
切换全局轨道禁用状态 |
/orbital gui [player] |
ultorbitals.admin.gui |
打开管理员玩家界面 |
| /orbital recipe | ultorbitals.recipe | 打开配方界面 |
管理员命令 — /orbitala
| 命令 |
权限 |
描述 |
/orbitala |
ultorbitals.admin |
打开管理员仪表盘 GUI |
/orbitala dashboard |
ultorbitals.admin |
打开管理员仪表盘 GUI |
/orbitala cap [on|off] |
ultorbitals.admin |
查看或切换全图打击上限 |
/orbitala capset <number> |
ultorbitals.admin |
设置同时激活的最大打击次数 |
/orbitala capreset |
ultorbitals.admin |
将活跃打击计数器重置为 0 |
/orbitala weapon <type> <key> <value> |
ultorbitals.admin |
实时编辑任意武器参数 |
/orbitala track [player] |
ultorbitals.admin |
打印玩家的当前轨道库存 |
武器编辑器示例:
/orbitala weapon nuke rings 8
/orbitala weapon nuke tnt-per-ring-base 60
/orbitala weapon wither count 10
/orbitala weapon stab explosion-power 6
? 权限
| 节点 |
默认值 |
描述 |
ultorbitals.use |
OP |
基础使用权限(涵盖所有武器) |
ultorbitals.nuke |
OP |
核弹武器 |
ultorbitals.stab |
OP |
刺击武器 |
ultorbitals.bomb |
OP |
炸弹武器 |
ultorbitals.dogs |
OP |
狗狗加农炮 |
ultorbitals.chunk |
OP |
区块吞噬者 |
ultorbitals.wither |
OP |
凋灵加农炮 |
ultorbitals.give |
OP |
将武器给予他人 |
ultorbitals.remove |
OP |
从他人处移除武器 |
ultorbitals.reload |
OP |
重载配置 |
ultorbitals.disable |
OP |
切换全局禁用状态 |
ultorbitals.admin |
OP |
完整管理员权限(GUI + 上限设置 + 武器编辑器) |
ultorbitals.admin.gui |
OP |
仅打开管理员 GUI |
ultorbitals.recipe |
Default |
打开配方 GUI |
?️ 管理员 GUI
通过 /orbitala 或 /orbitala dashboard 打开。
仪表盘(54格背包):
- 信标(第 5 槽位)— 显示全局状态;点击可切换全局禁用
- 屏障(第 9 槽位)— 显示上限状态;点击可切换上限开启/关闭
- 红石粉(第 8 槽位)— 点击以重置当前激活的打击计数
- 玩家头颅(第 3–6 行)— 每个在线玩家对应一个头颅;显示其轨道打击次数;点击进行管理
玩家界面(每位玩家独立,54格):
- 每种武器类型对应一个钓鱼竿图标,显示该武器在背包中的当前数量
- 左键点击 → 给予玩家 +1 个
- 右键点击 → 从玩家处移除 1 个
- Shift+左键点击 → 给予玩家 +5 个
- Shift+右键点击 → 移除该类型的所有数量
- 箭矢(第 46 槽位)→ 返回仪表盘
- 熔岩桶(第 54 槽位)→ 移除玩家身上的所有轨道打击
⚙️ 全服上限
上限机制防止在同一时间内,整个服务器中激活的轨道打击总数超过 N。默认情况下为禁用。
在 config.yml 中启用并配置:
global:
cap:
enabled: true
max: 1
或使用命令:
/orbitala cap on
/orbitala capset 1
当达到上限时,玩家会看到 cap_reached 消息,且他们的钓鱼竿不会被消耗。如果打击计数卡住,管理员可以使用 /orbitala capreset 强制重置计数器。
? 合成配方
所有配方均可在 config.yml 的 recipes: 下进行配置。每种武器都有自己独特的 3×3 形状配方。设置 recipes.enabled: false 可禁用所有自定义配方。使用 recipes.<type>.enabled: false 可单独禁用特定武器。
默认配方:
| 武器 |
图案 |
关键材料 |
| Nuke |
TNT 环 + 下界合金中心 |
TNT, Netherite Ingot, Soul Sand, Redstone Block, Fishing Rod |
| Stab |
钻石环 |
Diamond, Stick, Fishing Rod |
| Bomb |
火药环 |
Gunpowder, Fishing Rod |
| Dog Cannon |
骨头环 |
Bone, Fishing Rod |
| Chunk Eater |
黑曜石环 |
Obsidian, Fishing Rod |
| Wither Cannon |
凋灵骷髅环 |
Wither Skeleton Skull, Fishing Rod |
所有配方均可在配置文件中自由重新设计。运行 /orbital reload 重载即可生效。
? 配置参考
单个 config.yml 文件控制一切。主要部分如下:
global
disabled — 总开关(也可通过 /orbital disable 切换)
allowed-worlds — 世界名称白名单(为空 = 所有世界)
cap.enabled — 全服活跃打击上限开关
cap.max — 同时活跃打击的最大数量
cooldowns
每位玩家每种武器的冷却时间(秒)。0 表示无冷却。
messages
所有面向玩家的字符串。支持 & 颜色代码。可用的占位符:
%weapon% — 武器显示名称
%amount% — 数量
%player% — 目标玩家名称
%sender% — 命令发送者名称
%time% — 剩余冷却秒数
%weapons% — 有效武器类型的逗号分隔列表
weapons.<type>
针对每种武器的调整。所有值均可通过 /orbitala weapon 实时编辑,或通过编辑配置文件并运行 /orbital reload 生效。
recipes
参见上方的合成部分。形状由 3 行 × 3 个字符组成。原料映射为 character: MATERIAL_NAME。
? 开发者 API
UltOrbitals 通过 UltOrbitalsAPI 提供了完整的公共 API,允许其他插件以编程方式构建、给予、追踪和触发轨道武器。
获取 API 实例
UltOrbitalsAPI api = UltOrbitalsAPI.get();
Maven 依赖
<dependency>
<groupId>me.ultorbitals</groupId>
<artifactId>UltOrbitals</artifactId>
<version>1.0.0</version>
<scope>provided</scope>
</dependency>
在你的插件 plugin.yml 中将 UltOrbitals 添加为 depend(或 softdepend):
depend: [UltOrbitals]
构建武器物品
ItemStack nuke = api.buildOrbital("nuke");
支持的类型:nuke, stab, bomb, dogs, chunk, wither
给予武器
api.giveOrbital(player, "nuke", 3);
移除武器
int removed = api.removeOrbital(player, "bomb", 2);
统计武器数量
int amount = api.getOrbitalCount(player, "nuke");
获取玩家持有的所有轨道武器
Map<String, Integer> orbitals = api.getAllOrbitals(player);
// 例如 { "nuke": 3, "bomb": 5, "dogs": 1 }
检测轨道物品
if (api.isOrbital(item)) {
String type = api.getOrbitalType(item);
}
触发打击
尊重全服上限和全局禁用开关。
boolean scheduled = api.triggerStrike("nuke", player.getLocation(), player);
如果达到打击上限、武器类型无效或轨道武器被全局禁用,则返回 false。
强制触发打击
绕过打击上限(即使通常会被上限阻止,也会发射)。
api.forceStrike("wither", player.getLocation(), player);
读取实时武器配置
允许其他插件读取与管理员 GUI 编辑相同的可调值。
int rings = api.getWeaponInt("nuke", "rings", 5);
double power = api.getWeaponDouble("nuke", "explosion-power", 10.0);
boolean charged = api.getWeaponBool("wither", "charged", true);
String particle = api.getWeaponStr("nuke", "particles", "flame");
打击上限控制
int active = api.getActiveStrikes();
int cap = api.getGlobalCap();
api.setGlobalCap(5);
api.resetActiveStrikes();
全局启用/禁用
boolean disabled = api.isDisabled();
api.setDisabled(true);
列出支持的武器类型
List<String> types = api.getAllTypes();
// [nuke, stab, bomb, dogs, chunk, wither]
?️ 架构
UltOrbitals
├── Weapons
│ ├── Nuke
│ ├── Bomb
│ ├── Stab
│ ├── Dogs
│ ├── Chunk
│ └── Wither
│
├── Commands
├── GUI
├── Recipes
├── Cooldowns
├── Config
├── API
└── Managers
构建要求: Maven 3.8+ 和 JDK 21+。
❓ 常见问题
Q: 钓鱼竿一次使用后不损坏?
A: 确保 pulls-required 设置为 2(默认值)。第一次拉动是为武器充能,第二次才会发射并使其损坏。
Q: 服务器崩溃后打击计数卡住?
A: 运行 /orbitala capreset 将活跃计数器重置为 0。
Q: 如何让所有玩家免费制作某种武器?
A: 在你的权限插件中向 default 组授予 ultorbitals.<type> 权限。拥有该权限的任何人都可以使用合成配方。
Q: 配方与其他插件冲突?
A: 对于冲突的武器,设置 recipes.<type>.enabled: false,并在该插件中定义它。
Q: 其他插件可以接入 UltOrbitals 吗?
A: 可以——请参阅上方的 Developer API 部分。在你的 plugin.yml 中添加 depend: [UltOrbitals] 并调用 UltOrbitalsAPI.get()。
? 许可证
UltOrbitals 根据 GNU Affero General Public License 发布。
展示视频 :-
基于 OrbitalStrikeCannon 机制构建,新增了凋灵炮、管理员 GUI、世界上限、配方系统、完整的配置控制以及公开的开发人员 API。
☢️ UltOrbitals
High-performance orbital strike system for Paper & Folia 1.21+
Massive configurable orbital weapons • Admin GUI • Public Developer API • Folia Compatible
? Overview
UltOrbitals gives players fishing rods that function as orbital strike weapons. Right-clicking aims at your crosshair target (up to the configured max range), and after the required number of pulls the payload drops from the sky. Every rod is single-use — it breaks immediately on firing.
Six weapon types are included out of the box:
| Weapon |
Description |
| Nuke |
Concentric rings of TNT raining from above |
| Stab |
A vertical pillar of explosions descending from max height |
| Bomb |
One massive central crater with scatter blasts |
| Dog Cannon |
Armored, buffed wolf pack deployed at the target |
| Chunk Eater |
Clears away the whole chunk up to bedrock level |
| Wither Cannon |
Charged wither skulls launched from the sky in a ring pattern |
? Preview
✨ Features
- ☢️ Six unique orbital weapons
- ? Fishing-rod-based targeting
- ⚙️ Fully configurable per-weapon parameters
- ? Configurable recipe system
- ?️ Full admin dashboard GUI
- ? Per-player inventory management
- ? World allow-list restrictions
- ? World-wide simultaneous-strike cap
- ? Live configuration editing (
/orbital reload)
- ? Paper + Folia support
- ? Public Developer API for other plugins
⚡ Installation
- Drop
UltOrbitals-1.0.0.jar into your plugins/ folder.
- Start or restart the server.
- Edit
plugins/UltOrbitals/config.yml to taste.
- Run
/orbital reload to apply changes without restart.
Requirements: Paper or Folia 1.21.x, Java 21.
? Commands
Player Commands — /orbital
| Command |
Permission |
Description |
/orbital nuke [amount] |
ultorbitals.nuke |
Give yourself nuke rod(s) |
/orbital stab [amount] |
ultorbitals.stab |
Give yourself stab rod(s) |
/orbital bomb [amount] |
ultorbitals.bomb |
Give yourself bomb rod(s) |
/orbital dogs [amount] |
ultorbitals.dogs |
Give yourself dog cannon rod(s) |
/orbital chunk [amount] |
ultorbitals.chunk |
Give yourself chunk eater rod(s) |
/orbital wither [amount] |
ultorbitals.wither |
Give yourself wither cannon rod(s) |
/orbital give <player> <type> [amount] |
ultorbitals.give |
Give a weapon to another player |
/orbital remove <player> <type> [amount] |
ultorbitals.remove |
Remove weapons from a player |
/orbital reload |
ultorbitals.reload |
Reload config.yml live |
/orbital disable |
ultorbitals.disable |
Toggle global orbital disable |
/orbital gui [player] |
ultorbitals.admin.gui |
Open admin player GUI |
/orbital recipe |
ultorbitals.recipe |
Open recipe gui |
Admin Commands — /orbitala
| Command |
Permission |
Description |
/orbitala |
ultorbitals.admin |
Open the admin dashboard GUI |
/orbitala dashboard |
ultorbitals.admin |
Open the admin dashboard GUI |
/orbitala cap [on|off] |
ultorbitals.admin |
View or toggle the world-wide strike cap |
/orbitala capset <number> |
ultorbitals.admin |
Set the maximum simultaneous active strikes |
/orbitala capreset |
ultorbitals.admin |
Reset the active strike counter to 0 |
/orbitala weapon <type> <key> <value> |
ultorbitals.admin |
Edit any weapon parameter live |
/orbitala track [player] |
ultorbitals.admin |
Print a player's current orbital inventory |
Weapon editor example:
/orbitala weapon nuke rings 8
/orbitala weapon nuke tnt-per-ring-base 60
/orbitala weapon wither count 10
/orbitala weapon stab explosion-power 6
? Permissions
| Node |
Default |
Description |
ultorbitals.use |
OP |
Base usage permission (covers all weapons) |
ultorbitals.nuke |
OP |
Nuke weapon |
ultorbitals.stab |
OP |
Stab weapon |
ultorbitals.bomb |
OP |
Bomb weapon |
ultorbitals.dogs |
OP |
Dog Cannon |
ultorbitals.chunk |
OP |
Chunk Eater |
ultorbitals.wither |
OP |
Wither Cannon |
ultorbitals.give |
OP |
Give weapons to others |
ultorbitals.remove |
OP |
Remove weapons from others |
ultorbitals.reload |
OP |
Reload config |
ultorbitals.disable |
OP |
Toggle global disable |
ultorbitals.admin |
OP |
Full admin access (GUI + cap + weapon editor) |
ultorbitals.admin.gui |
OP |
Open admin GUI only |
ultorbitals.recipe |
Default |
Open recipe GUI |
?️ Admin GUI
Open with /orbitala or /orbitala dashboard.
Dashboard (54-slot inventory):
- Beacon (slot 5) — shows global status; click to toggle global disable
- Barrier (slot 9) — shows cap status; click to toggle cap on/off
- Redstone (slot 8) — click to reset active strike counter
- Player heads (rows 3–6) — one head per online player; shows their orbital counts; click to manage
Player GUI (per-player, 54-slot):
- One fishing rod icon per weapon type showing current count in inventory
- Left-click → give +1 to player
- Right-click → remove 1 from player
- Shift+Left → give +5
- Shift+Right → remove all of that type
- Arrow (slot 46) → back to dashboard
- Lava bucket (slot 54) → remove ALL orbitals from player
⚙️ World-Wide Cap
The cap prevents more than N orbital strikes from being active at the same time across the entire server. By default it is disabled.
Enable and configure in config.yml:
global:
cap:
enabled: true
max: 1
Or use commands:
/orbitala cap on
/orbitala capset 1
When the cap is reached, players see the cap_reached message and their rod is not consumed. Admins can force-reset the counter with /orbitala capreset if strikes get stuck.
? Crafting Recipes
All recipes are configurable in config.yml under recipes:. Each weapon has its own 3×3 shaped recipe. Set recipes.enabled: false to disable all custom recipes. Disable individual weapons with recipes.<type>.enabled: false.
Default recipes:
| Weapon |
Pattern |
Key Materials |
| Nuke |
TNT ring + Netherite center |
TNT, Netherite Ingot, Soul Sand, Redstone Block, Fishing Rod |
| Stab |
Diamond ring |
Diamond, Stick, Fishing Rod |
| Bomb |
Gunpowder ring |
Gunpowder, Fishing Rod |
| Dog Cannon |
Bone ring |
Bone, Fishing Rod |
| Chunk Eater |
Obsidian ring |
Obsidian, Fishing Rod |
| Wither Cannon |
Wither Skull ring |
Wither Skeleton Skull, Fishing Rod |
All recipes can be freely redesigned in config. Reload with /orbital reload.
? Configuration Reference
The single config.yml file controls everything. Key sections:
global
disabled — master on/off (also toggled by /orbital disable)
allowed-worlds — whitelist of world names (empty = all worlds)
cap.enabled — world-wide active strike cap toggle
cap.max — max simultaneous active strikes
cooldowns
Per-weapon cooldown in seconds per player. 0 = no cooldown.
messages
Every player-facing string. Supports & color codes. Available placeholders:
%weapon% — weapon display name
%amount% — quantity
%player% — target player name
%sender% — command sender name
%time% — cooldown seconds remaining
%weapons% — comma-separated list of valid weapon types
weapons.<type>
Per-weapon tuning. All values are live-editable via /orbitala weapon or by editing config and running /orbital reload.
recipes
See crafting section above. Shapes use 3 rows × 3 chars. Ingredient map = character: MATERIAL_NAME.
? Developer API
UltOrbitals exposes a full public API through UltOrbitalsAPI, so other plugins can build, give, track, and trigger orbital weapons programmatically.
Getting the API instance
UltOrbitalsAPI api = UltOrbitalsAPI.get();
Maven dependency
<dependency>
<groupId>me.ultorbitals</groupId>
<artifactId>UltOrbitals</artifactId>
<version>1.0.0</version>
<scope>provided</scope>
</dependency>
Add UltOrbitals as a depend (or softdepend) in your plugin's plugin.yml:
depend: [UltOrbitals]
Building weapon items
ItemStack nuke = api.buildOrbital("nuke");
Supported types: nuke, stab, bomb, dogs, chunk, wither
Giving weapons
api.giveOrbital(player, "nuke", 3);
Removing weapons
int removed = api.removeOrbital(player, "bomb", 2);
Counting weapons
int amount = api.getOrbitalCount(player, "nuke");
Getting all orbitals a player holds
Map<String, Integer> orbitals = api.getAllOrbitals(player);
// e.g. { "nuke": 3, "bomb": 5, "dogs": 1 }
Detecting orbital items
if (api.isOrbital(item)) {
String type = api.getOrbitalType(item);
}
Triggering a strike
Respects the world-wide cap and global disable toggle.
boolean scheduled = api.triggerStrike("nuke", player.getLocation(), player);
Returns false if the strike cap is reached, the weapon type is invalid, or orbitals are globally disabled.
Forcing a strike
Bypasses the strike cap (still fires even if the cap would normally block it).
api.forceStrike("wither", player.getLocation(), player);
Reading live weapon configuration
Lets other plugins read the same tunable values the admin GUI edits.
int rings = api.getWeaponInt("nuke", "rings", 5);
double power = api.getWeaponDouble("nuke", "explosion-power", 10.0);
boolean charged = api.getWeaponBool("wither", "charged", true);
String particle = api.getWeaponStr("nuke", "particles", "flame");
Strike cap controls
int active = api.getActiveStrikes();
int cap = api.getGlobalCap();
api.setGlobalCap(5);
api.resetActiveStrikes();
Global enable/disable
boolean disabled = api.isDisabled();
api.setDisabled(true);
Listing supported weapon types
List<String> types = api.getAllTypes();
// [nuke, stab, bomb, dogs, chunk, wither]
?️ Architecture
UltOrbitals
├── Weapons
│ ├── Nuke
│ ├── Bomb
│ ├── Stab
│ ├── Dogs
│ ├── Chunk
│ └── Wither
│
├── Commands
├── GUI
├── Recipes
├── Cooldowns
├── Config
├── API
└── Managers
Build requirements: Maven 3.8+ and JDK 21+.
❓ FAQ
Q: Rods don't break on one use?
A: Make sure pulls-required is set to 2 (default). The first pull primes the weapon, the second fires and breaks it.
Q: Cap counter stuck after server crash?
A: Run /orbitala capreset to reset the active counter to 0.
Q: How do I make a weapon free-craft for all players?
A: Grant ultorbitals.<type> to the default group in your permissions plugin. The crafting recipe will work for anyone with that permission.
Q: Recipe conflicts with another plugin?
A: Set recipes.<type>.enabled: false for the conflicting weapon and define it in that plugin instead.
Q: Can other plugins hook into UltOrbitals?
A: Yes — see the Developer API section above. Add depend: [UltOrbitals] to your plugin.yml and call UltOrbitalsAPI.get().
? License
UltOrbitals is released under a GNU Affero General Public License.
SHOWCASE VIDEO :-
Built on the OrbitalStrikeCannon mechanism. Expanded with wither cannon, admin GUI, world cap, recipe system, full config control, and a public developer API.
评论 0
登录后参与评分
还没有评论,来抢沙发吧