Admin UI

Admin UI

The Item Control admin interface provides a visual management hub for all modules. Access it with /ksitem admin.

Admin Hub Layout

The Admin Hub is a single-page UI (920x700) with three sections:

• Left sidebar — Tabbed navigation organized by color-coded section headers, with a scrollable list of module tabs
• Center content area — The active tab’s management panel
• Right browse panel — A persistent item browser shared across all tabs

Tabs only appear for enabled modules. If a module is disabled, its tab is hidden from the sidebar.

---

Sidebar Sections

The sidebar tabs are grouped under labeled section headers:

Section	Tabs
MODULES	Modules
ITEM RULES	Crafting, Death
ADMIN	Recipes, Watchlist, Alerts, Usage Rules
TEMPORARY	Temp Rules
INVENTORY	Inventory
WORLD	NPC/Block Drops, Cmd Blocks
OVERRIDES	Item Overrides (opens sub-page), Soulbound, Cooldowns

At the bottom of the sidebar is a Reload Config button.

---

Modules Tab

The default tab. Displays all 13 modules in a paginated list with toggle buttons.

• Module list — Shows module ID, display name, and current status (ON/OFF)
• Toggle buttons — Enable or disable any module live
• Pagination — Navigate through modules (15 per page)

When a module is toggled, its corresponding sidebar tab appears or disappears immediately.

---

Crafting Tab

Manage the crafting blacklist/whitelist.

• Item list — Shows all blocked (or allowed) item IDs with delete buttons
• Add input — Text field to add an item ID, or click an item in the browse panel
• Pagination — Navigate through the item list (10 per page)

---

Death Tab

Configure death protection rules.

• Death Mode dropdown — Select between vanilla, keep-all, or selective
• Preserve Durability toggle — Whether items lose durability on death
• Protected items list — Items/categories that are kept on death (in selective mode)
• Add input — Add items to the protected list
• Pagination — Navigate through protected items

---

Recipes Tab

Browse and manage all crafting recipes with filtering and batch operations.

• Filter dropdown — Filter by crafting station (All, Pocket Crafting, specific benches, Custom)
• Search field — Filter recipes by name
• Recipe list — Paginated list showing output item, bench type, input count, and status
• Status colors — Green rows for enabled recipes, red for disabled
• Per-recipe actions:
  • Enable/Disable toggle
  • Edit (opens Custom Recipe Editor sub-page)
  • Copy (duplicate a recipe)
  • Delete (custom recipes only)
• Batch operations:
  • Disable All Filtered — Disable all recipes matching the current filter
  • Enable All Filtered — Enable all recipes matching the current filter
• + Add Custom — Opens the Custom Recipe Editor sub-page for a new recipe
• Tags: Edited, Custom, Custom/Off, Disabled, Enabled
• Pagination — Navigate through recipes (10 per page)

---

Drops Tab

Configure custom drop rules for NPCs and blocks. Has two sub-tabs:

Custom Rules Sub-Tab

• Add rule form:
  • Role (NPC role ID, drop list ID, or * for all)
  • Item (item ID to drop)
  • Min / Max quantity
  • Chance (0.0 to 1.0)
  • Mode dropdown (Add / Replace / Remove)
• Rules list — Paginated table showing NPC role, item, quantity, chance, and mode
• Delete buttons — Remove individual rules
• Pagination — Navigate through rules (10 per page)

Drop Lists Sub-Tab

• Search field — Filter NPC roles by name
• Drop list browser — Paginated list of all 728+ drop lists from the game data
• Vanilla Drops lookup — Enter a drop list ID to view its vanilla drops
• Pagination — Navigate through drop lists (15 per page)

---

Watchlist Tab

Monitor specific items and manage the watch list.

• Watched items list — All items currently being monitored
• Add input — Add an item ID to the watchlist
• Delete buttons — Remove items from the watchlist
• Pagination — Navigate through watched items

---

Alerts Tab

View the watchlist alert history.

• Alert table — Columns: Timestamp, Player, Action, Item
• Chronological list — Most recent alerts first
• Pagination — Navigate through alerts (10 per page)
• Empty state — “No alerts recorded” when the history is empty

---

Usage Rules Tab

Manage item usage restrictions.

• Restrictions list — Shows item IDs with their required permission
• Add input — Item ID field and optional permission field
• Delete buttons — Remove individual restrictions
• Pagination — Navigate through restrictions

---

Soulbound Tab

Configure auto-soulbound items.

• Auto-soulbound list — Items that automatically bind to the player on pickup
• Add input — Add an item ID to the auto-soulbound list
• Delete buttons — Remove items from the list
• Pagination — Navigate through items

---

Cooldowns Tab

Manage item cooldown timers.

• Cooldowns list — Shows item IDs with their cooldown duration in seconds
• Add input — Item ID field and duration (seconds) field
• Delete buttons — Remove individual cooldowns
• Pagination — Navigate through cooldowns

---

Temp Rules Tab

Manage time-limited rules.

• Rule type dropdown — Select between crafting-block, crafting-unlock, or usage-block
• Items field — Item ID(s) the rule applies to
• Duration field — Duration in minutes
• Rules list — Shows rule ID, type, items, and status (Active/Pending/Expired with time remaining)
• Delete buttons — Remove individual rules
• Pagination — Navigate through rules

---

Inventory Tab

Inventory management tools for administrators.

• Player search — Text field to enter a player name
• Online players list — Quick-access buttons for all currently online players
• Known players list — Players with backup history (for offline browsing)
• Actions per player:
  • View — Opens the Inventory View sub-page
  • History — Opens the Inventory History sub-page
  • Backup — Create a manual backup snapshot

