一个神秘的文档站

简体中文

English

简体中文

English

外观

常见问题

约 1367 字大约 5 分钟

2026-07-30

常见问题解答

Oraxen 是一个 Mod 吗？

不，Oraxen 并不是通常意义上的 Mod。它是一款 Minecraft 插件，让你能够为游戏添加物品、方块以及其他各种炫酷的内容——这一切都通过自动安装的资源包来实现。

Oraxen 支持 Folia 吗？

当然支持！Oraxen 原生兼容 Folia（PaperMC 的多线程服务端分支）。Oraxen 会在启动时自动识别 Folia，并启用基于区域和实体的调度机制，从而保证所有操作都是线程安全的。你完全不需要额外配置任何东西。

使用了 Oraxen 的资源包，我还能使用我自己的吗？

可以的。详细信息请参见此处。

我使用了 BungeeCord / Velocity，但是玩家切换服务器时资源包总在重新加载，该怎么办？

这是因为玩家在技术上相当于离开了一个服务器并加入了另一个服务器，因此 Minecraft 会移除原资源包并重新发送。如果你想避免这种情况，可以使用 BungeePackLayer。这是一款 BungeeCord / Velocity 插件，用于防止资源包被重复发送（除非资源包内容不同）。如果各服务器的配置文件不一致，资源包就会被视为不同而重新发送。

我可以禁用 Oraxen 自带的默认资源和配置吗？

当然可以。你可以在 settings.yml 文件中找到禁用这两者的配置选项：

Plugin:
  generation:
    default_assets: false  # 禁用默认纹理/模型/音效
    default_configs: false # 禁用默认物品配置

注意：即使禁用了这些选项，必要的文件仍然会照常生成：

  • glyphs/required.yml —— 包含必要的 UI 字形（如退出图标等）
  • 核心插件配置文件（包括 settings.yml、mechanics.yml 等）

当 default_assets 设为 false 时，Oraxen 将不会生成以下内容：

  • 13 个默认物品配置文件（盔甲、方块、武器、家具等）
  • 资源包中的默认纹理和模型
  • 5 个字形文件（表情符号、界面、动画、聊天标签）

当 default_configs 也设为 false 时，则仅保留必要的字形文件和核心配置文件。

如何关闭或修改欢迎音效？

当然可以。settings.yml 中包含了一些可配置的动作，会在资源包发送给玩家时执行，默认其中包含一个音效。下面的示例展示了如何根据需要禁用或更改该音效。

要禁用音效，请将 enabled 设为 false。要更改音效，请修改 type、volume 或 pitch 的值。

  receive:
    enabled: true
    loaded:
      actions:
        sound:
          # 设为 false 以禁用欢迎音效
          # 设为 true 以启用欢迎音效
          enabled: true
          type: minecraft:welcome  # 修改此项以使用其他音效
          volume: 1.0  # 0.0 至 1.0
          pitch: 1.0   # 0.5 至 2.0

Oraxen 是否会替换掉原版的物品？

Oraxen 的目标是在不丢失任何功能的前提下为游戏添加新内容，所以简短的答案是：不会。然而，Minecraft 本身存在一些限制（例如，你无法真正添加全新的方块或盔甲），因此我们不得不做出一些选择（这些选择可以通过禁用相关机制来撤销）：-新方块将使用原版中未使用的音符盒变种：这可能会在使用这些不常见变种的建筑结构中引发问题。

添加新物品时，为什么会导致之前创建的物品纹理损坏？

在默认情况下（1.21.4 之前），Oraxen 会自动为你的物品分配自定义模型数据值，并以最优化的方式进行生成。每个使用不同模型的物品都需要拥有一个独立的数值。如果你手动设置了某个物品的自定义模型数据值，又不小心将两个或更多不同的物品设置为相同的值，就会导致其他物品的纹理被破坏。

添加新物品后，别忘了执行 /o reload all 重载插件，然后使用 /o pack send @a 发送资源包（或者你也可以让玩家断开并重新连接服务器来加载）。

为什么我的纹理只有安装了 Optifine 才能生效，而原版 Minecraft 却看不到？

从 Minecraft 1.11 开始，原版资源包就已经不再允许在文件夹、纹理或模型文件名中使用大写字母了（不过 Optifine 仍然支持）。为了避免兼容性问题，请务必不要使用大写字母命名。

如何更新 Oraxen？

这里有一个很榜的视频教程，或许能够帮到你：https://youtu.be/LkansZwVaPY

怎样隐藏物品的 Tooltip？

https://github.com/lolgeny/item-tooltip-remover

在哪里可以反馈 Bug 或提出新功能需求？

第一种方式：登录 GitHub，在官方仓库提交 Issue：git.io/oraxen

第二种方式：加入 Discord 服务器，完成 Oraxen 身份验证后，在支持频道中创建工单。

我只想用 Oraxen 的机制功能，该怎么配置？

打开 settings.yml 文件，然后设置以下选项：

  upload:
    enabled: false
Pack:
  generation:
    generate: false
    compression: BEST_COMPRESSION
    protection: false
  dispatch:
    send_pack: false
  enable_configs_updater: false
Misc:
  reset_recipes: false
  auto_update_items: false

配置项的顺序不是固定的，不一定要完全按那个顺序排列。修改完成后，请清空 /Oraxen/pack、/Oraxen/items 和 /Oraxen/glyphs 这三个文件夹，然后重启服务器。