Skip to main content

⌨️ Commands

Overview​

Oraxen is managed through the /oraxen root command. It also includes the /o and /oxn aliases. Most subcommands are intended for administrators, while a few are player-facing tools such as item browsing, emoji browsing, and HUD toggling.

Permissions​

The root command uses oraxen.command.
Most subcommands also use their own permission nodes, such as oraxen.command.give or oraxen.command.reload.
Some subcommands inherit access from their parent command, while others add an extra permission requirement.

Command Reference​

Core Commands​

📦 Inventory

Opens the Oraxen item browser GUI.

/oraxen inventory - Open the item browser.
/oraxen inv - Alias for the same command.

/oraxen inventory
/oraxen inv

oraxen.command.inventory.view - Allows viewing the item browser.
Anyone who can open the browser can take items from it. There is no separate permission for this.

🎁 Give

Gives an Oraxen item to one or more players.

/oraxen give <targets> <item>
/oraxen give <targets> <item> <amount>

oraxen.command.give - Allows using the give command.

note

targets uses the standard Minecraft player selector format, so you can target one player, multiple players, or selector groups.

📤 Take

Removes matching Oraxen items from one or more players.

/oraxen take <targets> <item>
/oraxen take <targets> <item> [amount]

If amount is omitted, Oraxen removes all matching items from each target.

oraxen.command.take - Allows using the take command.

🎨 Dye

Dyes the item in your main hand using a hex color.

/oraxen dye <#RRGGBB>

oraxen.command.dye - Allows using the dye command.

warning

This command only works for players and expects a valid hex color such as #FFAA00.

🛠️ Repair

Repairs the item in your hand or all repairable items in your inventory.

/oraxen repair hand
/oraxen repair all

oraxen.command.repair - Allows using /oraxen repair.
oraxen.command.repair.all - Allows using /oraxen repair all.

note

This command is marked as deprecated in the plugin source, but it is still registered and available.

🔄 Reload

Reloads specific Oraxen systems or everything at once.

/oraxen reload <items|pack|hud|recipes|configs|messages|paintings|discs|all>
/oraxen rl <items|pack|hud|recipes|configs|messages|paintings|discs|all>

oraxen.command.reload - Allows using the reload command.

items - Reload item definitions and refresh the item browser.
pack - Regenerate the resource pack.
hud - Reload HUD configuration and restart HUD tasks.
recipes - Reload recipes.
configs - Reload configuration files, custom paintings, and custom jukebox songs.
messages - Reload configuration files/messages.
paintings - Reload custom paintings.
discs - Reload custom jukebox song (music disc) configuration.
all - Reload messages, paintings, jukebox songs, mechanics, items, pack, HUDs, and recipes.

🏷️ Version

Shows the installed Oraxen version.

/oraxen version

oraxen.command.version - Allows using the version command.

Resource Pack​

🧳 Pack

Handles resource-pack delivery utilities and default asset extraction.

/oraxen pack send [targets]
/oraxen pack extract_default [all|textures|models|sounds] [override]

oraxen.command.pack - Base permission for the pack command.
oraxen.command.pack.send - Extra permission required for /oraxen pack send.

send - Sends the configured resource pack to the selected players, or to yourself if no target is provided.
extract_default - Extracts bundled default assets into the Oraxen data folder.

warning

pack extract_default does not define its own extra permission in code, so access depends on the parent /oraxen pack permission.

Recipes​

📖 Recipes Showcase

Opens the recipe showcase GUI for all permitted recipes or one specific recipe.

/oraxen recipes show <all|recipe_name>

oraxen.command.recipes - Base permission for recipe commands.
oraxen.command.recipes.show - Allows opening the recipe showcase.

🧪 Recipe Builder

Opens the interactive recipe builder or creates a builder for a specific recipe type.

/oraxen recipes builder
/oraxen recipes builder shaped
/oraxen recipes builder shapeless
/oraxen recipes builder furnace <cookingtime> <experience>
/oraxen recipes builder blasting <cookingtime> <experience>
/oraxen recipes builder campfire <cookingtime> <experience>
/oraxen recipes builder smoking <cookingtime> <experience>
/oraxen recipes builder stonecutting
/oraxen recipes builder smithing
/oraxen recipes builder anvil <experience_cost>
/oraxen recipes builder grindstone <experience>

oraxen.command.recipes.builder - Allows opening and using the recipe builder.

experience_cost is the anvil cost in player levels; experience is the grindstone reward in experience points. Both arguments are required for their respective commands and accept 0.

💾 Recipe Save

Saves the currently open recipe builder to disk.

/oraxen recipes save <name> [permission]

