KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #deepseek-harness #typescript #ai-agent #codex #developer-tools #claude-code #windows #mcp #python #desktop-app

pz-admin

★ 19 Open GitHub ↗

PZ Admin is a Windows and Linux desktop application for managing Project Zomboid servers with RCON.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**PZ Admin** is a Windows and Linux desktop application for managing Project Zomboid servers with RCON.

## Installation

Download from the [website](https://beyenilmez.github.io/pz-admin) or go to [the releases page](https://github.com/beyenilmez/pz-admin/releases/latest) and download the matching binary for your platform.
Windows(amd64, arm64) and Linux(amd64) are supported.

## Table of Contents

- [Screenshots](#screenshots)
- [Features](#features)
- [Development](#development)
- [Frontend Scripts](#frontend-scripts)
- [Technologies](#technologies)
- [License](#license)

## Screenshots

> Expand the section below to view screenshots.

<details>
<summary>Click to view screenshots</summary>

_Manage your server._
![Management Tab](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/management.webp)

_View and manage your players._
![Player List Tab](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/players.webp)

_Modify and save server options._
![Options Tab](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/options.webp)

_Interact with your server directly via an RCON terminal._
![Terminal Tab](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/terminal.webp)

_Spawn vehicles with a catalog._
![Add Vehicle Dialog](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/add_vehicle.webp)

_Add items with an item catalog._
![Add Items Dialog](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/add_items.webp)

_Add xp to players with custom skills and levels._
![Add XP Dialog](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/add_xp.webp)

_Set player access level._
![Set Access Level Dialog](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/set_access_level.webp)

_Message Editor_
![Message Editor](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/message_editor.webp)

_Item Browser_
![Item Browser](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/item_browser.webp)

_Vehicle Browser_
![Vehicle Browser](https://raw.githubusercontent.com/beyenilmez/pz-admin/main/assets/vehicle_browser.webp)

</details>

## Features

### Server Management

- RCON terminal for remote console access.
- Modify, import, and export server options.
- Save world, stop server.
- Send server-wide messages.
- Weather controls: Start/stop rain and weather.
- Trigger random events like choppers, gunshots, lightning, and thunder.

### Player Management

- View and manage player list.
- Add XP, items, or vehicles to players.
- Adjust access levels, ban/unban, kick, or teleport players.
- Add/remove players to/from the whitelist.
- Create hordes, lightning or thunder on specific players.

### Tools

- Message editor, item browser and vehicle browser available as standalone tools.

## Development

### Pre-requisites

Before starting development, ensure you have the following installed:

1. **Install NodeJS:** [NodeJS installation guide](https://nodejs.org/en/download/).
2. **Install Yarn:** [Yarn installation guide](https://classic.yarnpkg.com/lang/en/docs/install/).
3. **Install Go:** [Go installation guide](https://go.dev/doc/install).
4. **Install Wails:** [Wails installation guide](https://wails.io/docs/gettingstarted/installation).

### Development or Building

1. **Clone the repository:**
   ```bash
   git clone https://github.com/beyenilmez/pz-admin.git
   ```
2. **Navigate to the project directory:**
   ```bash
   cd pz-admin
   ```
3. **Run in dev mode:**

```bash
   wails dev
   ```

**or build the application:**

```bash
   wails build
   ```

## Frontend Scripts

- **`yarn vehicles`:** Updates the `src/assets/vehicles.json` file with the new vehicles from `public/vehicles` folder.
- **`yarn items`:** Downloads item images to `public/items` and updates the `src/assets/items.json` file.
- **`yarn convert-item-translations:`** Converts translations for items into JSON.

Usage: `yarn convert-item-translations {lang} {encoding}`

Example: `game-translations/{lang}.txt` → `public/locales/{lang}/items.json`.

Item translation files are located in: `C:\Program Files (x86)\Steam\steamapps\common\ProjectZomboid\media\lua\shared\Translate\{lang}\ItemName_{lang}.txt`

## Technologies

- **Backend**: [Go](https://go.dev/), [Wails](https://wails.io/), [RCON](https://github.com/gorcon/rcon)
- **Frontend**: [React](https://react.dev/), [TailwindCSS](https://tailwindcss.com/), [shadcnUI](https://ui.shadcn.com/)
- **Translation**: [i18next](https://react.i18next.com/)

## License

Distributed under the MIT License. See [LICENSE](https://github.com/beyenilmez/pz-admin/blob/main/LICENSE) for more information.

pz-admin

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README