Skip to main content

Mods & Plugins

The KyuubiSoft Panel provides comprehensive mod and plugin management with multiple installation sources.

Overview​

Navigate to Mods & Plugins to see:

  • Installed mods and plugins
  • Available updates
  • Installation sources

Installation Sources​

CurseForge​

Browse and install mods from CurseForge:

  1. Go to Mods & Plugins → CurseForge tab
  2. Search for mods by name
  3. View mod details, downloads, and ratings
  4. Click Install to download
tip

CurseForge integration works without an API key using CFWidget proxy.

Modtale​

Hytale-specific mod repository:

  1. Go to Modtale tab
  2. Browse available mods
  3. Click Install

Requires MODTALE_API_KEY in environment.

StackMart​

Asset and plugin marketplace:

  1. Go to StackMart tab
  2. Browse plugins and assets
  3. Download and install

Requires STACKMART_API_KEY in environment.

Manual Upload​

Upload mods directly:

  1. Go to Upload tab
  2. Drag & drop or select .jar file
  3. File is validated and installed

Installed Mods​

Viewing Mods​

The installed list shows:

  • Mod name and version
  • Source (CurseForge, Modtale, Manual)
  • File size
  • Status (Enabled/Disabled)

Managing Mods​

ActionDescription
EnableActivate the mod
DisableDeactivate without removing
ConfigureEdit mod config files
UpdateInstall newer version
DeleteRemove completely

Mod Configuration​

Edit mod config files:

  1. Click Configure on a mod
  2. Select config file (JSON, YAML, etc.)
  3. Edit in the built-in editor
  4. Save changes
  5. Restart server to apply

Plugin Management​

KyuubiAPI Plugin​

The panel requires the KyuubiAPI plugin for advanced features:

  • Real-time player data
  • Inventory viewing
  • Performance metrics
  • Chat logging

Current Version: v1.2.2

Installing KyuubiAPI​

  1. Go to Settings → KyuubiAPI
  2. Click Install Plugin
  3. Restart the server

Plugin Status​

Check plugin status:

  • Connected - Plugin is active
  • Disconnected - Plugin not responding
  • Not Installed - Plugin missing

Update Management​

Checking for Updates​

The panel automatically checks for mod updates from:

  • CurseForge (via CFWidget)
  • Modtale
  • StackMart

Update Notifications​

When updates are available:

  • Badge appears on Mods & Plugins
  • Updates tab shows all available
  • Dashboard may show alert

Applying Updates​

  1. Go to Updates tab
  2. Review available updates
  3. Click Update for individual mods
  4. Or Update All for batch update
  5. Restart server

Wishlist​

Track mods before installing:

  1. Find a mod on CurseForge
  2. Click Add to Wishlist
  3. Get notified of updates
  4. Install when ready

Best Practices​

Mod Compatibility​

  • Check mod compatibility before installing
  • Test new mods on a backup first
  • Keep mods updated for security

Performance​

  • Don't install too many mods
  • Monitor TPS after adding mods
  • Remove unused mods

Backups​

  • Create backup before major mod changes
  • Test restore procedure
  • Keep known-good backup

Troubleshooting​

Mod Won't Load​

  1. Check server console for errors
  2. Verify mod is for correct Hytale version
  3. Check for missing dependencies
  4. Try disabling other mods

Config Not Saving​

  1. Check file permissions
  2. Verify JSON/YAML syntax
  3. Restart server after changes

CurseForge Not Working​

  1. Check internet connectivity
  2. Try with CURSEFORGE_API_KEY set
  3. Check rate limiting

Plugin Not Connecting​

  1. Verify KyuubiAPI plugin is installed
  2. Check plugin is enabled
  3. Review server logs for errors
  4. Ensure correct plugin version