oraxen.command.recipes.builder - Allows saving built recipes.

If permission is set, the saved recipe uses that permission as its unlock requirement.

Player Utilities​

😊 Emojis

Opens the emoji book and shows all configured emoji glyphs the player can access.

/oraxen emojis

oraxen.command.emojis - Allows using the emoji command.

note

Clicking an emoji entry copies the glyph character to the clipboard, and hovering it shows its placeholders.

🖥️ HUD Toggle

Enables or disables a specific HUD for the player.

/oraxen hud toggle <hud_id>

oraxen.command.hud.toggle - Allows toggling HUDs.

warning

The root hud command defines a toggle argument in code, but the actual executable path is /oraxen hud toggle <hud_id>.

Information Commands​

🔤 Glyph Info

Shows information about a configured glyph, including texture and Unicode characters.

/oraxen info glyph <glyphid|all>

oraxen.command.info - Allows using info commands.

📦 Item Info

Shows debug information about an Oraxen item such as material, model data, item model, display name, and generated model path.

/oraxen info item <itemid|all>

oraxen.command.info - Allows using info commands.

🧱 Block Info

Shows block-state information for Oraxen blocks, including noteblock or stringblock data.

/oraxen info block <itemid|all>

oraxen.command.info - Allows using info commands.

🧾 Report

Prints a small system report with plugin, server, and operating-system information.

/oraxen report

oraxen.command.report - Allows using the report command.

🧮 Highest Model Data

Lists the highest used custom model data value for each material.

/oraxen highest-modeldata

oraxen.command.debug - Allows using this command.

Update And Admin Tools​

♻️ Update

Updates Oraxen items in player inventories or refreshes nearby furniture entities.

/oraxen update item <targets>
/oraxen update furniture [radius]

oraxen.command.update - Allows using update commands.

item - Updates Oraxen items for the selected players.
furniture - Updates nearby furniture around the executing player. The default radius is 10.

🪣 Remove Branding

Removes branding (escape menu) and disables the "welcome" sound.

/oraxen remove-branding
/oraxen remove-branding confirm

oraxen.command.remove-branding - Allows removing branding after confirmation.

💎 Remove Defaults

Removes all shipped default assets and configs (for a clean, minimalistic setup).

warning

It's not recommended to use this command if you have already added your own configs or assets.

/oraxen remove-defaults
/oraxen remove-defaults confirm

oraxen.command.remove-defaults - Allows removing defaults after confirmation.

🧱 Admin Block Tools

Places or removes Oraxen blocks in a single location or in an area.

/oraxen admin block <block> <place|remove> [location] [radius] [random]

oraxen.command.admin - Allows using admin tools.

location defaults to the executing player's position.
radius defaults to 1.
random limits the action to one random block in the selected area when set to true.

🪑 Admin Furniture Tools

Places or removes Oraxen furniture in a single location or in an area.

/oraxen admin furniture <place|remove> <furniture> [location] [radius] [random]

oraxen.command.admin - Allows using admin tools.

🪄 Totem Animation

Plays a totem-resurrection animation for a player using an Oraxen item or vanilla item material.

/oraxen totem-animation <player> <item|minecraft:material>

oraxen.command.totem-animation - Allows playing custom totem animations.

note

This command is only available on servers running Minecraft 1.21.2 or newer.

note

Vanilla items can be written as minecraft:totem_of_undying or by material name. Oraxen applies Paper death-protection components when supported so custom items can trigger the animation.

Debug And Maintenance​

🐞 Debug

Enables or disables Oraxen debug mode in settings.yml.

/oraxen debug
/oraxen debug <true|false>

oraxen.command.debug - Allows toggling debug mode.

📋 Dump Log

Uploads logs/latest.log to mclo.gs, with a Hastebin fallback if needed.

/oraxen dump-log

oraxen.command.dumplog - Allows using the log dump command.

warning

Oraxen redacts the default Atlas pack URL pattern before uploading, but you should still review logs before sharing them publicly.

🧬 Schema

Generates the Oraxen JSON schema file inside the plugin folder.

/oraxen schema

oraxen.command.schema - Allows generating the schema.

Notes​

info

The text effect commands were removed from the plugin. An old text_effects.yml is migrated to a backup folder automatically.

info

Many utility and admin commands are player-only in practice, even when the syntax looks generic. Commands such as /oraxen inventory, /oraxen repair, /oraxen recipes, /oraxen emojis, /oraxen hud toggle, /oraxen totem-animation, and the admin placement tools should be run by or target an online player ingame.

warning

This page is based on the currently registered commands in the plugin source. If you are using an older build, some commands may be missing or behave slightly differently.