Admin Panel
The Lootbags admin panel is a full in-game management interface opened via /lbadmin panel. It provides five tabs organized in a sidebar: Catalog, Give, Drops, Statistics, and Settings.
The admin panel requires the kslootbagsadmin command permission. It is also accessible through the Core Admin Menu and the Showcase NPC integration.
Sidebar
The sidebar groups the five tabs into three sections:
| Section | Tabs |
|---|---|
| LOOTBAGS | Catalog, Give |
| SYSTEM | Drops, Statistics |
| CONFIG | Settings |
Click any tab in the sidebar to switch the content area. The active tab is indicated by a blue bar.
Catalog Tab
Browse, inspect, and edit all registered lootbag definitions.
List View
The default view shows a paginated, filterable list of all lootbags.
| Element | Description |
|---|---|
| Rarity Filter Buttons | All, Common, Uncommon, Rare, Epic, Legendary -- click to filter the list instantly |
| Count Info | Shows total matching lootbags and the active filter (e.g., "120 Lootbags | Filter: All") |
| Lootbag Rows | 10 per page -- each row shows the item icon, name, and type badge (Fixed/Random/Hybrid) |
| Page Navigation | Back/Next buttons with page indicator (e.g., "1 / 12 (120)") |
Click any lootbag row to open the Detail View.
Detail View (Editor)
When you click a lootbag in the list, a full editor opens with these sections:
Header Area
| Element | Description |
|---|---|
| Back Button | Returns to the list view |
| Title | Lootbag name with rarity label (e.g., "Default Lootbag [Common]") |
| Info Line | Shows loot type and item ID (e.g., "[Hybrid] Default_Lootbag") |
Editable Fields
| Field | Description |
|---|---|
| Name | Text field -- edit the display name |
| Picks | Text field -- set the number of random pool picks |
| Rarity Cycle | Button that cycles through Common, Uncommon, Rare, Epic, Legendary |
| Dupes Toggle | Button that toggles allowDuplicates on/off (shown as "Dupes: ON" or "Dupes: OFF") |
Item Table
A paginated table (6 items per page) showing all guaranteed and pool items:
| Column | Description |
|---|---|
| Type | "Gar" for guaranteed items, "Pool" for pool items |
| Item-ID | The item identifier |
| Amount | Item count (e.g., "x5") |
| Weight | Pool weight (blank for guaranteed items, e.g., "w:25") |
| Edit | Loads the item's values into the add/update form below |
| Delete | Removes the item from the definition |
Page navigation (Back/Next) appears below the table with a page indicator.
Add/Edit Item Form
| Element | Description |
|---|---|
| Type Toggle | "Guaranteed" or "Pool" buttons -- determines where the item is added |
| ID | Text field for the item ID |
| Amt | Text field for the amount |
| Wt | Text field for the weight (only relevant for pool items) |
| Add / Update | Button label changes to "Update" when editing an existing item |
Save Button
Clicking Save reads the current Name and Picks values from the text fields, applies them to the definition, and persists all changes to custom/custom_lootbags.json. A status message confirms the save.
The standard configs/lootbags.json is never modified. All edits made through the admin panel are saved to custom/custom_lootbags.json, which overrides standard definitions at load time.
Give Tab
Give lootbag items to yourself or other players.
Single Give
| Field | Description |
|---|---|
| Lootbag-ID | Text field -- enter the lootbag item ID (e.g., Golden_Lootbag_Legendary) |
| Player | Text field -- leave empty to give to yourself, or enter another player's name |
| Amount | Text field -- stack size (1--64, defaults to 1) |
| Give | Button to execute the give action |
Pressing Enter in the Lootbag-ID field also triggers the give action.
Validation:
- The Lootbag-ID is checked against the registry; unknown IDs show an error
- Amount is clamped to 1--64
- Player name is matched case-insensitively against online players
Bulk Give
Below the single give section, there are five rarity buttons:
| Button | Action |
|---|---|
| Common -- all 24 variants | Gives all 24 family variants at Common rarity |
| Uncommon -- all 24 variants | Gives all 24 family variants at Uncommon rarity |
| Rare -- all 24 variants | Gives all 24 family variants at Rare rarity |
| Epic -- all 24 variants | Gives all 24 family variants at Epic rarity |
| Legendary -- all 24 variants | Gives all 24 family variants at Legendary rarity |
A status message shows how many lootbags were given (e.g., "24 Lootbags given!").
Drops Tab
Add, edit, search, and delete drop rules for mob kills and block breaks.
Drop Rule Table
A paginated table (8 rules per page) of all active drop rules:
| Column | Description |
|---|---|
| Type | "M" for mob drop, "B" for block drop |
| Pattern | The wildcard pattern (e.g., *, Trork_*, Ore_Gold*) |
| Lootbag | The lootbag item ID to drop |
| Chance | Drop probability as percentage (e.g., "5.0%") |
| Edit | Loads the rule into the editor form below |
| Delete | Removes the rule and auto-saves |
Page navigation (Back/Next) appears below the table with a page indicator.
Search
A search field at the top filters drop rules by pattern, lootbag ID, or type ("M"/"B"). The header updates to show filtered count vs. total (e.g., "Drop Rules (3/12)").
Add/Edit Form
| Element | Description |
|---|---|
| Type Toggle | "Mob" or "Block" buttons -- determines the drop category |
| Pattern | Text field -- the mob role name or block ID pattern (supports * wildcards) |
| Lootbag | Text field -- the lootbag item ID to drop (validated against registry) |
| % | Text field -- drop chance as percentage (0--100, default: 5) |
| Add / Update | Button label changes to "Update" when editing an existing rule |
| Cancel | Visible during edit mode -- click to abort the edit and reset the form |
Pressing Enter in the Pattern field also triggers the add/update action.
Validation:
- Pattern and Lootbag-ID are required
- The lootbag ID must exist in the registry
- Chance must be a number between 0 and 100
Every change (add, update, delete) is automatically saved to configs/drop_tables.json. A backup (.bak) is created before each save. There is no manual save button.
Statistics Tab
Displays server-wide and per-player lootbag statistics. All data is read-only.
Server Statistics (Online)
Aggregated across all currently online players:
| Metric | Description |
|---|---|
| Players online | Number of connected players |
| Total opened | Combined lootbag openings |
| Items received | Combined items received |
| Rarity Distribution | Breakdown by Common, Uncommon, Rare, Epic, Legendary |
Your Statistics
Personal statistics for the admin viewing the panel:
| Metric | Description |
|---|---|
| Total opened | Your total lootbag openings |
| Items received | Your total items received |
| Per-Rarity Breakdown | Color-coded counts for each rarity tier |
| Top Opened Lootbags | Your 5 most frequently opened lootbag types with open counts |
If no data is available, a "No data available" message is shown.
Settings Tab
Toggle global settings and manage the plugin configuration.
Toggles
| Toggle | Description | Effect |
|---|---|---|
| Mod enabled | Enable/disable the entire lootbag system | Immediate -- disables opening, drops, and interactions |
| Reveal Page | Enable/disable the animated reveal page | Immediate -- when off, items go directly to inventory |
| Mob/Block Drops | Enable/disable lootbag drops from mob kills and block breaks | Immediate -- does not affect manual gives |
Toggles take effect immediately via native checkbox controls. Changes are applied in memory but not persisted to disk until you click Save config.
Language Dropdown
A dropdown selector with the following language options:
en-US, de-DE, fr-FR, es-ES, pt-BR, ru-RU, pl-PL, tr-TR, it-IT
Selecting a language immediately changes the admin panel's UI language for the current player. The selected language is also used for all command messages.
Info Line
Shows the current count of loaded lootbag definitions and drop rules (e.g., "Lootbags: 120 | Drop rules: 12").
Action Buttons
| Button | Description |
|---|---|
| Reload configs | Reloads all configuration files from disk (lootbags, drop tables, localization) |
| Save config | Saves the current config.json toggles to disk |
A status message confirms each action (e.g., "Saved!" or "Reloaded! 120 Lootbags.").