AuraUtils

Lightweight homes, warps, TPA, back, RTP, timber, player inventories, and player toggles for Spigot, CraftBukkit, Paper, Purpur, and Folia.

Players get a shared teleport countdown, a simple GUI, and translatable messages. Operators get warps, home limits, reload, and an optional GitHub update notice.

AuraUtils does not include an economy. Pair it with PureEconomy for a lightweight utilities + economy stack. They talk through Vault; AuraUtils charges PureEconomy's default currency. Neither plugin requires the other.

!INSTALLATION

Install exactly one platform JAR. Both filenames are copies of the same shaded bytecode; Paper, Folia, and Spigot behavior is detected at runtime. Use the name that matches your server.

Server	Install
Spigot / CraftBukkit / Bukkit	AuraUtils-<version>-spigot.jar
Paper / Purpur / Folia	AuraUtils-<version>-paper-folia.jar

1. Place the matching JAR in plugins/.
2. Restart the server.
3. Edit plugins/AuraUtils/config.yml if you want.
4. On first start the plugin copies lang/en.yml. Translate it or add another locale and set language:.
5. Run /aura reload (aura.admin) after config or language edits.

!FEATURES

• Homes with optional GUI, name rules, overwrite confirm, and optional limits
• Server warps with optional GUI and overwrite confirm
• Timed TPA plus a trusted list that auto-accepts requests
• /back, safe /rtp, god, fly, nofall, nohunger, timber
• Extra player inventories (/inv 1, /inv 2, …) with rank limits
• /menu utility GUI
• Shared countdown: chat, action bar, title, cancel on move/damage, rising-pitch sounds
• aura.teleport.bypass for instant teleports
• Optional Vault economy costs for home, warp, TPA, RTP, and back — pair with PureEconomy or any Vault economy
• All player-facing text in lang/en.yml

Trusted TPA: /tpatrust <player> adds them to your list. They can /tpa you without /tpaccept. Manage with /tpatrust list and /tpauntrust <player>. Cancel a countdown or an outgoing TPA with /tpacancel (/tpcancel, /auracancel).

Timber: with timber.enabled: true (default), chopping a log with an axe fells the connected tree. /timber turns it off for you. Sneak to chop a single log.

Player inventories: /inv 1 is a personal double chest. Normal ranks get that one inventory. Give a rank more with a single node — aura.inv.3 allows /inv 1–3. Works with LuckPerms or any other permission plugin.

!COMMANDS

Command	Permission	Description
/home [name|list]	aura.home	Teleport to a home or open the home GUI
/sethome <name>	aura.home.set	Create or update a home
/delhome <name>	aura.home.delete	Delete a home
/warp [name|list]	aura.warp	Teleport to a warp or open the warp GUI
/setwarp <name>	aura.warp.set	Create or update a warp
/delwarp <name>	aura.warp.delete	Delete a warp
/tpa <player>|list	aura.tpa	Send a TPA request or open the TPA GUI
/tpaccept / /tpadeny	aura.tpa	Accept or deny a pending TPA
/tpacancel	aura.use	Cancel a countdown or outgoing TPA
/tpatrust / /tpauntrust	aura.tpa.trust	Manage your trusted TPA list
/back	aura.back	Return to the last teleport location
/rtp	aura.rtp	Random safe teleport
/god [player]	aura.god	Toggle invincibility
/fly [player]	aura.fly	Toggle flight
/nofall [player]	aura.nofall	Toggle fall damage
/nohunger [player]	aura.nohunger	Toggle hunger depletion
/timber [player]	aura.timber	Toggle chopping a whole tree from one log
/inv [number|list]	aura.inv	Open a personal extra inventory
/menu	aura.menu	Open the utility GUI
/aura [reload]	aura.use / aura.admin	Command list; reload config and language

!REQUIREMENTS

• Java 21+ (Minecraft 26.1+ servers need Java 25)
• Minecraft 1.21.x and 26.1 / 26.2
• Spigot, CraftBukkit, Paper, Purpur, or Folia
• Optional: Vault + an economy plugin if you want paid teleports / set-home / set-warp. PureEconomy is the matching lightweight companion.

