Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
A Minecraft plugin for easily creating custom items, blocks, glyphs, paintings, music discs, and more.
Oraxen is a Minecraft plugin that allows server owners, administrators, and developers to easily create custom content through configuration files and a simple resource pack setup.
It supports Paper (including forks) and Folia from versions 1.20.1 through 26.2.
Some of the features Oraxen provides to server owners and administrators are listed below.
- Built-in ViaVersion support for versions 1.21.4–26.2, with optional advanced support for versions 1.20–26.2 through MultiVersionPacks.
- Hot reloading for custom paintings and, in the future, custom music discs.
- Fast support through tickets and a team that listens to the community and considers its ideas.
- Well-organized documentation available here.
- Swords, pickaxes, food, shields, bows, and more.
- Blocks, slabs, stairs, doors, and more. Supports hot reloading and animations.
example-block:
itemname: 'Cool block'
Mechanics:
block:
type: FULL # FULL, STRING, CHORUS, STAIR, SLAB, DOOR, TRAPDOOR, GRATE, BULB
light: 15
block-sounds:
break-sound: block.wood.break
place-sound: block.wood.place
placeable:
floor: true # Top of blocks
wall: true # Sides of blocks
roof: false # Underside of blocks
allow:
- minecraft:grass
disallow:
- minecraft:dirt
custom-variation: 5
appearance: # Textures are also supported
model: blocks/cool-block
events: # Run actions when a placed block is clicked
- click: right # BOTH, LEFT, RIGHT
actions:
- command: 'say "<Player> clicked this block"'
executor: CONSOLE # PLAYER, CONSOLE, OP-PLAYER
- message: '<green>Hi <Player>.'
breaking: # Custom drop and breaking configuration
- when: # When the tool is...
- minecraft:iron_axe
- minecraft:golden_axe
- minecraft:diamond_axe
- minecraft:netherite_axe # Tags are also supported through "#<tag>"
hardness: 2 # Hardness when one of these tools is used
drops: # Drops when one of these tools is used
- item: crystalmush_log
probability: 1.0
silk-touch: any # "required" only drops with Silk Touch; "forbidden" only drops without it
fortune: 1 # Percentage increase per Fortune level, where 1 equals 100%
durability:
remove: 1 # Remove or add durability when breaking
add: 0
- else: # Anything not covered by another `when` section
hardness: 4
drops:
- item: example-block
probability: 1.0
durability:
remove: 2 # Remove or add durability when breaking
add: 0- Custom paintings with support for hot reloading and animations.
A tutorial is available here.
example-painting:
material: PAINTING
itemname: "<gold>Example Painting"
Components:
painting_variant: "oraxen:example"paintings:
oraxen:example:
author: the_jan_craft
title: <red>Example Painting
asset_id: oraxen:example # References plugins/Oraxen/pack/assets/oraxen/textures/painting/example.png
width: 1
height: 1- Custom sounds and music discs.
Tutorials are available here and here.
example-disc:
material: MUSIC_DISC_13
itemname: "<gold>Example Disc"
Pack:
model: discs/example
Components:
jukebox_playable:
show_in_tooltip: true
song_key: "oraxen:example"sounds:
- id: oraxen:example
category: records
sound: discs/example.ogg # References plugins/Oraxen/pack/sounds/discs/example.ogg
stream: true
subtitle: "Example Song"
jukebox:
description: "<gold>Example <yellow>Song</yellow></gold>"
duration: 20s- Animated and static emojis, ranks, GUIs, escape menus, and more.
- Custom armor and elytra.
- Crafting, smelting, blasting, smoking, and stonecutting recipes, with an easy-to-use in-game GUI editor.
See https://docs.oraxen.com/developers/compiling.
See https://docs.oraxen.com/developers/contributing.
Read the full license in LICENSE.md.
Oraxen is a paid plugin. You must purchase a license from SpigotMC or BuiltByBit to use it. Public forks are permitted for contributing pull requests, provided that you comply with the license. Do not redistribute compiled builds or source code, whether modified or unmodified, except as permitted by the license.