# Advanced Settings

# Advanced Settings

Configure advanced panel settings, server authentication, and recommended plugins.

## Accessing Settings

Navigate to **Settings** in the sidebar.

## Language Selection

Change the panel interface language:

| Language | Code |
|----------|------|
| English | en |
| German | de |
| Portuguese (Brazil) | pt-BR |

1. Click the language dropdown
2. Select your preferred language
3. Interface updates immediately

## Hytale Server Authentication

Configure how the server authenticates with Hytale services.

### Authentication Status

The settings page shows:
- **Status** - Authenticated / Not Authenticated
- **Persistence** - Memory (resets on restart) or Persistent

### Device Code Flow

To authenticate:

1. Click **Start Authentication**
2. A device code appears
3. Go to the Hytale authentication URL
4. Enter the device code
5. Authorize the server
6. Panel shows "Authenticated"

### Reset Authentication

To reset:

1. Click **Reset Auth**
2. Confirm the action
3. Server is deauthenticated

### API Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/auth/hytale/status` | Get auth status |
| POST | `/api/auth/hytale/start` | Start device flow |
| POST | `/api/auth/hytale/reset` | Reset authentication |

---

## Server Settings

### Patchline

Select which Hytale update channel to use:

| Patchline | Description |
|-----------|-------------|
| **Release** | Stable releases (recommended) |
| **Pre-Release** | Early access to new features |

:::warning
Changing patchline requires a server restart.
:::

### Accept Early Plugins

Enable support for plugins marked as "early access":
- **Enabled** - Load early plugins
- **Disabled** - Only load stable plugins (default)

:::note
Requires server restart to apply.
:::

### Disable Sentry

Toggle error reporting to Hytale:
- **Enabled** - Errors are reported
- **Disabled** - No error reporting

:::note
Requires server restart to apply.
:::

### Allow OP

Enable or disable the operator (OP) command system:
- **Enabled** - OP commands work (default)
- **Disabled** - OP system is disabled

:::note
Requires server restart to apply.
:::

---

## Recommended Plugins

The panel recommends these plugins for enhanced functionality:

### Nitrado:WebServer

Provides a web server for custom pages and APIs.

**Features:**
- Custom web endpoints
- Static file serving
- API integration

### Nitrado:Query

Enables server query protocol support.

**Features:**
- Server status queries
- Player list queries
- Server info protocol

### Nitrado:PerformanceSaver

Optimizes server performance.

**Features:**
- Chunk unloading optimization
- Entity management
- Memory optimization

### ApexHosting:PrometheusExporter

Exports detailed metrics for monitoring.

**Features:**
- JVM metrics
- Server metrics
- Custom metrics
- Grafana integration

---

## Config File Editor

Edit server configuration files directly.

### Accessing

1. Go to **Settings**
2. Scroll to **Server Configuration**
3. Click on a config file

### Supported Formats

- JSON (`.json`)
- YAML (`.yml`, `.yaml`)
- Properties (`.properties`)

### Editing

1. Select the file
2. Edit in the text editor
3. Click **Save**
4. Restart server if required

:::danger
Incorrect configuration can prevent server startup. Always backup before editing.
:::

---

## Mod Update Checker

Track and update mods from CurseForge.

### Accessing

Navigate to **Mod Updates** in the sidebar.

### Tracking Mods

1. Click **Track Mod**
2. Enter the CurseForge URL
3. Click **Add**
4. Mod appears in the list with version info

### Checking for Updates

- **Manual** - Click **Check All**
- **Automatic** - Runs every hour

### Update Status

| Status | Description |
|--------|-------------|
| ✓ Up to date | Latest version installed |
| ⚠ Update available | Newer version exists |
| ✕ Unknown | Version check failed |

### Untracking Mods

1. Find the mod in the list
2. Click **Untrack**
3. Mod is removed from monitoring

### API Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/management/modupdates/status` | Get update status |
| POST | `/api/management/modupdates/check-all` | Check for updates |
| POST | `/api/management/modupdates/track` | Track a mod |
| DELETE | `/api/management/modupdates/untrack` | Untrack a mod |

---

## Help & Command Reference

In-app command reference with 150+ commands.

### Accessing

Navigate to **Help** in the sidebar.

### Command Categories

| Category | Commands |
|----------|----------|
| **Player** | kick, ban, op, whitelist, heal, effects |
| **Admin** | stop, restart, save, reload, broadcast |
| **World** | time, weather, difficulty, gamerule |
| **Teleport** | tp, spawn, home, warp |
| **Entities** | summon, kill, count |
| **Blocks** | setblock, fill, clone |
| **XP** | xp add, level set |
| **Debug** | tps, memory, gc, log level |

### Using Commands

1. Browse categories or search
2. Click a command to expand details
3. View syntax, parameters, permissions
4. Click **Copy** to copy the command

---

## About

View panel version and technology information:

- **Panel Version** - Current installed version
- **Technology Stack** - Vue.js, Express.js, Docker
- **Support Links** - Discord, GitHub

---

## Permission Reference

| Permission | Description |
|------------|-------------|
| `settings.view` | View settings page |
| `settings.manage` | Modify settings |
| `hytale_auth.manage` | Manage Hytale authentication |
| `config.view` | View config files |
| `config.edit` | Edit config files |
| `updates.view` | View update information |
| `updates.manage` | Manage updates |