RPLicenses UI
Require players to hold licenses to drive cars, fly aircraft, sail boats, equip firearms and more!
Require players to hold licenses to drive cars, fly aircraft, sail boats, equip firearms, use tools, or gather resources — with an optional License Store UI, a nearby ID Card popup (/showlicense), police suspension/revocation tools, and full custom license support.
Key Features
- Vehicles, Weapons, Tools, Gathering & Custom Licenses:
- Vehicles: Split licenses by
Car,Plane,Helicopter,Boat,Train, or specific vehicle IDs. - Weapons: Require licenses for all guns or separate them by weapon rarity (e.g., Civilian vs. Heavy/Military) or specific item IDs.
- Tools & Gathering: Restrict lockpicks, blowtorches, C4, or tree/ore harvesting.
- Custom RP Licenses: Create any custom license (like Medical or Business) and automatically give owners a RocketMod permission group while their license is active.
- Vehicles: Split licenses by
- Flexible Ownership:
- Choose between Virtual (saved in database), Physical Item (must carry the license item in inventory), or Hybrid (works with either).
- Optional License Store UI (or Chat Mode):
- Players can open a visual License Store with category tabs (
ALL,VEHICLES,WEAPONS,TOOLS,GATHERING,CUSTOM) and custom hex color coding for every license. - Prefer no UI? Set
UseUItofalseand everything works cleanly in chat.
- Players can open a visual License Store with category tabs (
- Show ID Card to Nearby Players (
/showlicense):- Players can flash their license to anyone within a configurable radius, popping up a color-coded ID card on the middle-left of their screen with their Steam Avatar, Player Name, License Type, Issued Date, Expiry Date, and Status.
- Police & Staff Controls:
- Grant, check, temporarily suspend (e.g.,
30m,2h,7d), or revoke licenses for both online and offline players. - Revoking or suspending immediately removes them from restricted vehicles/weapons and removes the license's permission group.
- Grant, check, temporarily suspend (e.g.,
- Multi-Currency & Storage:
- Charge Uconomy cash, Unturned XP, or make licenses Free — configurable per license.
- Save data with LiteDB (zero setup), JSON, or MySQL.
Commands
Player Commands
| Command | Aliases | Usage | Description |
|---|---|---|---|
/licenses | /license, /licensestore | /licenses | Opens the License Store UI (or lists licenses in chat if UI is disabled). |
/buylicense | /renewlicense | /buylicense <id> | Buys or renews a license. |
/mylicenses | /mylicense | /mylicenses | Shows all of your active, expiring, and suspended licenses in chat. |
/showlicense | /flashlicense, /idcard | /showlicense [id] | Shows your license ID card to nearby players. |
Police & Staff Commands
(Accepts either an online player's name or an offline player's SteamID64)
| Command | Aliases | Usage | Description |
|---|---|---|---|
/givelicense | — | /givelicense <player|steamId64> <id> [hours] | Gives a license to a player (optional custom duration in hours). |
/revokelicense | — | /revokelicense <player|steamId64> <id> | Permanently revokes a license and removes any physical card. |
/suspendlicense | /suspend | /suspendlicense <player|steamId64> <id> <time> | Temporarily suspends a license (e.g. 30m, 2h, 7d, or 0 to lift early). |
/unsuspendlicense | /unsuspend | /unsuspendlicense <player|steamId64> <id> | Lifts a temporary suspension early. |
/checklicense | /checklicenses | /checklicense <player|steamId64> | Checks all active and suspended licenses on a player. |
Permissions
Player Permissions
vortixlicenses.licenses— Open the License Store (/licenses)vortixlicenses.buy— Buy or renew licenses (/buylicense)vortixlicenses.mylicenses— View owned licenses (/mylicenses)vortixlicenses.show— Show license card to nearby players (/showlicense)
Police & Staff Permissions
vortixlicenses.give— Grant licenses (/givelicense)vortixlicenses.revoke— Revoke licenses (/revokelicense)vortixlicenses.suspend— Temporarily suspend or unsuspend licenses (/suspendlicense,/unsuspendlicense)vortixlicenses.check— Inspect a player's licenses (/checklicense)
Per-License Permissions
Inside licenses_config.json, each license also has:
BypassPermission— Anyone with this permission (e.g., staff/admins) can use the vehicle/item without owning the license.GrantedPermissionGroup— RocketMod permission group automatically given to players while they own the license (and removed if it expires, is suspended, or is revoked).
Configuration
VortixLicenses keeps your server settings and your license list in two separate files so it's easy to manage:
-
VortixLicenses.configuration.xml— General settings:- Choose storage (
LiteDB,Json, orMySql) and MySQL details. - Toggle
UseUI(true/false), UI Effect IDs (51200for Store,51201for ID Card), and button cooldowns. - Adjust
/showlicenseradius (ShowLicenseRadius), popup duration (ShowLicenseDurationSeconds), and revocation rules.
- Choose storage (
-
licenses_config.json— Your licenses (auto-created with 8 ready-to-use defaults on first launch):- Add, remove, or edit any license.
- Set
ColorHexto any hex color (e.g.,#3B82F6blue,#EF4444red,#10B981green) to color-code it in the Store UI and ID Card. - Set
Currencyto"Uconomy","Experience", or"Free", andDurationHoursto0for permanent or any number of hours for timed licenses.
[
{
"Id": "vehicle_car",
"DisplayName": "Driver's License",
"Description": "Required to operate land vehicles and cars.",
"ColorHex": "#3B82F6",
"SortOrder": 1,
"Enabled": true,
"Type": "Vehicle",
"OwnershipMode": "Hybrid",
"PhysicalItemId": 1052,
"GivePhysicalItemOnPurchase": false,
"BypassPermission": "license.vehicle.car",
"GrantedPermissionGroup": "license_driver",
"Currency": "Uconomy",
"Price": 1500.0,
"DurationHours": 0,
"VehicleCategories": ["Car"]
}
]
Variables & Settings Reference
1. License Definition Variables (licenses_config.json)
| Variable | Example | Description |
|---|---|---|
Id | "vehicle_car" | Unique ID used in commands like /buylicense and /givelicense. |
DisplayName | "Driver's License" | Name shown in the Store UI, chat, and ID Card. |
Description | "Required to drive..." | Short description shown in the Store UI. |
ColorHex | "#3B82F6" | Hex color code used to color-code the license in the Store UI and ID Card. |
SortOrder | 1 | Controls the display order in the Store UI (lowest first). |
Enabled | true | Set to false to disable a license without deleting it. |
Type | "Vehicle" | Category: Vehicle, Gun, Tool, Gathering, or Custom. |
OwnershipMode | "Hybrid" | Virtual (DB only), PhysicalItem (inventory item only), or Hybrid (either). |
PhysicalItemId | 1052 | Unturned item ID for physical card mode (0 = none). |
GivePhysicalItemOnPurchase | false | Gives PhysicalItemId to the player when bought or granted. |
BypassPermission | "license.vehicle.car" | Permission that lets staff/VIPs bypass this license requirement. |
GrantedPermissionGroup | "license_driver" | RocketMod permission group automatically given while the license is active. |
Currency | "Uconomy" | Payment type: Uconomy, Experience, or Free. |
Price | 1500.0 | Cost in Uconomy cash or Unturned XP (0 for free). |
DurationHours | 0 | How long the license lasts in hours (0 = permanent). |
VehicleCategories | ["Car"] | (Vehicle) Categories to restrict: Car, Plane, Helicopter, Boat, Train, All. |
VehicleIds | [140, 43] | (Vehicle) Optional list of specific vehicle IDs to restrict. |
ExcludedVehicleIds | [1] | (Vehicle) Vehicle IDs exempt from this license. |
MatchAllGuns | false | (Gun) Set to true to require this license for every firearm. |
WeaponRarities | ["COMMON", "UNCOMMON"] | (Gun) Restrict guns by rarity: COMMON, UNCOMMON, RARE, EPIC, LEGENDARY, MYTHICAL. |
ItemIds | [76, 1194] | (Gun / Tool) Specific item IDs required by this license. |
ExcludedItemIds | [] | (Gun / Tool) Item IDs exempt from this license. |
ResourceIds | [] | (Gathering) Specific tree/ore resource IDs (leave empty to restrict all resources). |
Roleplay Essentials
Essential roleplay plugins for the ideal RP experience.
Bundle Price:
RPLicenses UI
Required Workshop
Latest Changes
v1.0.2