!CONFIGURATION

tpa:
  timeout: 60
  trusted-max: 50
  trusted-instant: false

homes:
  default-limit: 3
  limits: []

inventories:
  enabled: true
  rows: 6
  max: 10
  default-limit: 1
  limits: []

rtp:
  radius: 2000
  minDistance: 250
  attempts: 30
  generate-unloaded: true     # Spigot / CraftBukkit
  max-sync-generations: 3     # Spigot / CraftBukkit cap

teleport:
  countdown: 5
  countdown-display: both
  chat-at: [3, 2, 1]
  title: true
  cancel-on-move: true
  sound: true
  sound-rising-pitch: true

language: en
prefix: "&8[&bAura&8] &r"

update-checker:
  enabled: true

economy:
  enabled: true
  notify: true
  costs:
    home: 0.0
    sethome: 0.0
    warp: 0.0
    setwarp: 0.0
    tpa: 0.0
    rtp: 0.0
    back: 0.0

timber:
  enabled: true
  require-axe: true
  sneak-chops-single: true
  break-leaves: true
  max-logs: 128
  max-leaves: 256

Home and warp names are 1–32 letters, numbers, _, or -. Overwriting an existing name asks for clickable [CONFIRM] / [CANCEL] (30 seconds).

chat-at: [3, 2, 1] always announces the start (for example 5), then only those remaining seconds. Action bar and title still update every second.

When update-checker.enabled is true, operators with aura.admin get a clickable chat link if a newer GitHub release exists.

Economy is optional. Costs of 0 are free. Without Vault (or without an economy provider), every action stays free. Money is taken when the action succeeds; a cancelled countdown is not charged; a failed teleport is refunded. aura.economy.bypass skips costs.

!PERMISSIONS

Permission	Default	Description
aura.use	true	Basic access / /tpacancel
aura.menu	true	Open the utility menu
aura.back	true	Use /back
aura.warp	true	Use warp commands
aura.warp.set	op	Create/update warps
aura.warp.delete	op	Delete warps
aura.home	true	Use home commands
aura.home.set	true	Set homes
aura.home.delete	true	Delete homes
aura.tpa	true	Use tpa / tpaccept / tpadeny
aura.tpa.trust	true	Manage trusted TPA list
aura.god / aura.god.others	op	God mode for self / others
aura.fly / aura.fly.others	op	Fly for self / others
aura.nofall / aura.nofall.others	op	Fall damage for self / others
aura.nohunger / aura.nohunger.others	op	Hunger for self / others
aura.timber / aura.timber.others	true / op	Easy tree chopping for self / others
aura.inv	true	Open extra inventories (/inv)
aura.inv.<n>	false	Open inventories 1 through n
aura.rtp	true	Random safe teleport
aura.teleport.bypass	op	Skip teleport countdown
aura.economy.bypass	op	Skip Vault economy costs
aura.admin	op	All permissions, including /aura reload

!NOTE

Use the matching marketplace filename (AuraUtils-<version>-spigot.jar or AuraUtils-<version>-paper-folia.jar). Both files are the same bytecode; the server type is detected at runtime. After first start, translate plugins/AuraUtils/lang/en.yml or add another lang/<code>.yml. Add language:, homes.default-limit, inventories, update-checker.enabled, economy, and timber to an existing config.yml if those keys are missing.

!METRICS

AuraUtils sends anonymous usage stats through bStats (plugin id 33574). Charts are public. No player names, UUIDs, IPs, chat, or inventory contents.

Every bStats plugin reports player count, online-mode, Minecraft version, server software, Java version, OS, CPU cores, country, and plugin version.

AuraUtils also reports (config and usage only): teleport countdown length and display mode; cancel-on-move / cancel-on-damage / teleport sound; RTP countdown and TPA timeout; whether timber, player inventories, and Vault economy are enabled or hooked; how many currently online players have god, fly, nofall, or nohunger on; how many server warps exist.

Opt out for every bStats plugin on the server: plugins/bStats/config.yml → enabled: false, then restart. There is no separate AuraUtils metrics switch.

Downloads · Changelog · Support

Copyright: Lozaine@Tamawish · MIT