OraxenOre

OraxenOre is a lightweight addon for Oraxen that allows you to naturally generate your custom Oraxen blocks (ores, decorations, etc.) in the world, just like vanilla ores — all fully configurable through a simple config.yml.

✨ Features

• 🎯 100% configurable generation: choose any Oraxen block, the number of placement attempts per chunk, and the minimum and maximum generation height.
• 🪨 Automatic deepslate support: assign a deepslate variant to your ore, and the plugin will automatically choose the correct version based on the Y level (configurable threshold).
• ⚡ On-the-fly generation: ores are placed as soon as a new chunk is generated, with no need to regenerate the world.
• 🔒 Safe and performant: placement is designed to avoid freezes or lag during chunk generation (no interaction with neighboring chunks).
• 🔄 Hot reload: modify your configuration and apply changes without restarting the server using /oraxenore reload.
• ✅ Automatic validation: on startup, the plugin checks that every configured block exists in Oraxen and safely ignores invalid entries (with a clear message in the console).

📋 Requirements

• Paper 1.21+ (or a compatible fork)
• Oraxen (an Oraxen license is required)

⚙️ Configuration

Example config.yml:

# Y threshold below which the deepslate variant is used
deepslate-threshold-y: 0

ores:
  amethyst:
    block: "amethyst_ore"
    deepslate-block: "amethyst_deepslate_ore"
    amount-per-chunk: 6
    min-y: -64
    max-y: 32

  ruby:
    block: "ruby_ore"
    amount-per-chunk: 4
    min-y: -64
    max-y: 16

📦 Installation

1. Download the latest version of OraxenOre.
2. Place the .jar file into your server's plugins/ folder (Oraxen must already be installed).
3. Start the server to generate the default config.yml.
4. Configure your ores in plugins/OraxenOre/config.yml.
5. Reload the plugin with /oraxenore reload or restart the server.

🐛 Report a Bug / Suggestion

Feel free to open an issue on the project's repository if you encounter a bug or have an idea for an improvement.