# Blockland Pelican Egg

Pelican Panel egg for running Blockland dedicated servers. Uses the [rallyblockk/blockland-pelican](https://hub.docker.com/r/rallyblockk/blockland-pelican) Docker image.

## Files

| File | Description |
|------|-------------|
| `egg-blockland.json` | Egg export in JSON format — use this to import into Pelican |
| `egg-blockland.yaml` | Same egg exported in YAML format from the panel |

## How to Import

1. Open your Pelican Panel **Admin Panel**
2. Click **Eggs** in the sidebar
3. Choose **File** (upload `egg-blockland.json`) or **URL** and paste:
   ```
   https://git.ny.daprogs.com/RallyBlock/Blockland-Pelican-Egg/raw/branch/main/egg-blockland.json
   ```
4. Click **Submit** — Pelican imports and installs the egg, if it doesn't already exist.
5. When creating a server, assign the Blockland egg to it.

## Requirements

- [Pelican Panel](https://pelican.dev/) installed
- The `rallyblockk/blockland-pelican` Docker image (Pelican pulls it when you create a server)
- A [Blockland DToken](https://blockland.us/steam-dToken.php) for authentication

## Egg Variables

When creating a server, you can assign additional environment variables. The ones below are commonly used; the full list is in the [Blockland-Docker-Pelican](https://git.ny.daprogs.com/RallyBlock/Blockland-Docker-Pelican) repository.

| Variable | Description |
|----------|-------------|
| **bl dtoken** | Your DToken from your Steam account (required for hosting) |
| **bl gamemode** | The name of the gamemode to launch with (default: Custom) |
| **bl patch enable** | Patches Blockland.exe with RedBlocklandLoader for WineFix (default: 1) |
| **bl port** | Server port (defaults to `{{SERVER_PORT}}` from Pelican) |
| **bl unzip addons** | Unzips .zip add-ons on startup (default: 0) |
| **bl inst force** | Forces a full game reinstall on every launch. Turn off BL_UNZIP_ADDONS when using this—the reinstall restores .zip files to Add-Ons, then unzip fails because the extracted folders already exist from the previous run. (default: 0) |

## Related

- **Docker image**: [rallyblockk/blockland-pelican](https://hub.docker.com/r/rallyblockk/blockland-pelican)
- **Docker source**: [Blockland-Docker-Pelican](https://git.ny.daprogs.com/RallyBlock/Blockland-Docker-Pelican) — build or modify the Docker image