Blockland Fan Forums - Tools and Resources

Gamemode.txt Creation

Mon, 23 Mar 2026 08:35:22 +0000

This script will create a generateGamemodeTxt function, that when used, will create a file styled like your average gamemode's gamemode.txt.

It will collect information from the gamemode you're hosting right now (Only tested on Custom gamemode).
Specifically it'll create data about all add-ons, musics, and the environment. Minigame should be handled by the creator.

Example:

Code:
generateGamemodeTXT("Add-ons/Gamemode_MyEpicDM/gamemode.txt"); //In console

Note: This will include itself in the gamemode.txt, you can remove it if you want to. It will not create (For now) $Server::GhostLimit ETC.

Script_GamemodeTXT.zip (Size: 1.45 KB / Downloads: 21)

Linux Raw Input (DLL)

Sat, 07 Mar 2026 02:14:42 +0000

https://codeberg.org/Queuenard/blockland...uxRawInput
DLL is in releases folder

This DLL enables use of the raw input APIs provided by Windows and implemented by Wine.

Right now I only implemented mouse movement.

This should alleviate some of the input buffering faced by Linux/Wine users.

Blockland Liberator Python

Fri, 28 Nov 2025 06:09:26 +0000

https://codeberg.org/Queuenard/blockland...tor-python

This is the Python equivalent of the "Blockland Liberator" written in 2024. Works for r2033, the current version.
https://github.com/Elletra/bl-liberator

This really isn't meant to be a fully supported project and I don't claim to understand everything it does but a few people make use of the original tool, so I made something accessible to those without the ability to compile C/C++. The C program duplicates a lot of logic already in pre-existing libraries.

Queuenard's Blockland video archive

Fri, 07 Nov 2025 03:22:38 +0000

https://archive.org/details/blockland-qu...eo-archive

What's that? A video archive with no videos uploaded?

Last Update: April 13th, 2026

Since March 2025 I've been doing weekly scans of YouTube videos matching the search term "Blockland". I do full 2006-to-present scans usually at the beginning of every month. The full searches still turn up videos that didn't show up in prior searches. Right now I've uploaded only the export of video data since writing a whole video upload mechanism is a lot of work. As far as I'm concerned, all the videos are now safe since I personally have them all downloaded. You are encouraged to use the list to download the videos yourself, which should require 2.2TB 2.13TB 2.18TB of space. The full details are in the link.

The Titanium / Blockistium (whose videos also take up 625GB or 29% of the archive by disk usage) found the data useful for making this compilation.

Prison Escape Resources

Thu, 04 Sep 2025 02:51:59 +0000

Here is the files I use when hosting prison escape. Unfortunately, the gamemode isn't properly packaged, and uses the server's enabled add-on list instead.
As a result, the setup is quite convoluted and requires a few manual steps to get the game to run. This archive contains hopefully the bare mininum to run the gamemode.
Or maybe you are just here to grab the music or a specific add-on, if so go for it.

Server_Prison_Escape is the main add-on for the gamemode, although you can't run it like a normal gamemode. It is also not the true original file used in Tezuni's or Apak's host
of the server. I made this newer add-on as I only had access to an old build I saved a long time ago, alongside another build supplied by Gentle Spy. Since then, the map used here has undergone
substantial changes and additions from the original host. To be honest the code is quite spaghetti-like and has lots of hard-coded stuff in it, which makes setting up the server more difficult.

