RxyLevel V1.0

RxyLevel

Advanced Level & Rank System for RPG & Survival Servers

Folia Support! 1.20+

- Discord - Wiki -

Introduction​

RxyLevel is a powerful and flexible leveling and ranking system designed for Minecraft servers running Spigot, Paper, Folia, and similar forks. It offers a fully customizable progression system with advanced rank handling, multi-database support, Discord logging, PvP logic, region restrictions, and deep configuration options for server owners who want full control.

 Core Level System

RxyLevel introduces a two-layer progression structure:

• Numeric Levels (e.g. 0–150)
• Named Ranks tied to level ranges

Players gain levels, automatically rank up, receive permissions, and trigger customizable events.

Key features include:

✔ SQLite, MySQL, or Redis data storage (fully configurable)

✔ Automatically calculated next-level requirements

✔ Fully customizable rank names and display identifiers

✔ Rank-up commands, messages, and permission granting

✔ Terminal-friendly level modification commands

✔ %player% support for commands and automation

✔ Optional debug mode for full decision-trace logging

Rank Logic & Automation:

Each rank can define:

✔ min_level and max_level boundaries

✔ Custom rank display IDs

✔ Rank-up messages

✔ Rank-up commands

✔ PvP-specific messages

✔ Permission nodes

When players reach the required level:

 They rank up automatically

 Configured commands are executed

 Permissions are granted instantly

 A notification is sent to the player

RxyLevel can also check permissions on join and grant missing ones automatically. This feature can be toggled in config.yml.

 PvP Control System

RxyLevel introduces a unique PvP mechanic based on ranks:

✔ Players can only PvP if they share the same rank

✔ Custom message displayed on rank mismatch

✔ Worlds can bypass rank PvP rules via wwa_players_can_pvp

✔ Integrates with WorldGuard pvp_disable flag (priority respected)

If a player is in a world listed under wwa_players_can_pvp, all PvP restrictions are lifted.

 Region Access Control

Server owners can lock regions behind level requirements using regions.yml.

Features include:

✔ Block low-level players from entering restricted regions

✔ Teleport back to nearest surface block

✔ Custom denial messages

✔ Optional optimization via predefined teleport points

✔ Integration with level-based gameplay loops

Discord Webhook Logging

RxyLevel can notify a Discord server about player level changes

 using Webhooks with full customization.

Supported webhook events:

 Level added

 Level removed

 Level set

 Rank changed

 Debug Mode

A fully toggleable debug mode logs:

✔ Decision chains

✔ Rank-up checks

✔ Region checks

✔ PvP checks

✔ Database interactions

Perfect for development, testing, and administration.

 PlaceholderAPI Support

RxyLevel integrates directly with PlaceholderAPI and provides multiple useful placeholders for UI, scoreboards, menus, and HUDs.

Current placeholders:

%rxylevel_current_level%

%rxylevel_next_rank_level%

%rxylevel_current_rank%

%rxylevel_next_rank%

Conditional checks supported as boolean outputs:

%rxylevel_level_>50%

%rxylevel_level_<50%

%rxylevel_level_>=50%

(It prints 1 if true and 0 if false. You can write a different number instead of '50', this is just an example.)

 Configuration System

RxyLevel uses three YAML files for full flexibility:

 config.yml system configuration

 ranks.yml rank tiers & behavior

 regions.yml region-level restrictions

This structure keeps everything modular, readable, and production-ready.

 Database Drivers

Supported storage drivers:

• SQLite
• MySQL
• Redis

This allows RxyLevel to scale from small SMP servers to large network clusters.

 Example Use Cases

 Level-based region progression

 Rank-locked PvP competitive modes

 RPG & Survival servers with named rank tiers

 Discord-integrated stat tracking

 Hybrid database setups with Redis caching

 Compatibility

✔ Spigot / Paper / Folia compatible

✔ Supports PlaceholderAPI

✔ Supports WorldGuard

✔ Works with permissions plugins (LuckPerms etc.)

Dependencies:

PlaceholderAPI

WorldGuard

LuckPerms

Discord

Web

Wiki