# User Management

# User Management

The KyuubiSoft Panel includes a comprehensive role-based access control (RBAC) system with granular permissions.

## Users

### Creating Users

1. Navigate to **Users** in the sidebar
2. Click **Add User**
3. Enter username and password
4. Select a role
5. Click **Create**

### Default Roles

| Role | Description | Access Level |
|------|-------------|--------------|
| **Administrator** | Full access to all features | All permissions |
| **Moderator** | Player management and monitoring | Limited admin |
| **Operator** | Basic server operations | Operational |
| **Viewer** | Read-only access | View only |

### Editing Users

- Click on a user to edit their details
- Change password or role assignment
- Delete users (cannot delete your own account)

## Roles

### Creating Custom Roles

1. Navigate to **Permissions** → **Roles**
2. Click **Create Role**
3. Enter role name and select color
4. Assign permissions
5. Save

### Permission Categories

The system includes **68 permissions** across **19 categories**:

#### Dashboard Permissions
| Permission | Description |
|------------|-------------|
| `dashboard.view` | View dashboard |
| `dashboard.stats` | View dashboard statistics |

#### Server Permissions
| Permission | Description |
|------------|-------------|
| `server.view_status` | View server status |
| `server.start` | Start the server |
| `server.stop` | Stop the server |
| `server.restart` | Restart the server |
| `server.quick_settings` | Modify quick settings |

#### Console Permissions
| Permission | Description |
|------------|-------------|
| `console.view` | View console output |
| `console.execute` | Execute commands |

#### Performance Permissions
| Permission | Description |
|------------|-------------|
| `performance.view` | View performance metrics |

#### Player Permissions (17 granular permissions)
| Permission | Description |
|------------|-------------|
| `players.view` | View player list and inventories |
| `players.edit` | Edit player data |
| `players.kick` | Kick players |
| `players.ban` | Ban players |
| `players.unban` | Unban players |
| `players.whitelist` | Manage whitelist |
| `players.op` | Grant/revoke operator |
| `players.permissions` | Manage player permissions |
| `players.teleport` | Teleport players |
| `players.kill` | Kill players |
| `players.respawn` | Respawn players |
| `players.gamemode` | Change player gamemode |
| `players.give` | Give items to players |
| `players.heal` | Heal players |
| `players.effects` | Apply/clear effects |
| `players.clear_inventory` | Clear player inventory |
| `players.message` | Send messages to players |

#### Chat Permissions
| Permission | Description |
|------------|-------------|
| `chat.view` | View chat logs |
| `chat.send` | Send chat messages |

#### Backup Permissions
| Permission | Description |
|------------|-------------|
| `backups.view` | View backup list |
| `backups.create` | Create backups |
| `backups.restore` | Restore backups |
| `backups.delete` | Delete backups |
| `backups.download` | Download backups |

#### Scheduler Permissions
| Permission | Description |
|------------|-------------|
| `scheduler.view` | View scheduled tasks |
| `scheduler.edit` | Create/edit/delete tasks |

#### Worlds Permissions
| Permission | Description |
|------------|-------------|
| `worlds.view` | View worlds |
| `worlds.manage` | Manage world settings |

#### Mods Permissions
| Permission | Description |
|------------|-------------|
| `mods.view` | View installed mods |
| `mods.install` | Install new mods |
| `mods.delete` | Remove mods |
| `mods.config` | Edit mod configs |
| `mods.toggle` | Enable/disable mods |

#### Plugins Permissions
| Permission | Description |
|------------|-------------|
| `plugins.view` | View installed plugins |
| `plugins.install` | Install plugins |
| `plugins.delete` | Remove plugins |
| `plugins.config` | Edit plugin configs |
| `plugins.toggle` | Enable/disable plugins |

#### Configuration Permissions
| Permission | Description |
|------------|-------------|
| `config.view` | View configurations |
| `config.edit` | Edit configurations |

#### Assets Permissions
| Permission | Description |
|------------|-------------|
| `assets.view` | View and download assets |
| `assets.manage` | Extract and manage assets |

#### User Management Permissions
| Permission | Description |
|------------|-------------|
| `users.view` | View user list |
| `users.create` | Create users |
| `users.edit` | Edit users |
| `users.delete` | Delete users |

#### Roles Permissions
| Permission | Description |
|------------|-------------|
| `roles.view` | View roles |
| `roles.manage` | Create/edit/delete roles |

#### Activity Permissions
| Permission | Description |
|------------|-------------|
| `activity.view` | View activity log |
| `activity.clear` | Clear activity log |

#### Hytale Auth Permissions
| Permission | Description |
|------------|-------------|
| `hytale_auth.manage` | Manage Hytale authentication |

#### Settings Permissions
| Permission | Description |
|------------|-------------|
| `settings.view` | View panel settings |
| `settings.edit` | Edit panel settings |

#### Update Permissions
| Permission | Description |
|------------|-------------|
| `updates.view` | View update status |
| `updates.check` | Check for updates |
| `updates.download` | Download updates |
| `updates.apply` | Apply updates |
| `updates.config` | Configure update settings |

## Example Role Configurations

### Moderator Role

Typical moderator permissions:
```
- server.view_status
- console.view
- console.execute
- players.view
- players.kick
- players.ban
- players.unban
- players.whitelist
- chat.view
- chat.send
```

### Builder Role

For players who only need building access:
```
- server.view_status
- players.view
- worlds.view
```

### Backup Manager Role

Dedicated backup management:
```
- server.view_status
- backups.view
- backups.create
- backups.restore
- backups.download
- scheduler.view
- scheduler.manage
```

## Security Best Practices

1. **Principle of Least Privilege**
   - Only grant permissions users actually need
   - Use custom roles for specific tasks

2. **Strong Passwords**
   - Minimum 12 characters
   - Mix of letters, numbers, symbols
   - Unique per user

3. **Regular Audits**
   - Review user accounts periodically
   - Check activity logs for suspicious actions
   - Remove inactive accounts

4. **Separate Admin Account**
   - Don't use admin account for daily tasks
   - Create personal accounts for each admin

## Activity Logging

All admin actions are logged:

- User logins/logouts
- Server start/stop/restart
- Configuration changes
- Player actions (kick, ban, etc.)
- Backup operations
- User management changes

View the activity log at **Activity Log** in the sidebar.