VertexNexus Documentation

Overview
VertexNexus is a powerful Minecraft plugin that provides an automated 4-stage KeyAll reward system and an advanced AFK Zone reward system. It is designed for modern servers and supports Paper, Spigot, Purpur, and Folia (1.20–1.21).

The plugin allows server owners to automatically reward players through configurable stages, AFK zones, and console commands while maintaining high performance and stability.

━━━━━━━━━━━━━━━━━━━━━━

⚙ Installation

1️⃣ Download the VertexNexus .jar file
2️⃣ Place the file inside your server's /plugins folder
3️⃣ Restart the server
4️⃣ The plugin will generate its configuration files automatically

Generated files:
config.yml
data.yml
zones.yml
messages.yml

━━━━━━━━━━━━━━━━━━━━━━

KeyAll System

VertexNexus includes a global 4-stage KeyAll reward system.

Stage Cycle:
Stage 1 → Stage 2 → Stage 3 → Stage 4 → Reset

Each stage can run custom commands such as:

crates keyall vote 1
eco give %player% 500

✨ Features
⚡ Custom timers for every stage
Broadcast messages
Sounds and titles
Admin controls for skipping or triggering stages

━━━━━━━━━━━━━━━━━━━━━━

AFK Zone System

The AFK system rewards players who stay inside a selected AFK area.

Players inside the zone will receive rewards based on a stage cycle similar to KeyAll.

AFK Stage Cycle:
Stage 1 → Stage 2 → Stage 3 → Stage 4 → Reset

✨ Features
BossBar countdown timer
Automatic AFK rewards
Zone-based reward detection
Entry title display

━━━━━━━━━━━━━━━━━━━━━━

Creating an AFK Zone

Step 1
Use the wand command:

/vn wand

You will receive a Blaze Rod.

Step 2
Select the region:

Left Click → Set Point 1
Right Click → Set Point 2

Step 3
Save the zone:

/vn setzone

The region will be saved inside zones.yml.

━━━━━━━━━━━━━━━━━━━━━━

Commands

Main Command:
/vn

Admin Commands:

/vn wand
Gives the zone selection wand

/vn setzone
Saves the selected AFK zone

/vn reload
Reloads all plugin configurations

/vn info
Shows plugin information

KeyAll Controls

/vn keyall now
Trigger the current KeyAll stage

/vn keyall skip
Skip to the next stage

/vn keyall pause
Pause the KeyAll timer

/vn keyall resume
Resume the timer

━━━━━━━━━━━━━━━━━━━━━━

PlaceholderAPI Support

VertexNexus integrates with PlaceholderAPI for scoreboards and tablists.

Available placeholders:

%vn_keyall_timer%
%vn_keyall_stage%
%vn_afk_timer%
%vn_afk_stage%

Example:

KeyAll Stage: 2
Next Reward: 05:30

━━━━━━━━━━━━━━━━━━━━━━

Data Persistence

The plugin automatically saves runtime progress.

Saved information includes:

current_keyall_stage
remaining_keyall_time

This ensures timers and stages continue correctly even after server restarts.

━━━━━━━━━━━━━━━━━━━━━━

⚡ Performance

VertexNexus is optimized for modern Minecraft servers.

✨ Lightweight and optimized
⚡ Clean Object-Oriented architecture
Folia-compatible scheduling
Independent KeyAll and AFK timers

━━━━━━━━━━━━━━━━━━━━━━

Credits

Developer: Aarav Singh
Owner: Aarav Singh

Discord Support Server
https://discord.gg/uEPbjWJn2d

Join the Discord server for plugin support, bug reports, updates, and announcements.