AstralBackpacks

![Replace this with a description](https://cdn.modrinth.com/data/cached_images/2efd83101f1d77fc0de42566b26b8e2341da04c9.png)

๐ŸŽ’ AstralBackpacks – Premium Portable Storage Solution
๐ŸŽ’ Custom Model Texture Pack Support

![Replace this with a description](https://cdn.modrinth.com/data/cached_images/8ae40d0ae60f99f970445176536926c41befcac9_0.webp)

๐Ÿ›ก๏ธ Anti-Dupe Protection

![Replace this with a description](https://cdn.modrinth.com/data/cached_images/998aaba77c25a837d4fcfec191ce930acfea600f_0.webp)

๐ŸŽฎ Player Commands

“`
/backpack create – Create a new backpack
/backpack info – View backpack information
“`

๐Ÿ‘‘ Admin Commands

“`
/backpack give [amount] – Give backpacks to players
/backpack reload – Reload configuration
“`

โšก Smart Recipe Integration

![Replace this with a description](https://cdn.modrinth.com/data/cached_images/112465e34a523e929200a2b20bdbd67359cb559a_0.webp)

![Replace this with a description](https://cdn.modrinth.com/data/cached_images/394f7c1b74af2230a969747890b2dec42d2b3a72_0.webp)

๐ŸŽจ Complete Customization Control
“`
backpacks:
common:
rows: 2
material: CHEST
custom-model-data: 100
name: “&7&lCommon Backpack”
lore:
– “&7Basic storage solution”
– “&7Rows: &a2 &7(&a18 slots&7)”
– “”
– “&eRight-click to open!”
craftable: false
craft:
– “LEATHER”
– “STICK”
– “LEATHER”
– “STICK”
– “CHEST”
– “STICK”
– “LEATHER”
– “STICK”
– “LEATHER”
permission: “astralbackpacks.use.common”
create-permission: “astralbackpacks.create.common”
glow: false
“`

๐Ÿš€ Why Choose AstralBackpacks?
๐ŸŽฏ Premium Features That Matter
๐Ÿ”ง Fully Customizable – Configure everything from GUI design to permissions
๐Ÿ’Ž NBT-Based Storage – Ultra-secure data storage directly in the item
๐Ÿ›ก๏ธ Anti-Dupe Protection – Enterprise-grade security prevents all duplication exploits
โšก Zero-Lag Performance – Optimized async operations never slow down your server
๐ŸŒ Multi-Language Support – Every message is customizable for your community
๐Ÿ“ฑ Intuitive Interface – Clean, user-friendly GUI that feels native to Minecraft

๐Ÿฐ Advanced Administration
Smart Permissions – Granular control over who can create, use, and access different backpack types
Powerful Commands – /backpack create, /backpack give, /backpack reload and more
Real-time Monitoring – Debug mode and comprehensive logging
Database Integration – Optional MySQL/SQLite backup for enterprise setups

โš™๏ธ Technical Excellence
๐Ÿ”’ Unbreakable Security
โœ… Shift-Click Protection – Prevents inventory manipulation exploits
โœ… Creative Mode Guards – Stops middle-click duplication attempts
โœ… Nested Prevention – Blocks backpacks inside backpacks
โœ… UUID Validation – Each backpack has a unique, validated identifier
โœ… Death Protection – Secure handling of player death scenarios
โœ… Concurrent Safety – Thread-safe operations prevent data corruption

AsTimeStealSMP

# โณ AsTimeStealSMP

**Time is Life. Run out of time = RIP.**
A unique SMP plugin that changes the way you play Minecraft โ€” your **life is measured in time**.
Every action matters. Survive, fight, and steal time from others to stay alive!

## โšก Features

* โณ **Starting Time** โ†’ Players start with 24 hours (configurable).
* โš”๏ธ **Kill To Gain Time** โ†’ Every kill rewards bonus minutes (default: +30m).
* ๐Ÿ“œ **Fully Configurable** โ†’ Edit `config.yml` for starting time, time on kill, shrines, and timeout actions.
* ๐Ÿ•น **Action Bar Timer** โ†’ See your remaining time displayed permanently in the action bar.
* ๐ŸŽ **Daily Rewards** โ†’ Login bonuses + streak system to keep players active.
* โ› **Shrine Sacrifices** โ†’ Trade rare items (like Diamonds, Nether Stars, Dragon Eggs) for extra time.
* โ˜ ๏ธ **Timeout Actions** โ†’ Choose what happens when time runs out: `BAN`, `SPECTATOR`, or `KICK`.

## ๐Ÿ”ง Configuration

The plugin comes with a detailed `config.yml` for maximum customization:

“`yaml
# ๐Ÿ•ฐ Starting time for new players (in minutes)
starting-time: 1440 # 24 hours

# โš”๏ธ Time gained per player kill
time-on-kill: 30

# ๐ŸŽ Daily login bonus (in minutes)
daily-bonus: 60

# ๐Ÿ”ฅ Streak bonus (extra reward for login streaks)
streak-bonus: 120
streak-days: 5

# โ˜ ๏ธ On timeout: BAN | SPECTATOR | KICK
on-timeout: “BAN”

# ๐ŸŒ Shrine sacrifices (trade items for more time)
shrines:
DIAMOND_BLOCK: 10
NETHER_STAR: 120
DRAGON_EGG: 1440
“`

## ๐Ÿ“œ Commands

* `/astimestealsmp info` โ†’ Show plugin info.
* `/astimestealsmp reload` โ†’ Reload the config.
* `/astimestealsmp timeleft` โ†’ Check your remaining time.
* `/astimestealsmp timeout ` โ†’ View another playerโ€™s time.

## ๐Ÿ“ก Support

๐Ÿ‘จโ€๐Ÿ’ป Made by: **ItzAzeem**
๐Ÿ’ฌ Discord: `itzazeem.as`
๐ŸŒ Support Server: [Join Here](https://discord.gg/xRW5rdAvs5)

๐Ÿ”ฅ **Survive the ticking clock, fight to steal time, and outlast everyone in AsTimeStealSMP!**

AsTeams

# ๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘ AsTeams
### Advanced Team Management Plugin for Survival & Network Servers

AsTeams is a powerful and fully network-ready Team System plugin designed for SMP, Lifesteal, Earth and Survival servers.
It provides an advanced team experience with internal role management, shared vaults, diplomacy system and cross-server support.

## ๐Ÿ‘จโ€๐Ÿ’ป Developer
**ItzAzeem**

## ๐Ÿ’ฌ Support Server
Join our Discord for support, updates & suggestions:
https://discord.gg/xRW5rdAvs5

## ๐Ÿ”ฅ Features

– Team Creation System
– Advanced Role Management
– Team Vault (Shared Storage)
– Diplomacy System (Ally / Enemy)
– Friendly Fire Toggle
– Team Homes
– Team Logs
– Team Level System
– Cross Server Support
– MySQL Storage
– Async Saving
– Bungee / Velocity Support

## ๐Ÿ“œ Commands

| Command | Description |
|——–|————-|
| /team create | Create a team |
| /team invite | Invite player |
| /team join | Join team |
| /team leave | Leave team |
| /team kick | Kick member |
| /team promote | Promote member |
| /team demote | Demote member |
| /team info | Team information |
| /team chat | Team chat |
| /team home | Teleport to team home |
| /team sethome | Set team home |
| /team vault | Open team vault |
| /team ally | Ally request |
| /team enemy | Declare enemy |
| /team pvp toggle | Toggle Friendly Fire |
| /team transfer | Transfer ownership |
| /team rename | Rename team |
| /team description | Team description |
| /team top | Top teams list |
| /team disband | Delete team (Owner Only) |

## ๐Ÿ” Permissions

Admin Permission Allows:

– Force Join Team
– Force Kick Player
– Disband Any Team
– Rename Team
– Bypass Limits

## ๐ŸŒ Network Ready

– MySQL Based Data Storage
– Cross Server Team Sync
– Async Saving
– BungeeCord Support
– Velocity Support
– Developer API Ready

Made with โค๏ธ by **ItzAzeem**

AssassinContracts

AssassinContracts is a Minecraft plugin that allows players to anonymously place hit contracts on other players. Assassins receive these contracts in secret and are rewarded with money, loot, or other server-defined rewards upon a successful kill. All interactions are handled through simple commandsโ€”no menus or GUIsโ€”making it lightweight and easy to use in PvP or roleplay-focused servers.

This plugin is ideal for adding stealth, danger, and player-driven conflict to your world. It encourages strategy, betrayal, and bounty hunting while keeping things fair through built-in protections like cooldowns and IP checks. A live contract list and PlaceholderAPI support make tracking and integrating contracts easy.

You need Vault for economy support. PlaceholderAPI is optional but recommended. Built for Paper 1.21.4.

AssassEffects

**AssassEffects requires [OpenJavascript](https://modrinth.com/plugin/openjavascript)**!

# AssassEffects

AssassEffects is a simple **PvP plugin** for your server. The premise is simple:

Kill -> Positive Effect;

Death -> Negative Effect.

Dying with a positive effect leads to said effect’s removal. Killing a player with a negative effect leads to said effect’s removal. You can have up to 8 positive or negative effects simulataneously (but the two types cannot mix).

Positive Effects:

– Saturation
– Resistance
– Strength
– Speed
– Luck
– Hero Of The Village
– Water Breathing
– Haste

Negative Effects:

– Slowness
– Glowing
– Hunger
– Slow Falling
– Nausea
– Bad Omen
– Weakness
– Mining Fatigue

Effects Cannot Be Negated Via Milk Bucket, or Death. They Are Infinite Until You Kill, or Die.

## Commands

Permission (All): `assasseffects.use`

1. `/ae help` -> Help Message
2. `/ae re ` -> Remove Effect from Player
3. `/ae ue Use/Apply Effect on Player

AsRTP

# ๐ŸŒ AsRTP
### Advanced Random Teleportation Engine
**by ItzAzeem | AsDevs**

[![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white)](https://discord.gg/xRW5rdAvs5)
[![Website](https://img.shields.io/badge/Website-asdevs.netlify.app-orange)](https://asdevs.netlify.app/)
[![Version](https://img.shields.io/badge/MC-1.20–1.21-brightgreen)](https://modrinth.com)
[![License](https://img.shields.io/badge/License-MIT-blue)](https://modrinth.com)
[![Performance](https://img.shields.io/badge/Performance-Async-green)](https://modrinth.com)

![GUI](https://cdn.modrinth.com/data/cached_images/dba65cd172f46f8e6b898814ccd47f8342f4d163.jpeg)

*Interactive dimension selection menu โ€” no commands, just click and go.*

## ๐ŸŽฏ What is AsRTP?

AsRTP is a **premium random teleportation system** built for modern Minecraft servers. Players can explore the world safely with **intelligent hazard detection**, **smooth countdown animations**, and a **beautiful interactive GUI** for dimension selection โ€” all while keeping your server’s TPS at maximum.

No lag. No unsafe teleports. No compromises.

![arrived](https://cdn.modrinth.com/data/cached_images/9511ff20b782bfffa5cd507d7b6ccda505457b30.jpeg)

*Cinematic arrival confirmation with premium title displays.*

## โœจ Features

### ๐ŸŽฎ Dual Operation Modes
– **GUI Mode:** Interactive 27-slot menu with dimension icons
– **Direct Mode:** Classic `/rtp` command for instant teleport
– Seamlessly switch between modes in config
– Beautiful center-aligned item layout (slots 10, 13, 16)

### ๐Ÿ›ก๏ธ Smart Safety System
– **9+ hazard detection:**
– โŒ Lava & Magma blocks
– โŒ Water & Ocean depths
– โŒ Void & Fall damage
– โŒ Fire & Campfires
– โŒ Cactus & Sweet berry bushes
– โŒ Powder snow & Drowning risks
– **2-block vertical clearance** requirement
– **Solid ground verification** before teleport
– **Configurable max attempts** to prevent infinite loops

### โšก Performance Optimized
– **Asynchronous location scanning** โ€” zero main thread blocking
– **UUID-based cooldown system** โ€” efficient memory usage
– **Configurable search parameters** for optimal performance
– Near-zero TPS impact even with 100+ players

### ๐ŸŽจ Premium Visual Experience
– **Countdown system** with “Don’t Move” mechanic
– **Title animations** during teleport sequence
– **Custom arrival messages** with smooth fade effects
– **Modern hex color support** `&#RRGGBB` + classic `&` codes
– **Fully customizable** messages and branding

### ๐ŸŒ Multi-Dimension Support
– โœ… **Overworld** random teleportation
– โœ… **Nether** dimension warping
– โœ… **End** exploration
– Per-world configuration for each dimension
– Separate range settings for each world

### ๐Ÿ”ง Administrative Power
Real-time management without server restart:
– Toggle plugin on/off globally
– Adjust cooldown times on-the-fly
– Change teleport ranges instantly
– Force teleport specific players
– Reload configuration in-game

## ๐Ÿ“œ Commands

| Command | Description | Permission |
|—|—|—|
| `/rtp` | Open GUI or teleport directly | `asrtp.use` |
| `/rtp info` | Show plugin information | `asrtp.use` |
| `/rtp cooldown` | Check remaining cooldown | `asrtp.use` |
| `/rtp reload` | Reload configuration | `asrtp.admin` |
| `/rtp toggle` | Enable/disable plugin globally | `asrtp.admin` |
| `/rtp setcooldown ` | Change cooldown time | `asrtp.admin` |
| `/rtp setrange ` | Change teleport range | `asrtp.admin` |
| `/rtp force ` | Force player teleport | `asrtp.admin` |
| `/rtp world ` | RTP in specific world | `asrtp.world` |

**Aliases:** `/randomtp` ยท `/asrtp`

## ๐Ÿ”‘ Permissions

| Permission | Description | Default |
|—|—|—|
| `asrtp.use` | Use RTP command | `true` |
| `asrtp.bypass.cooldown` | Bypass cooldown timer | `op` |
| `asrtp.world` | Use world-specific RTP | `op` |
| `asrtp.admin` | Access admin commands | `op` |
| `asrtp.*` | All permissions | `op` |

## โš™๏ธ Configuration

“`yaml
# โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—
# โ•‘ โ•‘
# โ•‘ AsRTP Configuration โ•‘
# โ•‘ Random Teleport Plugin for Spigot โ•‘
# โ•‘ โ•‘
# โ•‘ Author: ItzAzeem โ•‘
# โ•‘ Version: 1.0.0 โ•‘
# โ•‘ Discord: ItzAzeem โ•‘
# โ•‘ โ•‘
# โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

# โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
# โ”‚ GENERAL SETTINGS โ”‚
# โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

settings:
enabled: true
allowed-worlds:
– world
– world_nether
– world_the_end
overworld-only: false

# โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
# โ”‚ TELEPORTATION CONFIG โ”‚
# โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

teleport:
distance:
min: 100 # Minimum distance from spawn
max: 1000 # Maximum distance from spawn

height:
min: 60 # Minimum Y level
max: -1 # Maximum Y level (-1 = world height)

max-attempts: 50 # Max tries to find safe spot
countdown: 5 # Countdown before teleport
cooldown: 60 # Cooldown between uses (seconds)

# โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
# โ”‚ MESSAGES & TEXT โ”‚
# โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

messages:
prefix: “&8[&b&lAs&3&lRTP&8] &r”

teleport-success: “&a&lSUCCESS! &7You’ve been teleported!”
teleport-searching: “&e&lโšก &7Searching for a safe location…”
teleport-failed: “&c&lโœ– &7Could not find a safe spot. Try again!”

on-cooldown: “&c&lโฑ &7Wait &c%seconds%s &7before using RTP again!”
wrong-world: “&c&lโœ– &7RTP is not enabled in this world!”
no-permission: “&c&lโœ– &7You don’t have permission!”

# โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
# โ”‚ TITLE SETTINGS โ”‚
# โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

titles:
enabled: true
countdown:
title: “&b&lTELEPORTING”
subtitle: “&7in &e&l%time% &7seconds…”
fade-in: 5
stay: 20
fade-out: 5

success:
title: “&a&lโœ“ TELEPORTED”
subtitle: “&7Welcome to your new location!”
fade-in: 10
stay: 40
fade-out: 10

# โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
# โ”‚ ADVANCED OPTIONS โ”‚
# โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

advanced:
safety-check: true
cancel-on-move: true

sounds:
enabled: true
countdown: “BLOCK_NOTE_BLOCK_PLING”
success: “ENTITY_ENDERMAN_TELEPORT”
fail: “ENTITY_VILLAGER_NO”
“`

## ๐Ÿ–ฅ๏ธ Compatibility

| Software | Supported |
|—|—|
| Paper 1.20 โ€” 1.21 | โœ… Recommended |
| Spigot 1.20 โ€” 1.21 | โœ… |
| Purpur 1.20 โ€” 1.21 | โœ… |
| Java 17+ | โœ… |
| Java 21 | โœ… Optimized |

**Dependencies:** None (fully standalone)

## ๐Ÿ”ง Installation

1. Download `AsRTP-1.0.0.jar`
2. Drop it into your `/plugins` folder
3. Restart your server
4. Edit `plugins/AsRTP/config.yml` to customize
5. Run `/rtp reload` โ€” **done!** โœ…

**Optional:** Configure GUI mode in config for interactive menu

## ๐Ÿ“Š Technical Details

### System Architecture
Built on a **modular Manager pattern** for maximum maintainability:

– **AsRTP (Core)** โ€” Plugin lifecycle and command registration
– **ConfigManager** โ€” Centralized configuration handling
– **TeleportManager** โ€” Async spatial scanning engine
– **GUIManager** โ€” Interactive inventory menu system
– **CooldownManager** โ€” UUID-based rate limiting
– **MessageUtils** โ€” Consistent branding and color handling

### Performance Metrics
– **Async processing** โ€” All location searches off main thread
– **Zero database** โ€” No SQL, no MongoDB
– **Disk caching** โ€” Optimized configuration loading
– **TPS impact** โ€” <0.01ms per teleport operation --- ## ๐ŸŽฎ Use Cases Perfect for: - โœ… **Survival servers** with exploration rewards - โœ… **Faction servers** for base searching - โœ… **Skyblock servers** for island warping - โœ… **Prison servers** for mine teleports - โœ… **Creative servers** for plot finding - โœ… **SMP networks** with multiple worlds --- ## ๐Ÿ‘จโ€๐Ÿ’ป Developer **ItzAzeem** โ€” Founder of **AsDevs** Passionate Minecraft plugin developer specializing in performance-optimized, visually stunning server tools. Building the future of public and competitive SMP experiences. - ๐ŸŒ Portfolio: [asdevs.netlify.app](https://asdevs.netlify.app/) - ๐Ÿ’ฌ Discord: [discord.gg/xRW5rdAvs5](https://discord.gg/xRW5rdAvs5) - ๐Ÿ“ง Email: azzugaming9571@gmail.com --- ## ๐Ÿ†˜ Support Having issues? Need help with configuration? > **Join our Discord for instant support:**
> ๐Ÿ‘‰ [discord.gg/xRW5rdAvs5](https://discord.gg/xRW5rdAvs5)

Please **do not** use Modrinth comments for bug reports โ€” Discord support is way faster and more reliable!

## ๐Ÿ“ Changelog

### v1.0.0 โ€” Initial Release
– ๐ŸŽ‰ Public release
– โœจ GUI & Direct mode support
– ๐Ÿ›ก๏ธ Advanced safety system with 9+ hazard checks
– โšก Async performance optimization
– ๐ŸŽจ Premium visual design with title animations
– ๐Ÿ“ Full configuration system
– ๐Ÿ”ง Admin management tools
– ๐ŸŒ Multi-dimension support

**Made with โค๏ธ by ItzAzeem | AsDevs**

*Enjoying AsRTP? Please leave a โญ review on Modrinth โ€” it helps us grow!*

*Transform your server’s exploration experience today. Download now and let your players explore safely!*

AsProfiles

# โš”๏ธ AsProfiles
### Animated Kill Card & Player Profile System

**by ItzAzeem | AsDevs**

[![Discord](https://img.shields.io/discord/xRW5rdAvs5?label=Discord&logo=discord&color=5865F2)](https://discord.gg/xRW5rdAvs5)
[![Website](https://img.shields.io/badge/Website-asdevs.netlify.app-orange)](https://asdevs.netlify.app/)
[![Version](https://img.shields.io/badge/MC-1.21.4-brightgreen)](https://modrinth.com)
[![License](https://img.shields.io/badge/License-ARR-red)](https://modrinth.com)

## ๐ŸŽฏ What is AsProfiles?

AsProfiles is a **high-performance, cinematic kill card and player profile system** designed for competitive and survival PvP servers. When a player gets eliminated, a beautiful animated GUI instantly pops up showing the killer’s full profile โ€” just like PUBG or Valorant kill screens, but inside Minecraft!

No databases. No lag. Just pure cinematic PvP experience.

## โœจ Features

### ๐Ÿ’€ Kill Card System
– Animated chest GUI popup on every player death
– Displays killer’s **head, name, rank, kill streak, K/D ratio and weapon**
– Auto-closes after configurable seconds
– Works on every PvP kill โ€” no setup needed

### ๐Ÿ‘ค Player Profile GUI
– Full profile viewer with beautiful GUI layout
– Shows kills, deaths, K/D ratio, best streak, rank and last weapon
– View anyone’s profile with `/profile `
– Click-through GUI โ€” fully interactive

### ๐Ÿ† Rank System
| Rank | Kills Required |
|——|—————|
| Novice | 0 |
| Recruit | 5+ |
| Soldier | 20+ |
| Warrior | 50+ |
| Veteran | 100+ |
| Warlord | 200+ |
| โ˜  Legendary | 500+ |

### ๐Ÿ”ฅ Kill Streak Broadcasts
– **5 kills** โ†’ Server announcement
– **10 kills** โ†’ DOMINATING broadcast
– **20 kills** โ†’ UNSTOPPABLE broadcast
– **50 kills** โ†’ GODLIKE server-wide alert

### ๐Ÿ“Š Leaderboard GUI
– Top 7 killers displayed with player heads
– Live K/D and kill count per player
– Command: `/profile top`

### ๐ŸŽจ Card Design System
– 3 built-in card designs: **Default, VIP, Admin**
– Each rank can have its own unique card style
– Fully customizable via YAML โ€” no coding needed

### โšก Performance
– Zero database โ€” pure YAML storage
– Async-safe design
– Near-zero TPS impact
– Instant GUI loading

## ๐Ÿ“œ Commands

| Command | Description | Permission |
|———|————-|————|
| `/profile` | View your own profile GUI | `asprofiles.use` |
| `/profile ` | View any player’s profile | `asprofiles.use` |
| `/profile top` | Top killers leaderboard | `asprofiles.use` |
| `/profile stats ` | View stats in chat | `asprofiles.use` |
| `/profile info` | Plugin info & links | `asprofiles.use` |
| `/profile reset ` | Reset a profile | `asprofiles.admin` |
| `/profile reload` | Reload plugin | `asprofiles.admin` |

## ๐Ÿ”‘ Permissions

| Permission | Description | Default |
|————|————-|———|
| `asprofiles.use` | Use all profile commands | `true` |
| `asprofiles.admin` | Reset profiles & reload | `op` |

## โš™๏ธ Configuration
“`yaml
card:
enabled: true
title: “&0&lโ˜  &4&lKILLED BY &0&lโ˜ ”
bottom-message: “&7You were eliminated. Fight back!”
delay-ticks: 20
auto-close-seconds: 4
border-material: BLACK_STAINED_GLASS_PANE
“`

## ๐Ÿ–ฅ๏ธ Compatibility

| Software | Supported |
|———-|———–|
| Paper 1.21+ | โœ… |
| Spigot 1.21+ | โœ… |
| Java 21+ | โœ… |
| PlaceholderAPI | ๐Ÿ”œ Soon |

## ๐Ÿ‘จโ€๐Ÿ’ป Developer

**ItzAzeem** โ€” Founder of **AsDevs**

Passionate Minecraft plugin developer focused on creating unique, high-quality plugins for competitive servers.

– ๐ŸŒ Website: [asdevs.netlify.app](https://asdevs.netlify.app/)
– ๐Ÿ’ฌ Discord: [discord.gg/xRW5rdAvs5](https://discord.gg/xRW5rdAvs5)

## ๐Ÿ†˜ Support

Having issues? Need help with configuration?

> **Join our Discord server for fast support:**
> ๐Ÿ‘‰ [discord.gg/xRW5rdAvs5](https://discord.gg/xRW5rdAvs5)

Please **do not** use the Modrinth comment section for bug reports โ€” Discord is much faster!

**Made with โค๏ธ by ItzAzeem | AsDevs**

*If you enjoy AsProfiles, please leave a โญ review on Modrinth!*

AspectoftheVoid

# Aspect of the Void – Hypixel Skyblock

## Description
Aspect of the Void is a Spigot plugin inspired by the [Aspect of the Void](https://wiki.hypixel.net/Aspect_Of_The_Void) from [Hypixel Skyblock](https://wiki.hypixel.net/Main_Page).

## Features
– **Instant Transmission RIGHT CLICK**: Teleport 12 blocks ahead of you and gain speed effect for 3 seconds.
– **Ether Transmission SNEAK RIGHT CLICK**: Teleport to your targeted block up to 61 blocks away.

## Usage
### Installation
1. Download the latest stable release from [here](https://github.com/VermeilChan/AspectoftheVoid/releases/latest).
2. Place the JAR file in the `plugins` folder in your Minecraft server directory.
3. Restart or reload your server to activate the plugin.

### In-Game
1. **Obtaining the Aspect of the Void:**
– Anyone can give themselves the Aspect of the Void by using the command `/giveaspectofthevoid`.
2. **Using the Aspect of the Void:**
– **Instant Transmission:** Right-click to teleport 12 blocks ahead. You will gain a speed boost for 3 seconds.
– **Ether Transmission:** Crouch and right-click to teleport to the targeted block within 61 blocks.

## Permissions
– There are no permissions. All players can get and use the Aspect of the Void.

## License
– This plugin is licensed under the [GNU General Public License v3.0](LICENSE).

## Credits
– Icon: [Furfsky](https://furfsky.net/)

AsManhunt

# **AsManhunt โ€“ Minecraft Manhunt Plugin with Hunter Compass**

Take your Minecraft manhunt games to the next level with **AsManhunt**! This plugin adds a fun and competitive twist by giving hunters a **tracking compass** to locate runners, while runners must survive and can even win by defeating the **Ender Dragon**.

**Features:**

* ๐Ÿƒโ€โ™‚๏ธ **Join Teams:** Players can join as **Hunters** or **Runners** using simple commands.
* ๐Ÿงญ **Hunter Compass:** Hunters get a special compass that tracks the nearest runner in their world.
* โš”๏ธ **Victory Conditions:**

* Hunters win when all runners are eliminated.
* Runners win if any runner kills the Ender Dragon.
* ๐ŸŽฎ **Easy Commands:**

* `/manhunt start` โ€“ Start the game.
* `/manhunt stop` โ€“ Stop the game.
* `/manhunt reset` โ€“ Force reset the game.
* `/manhunt join hunter` โ€“ Join as Hunter.
* `/manhunt join runner` โ€“ Join as Runner.
* ๐Ÿ’ก **Simple & Fun:** Lightweight, easy to configure, and perfect for server manhunt events.

**Why choose AsManhunt?**

* Adds competitive thrill for players.
* Easy to use and integrate in any server.
* Encourages teamwork and strategy for both hunters and runners.

AsLeaderBoard

# ๐Ÿ† AsLeaderBoard
### Ultimate Multi-Stats Leaderboard System
**by ItzAzeem | AsDevs**

[![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white)](https://discord.gg/xRW5rdAvs5)
[![Website](https://img.shields.io/badge/Website-asdevs.netlify.app-orange)](https://asdevs.netlify.app/)
[![Version](https://img.shields.io/badge/v1.0.0-Release-brightgreen)](https://modrinth.com)
[![License](https://img.shields.io/badge/License-MIT-blue)](https://modrinth.com)
[![Spigot](https://img.shields.io/badge/Spigot-1.16–1.21+-orange)](https://www.spigotmc.org/)
[![PlaceholderAPI](https://img.shields.io/badge/PlaceholderAPI-Supported-blue)](https://www.spigotmc.org/resources/placeholderapi.6245/)

![holo](https://cdn.modrinth.com/data/cached_images/74cbb5bfd14961e3f7a6922e9734a413a4cb72a1.jpeg)

![gui](https://cdn.modrinth.com/data/cached_images/2c6cb8291bc7640be64e625b00a8e7afe5568962.jpeg)

![chat](https://cdn.modrinth.com/data/cached_images/87d302b5fa23ecbf4f18cccf30d3ab2e99de8dca.jpeg)

*Track Money, Kills & Deaths across your entire server โ€” GUI, Chat & Holograms in one plugin.*

## ๐ŸŽฏ What is AsLeaderBoard?

AsLeaderBoard is the **most advanced and flexible leaderboard plugin** for competitive Minecraft servers. Unlike basic baltop plugins, AsLeaderBoard tracks **multiple statistics** (Money, Kills, Deaths) and displays them in **three different ways** โ€” interactive GUI menus, beautiful chat displays, and real-time scoreboards/holograms.

Built for **SMP servers, PvP arenas, and competitive networks** where player rankings matter. Zero lag. 100% configurable. **Works out of the box.**

## ๐ŸŒŸ WHY CHOOSE ASLEADERBOARD?

| Feature | AsLeaderBoard | Basic Plugins |
|———|—————|—————|
| **Multiple Stats** | โœ… Money + Kills + Deaths | โŒ Money only |
| **Display Modes** | โœ… GUI + Chat + Holograms | โŒ Chat only |
| **PlaceholderAPI** | โœ… 30+ placeholders | โŒ Limited/None |
| **Configuration** | โœ… 100% customizable | โŒ Hardcoded |
| **Performance** | โœ… Smart caching | โŒ Laggy queries |
| **GUI Design** | โœ… Beautiful, animated | โŒ Basic/None |

## โœจ Features

### ๐Ÿ† Triple Display System
– **Interactive GUI** โ€” Beautiful inventory menu with clickable stat items
– **Chat Leaderboards** โ€” Formatted top 10 rankings in chat
– **Hologram Support** โ€” Live-updating scoreboards for lobbies
– **Switch instantly** โ€” Same data, different views
– **Real-time updates** โ€” See changes as they happen

### ๐Ÿ“Š Multi-Stat Tracking
– ๐Ÿ’ฐ **Money Rankings** โ€” Vault integration for economy leaderboards
– โš”๏ธ **Kill Counts** โ€” Track PvP dominance server-wide
– โ˜ ๏ธ **Death Statistics** โ€” Who’s the most reckless?
– **Global tracking** โ€” All worlds combined into one leaderboard
– **Top 10 rankings** โ€” See the best of the best
– **Your personal stats** โ€” View your own rank and stats

### ๐ŸŽฎ Beautiful GUI System
– **3-tab menu** โ€” Money, Kills, Deaths in one interface
– **Clickable items** โ€” Click to view detailed rankings
– **Custom materials** โ€” Gold ingots, diamond swords, skulls
– **Animated lore** โ€” Live placeholder updates
– **Glass pane fillers** โ€” Professional-looking borders
– **Sound effects** โ€” Satisfying click feedback
– **Configurable slots** โ€” Position items anywhere

### ๐Ÿ’ฌ Professional Chat Display
– **Custom headers** โ€” Unique design per stat type
– **Rank indicators** โ€” ๐Ÿฅ‡๐Ÿฅˆ๐Ÿฅ‰ medals for top 3
– **Color-coded** โ€” Different colors for each stat
– **Your stats section** โ€” Shows your rank below leaderboard
– **Number formatting** โ€” $1.5M instead of $1500000
– **Fully customizable** โ€” Every line, color, and format

### ๐Ÿ”Œ PlaceholderAPI Integration
## ๐Ÿ”Œ Complete PlaceholderAPI Reference

AsLeaderBoard provides **50+ placeholders** for use in scoreboards, chat formats, holograms, and other plugins!

### ๐Ÿ“Š Top Player Placeholders

#### Money Leaderboard
– %asleaderboard_top_1_money_player% โ†’ #1 richest player name
– %asleaderboard_top_2_money_player% โ†’ #2 richest player name
– %asleaderboard_top_3_money_player% โ†’ #3 richest player name
– ……
– %asleaderboard_top_10_money_player% โ†’ #10 richest player name

#### Kills Leaderboard

– %asleaderboard_top_1_kills_player% โ†’ #1 top 1 killer name
– %asleaderboard_top_1_have_kills% โ†’ #1 how many kills have
– %asleaderboard_top_2_kills_player% โ†’ #2 top 2 killer name
– %asleaderboard_top_2_have_kills% โ†’ #2 how many kills have
– …..
– %asleaderboard_top_10_kills_player% โ†’ #2 top 10 killer name
– %asleaderboard_top_10_have_kills% โ†’ #10 how many kills have

#### Deaths Leaderboard

– %asleaderboard_top_1_death_player% โ†’ #1 most deaths player name
– %asleaderboard_top_1_have_death% โ†’ #1 player’s deaths
– %asleaderboard_top_2_death_player% โ†’ #2 most deaths player name
– %asleaderboard_top_2_have_death% โ†’ #2 player’s deaths
– %asleaderboard_top_3_death_player% โ†’ #3 most deaths player name
– %asleaderboard_top_3_have_death% โ†’ #3 player’s deaths
– …
– %asleaderboard_top_10_death_player% โ†’ #10 most deaths player name
– %asleaderboard_top_10_have_death% โ†’ #10 player’s deaths

### ๐Ÿ‘ค Personal Player Placeholders (Auto-detect viewer)

#### Your Money Stats

– %asleaderboard_player_money_value% โ†’ Your current balance
– %asleaderboard_player_money_rank% โ†’ Your money rank (#15, #3, etc.)

#### Your Kills Stats

– %asleaderboard_player_kills_value% โ†’ Your total kills
– %asleaderboard_player_kills_rank% โ†’ Your kills rank (#2, #10, etc.)

#### Your Deaths Stats

– %asleaderboard_player_death_value% โ†’ Your total deaths
– %asleaderboard_player_death_rank% โ†’ Your deaths rank (#5, #20, etc.)

### ๐ŸŽฏ Specific Player Placeholders (Query by name)

#### Money Stats by Player Name

– %asleaderboard_player_money_value% โ†’ Specific player’s balance
– %asleaderboard_player_money_rank% โ†’ Specific player’s money rank

Example:
– %asleaderboard_player_Notch_money_value% โ†’ Notch’s balance
– %asleaderboard_player_Dream_money_rank% โ†’ Dream’s money rank

#### Kills Stats by Player Name

– %asleaderboard_player_kills_value% โ†’ Specific player’s kills
– %asleaderboard_player_kills_rank% โ†’ Specific player’s kills rank
Example:
– %asleaderboard_player_Technoblade_kills_value% โ†’ Technoblade’s kills
– %asleaderboard_player_Dream_kills_rank% โ†’ Dream’s kills rank

#### Deaths Stats by Player Name

– %asleaderboard_player_death_value% โ†’ Specific player’s deaths
– %asleaderboard_player_death_rank% โ†’ Specific player’s deaths rank
Example:
– %asleaderboard_player_Steve_death_value% โ†’ Steve’s deaths
– %asleaderboard_player_Alex_death_rank% โ†’ Alex’s deaths rank

### ๐Ÿ“‹ Placeholder Usage Examples

#### Example 1: Scoreboard (with FeatherBoard)
“`yaml
scoreboard:
title: “&6&lMySMP Stats”
lines:
– “”
– “&e&lTop Money:”
– “&71. %asleaderboard_top_1_money_player%”
– “&7 &a$%asleaderboard_top_1_have_money%”
– “&72. %asleaderboard_top_2_money_player%”
– “&73. %asleaderboard_top_3_money_player%”
– “”
– “&e&lYour Stats:”
– “&7Rank: &e#%asleaderboard_player_money_rank%”
– “&7Balance: &a$%asleaderboard_player_money_value%”
– “”
“`

#### Example 2: Chat Format (with Essentials)
“`yaml
format: “{displayname}&r &8[&7Rank: &e#{asleaderboard_player_money_rank}&8]&r: {message}”
“`

#### Example 3: Hologram (with DecentHolograms)
“`yaml
hologram:
lines:
– “&6&lโ”โ”โ” TOP KILLERS โ”โ”โ””
– “&e๐Ÿฅ‡ %asleaderboard_top_1_kills_player% &7- &c%asleaderboard_top_1_have_kills%”
– “&e๐Ÿฅˆ %asleaderboard_top_2_kills_player% &7- &c%asleaderboard_top_2_have_kills%”
– “&e๐Ÿฅ‰ %asleaderboard_top_3_kills_player% &7- &c%asleaderboard_top_3_have_kills%”
“`

#### Example 4: Tab Header/Footer (with TAB)
“`yaml
header:
– “&6&lWelcome to MySMP”
– “&7Richest: &e%asleaderboard_top_1_money_player% &7(&a$%asleaderboard_top_1_have_money%&7)”
footer:
– “&7Your Rank: &e#%asleaderboard_player_money_rank%”
– “&7Your Balance: &a$%asleaderboard_player_money_value%”
“`

#### Example 5: Custom Join Message
“`yaml
join-message: “&e%player% &7joined! &8[&7Kills: &c%asleaderboard_player_kills_value% &8| &7Rank: &e#%asleaderboard_player_kills_rank%&8]”
“`

#### Example 6: MOTD (with ServerListPlus)
“`yaml
Motd:
– “&6&lMySMP &8- &7Top Killer: &c%asleaderboard_top_1_kills_player%”
– “&7Richest Player: &e%asleaderboard_top_1_money_player% &7(&a$%asleaderboard_top_1_have_money%&7)”
“`

### ๐ŸŽจ Advanced Placeholder Formatting

#### Number Formatting
By default, placeholders return raw values:
– `%asleaderboard_top_1_have_money%` โ†’ `1500000`

Configure number formatting in `config.yml`:
“`yaml
placeholders:
formatting:
money:
prefix: “$”
abbreviate: true # 1500000 โ†’ $1.5M
decimal-places: 2 # 1234.56
kills:
abbreviate: false # Show full number
deaths:
abbreviate: false
“`

#### Default Values (when no data)
“`yaml
placeholders:
defaults:
no-data: “N/A” # Player not found
loading: “Loading…” # Data being fetched
offline-player: “—” # Player offline
no-rank: “Unranked” # Player has 0 balance/kills
“`

### โš ๏ธ Important Notes

1. **PlaceholderAPI Required**: Install PlaceholderAPI plugin for these to work
2. **Case Sensitive**: Player names in specific placeholders are case-sensitive
3. **Auto-refresh**: Placeholders update every 5 minutes (configurable)
4. **Rank Format**: Ranks return as numbers only (no #): `15` not `#15`
5. **Offline Players**: Works for offline players too (cached data)

### ๐Ÿ”„ Placeholder Refresh

Placeholders automatically refresh based on cache settings:
“`yaml
performance:
cache:
duration: 60 # Refresh every 60 seconds
“`

Force manual refresh: `/leaderboard reload`

### โšก Lightning Performance
– **<50ms GUI opening** โ€” Instant response - **Smart caching** โ€” 5-minute data cache (configurable) - **Async operations** โ€” Zero main thread blocking - **~10MB memory** โ€” Minimal footprint - **No databases** โ€” Uses existing Vault/Statistics data - **TPS-friendly** โ€” Never causes lag spikes ### ๐ŸŽจ 100% Customizable - **4 config files** โ€” `config.yml`, `messages.yml`, `gui-items.yml`, `chat-formats.yml` - **200+ options** โ€” Customize literally everything - **No hardcoded text** โ€” Every message is editable - **Color codes** โ€” Support for `&c` and `&#FF5500` hex colors - **Material customization** โ€” Change GUI item types - **Position control** โ€” Move GUI items to any slot - **Sound customization** โ€” Change click sounds and volumes ### ๐Ÿ”ง Easy Configuration ```yaml # Change GUI items in 5 seconds items: money-leaderboard: material: "EMERALD" # Change to emerald slot: 13 # Move to center name: "&a&l๐Ÿ’Ž Rich List" # Custom name # Change chat colors instantly chat: money: header: "&6โ•โ•โ• TOP BALANCES โ•โ•โ•" entry: "&e#{RANK} &f{PLAYER} &7โ†’ &a${VALUE}" ``` --- ## ๐Ÿ“œ Commands | Command | Description | Permission | |---------|-------------|------------| | `/leaderboard` | Open GUI menu | `asleaderboard.use` | | `/leaderboard money` | Show money top 10 in chat | `asleaderboard.use` | | `/leaderboard kills` | Show kills top 10 in chat | `asleaderboard.use` | | `/leaderboard deaths` | Show deaths top 10 in chat | `asleaderboard.use` | | `/leaderboard info` | Plugin information | *(everyone)* | | `/leaderboard reload` | Reload all configs | `asleaderboard.reload` | | `/leaderboard help` | Show help menu | *(everyone)* | **Aliases:** `/lb` ยท `/top` ยท `/baltop` ยท `/leaderboards` --- ## ๐Ÿ”‘ Permissions | Permission | Description | Default | |-----------|-------------|---------| | `asleaderboard.use` | Use `/leaderboard` commands | `true` | | `asleaderboard.gui` | Open GUI menu | `true` | | `asleaderboard.reload` | Reload configuration | `op` | | `asleaderboard.admin` | All permissions | `op` | --- ## โš™๏ธ Quick Configuration ```yaml # โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•— # โ•‘ AsLeaderBoard Configuration โ•‘ # โ•‘ Made by ItzAzeem | v1.0.0 โ•‘ # โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• # Server Settings server: name: "MySMP" # Your server name # Feature Toggles (enable/disable anything!) features: gui: true # Interactive GUI menu chat: true # Chat leaderboards placeholders: true # PlaceholderAPI support sounds: true # Click sound effects # GUI Settings gui: main: title: "&6&lLeaderboard Menu" size: 27 # 9, 18, 27, 36, 45, or 54 items: kills: slot: 11 # Position in GUI material: "DIAMOND_SWORD" name: "&c&lโš” Kills Leaderboard" lore: - "&7Click to view top killers" - "" - "&eTop: &f%asleaderboard_top_1_kills_player%" - "&eKills: &c%asleaderboard_top_1_have_kills%" money: slot: 14 material: "GOLD_INGOT" name: "&a&l$ Money Leaderboard" lore: - "&7Click to view richest players" - "" - "&eTop: &f%asleaderboard_top_1_money_player%" - "&eMoney: &a$%asleaderboard_top_1_have_money%" # Chat Display chat: money: header: - "&6&lโ”โ”โ”โ”โ” MONEY LEADERBOARD โ”โ”โ”โ”โ”" entry: "&e#{RANK} &8ยป &f{PLAYER} &8- &a${VALUE}" footer: - "&6&lโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”" # Update Settings update: interval: 300 # Refresh every 5 minutes async: true # Use async processing # Statistics stats: money: enabled: true source: "VAULT" # Vault economy kills: enabled: true source: "STATISTICS" # Minecraft statistics deaths: enabled: true source: "STATISTICS" ``` --- ## ๐Ÿ–ฅ๏ธ Compatibility | Software | Versions | Status | |----------|----------|--------| | **Spigot** | 1.16 โ€” 1.21+ | โœ… Fully Supported | | **Paper** | 1.16 โ€” 1.21+ | โœ… Recommended | | **Purpur** | 1.16 โ€” 1.21+ | โœ… Fully Supported | | **Java** | 17+ | โœ… Required | | **Vault** | Latest | โœ… Required | | **PlaceholderAPI** | Latest | โš ๏ธ Optional | ### Economy Plugins (via Vault) โœ… EssentialsX ยท โœ… CMI ยท โœ… TNE ยท โœ… CraftConomy ยท โœ… Any Vault-compatible plugin --- ## ๐Ÿ”ง Installation 1. **Download** `AsLeaderBoard-1.0.0.jar` 2. **Drop** it into your `/plugins` folder 3. **Install** Vault + your economy plugin 4. **Install** PlaceholderAPI (optional but recommended) 5. **Restart** your server 6. **Type** `/leaderboard` in-game โ€” **it just works!** โœ… ### First-Time Setup (Optional) ```bash 1. Stop server 2. Edit plugins/AsLeaderBoard/config.yml 3. Change server name, colors, GUI items 4. Save and restart 5. Run /leaderboard reload ``` --- ## ๐ŸŽจ Customization Showcases ### ๐Ÿ”ฅ Example 1: Competitive PvP Theme ```yaml gui: main: title: "&4&lโš” PVP RANKINGS โš”" chat: kills: header: - "&c&lโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌ" - "&f &c&lTOP KILLERS" - "&c&lโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌโ–ฌ" entry: "&c๐Ÿ—ก #{RANK} &8โ”ƒ &f{PLAYER} &8- &e{VALUE} kills" ``` ### ๐Ÿ’Ž Example 2: Luxury Economy Theme ```yaml gui: items: money: material: "DIAMOND" name: "&#FFD700&l๐Ÿ’Ž BILLIONAIRES CLUB" lore: - "&#FFD700โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”" - "&fTop Tycoon: &e{player}" - "&fNet Worth: &#00FF00${balance}" - "&#FFD700โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”" ``` ### ๐ŸŒˆ Example 3: Rainbow Theme ```yaml chat: money: header: - "&#FF0000&lโ–ˆ&#FF7F00&lโ–ˆ&#FFFF00&lโ–ˆ&#00FF00&lโ–ˆ&#0000FF&lโ–ˆ MONEY TOP &#0000FF&lโ–ˆ&#00FF00&lโ–ˆ&#FFFF00&lโ–ˆ&#FF7F00&lโ–ˆ&#FF0000&lโ–ˆ" entry: "&#FFD700#{RANK} &#FFFFFF{PLAYER} &#00FF00${VALUE}" ``` ### โšก Example 4: Minimalist Clean ```yaml gui: main: title: "&fLeaderboards" size: 27 filler: material: "AIR" # No filler, clean look chat: money: header: - "&7โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”" entry: "&7#{RANK}. &f{PLAYER} &8โ†’ &a${VALUE}" ``` --- ## ๐Ÿ“Š PlaceholderAPI Guide ### Top Player Placeholders - %asleaderboard_top_1_money_player% โ†’ #1 richest player name - %asleaderboard_top_1_have_money% โ†’ #1 player's balance - %asleaderboard_top_2_kills_player% โ†’ #2 killer name - %asleaderboard_top_2_have_kills% โ†’ #2 player's kills - %asleaderboard_top_3_death_player% โ†’ #3 deaths player - %asleaderboard_top_3_have_death% โ†’ #3 player's deaths - ... works for ranks 1-10! ### Personal Player Placeholders - %asleaderboard_player_money_value% โ†’ Your balance - %asleaderboard_player_money_rank% โ†’ Your money rank (#15) - %asleaderboard_player_kills_value% โ†’ Your total kills - %asleaderboard_player_kills_rank% โ†’ Your kill rank - %asleaderboard_player_death_value% โ†’ Your total deaths - %asleaderboard_player_death_rank% โ†’ Your death rank ### Specific Player Placeholders - %asleaderboard_player_Notch_money_value% โ†’ Notch's balance - %asleaderboard_player_Dream_kills_value% โ†’ Dream's kills - %asleaderboard_player___rank% โ†’ Any player’s rank

### Use in Scoreboards (with DeluxeMenus, FeatherBoard, etc.)
“`yaml
# Example: Scoreboard showing top 3
lines:
– “&6&lTOP RICH PLAYERS”
– “&e1. %asleaderboard_top_1_money_player%”
– “&7 $%asleaderboard_top_1_have_money%”
– “&e2. %asleaderboard_top_2_money_player%”
– “&e3. %asleaderboard_top_3_money_player%”
– “”
– “&7Your Rank: &#%asleaderboard_player_money_rank%”
“`

## Hologram Config

### Kills Hologram
“`yaml
pages:
– lines:
– content: ‘#ICON: LIGHT_BLUE_DYE’
height: 0.6
– content: ‘&#50C7FF&lแด›แดแด˜ แด‹ษชสŸสŸs’
height: 0.3
– content: ‘&r’
height: 0.3
– content: ‘#50C7FF#1 &7| &f%asleaderboard_top_1_kills_player%: &c%asleaderboard_top_1_have_kills%’
height: 0.3
– content: ‘#50C7FF#2 &7| &f%asleaderboard_top_2_kills_player%: &c%asleaderboard_top_2_have_kills%’
height: 0.3
– content: ‘#50C7FF#3 &7| &f%asleaderboard_top_3_kills_player%: &c%asleaderboard_top_3_have_kills%’
height: 0.3
– content: ‘#50C7FF#4 &7| &f%asleaderboard_top_4_kills_player%: &c%asleaderboard_top_4_have_kills%’
height: 0.3
– content: ‘#50C7FF#5 &7| &f%asleaderboard_top_5_kills_player%: &c%asleaderboard_top_5_have_kills%’
height: 0.3
– content: ‘#50C7FF#6 &7| &f%asleaderboard_top_6_kills_player%: &c%asleaderboard_top_6_have_kills%’
height: 0.3
– content: ‘#50C7FF#7 &7| &f%asleaderboard_top_7_kills_player%: &c%asleaderboard_top_7_have_kills%’
height: 0.3
– content: ‘#50C7FF#8 &7| &f%asleaderboard_top_8_kills_player%: &c%asleaderboard_top_8_have_kills%’
height: 0.3
– content: ‘#50C7FF#9 &7| &f%asleaderboard_top_9_kills_player%: &c%asleaderboard_top_9_have_kills%’
height: 0.3
– content: ‘#50C7FF#10 &7| &f%asleaderboard_top_10_kills_player%: &c%asleaderboard_top_10_have_kills%’
height: 0.3
actions: {}

“`
### Money Hologram
“`yaml
pages:
– lines:
– content: ‘#ICON: GOLD_INGOT’
height: 0.6
– content: ‘&#FFD700&lแด›แดแด˜ ส™แด€สŸแด€ษดแด„แด‡๊œฑ’
height: 0.3
– content: ‘&r’
height: 0.3
– content: ‘#FFD700#1 &7| &f%asleaderboard_top_1_money_player%: &a$%asleaderboard_top_1_have_money%’
height: 0.3
– content: ‘#FFD700#2 &7| &f%asleaderboard_top_2_money_player%: &a$%asleaderboard_top_2_have_money%’
height: 0.3
– content: ‘#FFD700#3 &7| &f%asleaderboard_top_3_money_player%: &a$%asleaderboard_top_3_have_money%’
height: 0.3
– content: ‘#FFD700#4 &7| &f%asleaderboard_top_4_money_player%: &a$%asleaderboard_top_4_have_money%’
height: 0.3
– content: ‘#FFD700#5 &7| &f%asleaderboard_top_5_money_player%: &a$%asleaderboard_top_5_have_money%’
height: 0.3
– content: ‘#FFD700#6 &7| &f%asleaderboard_top_6_money_player%: &a$%asleaderboard_top_6_have_money%’
height: 0.3
– content: ‘#FFD700#7 &7| &f%asleaderboard_top_7_money_player%: &a$%asleaderboard_top_7_have_money%’
height: 0.3
– content: ‘#FFD700#8 &7| &f%asleaderboard_top_8_money_player%: &a$%asleaderboard_top_8_have_money%’
height: 0.3
– content: ‘#FFD700#9 &7| &f%asleaderboard_top_9_money_player%: &a$%asleaderboard_top_9_have_money%’
height: 0.3
– content: ‘#FFD700#10 &7| &f%asleaderboard_top_10_money_player%: &a$%asleaderboard_top_10_have_money%’
height: 0.3
actions: {}
“`
### Deaths Hologram
“`yaml
pages:
– lines:
– content: ‘#ICON: RED_DYE’
height: 0.6
– content: ‘&#FF3636&lแด›แดแด˜ แด…แด‡แด€แด›สœs’
height: 0.3
– content: ‘&r’
height: 0.3
– content: ‘#FF3636#1 &7| &f%asleaderboard_top_1_death_player%: &4%asleaderboard_top_1_have_death%’
height: 0.3
– content: ‘#FF3636#2 &7| &f%asleaderboard_top_2_death_player%: &4%asleaderboard_top_2_have_death%’
height: 0.3
– content: ‘#FF3636#3 &7| &f%asleaderboard_top_3_death_player%: &4%asleaderboard_top_3_have_death%’
height: 0.3
– content: ‘#FF3636#4 &7| &f%asleaderboard_top_4_death_player%: &4%asleaderboard_top_4_have_death%’
height: 0.3
– content: ‘#FF3636#5 &7| &f%asleaderboard_top_5_death_player%: &4%asleaderboard_top_5_have_death%’
height: 0.3
– content: ‘#FF3636#6 &7| &f%asleaderboard_top_6_death_player%: &4%asleaderboard_top_6_have_death%’
height: 0.3
– content: ‘#FF3636#7 &7| &f%asleaderboard_top_7_death_player%: &4%asleaderboard_top_7_have_death%’
height: 0.3
– content: ‘#FF3636#8 &7| &f%asleaderboard_top_8_death_player%: &4%asleaderboard_top_8_have_death%’
height: 0.3
– content: ‘#FF3636#9 &7| &f%asleaderboard_top_9_death_player%: &4%asleaderboard_top_9_have_death%’
height: 0.3
– content: ‘#FF3636#10 &7| &f%asleaderboard_top_10_death_player%: &4%asleaderboard_top_10_have_death%’
height: 0.3
actions: {}
“`

## ๐ŸŽฏ Use Cases

### For SMP Servers
– Track richest players with baltop-style rankings
– Show PvP kill counts for competitive players
– Display death statistics for fun challenges

### For PvP Arenas
– Real-time kill leaderboards in lobbies
– Track arena champions with holograms
– Reward top killers automatically

### For Economy Servers
– Showcase wealthy players in spawn
– Create economy competitions
– Motivate players to grind money

### For Prison Servers
– Rank up tracking with placeholders
– Display top miners/farmers
– Create prestige leaderboards

## ๐Ÿ› ๏ธ Developer API (Coming Soon)

“`java
// Get top players programmatically
List topKillers = AsLeaderBoard.getTopPlayers(StatType.KILLS, 10);

// Get player rank
int rank = AsLeaderBoard.getPlayerRank(player, StatType.MONEY);

// Register custom stats
AsLeaderBoard.registerCustomStat(“Votes”, new VoteStatProvider());
“`

## ๐Ÿ‘จโ€๐Ÿ’ป Developer

**ItzAzeem** (itzazeem.as) โ€” Founder of **AsDevs**

Passionate Minecraft plugin developer specializing in **performance-optimized, feature-rich** tools for competitive servers. Building the next generation of SMP and network plugins.

– ๐ŸŒ **Website:** [asdevs.netlify.app](https://asdevs.netlify.app/)
– ๐Ÿ’ฌ **Discord:** [discord.gg/xRW5rdAvs5](https://discord.gg/xRW5rdAvs5)
– ๐Ÿ“ง **Contact:** azzugaming9571@gmail.com

### Other Plugins by AsDevs
– ๐Ÿ† **AsBalTop** โ€” Lightning-fast balance leaderboard GUI
– โšก **AsCore** โ€” Essential utilities for SMP servers *(coming soon)*
– ๐ŸŽฎ **AsPvP** โ€” Advanced PvP arena system *(coming soon)*

## ๐Ÿ†˜ Support & Community

### Need Help?

> **๐ŸŽฎ Join our Discord for instant support:**
> ๐Ÿ‘‰ [discord.gg/xRW5rdAvs5](https://discord.gg/xRW5rdAvs5)

We’re active daily and respond within hours!

### Bug Reports
Found a bug? Please report it on our Discord **#support** channel with:
– Server version (Spigot/Paper)
– Plugin version
– Error logs (if any)
– Steps to reproduce

### Feature Requests
Have an idea? We love hearing from the community! Drop suggestions in **#suggestions** on Discord.

**Please don’t use Modrinth comments for support** โ€” Discord is 10x faster! ๐Ÿš€

## ๐Ÿ“ˆ Roadmap

### Version 1.1 (Coming Soon)
– [ ] MySQL/SQLite database support
– [ ] Historical leaderboards (daily/weekly/monthly)
– [ ] Custom stat types via API
– [ ] Hologram auto-generation
– [ ] More PlaceholderAPI variables

### Version 1.2 (Future)
– [ ] Web dashboard
– [ ] Discord bot integration
– [ ] Advanced filtering (by guild, rank, etc.)
– [ ] Tournament system
– [ ] Reward automation

## ๐Ÿ“ Changelog

### [1.0.0] – 2026-04-11
**Initial Release**

#### Added
โœจ Interactive GUI leaderboard system
โœจ Chat-based top 10 displays
โœจ Money, Kills, Deaths tracking
โœจ PlaceholderAPI expansion (30+ placeholders)
โœจ Vault economy integration
โœจ100% configurable (4 YAML files)
โœจ Smart caching system
โœจ Async data loading
โœจ Sound effects & animations
โœจ “Your Stats” personal display

#### Performance
โšก <50ms GUI load time โšก ~10MB memory footprint โšก Zero TPS impact โšก Smart 5-minute cache --- ## โญ Reviews > *”Best leaderboard plugin I’ve used. The GUI is beautiful and it’s so easy to configure!”*
> โ€” **Server Owner, 500+ players**

> *”Finally a plugin that tracks kills AND money. PlaceholderAPI support is amazing!”*
> โ€” **Network Admin, 3 servers**

> *”Zero lag, looks professional, works perfectly. 10/10″*
> โ€” **SMP Owner**

## ๐Ÿ“„ License

This plugin is released under the **MIT License**.

You are free to:
– โœ… Use on unlimited servers
– โœ… Modify for personal use
– โœ… Redistribute (with credit)

You cannot:
– โŒ Claim as your own work
– โŒ Sell/resell this plugin

## ๐Ÿ’– Made with Love

**AsLeaderBoard** is built with passion for the Minecraft community.

If you enjoy this plugin, please:
– โญ **Leave a review** on Modrinth
– ๐Ÿ’ฌ **Join our Discord** community
– ๐Ÿ”— **Share** with other server owners

**Thank you for using AsLeaderBoard!**

**Made with โค๏ธ by ItzAzeem | AsDevs**

*Building the future of Minecraft server plugins, one line at a time.*

[![Discord](https://img.shields.io/badge/Discord-Join%20Now-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/xRW5rdAvs5)
[![Website](https://img.shields.io/badge/Website-Visit%20Us-orange?style=for-the-badge)](https://asdevs.netlify.app/)