Modify 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

🔹 Menu Structure

menu_title: '&0&l| &8ʀᴀɴᴋ - ᴘᴇʀᴋꜱ'
open_command:
'rank-perks'
size: 54
update_interval: 1

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-perks-example1
rank-perks-example2
rank-perks-example3

🔹 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

/lp user %player_name% permission set group.example1

🔹 Temporary Purchase

/lp user %player_name% permission settemp group.example1 true 7d
/lp user %player_name% permission settemp group.example1 true 21d
/lp user %player_name% permission settemp group.example1 true 1mo

---

🔐 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

/lp user %player_name% permission settemp group.example1 true 3d
/lp user %player_name% permission set rank.trials_claimed true

🔒 Protection Logic

Menu open requirement:

%luckperms_has_permission_rank.trials_claimed%

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

group.example1
group.example2
group.example3
group.example4
group.example5

Trial Lock

rank.trials_claimed

Detection Placeholder

Use:

%luckperms_in_group_example1%

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.

---