{"id":26761678,"url":"https://github.com/zhibeigg/orryx","last_synced_at":"2026-02-14T17:02:03.629Z","repository":{"id":272893834,"uuid":"917434432","full_name":"zhibeigg/Orryx","owner":"zhibeigg","description":"跨时代技能插件，支持实现复杂逻辑，为稳定高效而生","archived":false,"fork":false,"pushed_at":"2025-04-14T15:44:23.000Z","size":913,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-15T09:11:38.869Z","etag":null,"topics":["bukkit","bukkit-plugin","minecraft","minecraft-plugin","paper","taboolib"],"latest_commit_sha":null,"homepage":"https://orryx.mcwar.cn","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhibeigg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-16T01:18:58.000Z","updated_at":"2025-04-14T15:44:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"d8e3620c-d5d9-4d5c-b3af-c1abfa131a1a","html_url":"https://github.com/zhibeigg/Orryx","commit_stats":null,"previous_names":["zhibeigg/orryx"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhibeigg%2FOrryx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhibeigg%2FOrryx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhibeigg%2FOrryx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhibeigg%2FOrryx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhibeigg","download_url":"https://codeload.github.com/zhibeigg/Orryx/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249040110,"owners_count":21202820,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit","bukkit-plugin","minecraft","minecraft-plugin","paper","taboolib"],"created_at":"2025-03-28T18:26:42.423Z","updated_at":"2026-02-14T17:02:03.609Z","avatar_url":"https://github.com/zhibeigg.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Orryx\n\n![orryx.png](https://image.mcwar.cn/i/2026/02/11/698c2c2c82af5.png)\n\n**跨时代技能插件，支持实现复杂逻辑，为稳定高效而生**\n\n[![Version](https://img.shields.io/badge/version-1.36.93-blue?style=for-the-badge)](https://github.com/zhibeigg/Orryx/releases)\n[![Minecraft](https://img.shields.io/badge/Minecraft-1.12--1.21-green?style=for-the-badge\u0026logo=minecraft)](https://www.minecraft.net/)\n[![Kotlin](https://img.shields.io/badge/Kotlin-2.1.20-purple?style=for-the-badge\u0026logo=kotlin)](https://kotlinlang.org/)\n[![TabooLib](https://img.shields.io/badge/TabooLib-6.2.4-orange?style=for-the-badge)](https://github.com/TabooLib/taboolib)\n\n[![Wiki](https://img.shields.io/badge/Wiki-开始使用-darkred?style=for-the-badge\u0026logo=gitbook)](https://o0vvjwgpeju.feishu.cn/wiki/Syzzw7aQwixJ4YkXoOAcyYkfnOg)\n[![Ask DeepWiki](https://img.shields.io/badge/DeepWiki-Ask_AI-00D4AA?style=for-the-badge)](https://deepwiki.com/zhibeigg/Orryx)\n[![Ask ZRead](https://img.shields.io/badge/ZRead-Ask_AI-00b0aa?style=for-the-badge)](https://zread.ai/zhibeigg/Orryx)\n\n\u003c/div\u003e\n\n---\n\n## 特色功能\n\n### 技能系统\n\n| 技能类型                     | 说明          |\n|--------------------------|-------------|\n| **被动技能 (Passive)**       | 自动触发，无需手动释放 |\n| **直接释放 (Direct)**        | 按键即释放       |\n| **直接指向性 (Direct Aim)**   | 带指示器的指向性技能  |\n| **蓄力释放 (Pressing)**      | 长按蓄力后释放     |\n| **蓄力指向性 (Pressing Aim)** | 蓄力型指向性技能    |\n\n- 技能等级与经验管理\n- 技能点升级系统\n- 技能冷却管理\n- 技能升级前检测与成功执行钩子\n- 按键绑定系统（支持多键组合如 `G+F`）\n\n### 冷却时间系统\n\n| 操作        | 说明                                    |\n|-----------|---------------------------------------|\n| **重置冷却**  | `cooldown reset`                      |\n| **增加冷却**  | `cooldown add \u003ctick\u003e` - 延长倒计时         |\n| **减少冷却**  | `cooldown take \u003ctick\u003e` - 缩短倒计时        |\n| **设置冷却**  | `cooldown set \u003ctick\u003e` - 重设倒计时         |\n| **获取倒计时** | `cooldown get` / `cooldown countdown` |\n| **检测冷却**  | `cooldown has` - 是否在冷却中               |\n\n### 职业系统\n\n- 职业绑定技能组\n- 职业等级与经验\n- 职业升级获取技能点\n- 职业最大法力值/精力值配置\n- 职业属性系统集成\n\n### 资源管理\n\n| 资源类型             | 功能                 |\n|------------------|--------------------|\n| **法力值 (Mana)**   | 给予/消耗/设置、充足检查、自然恢复 |\n| **精力值 (Spirit)** | 给予/消耗/设置、充足检查、自然恢复 |\n| **经验系统**         | 自定义经验算法、升级配置       |\n\n### 脚本引擎\n\n**Kether 脚本** - 74 个内置动作\n- 基础：延迟、同步、条件判断、流程控制\n- 技能：冷却管理、法力/精力操作、伤害计算\n- 效果：粒子特效、动画、音效\n- 数学：矩阵变换、四元数、向量运算\n- 选择器：几何体范围选择、目标筛选\n- 射线：光线追踪、碰撞检测\n\n### 触发器系统 (100+)\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eBukkit 原生事件 (44)\u003c/b\u003e\u003c/summary\u003e\n\n- 玩家加入/退出/踢出\n- 玩家伤害（前/后）\n- 玩家移动/跳跃\n- 物品操作（消耗、掉落、损坏、拾取）\n- 交互事件（实体、方块）\n- 聊天/命令\n- 等级/经验变化\n- 更多...\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eOrryx 事件 (28)\u003c/b\u003e\u003c/summary\u003e\n\n- 技能：释放、检查、冷却增加/减少/设置\n- 法力值：增加、减少、恢复、治疗、上升、下降\n- 精力值：增加、减少、恢复、治疗、上升、下降\n- 职业：更改（前/后）、清除\n- 等级：升级、降级\n- 经验：增加、减少\n- 技能点：增加、减少\n- 标志：玩家标志变更、全局标志变更\n- 按键：按下、抬起、持续\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e第三方插件事件\u003c/b\u003e\u003c/summary\u003e\n\n- **DragonCore**：DragonEntity 加入/离开、缓存加载、按键、数据包、槽位\n- **GermPlugin**：客户端连接、按键事件\n- **ArcartX**：按键（按下/释放/简单/组合）、鼠标点击、自定义数据包、实体加入/离开、客户端通道\n- **DungeonPlus**：副本开始/结束/离开\n\n\u003c/details\u003e\n\n### 选择器系统\n\n| 几何体 | 说明 |\n|-------|------|\n| Range | 圆形范围 |\n| Sector | 扇形范围 |\n| Annular | 环形范围 |\n| AABB | 轴对齐包围盒 |\n| OBB | 有向包围盒 |\n| RayHit | 射线击中 |\n| Frustum | 视锥体 |\n| Floor | 地板范围 |\n\n**目标流筛选**：Self、Origin、Direct、Offset、Type、Teammate、Team、PVP、Amount、Server、World、Current、Joiner\n\n### 碰撞系统\n\n- 球体碰撞 (Sphere)\n- 胶囊体 (Capsule)\n- 轴对齐包围盒 (AABB)\n- 有向包围盒 (OBB)\n- 射线 (Ray)\n- 复合体 (Composite)\n\n### 状态管理\n\n- 玩家状态机系统\n- 状态类型：眩晕、格挡、躲避、技能状态、普通攻击、蓄力攻击\n- 状态前置条件检查\n- 状态入场/退出钩子\n\n### 多端 UI\n\n| 端              | 功能        |\n|----------------|-----------|\n| **Bukkit**     | 原生 UI 界面  |\n| **GermPlugin** | HUD、动画、UI |\n| **DragonCore** | 自定义 UI、物品 |\n| **ArcartX**    | UI、脚本、变量  |\n\n### 伤害系统\n\n伤害类型：物理、魔法、火焰、真伤、自伤、控制台、自定义\n\n---\n\n## 第三方插件集成\n\n| 插件                  | 功能                        |\n|---------------------|---------------------------|\n| **ArcartX**         | UI、动画、模型、音效、Glimmer 脚本集成   |\n| **Nodens**          | 属性系统、伤害处理器、治疗处理器          |\n| **DungeonPlus**     | 副本系统集成、条件检查               |\n| **AttributePlus**   | 属性系统                      |\n| **AstraXHero**      | 英雄属性系统、战斗数据               |\n| **MythicMobs**      | 怪物管理、机制、条件、目标选择器          |\n| **DragonCore**      | UI、动画、时装、粒子、模型、数据包        |\n| **GermPlugin**      | UI、HUD、动画、时装、特效、按键        |\n| **CloudPick**       | 时装、粒子、动画、音乐、GUI、HUD、模型、槽位 |\n| **GDDTitle**        | 龙核 HUD 标题                 |\n| **packetevents**    | FOV 数据包处理                  |\n| **ProtocolLib**     | FOV 数据包处理                  |\n| **PlaceholderAPI**  | 变量占位符                     |\n| **Adyeshach**       | NPC 虚拟实体系统                 |\n\n---\n\n## 快速开始\n\n### 安装\n\n1. 下载 [最新版本](https://github.com/zhibeigg/Orryx/releases)\n2. 放入服务器 `plugins` 目录\n3. 重启服务器\n4. 编辑 `plugins/Orryx/config.yml`\n\n### 依赖\n\n| 类型 | 依赖项 |\n|-----|--------|\n| **必需** | TabooLib (已内置) |\n| **可选** | 见上方第三方插件列表 |\n\n---\n\n## 项目结构\n\n```\nOrryx/\n├── api/                    # 公开 API (30+ 事件和接口)\n│   ├── events/            # 事件系统\n│   ├── interfaces/        # API 接口\n│   └── collider/          # 碰撞系统\n├── core/                   # 核心模块\n│   ├── skill/             # 技能系统\n│   ├── job/               # 职业系统\n│   ├── station/           # 触发器系统 (100+)\n│   ├── kether/            # Kether 脚本引擎 (74 个动作)\n│   ├── selector/          # 选择器系统\n│   ├── damage/            # 伤害系统\n│   └── common/timer/      # 冷却时间系统\n├── module/                 # 功能模块\n│   ├── mana/              # 法力值\n│   ├── spirit/            # 精力值\n│   ├── state/             # 状态管理\n│   └── ui/                # UI 渲染 (Bukkit/Germ/Dragon/ArcartX)\n├── compat/                 # 第三方插件兼容\n└── utils/                  # 工具类\n```\n\n### 配置文件\n\n```\nplugins/Orryx/\n├── config.yml             # 主配置\n├── keys.yml               # 按键配置\n├── bloom.yml              # Bloom 泛光配置\n├── buffs.yml              # Buff 配置\n├── npc.yml                # NPC 配置\n├── state.yml              # 状态机配置\n├── selectors.yml          # 选择器预设\n├── skills/                # 技能定义\n├── jobs/                  # 职业定义\n├── stations/              # 中转站定义\n├── controllers/           # 控制器定义\n├── experiences/           # 经验算法\n├── status/                # 状态定义\n├── ui/                    # UI 配置\n├── lang/                  # 语言文件\n└── placeholders/          # 占位符配置\n```\n\n---\n\n## 构建\n\n### 发行版本\n```bash\n./gradlew build\n```\n\n### 开发版本 (API 包)\n```bash\n./gradlew taboolibBuildApi -PDeleteCode\n```\n\n---\n\n## API 使用\n\n### Gradle (Kotlin DSL)\n```kotlin\nrepositories {\n    maven(\"https://maven.mcwar.cn/releases\")\n}\n\ndependencies {\n    compileOnly(\"org.gitee.orryx:orryx:1.36.93:api\")\n}\n```\n\n### Gradle (Groovy)\n```groovy\nrepositories {\n    maven { url 'https://maven.mcwar.cn/releases' }\n}\n\ndependencies {\n    compileOnly 'org.gitee.orryx:orryx:1.36.93:api'\n}\n```\n\n---\n\n## 数据存储\n\n| 类型         | 说明      |\n|------------|---------|\n| **SQLite** | 默认，开箱即用 |\n| **MySQL**  | 生产环境推荐  |\n| **H2**     | 轻量级嵌入式  |\n| **Redis**  | 可选缓存层   |\n\n---\n\n## 文档资源\n\n- [飞书 Wiki](https://o0vvjwgpeju.feishu.cn/wiki/Syzzw7aQwixJ4YkXoOAcyYkfnOg) - 完整使用文档\n- [DeepWiki AI](https://deepwiki.com/zhibeigg/Orryx) - AI 问答助手\n- [ZRead AI](https://zread.ai/zhibeigg/Orryx) - AI 问答助手\n\n---\n\n## 统计\n\n\u003cdiv align=\"center\"\u003e\n\n[![bStats](https://bstats.org/signatures/bukkit/Orryx.svg)](https://bstats.org/plugin/bukkit/Orryx/24289/)\n\n*Powered by TabooLib*\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Orryx** © 2024-2026\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhibeigg%2Forryx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhibeigg%2Forryx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhibeigg%2Forryx/lists"}