promotional bannermobile promotional banner

KyuubiSoft Core (NPCs, NPC Shops and more)

The central foundation for all KyuubiSoft server mods. Provides a unified admin dashboard, a full-featured lootbag system with in-game editor, mod registry, multi-language support, and shared utilities — so every mod works together seamlessly

File Details

KyuubiSoftCore-2.1.0.jar

  • R
  • Mar 31, 2026
  • 7.63 MB
  • 60
  • Early Access

File Name

KyuubiSoftCore-2.1.0.jar

Supported Versions

  • Early Access

Added

  • SmartConfigManager — New utility class that automatically merges missing default fields into existing configs on load. Existing values are never overwritten. Supports deep-merge for nested objects.

Added — Shop Sell System

  • Players can sell items at NPC shops (BUY/SELL tabs)
  • buyEnabled=false for sell-only shops
  • Configurable sell prices: sellPrice per item or sellPricePercent as fallback
  • Whitelist/blacklist for sellable items
  • Daily sell limit: maxSells per item
  • Confirmation dialog with quantity selector and total price
  • Custom sell currency support (sellCurrencyId)
  • Dedicated buyer NPCs: sellShopId on CitizenData
  • Command purchases: Shop items can execute commands instead of giving items (command, commandRunAsServer)

Changed — Shop Admin Panel

  • Completely reworked: inline editing instead of popups
  • Buy/Sell toggles, sell config inline, item table with SELL column

Fixed

  • NPC Role Crash: Moved loadCitizenRoles() from setup() to start() — assets were not yet available during setup
  • NPC Role Spam: "NPC Role not found" warning now logged only once per role
  • i18n Version: Localization version correctly bumped (17 → 25) — new keys are now deployed
  • Sell Confirm Overlay Crash: Element was outside @PageOverlay
  • Shop Command / prefix: CommandSystem expects commands without leading /

i18n

  • 30+ new keys for Shop Sell UI, Admin Panel, Command Purchases (en-US + de-DE)