- Compatible API Versions
- 1.0.0
- Sourcecode
- https://github.com/BrunoJaegerK/RankshopUIV2
RankShopUI V2RankShopUI V2 is a graphical rank shop for Minecraft Bedrock servers running Nukkit. It allows players to purchase ranks using the server economy and automatically assigns the corresponding LuckPerms group. Players also unlock rank-specific kits that they can claim through a graphical interface, with configurable cooldowns, custom item names, and enchantments.
Installation- Download the RankShopUI V2 .jar file from this resource or the GitHub repository.
- Make sure your server has LlamaEconomy and LuckPerms installed and configured.
- Place the RankShopUI V2 .jar file inside your server's plugins folder.
- Start or restart your server.
- Once the plugin has generated its configuration files, open plugins/Rankshop/ and edit the .yml files to customize your ranks, kits, and messages.
- Restart the server after making configuration changes.
Important: Back up your configuration files before editing them. YAML indentation matters, so keep the structure consistent. Make sure your LuckPerms groups and economy setup are working correctly before allowing players to purchase ranks.
Features
Graphical rank shop.
Purchases using LlamaEconomy.
Automatic rank assignment through LuckPerms.
Rank-based kit unlocks.
Configurable kit cooldowns in seconds.
Custom item names and enchantments.
Colored item names using formatting codes.
Customizable shop, confirmation, kit interface, and messages.
Configurable rank prices and kit rewards.
Configuration FilesRankShopUI V2 uses four YAML files. Each one controls a different part of the plugin.
1. config.yml — Rank Shop Configuration
This file controls the rank shop's title, confirmation title, purchase messages, rank identifiers, prices, LuckPerms groups, and the kits unlocked by each rank.
Example:
form-name: "§lRankShop"
confirmation-form-name: "§lConfirmar compra"
rank-purchased: "§8┃ §6Rankshop §8× §aYou purchased a rank successfully."
no-money: "§8┃ §6Rankshop §8× §cYou don't have enough money."
identifiers:
- "0"
- "1"
"0":
name: "VIP"
lp-user: "vip"
price: 20000.00
kits:
- "vip"
"1":
name: "VIP+"
lp-user: "vipplus"
price: 35000.00
kits:
- "vip"
- "vipplus"
How it works:
- form-name: Title of the main rank shop.
- confirmation-form-name: Title of the purchase confirmation form.
- rank-purchased and no-money: Messages displayed for successful purchases and insufficient funds.
- identifiers: Lists the IDs of the ranks available in the shop. Each ID must match a rank section below.
- name: Rank name displayed in the shop.
- lp-user: LuckPerms group to assign when the rank is purchased.
- price: Purchase price using the configured economy.
- kits: Kit IDs unlocked by purchasing the rank. The IDs must match entries in kits.yml.
Tip: You can add more ranks by adding their identifiers and corresponding sections. Replace the example names, group names, prices, and kit IDs with those used on your server.2. kits.yml — Kits, Custom Names, and Enchantments
This file defines the kits players can claim after unlocking them through rank purchases. Each kit has a display name, cooldown, and list of items.
Example:
vip:
name: "VIP Kit"
cooldown-seconds: 86400
items:
- "276:0:1:&dVIP Sword:9:3:13:2"
- "278:0:1:&bVIP Pickaxe:15:3:17:2"
- "322:0:8:&6Golden Apple"
How it works:
- vip: Unique kit ID. Use this exact ID in the kits list inside config.yml.
- name: Name displayed in the kits interface.
- cooldown-seconds: Time players must wait before claiming the same kit again.
- items: List of items included in the kit.
ID:META:QUANTITY
ID:META:QUANTITY:NAME
ID:META:QUANTITY:NAME:ENCHANTMENT:LEVEL
ID:META:QUANTITY:NAME:ENCHANTMENT:LEVEL:ENCHANTMENT:LEVEL
Examples:
items:
- "276:0:1"
- "276:0:1:&dVIP Sword"
- "276:0:1:&dVIP Sword:9:3"
- "276:0:1:&dVIP Sword:9:3:13:2"
- "276:0:1:default:9:3"
- 276: Item ID.
- 0: Item metadata.
- 1: Quantity.
- &dVIP Sword: Custom item name. Color codes using & are supported.
- 9:3: Enchantment ID 9, level 3.
- 13:2: A second enchantment, ID 13, level 2.
- default: Keeps the item's normal name while allowing enchantments to be specified.
Enchantment IDs must be supported by your server's Nukkit version. Check the item and enchantment IDs for your specific server version.3. lang.yml — Interface Text and Messages
This file customizes the text displayed throughout the plugin, including the shop, purchase confirmation, kits interface, and player notifications.
Example:
forms:
shop:
title: "§l§dRankShop"
content: "§7Select the rank you want to purchase."
rank-button: "§8{rank}\n§d${price}\n§7Click to select"
confirmation:
title: "§l§dConfirm Purchase"
content: "§7Purchase §d{rank} §7for §d${price}§7?"
buy-button: "§aConfirm Purchase"
cancel-button: "§cCancel"
kits:
title: "§l§dYour Kits"
content: "§7Select the kit you want to claim."
kit-button: "§b{kit}\n§7Status: {status}"
available-status: "§aAvailable"
cooldown-status: "§cAvailable in {time}"
messages:
no-money: "§cYou don't have enough money to purchase this rank."
purchase-cancelled: "§7Purchase cancelled."
purchase-success: "§aYou purchased the rank §d{rank}§a successfully."
kit-cooldown: "§cYou can claim this kit in §e{time}§c."
kit-claimed: "§aYou claimed the kit §b{kit}§a."
inventory-full: "§cYour inventory doesn't have enough space."
How it works:
- forms.shop: Main rank shop title, description, and rank button text.
- forms.confirmation: Purchase confirmation title, price, and confirm/cancel buttons.
- forms.kits: Kits interface, kit button text, and availability status.
- messages: Notifications and errors displayed to players.
You can customize the text and colors to match your server's language and style. Use the existing keys from your generated lang.yml when editing it.4. plugin.yml — Plugin Metadata and Commands
This file contains the plugin's internal metadata, main class, version, dependencies, and command definitions. It is primarily used by the server to load the plugin.
Example:
name: Rankshop
version: 1.1.0
api: 1.0.0
main: com.brunojaegerk.rankshop.Main
author: BrunoJaegerK
description: Rank shop and kits with custom names and enchantments
depends: [LlamaEconomy, Luckperms]
commands:
ranks:
description: Purchase ranks using the server economy
usage: /rangos
aliases: [rangos, ranks, rank]
kits:
description: Open the unlocked kits interface
usage: /kits
aliases: [kit]
Commands:
- /ranks — Opens the rank shop. Aliases: /rangos, /rank.
- /kits — Opens the interface for claiming unlocked kits. Alias: /kit.
- LlamaEconomy — Economy integration for rank purchases.
- LuckPerms — Rank and group management.
Avoid changing the main class or dependency declarations unless you know how the plugin is built and loaded.
Economy SetupRankShopUI V2 currently declares LlamaEconomy as its economy dependency and LuckPerms for rank assignment.
You can obtain LlamaEconomy from the libs directory in the GitHub repository or from its own distribution source.
If you want to use LlamaBridge or another economy setup, verify that it provides the required compatible integration. An alternative economy plugin is not automatically supported simply by installing it.
Screenshots Rank Shop
Purchase Confirmation Kits Interface Custom Items and Enchantments
Future Updates
RankShopUI V2 is still being improved. More features, enhancements, and fixes are planned for future updates.
Bug Reports and SuggestionsFound a bug or have an idea for a new feature?
- Post your report or suggestion in the CloudburstMC discussion area for this resource.
You can also report issues or contribute through the GitHub repository.
Thank you for using RankShopUI V2!
