Avenoxrtp

# AvenoxRTP

## Overview

AvenoxRTP is a professional-grade Random Teleport plugin built from the ground up for performance, safety, and total configurability. Designed to compete with the best RTP plugins on the market, it focuses entirely on doing one thing exceptionally well — getting players to safe, random locations fast, with zero reward systems, zero economy gimmicks, and zero bloat.

## 🌐 Links

[!(https://img.shields.io/badge/Discord-Join%20Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/DH3xfGHDFt)

[!(https://img.shields.io/badge/YouTube-@FinalStrikerrr-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/@FinalStrikerrr)

## Features

### 🌍 Multi-World Support

Unlimited configured worlds — Overworld, Nether, End, or any custom world Per-world settings: cooldown, price, radius, permissions, enable/disable Two border modes: `FOLLOW_WORLD_BORDER` (auto-detects the vanilla world border) or `CUSTOM_RADIUS` (your own bounds)

### 🛡️ Safe Location System

Full hazard detection: lava, fire, cactus, magma, powder snow, void, cave pockets, and more Configurable safety rules with extra unsafe-block overrides Min/max Y-level bounds per search Main-thread-safe chunk loading — every chunk check happens correctly on Paper’s main thread, so destinations always render properly with no invisible terrain or lag spikes

### ⚡ Performance

Location pre-caching — safe spots are pre-calculated in the background so teleports feel instant Batched, tick-friendly search loop that avoids main-thread stalls Built to support 500+ concurrent players with minimal TPS impact Persistent chunk tickets keep destination chunks loaded through teleport

### 🎨 GUI Customization

Every slot, material, name, lore line, sound, enchant glow, and custom model data is editable via `gui.yml` Built-in placeholders for cooldown, distance, and player stats inside item lore Border/filler decoration support for a polished, professional look out of the box

### ⏱️ Countdown System

Configurable countdown timer with live BossBar, Title, and ActionBar updates Per-tick sound effects (fully configurable) Smart cancellation — countdown cancels on move, damage, command use, or disconnect (each independently toggleable) Particle effects on success/failure

### 🔌 Automatic Hooks

AvenoxRTP works completely standalone on a fresh Paper server. If you install any of the plugins below, it automatically detects and hooks them with no configuration needed — and silently skips them if they’re absent.

| Category | Supported Plugins | | -------------------- | ----------------------------------------------------------------------------------------------------- | | Economy | Vault | | Placeholders | PlaceholderAPI (13 built-in placeholders) | | Permissions | LuckPerms | | Claim Protection | WorldGuard, GriefPrevention, GriefDefender, Towny, Lands, Residence, KingdomsX, HuskTowns, RedProtect |

All integrations use pure reflection internally, meaning no external plugin jar is required to compile or run the plugin.

### 📊 Statistics

Tracks total, successful, and failed teleports Per-world usage breakdown Average search time tracking Per-player lifetime teleport counts

### 🎛️ Permissions

Tiered cooldown permissions (`avenoxrtp.cooldown.`) Bypass permissions for cooldown and economy Per-world access permissions Admin-only commands locked behind dedicated nodes

### 🧩 Commands

```text /rtp → Opens the RTP GUI /rtp gui → Opens the RTP GUI /rtp reload → Reloads all configuration files /rtp stats → View server-wide RTP statistics /rtp debug → View live debug information /rtp version → Plugin & integration info /rtp force → Force-teleport a player (admin) /rtp biome → Teleport into a specific biome ```

### ⚙️ Configuration

Four fully documented config files:

`config.yml` — worlds, cooldowns, economy, search behavior, feedback, sounds, particles `gui.yml` — every visual element of the GUI `messages.yml` — every player-facing message, fully customizable `worlds.yml` (generated) — per-world rules

## Compatibility

| Requirement | Version | | ------------------------- | ----------------------------- | | Server Software | Paper 1. 21+, Purpur, or Folia | | Java | J