To run the gamemode:
Create a new blockland instance and copy the "Add-Ons", "config", and "modules" folder over, overwriting conflicting files.
Optionally install RedBlocklandLoader to use the DLLs in the modules folder. (https://gitlab.com/Eagle517/redblockland...-/releases)
Run the server dedicated with the default Custom "gamemode".
Once you load in, run in the console "serverDirectSaveFileLoad("Add-Ons/Server_Prison_Escape/Save.bls",3,"",0,0); PrisonEscape_WantedLoop();".
This will load up the save, and start the scheduled loop for the bottom print for prisoners.
Create a slayer minigame using the two csv files supplied in the Server_Prison_Escape folder. You can copy this to your own client slayer config folder to more easily select it.
Run the minigame, and set the "$DefaultMinigame" global variable to the newly created minigame. Using "\$DefaultMinigame = %minigame" ingame with ClayEval should work.
The game should be ready to play now, glhf

Link to archive: https://mega.nz/file/RUJixDZY#POgRFhutlF...fcJC_fOci0

My DLLs

Sat, 24 May 2025 06:25:24 +0000

I wanted to make a thread to house the DLLs I've worked on over the years. I've arranged them based on whether they're client-side or server-side as well as how useful I think they are. As always, Queuenard maintains an exhaustive list of all DLLs made for Blockland over at https://codeberg.org/Queuenard/blockland-DLL-tools. All of these DLLs can be loaded into the game using RedBlocklandLoader.

Client DLLs
Name	Description
Immediate Refocus	This allows you to alt+tab in and out of the game without it freezing (assuming you're not in fullscreen mode).
Precipitation	Makes rain/snow collide with bricks, improving a build's atmosphere.
No Sleep	Prevents the game from sleeping when the window is not focused. This makes it so the game continues to run smoothly while in the background.
Texture Bleed	Makes it so textures clamp to their edges properly and don't bleed. See an example here.
More Coverage	Extends brick face culling to cover larger bricks. See an example here.

Server DLLs
Name	Description
Selective Ghosting	Dynamically ghost/unghost objects to clients and adjust objects' net fields. Original by Zeblote.
Network Priority	Control the network priority of objects so important objects ghost first for clients.
Wine Fix	Fixes the console so dedicated servers work properly with more recent versions of Wine (up to Wine 8.0.2).
Move Handler	Gives you the ability to see player's inputs and control bots in a precise manner. Originals by Port and Gytyyhgfffff.
Ghost Limit Bypass	Removes the ghost limit so more objects are able to update per game tick for clients. Note that clients with poor bandwidth may be negatively impacted. Original by Pah1023.
Object Collision	Gives you fine-grain control over object collisions, letting you specify it per-object. See examples here.
Player Data Fields	This lets you adjust datablock fields per-player, along with their recharge rates. This can reduce ghost updates, but it may cause client-side interpolation jittering depending on which fields you modify.

Utility DLLs (These work on both the server and client)
Name	Description
Player Collision Toggle	Lets you manipulate collisions between players and vehicles. Original by Zeblote. See examples here.
Float Precision	Increases the floating point precision of TorqueScript.
BL Tracy	Integrates the Tracy profiler into Blockland for TorqueScript, letting you better diagnose problems. See examples here.
DataChunker Fix	Fixes a bug with the DataChunker class, increasing the function limit of TorqueScript.
On Game Tick	Adds a TorqueScript callback that gets called every game tick with the game's delta time.

Memory Usage (DLL)

Thu, 24 Apr 2025 06:10:58 +0000

https://notabug.org/Queuenard/MemoryUsage
https://codeberg.org/Queuenard/blockland...emoryUsage
Documentation; DLL is in releases folder

This DLL allows TorqueScript to get the memory usage of the current Blockland process.

Blockland Docker Image

Sun, 09 Feb 2025 09:56:13 +0000

I found myself having to install Wine one too many times, so I put together a Docker image to simplify setting up and running a Blockland dedicated server on a Linux VPS. The image itself is based off of debian:bookworm-slim with all the necessary packages needed to run Blockland.

I put together a nice readme on the Git repo which is located here: https://gitlab.com/Eagle517/blockland-docker. This should have everything to get you started. The image itself is located on Docker Hub at eagle517/blockland-server.

Those familiar with Docker may notice I recommend using the host network driver. I would have liked to use the standard bridge driver, but I've yet to figure out how to get Blockland's UDP packets to play nicely with it, and the broader Docker community appears to have similar issues with UDP in general. The primary consequence of this is the host driver is only available on Linux, so it's not possible to use this image on Windows hosts. Fortunately most people running dedicated servers use Linux anyway.

This is the first Docker image I've put together, and I tried to learn the best practices. If you happen to be more experienced with Docker and think I've done something silly, please let me know.

Public Blob CDN

Sat, 08 Feb 2025 05:15:42 +0000

Back in January I setup a bot that periodically goes through servers and collects their blobs. These blobs are uploaded to a Storj bucket and accessible via http://blobs.bcs.place. The homepage just shows basic information such as how many blobs are available, but if you want to test it here's a link to base/data/shapes/empty.dts.

What's the point?
Servers have two ways of sending content to clients, either via a CDN (https://cloudf.blockland.us by default) or directly from the server. Sending content directly from the server is the fallback approach if the blob is not available on the CDN and is unfortunately very slow, as the packets are limited to 200 bytes/tick or so. This leads to long loading times on servers with a lot of custom content. Content sent via a CDN is a lot faster and can speed up load times by 4-7x depending on the average size of your server's blobs. As an example, loading times for BCS dropped from 13 minutes to 2 minutes once we implemented our own CDN (a ~6.5x improvement on a fresh install).

What's wrong with the default CDN?
The default CDN does not appear to be maintained by Badspot anymore, so it's missing a lot of blobs you encounter nowadays. And funnily enough, custom content has grown quite a bit in the past few years. Servers like Eventide, BCS, AoD, and Farming have a significant amount of custom content that isn't captured in the default CDN.

What's the solution?
Some time ago, Queuenard made Support_CustomCDN. This add-on enables servers to define what CDN clients should use, and clients with the add-on will make use of that CDN. This is great, but it puts the onus of hosting the CDN on the server host. A lot of hosts shy away from it because of the complexity/costs/etc. that come with setting one up and maintaining it. The purpose of my CDN is to make it as painless as possible. The host has to do nothing outside of configuring the add-on to point to my CDN and just wait for my bot to stop by and collect their blobs.

I also made an add-on to make CDN configuration/management a bit simpler for hosts, Server_BlobCDN. This adds RTB/Glass preferences and fallback mitigations should the CDN ever go down. It's optional, the only required add-on is Queuenard's.

Why am I doing this?
I like Blockland, and I want to encourage content creation without hosts worrying about loading times. The cost of running this is less than a Netflix subscription and gives me more enjoyment. I intend to keep it going until Badspot pulls the plug on the game, assuming no one is around that can plug it back in somehow.

Some footnotes
The bot is capable of automatically joining all public servers and collecting only blobs it has not encountered before. It is capable of joining passworded servers should the host provide the password to me. The upload process for the blobs is automatic but requires manual intervention should any upload fail. I also manually activate the bot when I think it's a good time to collect blobs. I would like to get it fully automated, and have it be proactive/focused in its blob gathering by scanning the server list for new servers occasionally along with a daily scheduled time.

If you need help configuring Support_CustomCDN or notice an issue, just let me know.

Trace Buddy (DLL)

Thu, 06 Feb 2025 08:03:19 +0000

https://gitlab.com/Queuenard/TraceBuddy
Documentation; DLL is in releases folder

This DLL adds a "trace2" function that dumps a custom (but extremely similar to regular trace) TorqueScript trace into a file if the program crashes* (see Linux caveat - this isn't reliable) or is requested to dump by script.

The stock trace() function is really difficult in certain circumstances because it outputs to the console log which makes the server wait for massive amounts of file writes.

A Python tool to read the trace log from a Windows memory dump has been released: https://notabug.org/Queuenard/blockland-memory-dump-search https://codeberg.org/Queuenard/blockland...ump-search

As of today I've added new timing features so you can actually see how long functions are taking to run.

Useful Resources Thread

Sun, 02 Feb 2025 17:55:28 +0000

Useful Resources Thread

The purpose of this thread is to help people unfamiliar or inexperienced with making Add-Ons for the game by sharing links to useful resources, or their experiences with making Add-Ons.
I'll start it off by dumping some of the links I have for programming in Torquescript and working with Blockland.
(Big thanks to Patyos for initially providing me with some of these links!)
I am specifically making it as it can be hard to find useful resources on Google as it indexes search content different depending on user account used and region.
For example: I cannot find this forum easily on Google unless i search for "heightmap2bls" (a tool I made and posted here) or for "bcs.place forum".

Blockland Forums (Official) Posts

"META-STICKY - Resources and helpful threads"
https://forum.blockland.us/index.php?topic=287458.0

"is there a good resource for torquescript syntax and inbuilt functions?"
https://forum.blockland.us/index.php?topic=327937.0

"Blockland Content Creators [Discord]"
https://forum.blockland.us/index.php?topic=318430.0

Mr. Wallet's "Blockland Scripting for Dummies"
A short document about scripting in torquescript, specifically aimed at Blockland
Good for beginners to get a handle of scripting
https://files.blockland.online/Documenta...ummies.pdf

Torque Game Engine (TGE & Torque3d)
Archives
Archive.org's archive of garagegames' tge documentation
http://web.archive.org/web/2022051509554.../official/
Kenko's archive of garagegames' tge documentation
https://bl.kenko.dev/Websites/docs.garag.../official/

Torque Quick References PDF
An almost 400 page long book about all things TGE
(I have yet to take a proper look at this but it seems to cover a wide array of topics to do with TGE)
http://www2.ift.ulaval.ca/~couture/IFT-2...rences.pdf

Torque3D
Not 100% applicable to Blockland, but there is still a decent amount of overlap with built-in functions (AFAIK)
https://torque-3d.readthedocs.io/en/latest/
Official Torque3D site (Has a discord server with an active community)
https://torque3d.org/

Community made documentation
The following is a list of community-made documentation specifically targeted at Blockland

BlDocs
https://bldocs.readthedocs.io/en/latest/index.html
https://github.com/nightkr/bldocs

Public Code Repositories
This section is for large, well-known or otherwise useful projects hosted on public code repositories such as GitHub, Gitlab, codeberg, notabug, etc.
These aren't specifically aimed at teaching someone how to make Add-Ons or for providing documentation, rather for reference and seeing how things are done.
Good for hands-on learning.

CityRPG4
https://github.com/cityrpg/CityRPG

TBP's megadump of his Blockland content
https://github.com/TheBlackParrot/blockland-megadump

Blockland Glass sourcecode
https://github.com/BlocklandGlass/BlocklandGlass

/Ty's CityRPG addon
(Exercise extreme caution if referring to this as it apparently contains backdoors, do not replicate them or you are putting yourself and all users of your add-on at risk)
https://github.com/Ty-lerCox/tys-city-rpg

Bl-decompiled
Has seemingly decompiled all of the game's cs.dso files (compiled torquescript) for several versions of the game (beta, v1, v20, v21)
https://github.com/Elletra/bl-decompiled

Queuenard's List of Blockland DLL Tools
https://codeberg.org/Queuenard/blockland-DLL-tools

Dead Links
These links contain archives and community made documentation that is currently unavailable, but will be left here in case they come back online.

Pecon's Archives
Torque Game Engine Advanced
https://pywb.pecon.us/en/all/20220422044.../official/
Torque Game Engine
https://pywb.pecon.us/en/all/20220422044.../official/

Blockdoc - Community made documentation
http://blockdoc.block.land/index.php/Main_Page

Heightmap2bls

Mon, 20 Jan 2025 00:10:35 +0000

Heightmap2bls

Generate high quality terrain from heightmaps!

0.3.0 - Now with a GUI!

Heightmap2bls is an external python command line tool for generating .bls save files from 8-bit greyscale heightmap images.

It also supports automatically colorizing the map if a colored png is provided!

(If you want to use this tool, you need Python 3!)

Main features:

Generate maps from 2d images!
Use custom colorsets
Automatically color the map using the closest color
Arbitrarily rescale all 3 axis of the map (x, y, z)!
Optionally fill in vertical gaps
Perform basic brick optimization
Load custom brick files (defined in JSON)
Hotswap save files (kind of )
Define the map's step (minimum height difference between layers)
Sit a map on the ground (if your heightmap doesn't have any pitch-black spots)

PROTOTYPE GUI! <--- If you have previously used the software, you will need to follow the setup instructions again.

Sample command on windows:

Code:
python hm2bls.py -hm res/heightmap.png --bricks res/terrainBricks.json --gapfill --optimize  --ground -x 400 -y 400 -z 90

This will generate a bls save file using "heightmap.png" for elevation data, use a custom brick set file, fill in any vertical gaps, try optimize the brickcount where possible, set the map on the ground and rescale it to 400x400x90!

See the github page for full usage guidelines!

What it looks like:

What it can do:

Get Heightmap2bls here!

(Includes Bonus brickpacks 4n8brickH and 4n8brickT in the res folder!)

Default game scripts and a little story

Wed, 13 Nov 2024 04:03:40 +0000

The default scripts are available in raw form here and have been available since 2019:
https://github.com/Elletra/bl-decompiled

This is a little example of how not having the game's default scripts caused headaches over the years and forced scripts to guess, often incorrectly, about default functions...

https://notabug.org/Queuenard/Blockland-...ion-Plague
https://codeberg.org/Queuenard/blockland...ion-Plague
Analysis of a scripting mistake with the parameters of ProjectileData::onCollision that has plagued Blockland for years

I wrote this after discovering this issue in December 2023. This common mistake will make the push broom only able to push players upwards.

The most likely cause for scripters getting this wrong was finding information on this function from the stock Torque Game Engine manuals, as Blockland had added a parameter that the stock engine did not have.

A big part of the problem was that the default TorqueScript code ("DSO code" or "default scripts") had been obscured in compiled form until a few years ago.