markerModify Rankup

A Step by step to add/change/remove a rank.

🏆 Rank System Documentation

📌 Overview

This documentation explains how to build a complete, scalable rank system using:

  • DeluxeMenus GUI structure

  • LuckPerms group & permission handling

  • PlayerPoints economy integration

  • Rank upgrades (temporary & permanent)

  • Rank trials (one-time claim system)

  • Perks & feature showcase menus

This system is designed to be:

  • Clean

  • Expandable

  • Priority-based

  • Economy-balanced

  • Professionally structured


🧱 1. Core Architecture

🔢 Rank Priority Structure

Each rank follows a numeric ladder:

Rank Name
Priority
LuckPerms Group

Example 1

1

group.example1

Example 2

2

group.example2

Example 3

3

group.example3

Example 4

4

group.example4

Example 5

5

group.example5

Higher number = higher priority.


💰 Economy Scaling Pattern

Prices scale cleanly between ranks:

Duration
Base Pattern

1 Week

25% of Monthly

3 Weeks

50% of Monthly

1 Month

100%

Permanent

200% of Monthly

Example scaling:

Rank 1:

  • 1 Week → ℗50

  • 3 Weeks → ℗100

  • 1 Month → ℗250

  • Permanent → ℗500

Rank 2:

  • 1 Week → ℗125

  • 3 Weeks → ℗250

  • 1 Month → ℗500

  • Permanent → ℗1,000


🖥 2. Creating the Main Rank Menu

Layout Rules

  • Slot 4 → Player Statistics

  • Slot 20–32 → Rank Icons

  • Slot 45 → Back

  • Slot 49 → Close

  • Glass panes → Background styling


📊 Player Statistics Section

Displays:

  • Current rank (%vault_prefix%)

  • PlayerPoints balance (%playerpoints_points_shorthand%)

Purpose:

  • Inform player before upgrading

  • Encourage rank progression


🎖 3. Rank Perks Submenu

Each rank has its own submenu:

🔹 Rank Info Section

Displays:

  • Rank name

  • Priority

  • Inherited groups

  • Full pricing breakdown

🔹 Rank Perks Section

Organized into:

Perks

  • Feature access

  • Cosmetic unlocks

  • Special abilities

Commands

  • /example1

  • /example2

  • /example3


💳 4. Upgrade System

🔹 Permanent Purchase

🔹 Temporary Purchase


🔐 Purchase Validation

Before purchase:

  • Check PlayerPoints balance

  • Deny if insufficient

  • Play fail sound

  • Send error message

  • Close and reopen menu safely

This prevents spam clicking and economy abuse.


🎁 5. Rank Trials System

🎯 Purpose

Allow players to try a rank once for free (3 days).

🔹 Claim Command

🔒 Protection Logic

Menu open requirement:

If TRUE → block access If FALSE → allow claim

This ensures:

  • One-time usage

  • Cannot re-claim after expiration

  • Secure against exploit


🧩 6. Permissions Structure

Rank Groups

Trial Lock

Detection Placeholder

Use:

For reliable group checks.


🎨 7. GUI Design Standards

Layout Consistency

  • Slot 4 → Info

  • Slot 20 → Rank icon

  • Slot 22 → Perks

  • Slot 24 → Terms

  • Slot 40 → Permanent

  • Slot 45 → Back

  • Slot 49 → Close

Design Language

  • Small caps formatting

  • ℗ symbol for points

  • &6 highlight sections

  • &8 bullet symbols

  • Clean spacing

Professional presentation increases perceived value.


🛡 8. Anti-Exploit Protection

System includes:

  • Balance verification before deduction

  • Menu refresh delay (20 ticks)

  • Explicit true on permission set

  • Trial lock permission

  • Group detection checks

Prevents:

  • Double purchase

  • Spam buying

  • Trial re-claim abuse


🚀 9. Expanding the System

To add Rank 6:

  1. Create group.example6

  2. Set priority 6

  3. Follow pricing pattern

  4. Duplicate submenu structure

  5. Update main rank GUI

  6. Add trial option if needed

System scales infinitely.


🧠 10. Best Practices

  • Always define explicit permissions (true)

  • Maintain consistent slot structure

  • Keep price scaling proportional

  • Prevent rank downgrade conflicts

  • Remove lower rank when upgrading (optional advanced setup)


📦 Final System Summary

This rank system includes:

✔ Structured priority ladder ✔ Clean GUI navigation ✔ Trial system ✔ Temporary & permanent upgrades ✔ Economy validation ✔ LuckPerms integration ✔ PlayerPoints integration ✔ Professional visual formatting

It is production-ready and scalable for a full network environment.


Last updated