PermissionsLite

Your ranks run themselves, and your VIP sells itself.

PermissionsLite starts every new player on a rank ladder that climbs by itself, and it sells your VIP for you through free trials and paid point rentals.

The Permissions plugin gives you groups, but somebody still has to hand them out, take them back, and remember who was promised what. PermissionsLite does all of that for you. A brand new player lands in a starter group the second they first join, climbs your ladder on real days or on played hours, gets warned before a rank runs out, and can taste your VIP once for free or rent it with shop points. Every grant goes through a timed group, so even if you remove me tomorrow, no player is ever stuck holding a rank they should have lost.

Supported Features

• A starter rank on first join: the moment a brand new player arrives I put them in your welcome group, cluster wide, with zero staff work.
• Ladders that climb alone: set up rungs like Newcomer, Settler and Resident, and players move up by themselves when their time on a rung is done.
• Two kinds of clock: a ladder can count real days, so everyone climbs, or only played hours, so the rank means somebody actually plays here.
• No rank ever gets stuck: every grant rides a timed group inside the Permissions plugin itself, so ranks still run out on time even if I am deleted.
• Warnings before the end: players hear in game and on Discord before a rank runs out, at the points you pick, like a day, an hour and ten minutes before.
• A free taste of VIP: one trial per player, ever. They type one command, hold your VIP for a while, and get your own pitch line when it is about to end.
• The trial finds them: set a played hours mark and the trial arrives as a gift right when a player is hooked, which is the best sales moment there is.
• Rank rental for points: players rent timed groups with ArkShop or WShop points, stack time up to your cap, and pay again to keep it going.
• Ranks that fade away: switch on decay and a player gone too long slides down one rung, then plays their way back up when they return.
• Weekend windows: give everyone online a boost group between two clock times each week, and it takes itself away when the window shuts.
• A paper trail for staff: every grant, promotion, rental and removal lands in the database with who, what and when, and one command shows a player's whole story.
• Every word in your words: the language file next to my config holds every line players see, so translate it, reword it, or share your file with another owner.

Console & RCON Commands

Command	What It Does	Where
PermissionsLite.Reload	Read config.json and discord.json again with no restart.	Both
PermissionsLite.Grant <eos> <group> <span>	Hand a player a group for a span like 7d, or perm for good.	Both
PermissionsLite.Extend <eos> <group> <span>	Stretch a running grant by more time.	Both
PermissionsLite.Revoke <eos> <group>	Take a granted group back early.	Both
PermissionsLite.GrantTribe <tribeId> <group> <span>	Hand a whole tribe a timed group.	Both
PermissionsLite.RevokeTribe <tribeId> <group>	Take a timed tribe group back.	Both
PermissionsLite.Skip <eos>	Move a player up one ladder rung right now.	Both
PermissionsLite.Reset <eos>	Start a player's ladder over from the first rung.	Both
PermissionsLite.Timeline <eos> [--json]	Show every grant I know for a player, as text or JSON for a bot.	Both
PermissionsLite.TestDiscord	Send a test post to both webhooks so you can check them.	Both

Player Commands

Both command words live in config.json, so rename them any time.

Command	What It Does
/rank	See your ranks and how long each one has left.
/rank next	See where you sit on the ladder and what comes next.
/rank offers	List the ranks you can rent and their point prices.
/rank buy <name>	Rent a rank with shop points, or stretch one you already rent.
/trial	Claim your one free taste of VIP.

Permissions

I add no permission nodes of my own. Permissions is the plugin I build on, so it must be installed, and the groups you name in my config must exist in it. My staff commands run from the console and over RCON, which are trusted already.

Config

To see every configuration option, visit our docs. To edit your config files the easy way, open our configuration editor.

Requirements

• AsaApi v2.01 or newer
• A Windows server running ArkAscendedServer through the AsaApi loader
• The free Permissions plugin. It holds your groups, and I am the engine that runs them, so I do nothing without it
• A licence key, pasted into config.json under License and then Key
• MySQL (optional, works without it, SQLite is built in and a cluster is the one reason to switch)
• ArkShop or WShop (optional, works without it, only trials with a price and rentals need points)
• A Discord webhook (optional, works without it)

Installation

1. Unzip the download.
2. Drop the PermissionsLite folder into ArkApi/Plugins/. Keep the folder name exactly, because AsaApi only loads a plugin whose folder and DLL share a name.
3. Paste your licence key into config.json under License and then Key.
4. Make your groups in the Permissions plugin, then name them in my Tracks section. Your webhook goes in discord.json beside the config.
5. Restart the server through AsaApiLoader.exe and watch ArkApi.log for my loaded line.
6. Join with a fresh account, or run PermissionsLite.Reset on a test player, and watch the starter rank land.

Support & Help

Stuck on a step, or a rank not doing what you expected? Bring it to the Discord and I will look at it with you: https://discord.gg/8GGaEzWk9p

Frequently Asked Questions

What does PermissionsLite do?

PermissionsLite runs your ranks for you on top of the free Permissions plugin. New players get a starter group on their first ever join, ladders promote them over real days or played hours, ranks warn before they run out, and players can trial your VIP once for free or rent it with shop points. Everything is stored in a database with a full audit trail.

Do I need the Permissions plugin for PermissionsLite to work?

Yes. PermissionsLite is an engine for the free Permissions plugin, not a replacement for it. Permissions holds your groups and their perks, and I decide who gets which group and for how long. Without Permissions installed I sit quietly and hand out nothing.

How do I install PermissionsLite?

Unzip the download and drop the PermissionsLite folder into ArkApi/Plugins/, keeping the folder name so it matches the DLL. Paste your licence key into config.json, name your groups in the Tracks section, then restart the server through the AsaApi loader and watch ArkApi.log for the loaded line.

Does PermissionsLite work across a cluster?

Yes, that is what the MySQL option is for. PermissionsLite shares its players, grants and clocks across every map, so a player who first joins on one map is not welcomed twice on the next, and only one map ever acts when a rank comes due. On a single server the built in SQLite needs no setup at all.

What happens to the ranks if I remove the plugin or my licence runs out?

Nothing gets stuck, and that is by design. PermissionsLite hands every timed rank to the Permissions plugin itself, which removes it on schedule with or without me. A lapsed licence stops new handouts, but every rank already out there still runs out on its own clock, so no player keeps perks they should have lost.

Was any AI content used in the making of this?

The source code itself was fully created by myself. I do use ChatGPT occasionally to generate product images, and I do use ChatGPT to generate the website descriptions. I do this because I don't speak native English perfectly. I am natively from Sweden, so I use GPT to help translate and write product descriptions. I also will sometimes use GPT to write better English logs. Majority of my Free plugins are open source, so you can review the code yourself and freely fork and edit it to your liking.