SodaPerms - Rank generation in one click

Soda – Advanced Rank & Perk System for Paper

Soda is a powerful and flexible rank-based perk system designed for Paper servers.
It integrates with LuckPerms, supports internal progression, and lets you create fully customizable perks, loadouts, and rank systems.
Whether you're running Prison, SMP, Skyblock, or Factions, Soda adapts to your server.

Feature Overview

Automatic rank progression system
AI-powered rank generation
Multiple loadouts per rank
Advanced perk system (flight, multipliers, permissions)
Smart conditions (world, time, permissions)
Full LuckPerms integration
GUI-based management
Real-time updates & live recalculation
PlaceholderAPI support
Built for Paper 1.20+
Works with 1.21.11 & 1.26
MongoDB, SQL & local support

Automatic Rank Generation & Progression

This is where Soda stands out, you’re not just assigning ranks manually, the system can create and manage progression for you.

Auto-Rank Progression

Automatically grant ranks based on:
- Playtime
- Blocks mined
- Distance walked
Fully configurable requirements per rank
Designed for progression-based servers (Prison, SMP, etc.)
Works alongside existing rank systems

What this means

Players naturally progress through ranks without staff involvement.
No more manual promotions or tracking stats.

AI Rank Generation

Generate complete rank setups from a single command
Create:
- Normal player ranks
- Donator rank tiers
- Staff hierarchies
Input:
- Server gamemode
- Rank count
- Style (P2W / normal)
- Custom inspiration text

What this means

You can go from zero setup → full rank system in seconds.

Full Server Rank Setup

Generate entire rank ladders automatically
Balanced progression between ranks
Logical naming and structure
Ready-to-use configurations

What this means

Perfect for:

New servers
Server resets
Testing new progression systems
Being lazy

Smart Rank Suggestions

AI suggests perks based on rank type
Adjusts difficulty and rewards automatically
Scales perks across rank tiers

What this means

Your ranks feel balanced and professional, even without manual tuning.

Real-Time Rank Updates

Automatically detects rank changes
Reapplies perks instantly
Syncs with LuckPerms and internal system

What this means

No relogging, no delays — everything updates live.

Hybrid Rank System

Combines:
- LuckPerms groups
- Internal Soda ranks
- Auto-generated ranks
Supports multiple rank sources simultaneously

What this means

You’re not locked into one system — Soda adapts to your setup.

Root

Command	Notes
/soda	Help
/soda perks	Player perks GUI

Admin – general

Command
/soda reload

Admin – rank

Command
/soda rank
/soda rank list
/soda rank get <player>
/soda rank set <player> <rank> [duration\|perm] [reason]
/soda rank remove <rankName>
/soda rank claim
/soda rank addpermission <rankName> <permission>
/soda rank removepermission <rankName> <permission>
/soda rank permissions <rankName>
/soda rank prefix <add\|remove> <rankName> [text]
/soda rank suffix <add\|remove> <rankName> [text]
/soda rank <rankName> (opens perk editor if name matches)
/soda rank <rankName> addpermission <permission> (legacy)

Admin – group (Soda “groups” = configured ranks)

Command
/soda group list
/soda group info <group>
/soda group create <group> [priority]
/soda group delete <group>
/soda group permission <set\|unset> <group> <node> (aliases: set/add, unset/remove)

Admin – user

Command
/soda user info <player>
/soda user parent <add\|remove> <player> <group> [duration\|perm] [reason]
/soda user permission <set\|unset> <player> <node> (requires LuckPerms)

Admin – grants

Command
/soda grant <user> <rankName> <duration\|perm\|donation> [reason]
/soda grantremove <user> <rankName> <reason>

Admin – AI

Command
/soda rankwithai create <rankName> <rankType> <examplePrefix…>
/soda serverwithai <serverGamemode> <donatorAmount> <staffAmount> <p2w\|normal> [inspiration]
/soda serverai <serverGamemode> <donatorAmount> <staffAmount> <p2w\|normal> [inspiration] (alias)
/soda ai evaluate <player>
/soda ai force-promote <player>
/soda ai reset <player>

YAML:

stacking-mode: ADD

features:
  visual-feedback:
    particles-on-apply: true
    sound-on-rank-change: true
    actionbar-on-apply: true
  conditional-perks: true
  loadouts: true
  world-toggle: true

worlds:
  globally-disabled: []

ai:
  enabled: false
  provider: "openai" # openai or gemini
  fallback-provider: "openai" # openai, gemini, or none
  retries: 2
  api-key: "YOUR_KEY"
  model: "gpt-4o-mini"
  endpoint: "https://api.openai.com/v1/chat/completions"
  gemini-endpoint: "https://generativelanguage.googleapis.com/v1beta/models/%s:generateContent"
  temperature: 0.4
  server-gamemode-hint: "prison"
  cache-minutes: 30
  connect-timeout-seconds: 10
  request-timeout-seconds: 25
  debug: false

integrations:
  neutron:
    enabled: true
    refresh-interval-seconds: 20

auto-ranks:
  Veteran:
    grant-mode: internal
    requirements:
      playtime-hours: 10
      blocks-mined: 2000
      distance-meters: 5000
  Grinder:
    grant-mode: internal
    requirements:
      playtime-hours: 30
      blocks-mined: 8000
      distance-meters: 15000

gui:
  enabled: true
  title: "&8Rank System"
  layout:
    - "M M M M M M M M M"
    - "M M M M M M M M M"
    - "M M M M M M M M M"
    - "B B B B B B B B B"
  rank-list:
    title: "&bSoda &8- Rank Management"
    size: 54
    rank-slots-start: 10
    rank-slots-end: 43
  perk-editor:
    title: "&bEditing &f%rank% &8- &e%loadout%"
    size: 54
  player-dashboard:
    title: "&bSoda &8- Your Perks"
    size: 54
  back-item:
    material: ARROW
    name: "&cBack"
  info-item:
    material: BOOK
    name: "&eInfo"
  ai-preview:
    title: "&dAI Rank Preview"
    size: 54
    permissions-preview-limit: 12

ranks:
  VIP:
    priority: 10
    permission: "rank.vip"
    display-name: "&aVIP"
    icon: EMERALD
    worlds:
      enabled: [ "world", "mine_world" ]
      disabled: []
    loadouts:
      Mining:
        fly: true
        speed: 2
        jump: 1
        token-multiplier: 1.5
        xp-multiplier: 1.3
        economy-multiplier: 1.2
        extra-permissions: [ "example.vip.mine" ]
        conditions:
          world: ""
          required-permission: ""
          only-during-night: false
      PvP:
        fly: false
        speed: 1
        jump: 2
        token-multiplier: 1.0
        xp-multiplier: 1.0
        economy-multiplier: 1.0
        extra-permissions: [ "example.vip.pvp" ]
        conditions:
          world: "arena"
          required-permission: ""
          only-during-night: false
  MVP:
    priority: 20
    permission: "rank.mvp"
    display-name: "&6MVP"
    icon: DIAMOND
    worlds:
      enabled: [ "world", "mine_world" ]
      disabled: []
    loadouts:
      Mining:
        fly: true
        speed: 3
        jump: 2
        token-multiplier: 2.0
        xp-multiplier: 1.7
        economy-multiplier: 1.5
        extra-permissions: [ "example.mvp.mine" ]
        conditions:
          world: ""
          required-permission: ""
          only-during-night: false

Support & Contact via Discord: cian1968

SodaPerms - Rank generation in one click v1.0.1

Overview Dependencies Updates (1) History