UltOrbital

插件

· 作者 geturplugins

适用于 Paper 1.21.x 的高性能轨道打击系统

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.0 · 26.2 · Folia / Paper

一键开服(送7天)

☢️ 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

⚡ 安装

  1. 将 UltOrbitals-1.0.0.jar 放入你的 plugins/ 文件夹中。
  2. 启动或重启服务器。
  3. 根据需要编辑 plugins/UltOrbitals/config.yml。
  4. 运行 /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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源