4.6 KiB
4.6 KiB
Blockland Config
Version 1.7.0 · Author: RallyBlock
A Pelican Panel plugin for managing Blockland dedicated server configuration directly from the panel UI.
Compatibility: Pelican Panel (Filament 4.x, Laravel 12.x)
Features
Add-Ons
- Toggle server add-ons on/off, grouped by category (Bricks, Vehicles, Weapons, etc.)
- Categories are automatically detected from add-on names
- Orphaned entries (add-ons removed from the server) are automatically cleaned up
- Save changes or Save & Restart to apply immediately
ColorSet
- Browse installed ColorSet add-ons and activate them with one click
- Read-only preview of the currently active color palette with color swatches
- Server restarts automatically after activating a new ColorSet
- Supports up to 64 colors (Blockland's maximum)
Preferences
- Edit server preferences (
prefs.cs) with typed form fields (toggles, text, numeric, password) - Preferences are grouped by category (General, Bricks, Network, Quotas, etc.)
- Save syncs prefs to server vars and runs
webcom_postserver()for live effect; Save & Restart for immediate full reload
Admins
- Manage AutoAdminList and AutoSuperAdminList in
prefs.cs - Add by BL_ID with role (Admin or Super Admin) and mode: Auto (saved to prefs) or Manual (session only, no rejoin persistence)
- Demote by BL_ID for manually granted admins (player must be online)
- Apply changes to connected players immediately when adding Auto admins—no rejoin required (vanilla TorqueScript:
findClientByBL_ID,commandToClient setAdminLevel,messageAll) - Remove button to remove BL_IDs from Super Admins or Admins lists; demotes connected players instantly if online
- Silent mode toggle—when enabled, no
messageAllannouncements are sent for promotions, demotions, or preference updates
Add-On Browser
- Browse and install community add-ons directly from bl.kenko.dev
- Browse by category with a searchable dropdown
- Search and filter add-ons by name
- Paginated results with a configurable page size (10, 25, 50, or 100 per page)
- One-click install downloads add-ons directly into the server's
Add-Ons/folder - Note: These add-ons are for Retail Blockland (v21+), are community-created, and have not been tested for safety
Save Loader
- List .bls save files from the server's
saves/folder with optional preview thumbnails - Copy any save to
base/server/temp/temp.bls— then run /ReloadBricks in-game to load it - Upload new .bls files into the saves folder; optionally add a preview image (.jpg, .jpeg, or .png with the same filename)
Requirements
- Pelican Panel with a Blockland server egg (must have
blocklandin egg tags or features)
The plugin is standalone and works with vanilla Blockland—no Blockland Glass or Support Preferences (BLPrefs) required.
Enabling Pages Per Server
Pages are controlled by egg features so you can choose which pages each server gets. Add these feature keys to your Blockland egg's features array:
| Feature | Page | Description |
|---|---|---|
blockland-all |
All pages | Enable all Blockland pages at once |
blockland-addons |
Add-Ons | Toggle add-ons on/off, save or restart |
blockland-colorset |
ColorSet | Activate ColorSet add-ons, preview palette |
blockland-prefs |
Preferences | Edit prefs.cs with typed form fields |
blockland-admins |
Admins | Manage admin lists, add/remove by BL_ID, demote, silent mode |
blockland-addon-browser |
Add-On Browser | Browse and install add-ons from bl.kenko.dev |
blockland-save-loader |
Save Loader | List saves with previews, copy to temp.bls, upload .bls and preview images |
Only pages whose features are present on the server's egg will appear in the server panel. For example, adding only blockland-addons and blockland-prefs will show just those two pages for servers using that egg.
Server File Paths
The plugin reads and writes the following files on the game server:
config/server/ADD_ON_LIST.cs— Add-on enable/disable listconfig/server/colorSet.txt— Active color paletteconfig/server/prefs.cs— Server preferencesconfig/server/.blockland-panel— Panel config (e.g. silent mode)Add-Ons/— Installed add-ons (folders or .zip files)Add-Ons/Colorset_*/— Installed ColorSet add-onssaves/— Save files (.bls) and optional preview images (.jpg, .jpeg, .png); Save Loader lists, uploads, and displays thumbnailsbase/server/temp/temp.bls— Target for Save Loader "Copy to temp.bls" (run /ReloadBricks in-game to load)