AuraUtils

Lightweight utility plugin for Spigot and Paper servers.

Homes · Warps · TPA · Back · RTP · God · Fly · NoFall · NoHunger · GUI menu

Features

All teleport actions share a configurable countdown (chat / actionbar / both / none), optional cancel-on-move and cancel-on-damage, and short feedback sounds.

Requirements

One JAR covers both the classic 1.21.x line and the new 26.x year-based line. No separate builds required.

Installation

1. Download the latest AuraUtils-x.y.z.jar.
2. Place it in your server’s plugins/ folder.
3. Restart (or reload carefully).
4. Edit plugins/AuraUtils/config.yml if desired, then run /aura or restart.

Configuration

Default config.yml (key options):

# TPA
tpa:
  timeout: 60                 # Seconds before a TPA request expires

# Random teleport
rtp:
  radius: 2000                # Search radius around world spawn
  minDistance: 250            # Minimum horizontal distance from current position
  attempts: 30                # Max random location attempts
  attemptsPerTick: 5          # Attempts spread per tick (reduces lag)
  countdown: 5                # Seconds before RTP; 0 = immediate

# Shared teleport behaviour (warp / home / back / tpa)
teleport:
  countdown: 5                # Seconds before teleport; 0 = instant
  countdown-display: both     # chat | actionbar | both | none
  chat-at: [3, 2, 1]          # Extra chat reminders at these seconds
  cancel-on-move: true
  cancel-on-damage: false
  sound: true

# Chat prefix (& color codes supported)
prefix: "&8[&bAura&8] &r"

Metrics (bStats)

AuraUtils uses bStats to collect anonymous usage statistics (server version, player count range, selected config options, and feature usage counts).

• No personal data is collected.
• Metrics are enabled by default.
• To disable metrics for this plugin (and any other bStats plugins on the server), edit plugins/bStats/config.yml and set enabled: false, then restart.
• Full public charts: https://bstats.org/plugin/bukkit/AuraUtils/33574

This disclosure satisfies SpigotMC resource guidelines for optional metrics.

Permissions

Full authoritative list is in plugin.yml.

Building from source

git clone https://github.com/TamaWish/AuraUtils.git
cd AuraUtils
mvn clean package

The shaded JAR is produced at target/AuraUtils-1.0.0.jar (or the current version).

• Java 21 toolchain
• Dependency: Spigot API 1.21.4 (compatible with 1.21.x and 26.x)
• bStats is shaded and relocated

Links

License

See the repository for license information.