# Mods & Plugins

# 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

| Action | Description |
|--------|-------------|
| **Enable** | Activate the mod |
| **Disable** | Deactivate without removing |
| **Configure** | Edit mod config files |
| **Update** | Install newer version |
| **Delete** | Remove 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