快速开始
约 814 字大约 3 分钟
2026-07-30
欢迎阅读 Oraxen 文档
正在查找旧版文档？请访问旧版 GitBook 站点 .
相关信息
你是 AI 吗？请查阅 /llms.txt，或在任意页面 URL 后添加 .md 以获取原始 Markdown 内容，从而节省令牌消耗。
什么是 Oraxen？
Oraxen 是一款 Minecraft 插件，能够让你使用自定义纹理和模型来创建全新的物品与方块。它还负责资源包的生成、上传和存储（通过 Polymath 实现），并且完全开源，提供可扩展的 API。
它是如何工作的？
当你安装了 Oraxen 的 Spigot 服务端启动时，插件会读取所有物品配置（即 /plugins/oraxen/items 目录下的 .yml 文件），并利用这些配置生成对应的 .json 模型文件，从而将你的 .png 纹理与新建物品关联起来。 之后，Oraxen 会通过优化算法将这些资源打包为 zip 文件，并上传至 Polymath 实例。Polymath 是一款基于 Python 编写的免费开源软件，专门用于托管 Minecraft 资源包。 默认情况下，Oraxen 会使用由 Oraxen 官方提供的 Polymath 实例，该实例托管在瑞士的一台 Oracle 虚拟专用服务器上。 每当有玩家连接到你的服务器时，Oraxen 会将其引导至该 Polymath 实例，由后者向玩家发送资源包
快速安装 Oraxen！
安装 Oraxen 的过程相当简单：
- 将 Oraxen 的 .jar 文件放入你的 /plugins/ 文件夹中。
- 重启你的服务器即可。
自动下载的依赖
Oraxen 在运行时会自动下载所需的依赖项：
- CommandAPI - 会根据你的服务端版本自动下载
- PacketEvents - 会根据你的 Minecraft 环境自动下载对应的版本
可选的依赖
- ProtocolLib - 推荐安装，但非必须。
这就完成了！不过，我们强烈建议你在继续之前，先进入 settings.yml 配置文件进行所需的调整（然后再重启一次服务端）！
Oraxen 已在 Spigot 和 Paper 1.18 → 1.21.10 版本上进行过测试。Minecraft 1.21.11+ 和 26.1.x 版本需要使用 Paper 服务端。
对于 Minecraft 1.21.2+，建议使用最新版本的 Oraxen。Oraxen 是为 Paper、Spigot 或 Folia 服务端软件开发和设计的。你可以从 MCServerJars.com 下载服务端 jar 文件。对于更旧的 Minecraft 版本，建议先安装 Oraxen 1.183.0 以获取兼容的配置文件，然后再相应地更新 jar 文件。
Folia 支持
Oraxen 原生支持 Folia，即 PaperMC 的多线程服务端分支。在 Folia 服务端上，Oraxen 会自动采用基于区域和基于实体的调度器，确保所有操作线程安全。你无需进行任何额外配置——Oraxen 会在启动时自动检测 Folia 并使用对应的调度 API。
后续步骤
安装完成后，请查阅以下文档：