Palworld REST Control by ZaylLahnma

## PalRestPlugin

A LangBot plugin for managing and monitoring dedicated Palworld servers via the official REST API, supporting server startup, server information, player list, performance status, save operations, and management actions.

## Features
- **Server Management**
  - Start the server from chat
  - Save world data
  - Shutdown or stop the server remotely
- **Information Retrieval**
  - Get server details (`!pal info`)
  - View performance metrics (`!pal metrics`)
  - List online players (`!pal players`)
  - Display selected server settings (`!pal settings`), configurable in WebUI
- **Player Management**
  - Ban / Unban players
  - Kick players
  - Announce messages to all players
- **Access Control**
  - Blacklist and whitelist support for controlling who can execute commands
- **Customizable Commands**
  - Change trigger words via the WebUI and map them to REST API paths

## Installation
1. Install from LangBot plugin market or GitHub release.
2. In LangBot WebUI, configure:
   - `api_host`, `api_port` – Palworld REST API server address
   - `api_user`, `api_pass` – HTTP basic authentication
   - `command_map` – Custom triggers and mapped REST API paths
   - `pal_blacklist`, `pal_whitelist` – Optional access control lists

## Usage
Examples in chat:
```
!pal info
!pal metrics
!pal players
!pal save
!pal ban <username> <userid> [message]
!pal unban <username> <userid>
!pal settings
```
Triggers can be customized in **command_map**.

## Requirements
- LangBot 4.0 or higher
- Palworld dedicated server with REST API enabled

## License
MIT License

---

> Note: This plugin code was assisted by AI tools during development.