---

Cmd Blocks Tab

View and manage all command blocks on the server.

• Command blocks list — Paginated table showing position, command, execution mode, and protection status
• Protected badge — Indicates indestructible blocks
• Delete buttons — Remove command block assignments
• Hint text — Instructions to use /ksitem cmdblock for edit mode
• Pagination — Navigate through command blocks (8 per page)

---

Browse Panel (Right Side)

The right side of the Admin Hub contains a persistent item browser shared across all tabs:

• Search field — Filter items by name in real-time
• Item grid — 44 item slots per page with icons
• Pagination — Navigate through all registered items
• Selected item — Shows the currently selected item ID

Click any item in the browse panel to use it in the active tab’s context (e.g., filling an “Add item” field, selecting an input for a custom recipe).

---

Sub-Pages

The Admin Hub opens dedicated sub-pages for advanced editing features. These are full-screen pages that replace the hub.

Item Override Page

Opened from the Overrides sidebar tab. Provides field-by-field editing of item properties.

• Item list — Paginated list of all items with search (15 per page)
• Field editor — 12 editable fields per item:

Field	Type	Description
Max Durability	int	Maximum durability
Durability Loss/Hit	int	Durability lost per hit
Max Stack	int	Maximum stack size
Quality ID	string	Item quality/rarity identifier
Consumable	boolean	Whether item is consumable
Drop on Death	boolean	Whether item drops on death
Durability Loss/Death	int	Durability lost on death
Tool Speed	double	Tool mining speed
Armor Resistance	double	Armor damage resistance
Crafting Tier	int	Required crafting tier
Crafting Output Qty	int	Crafting output quantity
Weapon Damage	double	Total weapon damage (proportional scaling)

• Override indicators — Modified fields are highlighted; original values shown for comparison
• Save / Reset — Save changes or reset to defaults
• Navigation — Links to Weapon Interaction Page and Armor Properties Page for applicable items

Weapon Interaction Page

Opened from the Item Override Page for weapon items. Deep editing of weapon behavior.

• Two tabs: Interactions and Weapon Stats
• Interaction list — All damage interactions (Swing Left, Swing Right, Charged, Vortex, Signature, etc.)
• Filter — By damage class (All, Light, Charged, Signature)
• Per-interaction editing:
  • Damage values per type (Physical, Fire, etc.) — up to 4 damage types
  • Knockback force and duration
  • Sequence and random values
  • EntityStatsOnHit (stat gains per hit)
• Signature Move dropdown — Swap a weapon’s signature ability to another weapon’s signature
• Weapon Stats tab — Edit stat modifiers (e.g., SignatureEnergy) — up to 6 stats
• Add new damage type — Dropdown to add a new damage type across all interactions
• Save / Reset — Save all changes or reset overrides
• Pagination — 6 interactions per page

Armor Properties Page

Opened from the Item Override Page for armor items. Edit armor stats grouped by damage type.

• Base Damage Resistance — Global resistance value
• Per-damage-type cards (6 per page):
  • Resistance value
  • Enhancement value
  • KB Resistance
  • KB Enhancement
• Stat Modifiers — Health, Speed, and other stats (up to 4)
• Attack Class Enhancement — LIGHT, CHARGED, SIGNATURE bonuses (up to 3)
• Add new damage type — Dropdown to add custom damage types
• Add new stat — Dropdown to add custom stat modifiers
• Save / Reset — Save all changes or reset overrides

Custom Recipe Editor Page

Opened from the Recipes tab (”+ Add Custom” or “Edit” on a recipe).

• Output section — Item ID (text field or browse selection) and quantity
• Crafting Station — Bench type dropdown, category dropdown (auto-detect option), and tier
• Craft Time — Duration in seconds
• Permission — Optional permission required to use the recipe
• Inputs section — Up to 4 input items, each with item ID and quantity
• Select buttons — Click “Select” next to any field, then click an item in the browse panel to fill it
• Save / Create — Save edits or create a new recipe
• Cancel / Reset — Discard changes

Command Block Editor Page

Opened by hitting a block while in edit mode (/ksitem cmdblock).

• Position display — Shows the block’s world coordinates
• Command field — Text input for the command to execute
• Placeholders — @p (player name), @pos (block position as x y z)
• Indestructible toggle — Mark the block as unbreakable (only admins can destroy)
• Execution mode — Radio selection between Console (permission bypass) and Player (position context)
• Save / Delete — Save the command block or remove the assignment

Inventory View Page

Opened from the Inventory tab or /ksitem inv view [player].

• Player header — Player name and online/offline status
• Inventory grid — All inventory slots organized by section (Hotbar, Armor, Utility, Tools, Storage, Backpack)
• Item icons — With stack counts and rarity background colors
• Hover tooltips — Detailed tooltips with name, rarity tag, durability, Weapon Mastery stats, and soulbound indicator
• Item detail panel — Click an item to see ID, quantity, slot, and section

Inventory History Page

Opened from the Inventory tab or /ksitem inv history [player].

• Backup list — Chronological list of all backups (auto and manual) with timestamps and names
• Backup preview — Click a backup to preview all 6 inventory sections (Hotbar, Armor, Utility, Tools, Storage, Backpack)
• Item slots — With icons, stack counts, rarity colors, and hover tooltips
• Restore button — Restore the selected backup to the player’s current inventory
• Teleport button — Teleport to the backup’s recorded location
• Offline support — Browse history for players who are not currently online

:::info Module-Dependent Tabs Tabs only appear for enabled modules. If soulbound is disabled, its tab will not show in the admin hub sidebar. The Overrides tab also requires the item-overrides module to be enabled. :::