Terrablox

 A 3D voxel virtual tabletop.

Build dungeons, ruins, and battlefields out of colored blocks. Place tokens. Run fog of war.

Building is fast. Left-click to paint, drag to fill a wall or a variety of shapes like ramps, pyramids, hills and more. Copy any chunk of  your scene and paste it elsewhere or share it as a text string in your notes (inspired by Talespire "slabs").

Fog of war is fully 3D. Line-of-sight traces from each token's eye position. Areas your party has visited stay visible behind fog. Visibility is team based, so your players could share vision, have individual vision, or you could even run PvP wargames with fog of war tracking multiple teams.

Lighting is raytraced through the voxel grid: sunlight, ambient occlusion, colored lighting, emissive blocks, and more.

Tokens are built as "standees" from any imported image, and can be scaled to any size. You can convert sections of the level into "props" that can be moved and rotated like tokens.

This project is in development and currently has only direct IP multiplayer. You'll need to be on the same LAN or be able to forward port 7777.

Quick Start

When you launch Terrablox you'll see the lobby. Choose Offline to play solo, Host to run a LAN session, or Join  and enter the host's IP to connect. After that, you'll pick or create a campaign and then a scene. Campaigns hold multiple scenes (dungeon level 1, the tavern, the overworld, etc.).

 The camera

 Right-drag to orbit. Middle-drag to pan. Scroll to zoom. This works in every mode.

Modes

  The tab bar at the top switches your active mode. Keyboard shortcuts are faster:

•  B: Build (place and erase blocks)
•  P: Paint (recolor existing blocks)
•  G: GM mode (tokens, fog, reveal)
•  R: Ruler
•  I: Images (GM only; import reference images)
•  Esc: back to Play (move tokens, camera only)

 Pressing the active mode key a second time also returns to Play.

Building

In Build mode, the default tool is placing a single block with left click, Shift+left-click to erase. The other shapes (line, rectangle, etc.) are drawn by clicking and dragging.

Brushes cycle with B (or the shelf button): Single, Line, Rect. [ and ] adjust brush width. - and = adjust how  many layers tall a stroke places. H toggles "hollow" drawing, and O toggles overwrite mode (shapes can replace existing blocks rather than only filling empty space).

Colors are picked from the two palette rows at the bottom. Keys 1–8 set the primary color, Shift+1–8 set the secondary. X swaps them. C opens a full color picker. E eyedrops a color off an existing block. 

L marks the current color as a light emitter — blocks placed in that color will glow and cast light.

Ctrl+Z / Ctrl+Y to undo and redo.

Selecting and copying

In Build or Paint mode, press V to enter selection mode. Drag to draw a rectangular volume around what you want. Handles on each face let you resize it. Arrow keys move the selection in X/Z; Page Up/Down move it in Y.

Ctrl+C copies the selection to your clipboard as plain text. You can paste it into a chat message or your notes and share it with anyone.

Ctrl+V enters paste mode. A ghost preview follows your cursor and snaps to the terrain. [/] adjust a vertical  offset. Q/E rotate it. Left-click to stamp it down. Esc cancels.

Painting

Paint mode (P) recolors blocks in place without removing them. Same color controls and brushes as Build. L toggles  emitter state on the target block. V enters selection mode here too, and painting will be restricted to the selected area.

Tokens

Switch to GM mode (G) and pick the Token tool from the shelf. Left-click the ground to place a token.

Ctrl-click a token to get its context menu — rename, edit size and image, toggle a light, add conditions, or delete it.

The Edit Token dialog sets the name, footprint size (1 = 1×1, 2 = 3×3, 3 = 5×5), height, vision range, a light radius and color, and an image file for the standee.

Y opens the token list panel on the right. Click any token there to jump to it.

In the Move sub-tool you can drag tokens around. In Select (the default GM sub-tool) clicking a token shows its point-of-view without risk of accidentally dragging it.

Fog of war

Fog is GM-controlled. In GM mode, the Fog sub-tool lets you drag a rectangle to reveal an area, or Shift-drag to  hide it. [/] adjust how many layers tall the reveal goes.

Tokens set as observers automatically compute 3D line-of-sight every time they move. Areas they can see are fully revealed, areas they've visited before can be set to get partial or full fog, and areas they've never seen can also get partial or full fog. Mix and match depending the scene and your campaign.

Shift+V (in GM mode) reveals everything. Ctrl+H hides everything. Ctrl+G toggles between the GM's full view and  the players' fog view.

The currently explored area for each team is saved with the scene.

Lighting

Lighting updates automatically when you place emitter blocks or move tokens that carry a light. Ctrl+L toggles fullbright (useful while building, turns off the lighting simulation entirely).

Rulers

R enters Ruler mode. Click a start point and drag to measure distance in feet along the floor. K locks the ruler in place so you can keep it visible while doing things in other modes.

Reference images (GM only)

I enters Images mode. Use the Import button on the shelf to bring in a PNG or JPG — it drops into the scene as a flat plane you can move, resize, and set opacity on. Useful for battle map underlays or GM notes you want to trace over. Images can also be directly converted into voxels, with an optional displacement map.

Scenes and saving

Ctrl+S saves the scene. Autosave runs in the background. Tab opens the scene panel where you can add, rename, switch, or delete scenes within the current campaign.

Multiplayer

The host always has full permissions. Players who join have no build permissions by default — the host grants them via the Players tab in the top bar (checkboxes per player). All block and token changes replicate to everyone in real time.

Fog of war is shared between tokens that are set to the same team, and players can be granted permission to see and/or move any or all teams in the Players tab.