ZunCAD Help

ZunCAD (Zunda Castle Architect & Designer) is an unofficial fan tool for designing castles and castle towns for "Sengoku Voxel Castle With Zundamon" (About this tool).
Original game (KC Project): Sengoku Voxel Castle With Zundamon (Steam)

Getting started

Mouse

Left-drag
Draw with the selected tool
Right-drag
Eraser (with any tool). While an area is selected, right-click clears the selection, and while the pen size is changed (yellow dotted box), right-click resets it to 1×1×1 (both same as Esc)
Middle-drag / Space+drag
Move the plan
Wheel
Zoom in and out
Ctrl+wheel
Move the layer up or down (scroll up for the upper layer)
Sidebar headings
Click the "Tools", "Blocks & roads", "View" or "Comments" heading to collapse that section (click again to expand; collapsed sections are remembered in the browser)

In the 3D preview, left-drag rotates the view, right-drag moves it, and the wheel zooms toward the cursor (the camera never goes below the ground, and the view is drawn a little coarser while it moves). "Reset view" returns to the initial view. The cell under the cursor in the plan is also shown in 3D with a white frame (in top view, at the top block of that column; in section view, at the height of the current layer). "Pause 3D" stops drawing 3D and frees GPU memory. Use it when the PC becomes heavy while running the game at the same time (for example, when loading a save in the game stalls). The browser remembers whether 3D is paused; "Resume 3D" draws it again.

Tools

B Pen
Place the selected block. As in the game, you can change the size you place: each press of Shift stacks one more level, → / ← change the width and ↑ / ↓ the depth by one cell (it grows to the right and up on screen from the cell under the cursor, even when the plan is rotated). The area is outlined with a yellow dotted line and the size is shown in the status bar. Esc resets it to 1×1×1. In top view blocks are stacked on top of each column; in section, from the current layer. While width or depth is changed, the brush size is not used
Drop floating blocks
A sidebar setting (on at first). With Pen, Line and Rectangle, a block placed on a cell with air below drops onto the surface below (the game does not allow floating blocks). Turn it off when you want to draw freely, such as overhanging roofs
E Eraser
Erase what you see: the block on the current layer if there is one, or the road underfoot on an air cell
L Line
Drag to draw a line
R Rectangle
Drag to draw a rectangle (choose whether to fill it in the sidebar)
F Fill
Fill the connected area of the same block
T Terrain
Set the ground height to the current layer (raise or dig). The surface becomes the selected block, and the dirt filled in below is of the same kind as the surface (original terrain or placed block)
I Eyedropper
Select the block of the clicked cell (or the road, if the visible surface is a road)
M Select
Drag to select an area (for copy and cut)
K Measure
Measure the length from the clicked cell to the cell you drag to (the drawing is not changed). Shows the number of cells east-west and north-south (including both ends), the distance between cell centers when diagonal, and the ground height difference in top view, on the plan and in the status bar. A diagonal measurement is framed by a dotted rectangle. The result stays until you switch to another tool or press Esc. The size is also shown while dragging with Line, Rectangle and Select
C Comment
Write speech-bubble comments (notes) on the plan. Click to open an input box, type, and press Enter to save (Shift+Enter for a new line, Esc to cancel). Pick one of 5 colors. Click a comment to edit it, drag to move it, right-click to delete it (emptying the text also deletes it). A comment points at a cell (the top of the column in top view, the current layer in cross-section) and does not follow buildings when they move. The bubble shows the first line; hover to see the whole text. In cross-section, only comments between the visible surface and the current layer are shown as bubbles; others appear as faint dots. Bubbles are also shown in 3D. Use "Comments" in the sidebar to show or hide them, and click an item in the list to jump there (in cross-section the layer also moves to the comment's height). Comments are included when you share a drawing.
Protect: check "Protect" in the input box, or click 🔓 in the sidebar list (the bubble gets a 🔒). A protected comment cannot be edited by clicking, moved by dragging or deleted by right-clicking, and is kept when you cut a range or clear all. If it ends up outside the range when re-importing from the game, it is moved to the edge of the drawing instead of being removed. To edit it, click 🔒 in the list to remove the protection

Blocks & roads

Blocks
Dirt, Grassy Dirt, Rock, Ore, Water, Ishigaki and Foundation Stone (only the game blocks needed for drawings). Ore is what you mine with a Mine Shaft (Mabu); it is split into Copper ore (copper color), Silver ore (silver color), Gold ore (gold color), Lead ore (bluish gray) and Sulfur (yellow) (ore in drawings imported earlier stays as ore of unknown type (purple)). Ore cannot be placed in the game, so it only appears when imported from a game save (it is not in the palette and cannot be picked with the Eyedropper)
Original terrain and placed blocks
Dirt, Grassy Dirt, Rock and Water are split into "Original terrain" and "Placed blocks" in the palette. Use original terrain to copy the existing landscape, and placed blocks for what you place in the game (which costs resources). Placed blocks have a dotted pattern in the plan and in 3D. Ishigaki and Foundation Stone always count as placed blocks
Totals
The totals in the sidebar count placed blocks (placed Dirt, Grassy Dirt, Rock and Water, plus Ishigaki and Foundation Stone) separately from original terrain. The ground of a new drawing, and the dirt, grass, rock and water in drawings from earlier versions, are original terrain
Roads
Roads are not placed as blocks; they turn the top of the block underfoot into a road (as in the game). In section view, they are laid on the block one level below the current layer (the ground you would stand on at that layer; in a hole, the surface further below). In top view, they can be laid on the top surface of each column
Road types
Dirt Road, Gravel Road and Stone Pavement
Tools for roads
Pen, Line, Rectangle and Fill (the connected area of the same block on the surface underfoot). With the Pen, as with blocks, → / ← change the width and ↑ / ↓ the depth so you can lay a wider area at once (no height; Esc or right-click resets to 1×1)
Removing roads
With the Eraser or right-drag, tracing air cells removes the road underfoot ("Remove" in the game). In top view, the road on top of the column is removed, and on cells without a road the top block is erased (the same while a road is selected)
How roads look
In the plan, the inside of the cell shows the road color and the border shows the block below. In 3D, roads are drawn as a thin plate on the top surface
Dig (Leveling)
When you choose "Dig" under "Leveling" in the palette, instead of placing blocks, dirt, grassy dirt, rock, ore, water, ishigaki and foundation stones at and above the current layer are removed (the top of the ground becomes one level below the current layer; lower places are left as they are). Pen, Line and Rectangle dig the traced area, and Fill digs the connected area of the same block on the current layer. In top view, digging starts not at the current layer but at the top block of the cell where the operation starts (the cell under the cursor). Each click digs one level deeper, and a dragged area is leveled to that height (lower places are left as they are). Fill also works. With the Pen you can change the size as with blocks: each press of Shift digs one more level deep, and → / ← change the width, ↑ / ↓ the depth (Esc resets to 1×1×1). Columns with buildings on them are not dug. If there is ore in the area to dig, you are asked whether to dig the ore too (cancel to undo that operation; the same applies when the Terrain tool removes ore). It can be undone

Keyboard

WASD
Move the plan
[ ] / PageDown PageUp
Move the layer down / up
V
Switch between top view (the view at startup) and section (layer). In top view, blocks placed with Pen, Line and Rectangle are stacked on top of each column, and the Eraser or right-drag erases the top block of each column (one level per drag, no matter how many times you trace). If the top block has a road on it, the road is erased first and the block on the next pass. Fill repaints the visible cells of the same connected block at the ground height of the clicked cell (up to where other blocks or ground at a different height surround it). With placed blocks, Ishigaki and foundation stones, it stacks one level on top of those cells instead of repainting them
G
Show or hide the grid ("Contour lines" in the sidebar toggles lines where the visible height changes between neighboring cells; differences of 2 or more levels are thick lines; they are not drawn when zoomed out so that cells are small)
Show ore veins
"Show ore veins" in the sidebar (on by default) marks columns with ore below the surface in top view with a diamond (in the color of the shallowest ore in that column: copper for Copper ore, silver for Silver ore, gold for Gold ore, bluish gray for Lead ore, yellow for Sulfur, purple for ore of unknown type). Marks that overlap buildings are hidden by the buildings; turn on "Also over buildings" below it (off by default) to draw marks on top of buildings too. Hovering a mark shows the number of ores of each type and how many levels below the surface they are in the status bar (also over buildings). Useful for deciding where to put a Mine Shaft. To dig there, switch to section view and lower the layer
Home
Fit (show the whole drawing)
Q / Shift+Q
Rotate the plan by 90° (the other way with Shift). The direction at the top changes north → east → south → west, and "E ↑" etc. is shown at the top right. "Rotate" in the layer bar does the same. Only the display rotates, so directions in the drawing and of buildings (such as the north side of a wall or rotating with R) are still named by the compass. The browser remembers the chosen direction, and Export PNG also uses it. The 3D view turns along with it, so the direction at the top of the plan is at the back (Reset view uses it too)
Ctrl+Z
Undo
Ctrl+Y / Ctrl+Shift+Z
Redo
Ctrl+S
Save the drawing file (overwrites the file you opened or saved)
Ctrl+Shift+S
Save as
Esc
Cancel pasting, selection or dragging a building

Buildings

Palette (below the plan)
Choose "Defense structure / Production structure / Stairs & bridges / Size only" in the upper row, and the category in the lower row. Searching by name looks through all categories. ▼ collapses it
Placing
Drag a tile onto the plan. In section view, the building goes on the current layer; if there is a block underfoot (such as ishigaki), it is placed on top of it. If there is air underfoot, it drops onto the surface below (ground, block or another building). In top view, it is placed on the highest surface underfoot. When moving or rotating leaves air underfoot it also drops, and when the destination is 2 or more levels higher it is raised on top
R
Rotate while dragging a building or when the cursor is over one. Stairs, bridges and walls change direction. Shrine, L-Shaped House and Transporter turn their front south → west → north → east (the status bar shows which way the front faces)
Number keys (hotbar)
Assign up to 10 frequently used buildings, blocks, roads or Dig to the hotbar below the plan, and use them with 1–9, 0 or a click. To assign: hover an item in the palette and press Shift+number, or drag a building from the palette onto a slot (a building attached to the mouse can also be assigned with Shift+number). Right-click a slot to clear it. A building follows the mouse, and a click places it. You keep holding it after placing, so you can place as many as you like. Dragging places them in a line from where you press to where you release (handy for walls and wooden fences; overlapping or unbuildable cells are skipped; one undo removes the whole line) (R rotates; press the same key again, right-click or Esc to stop; clicking outside the plan also stops; size-only buildings, which need a name, stop after one). Blocks, roads and Dig switch what you hold, and switch to the Pen if you had the Eraser, Select, etc. The browser remembers the assignments (not per drawing)
Walls
Wooden Fence, Wooden Wall, Earth Wall and Plaster Wall (including slot walls) are drawn half a cell thick, and L-shaped ones along two sides of the cell. R turns them clockwise (walls: north side → east side → south side → west side; L-shaped: north and west → east and north → south and east → west and south)
Stairs & bridges
Placed as 1×1 buildings. Stairs (dirt and stone, height 1 and 2) show the climbing direction with an arrow, and bridges (height 1–3, including the Vermilion Bridge) show the crossing direction with two lines. Bridges are placed on water
Drag
Move a placed building (the cursor becomes the move shape ✥ over buildings you can grab; buildings cannot be moved with the Select tool or while pasting)
Double-click
Rename (blank shows the building name). "Size only" buildings ask for a name right after placing
Right-click
Delete
Ctrl+C → Ctrl+V
Press Ctrl+C over a building to copy it, then hover another place and press Ctrl+V to place it there (with the same direction and name; the height is decided the same way as placing from the palette). You can paste it any number of times. Blocks and roads can be copied the same way (see "Copy & paste")

Copy & paste

Ctrl+C / X
Copy or cut the selected area. The vertical range follows "Selection height" in the sidebar (Current layer only / Current layer and above / All layers). Roads on top of the level just below the area (the roads underfoot you see in section view) are copied or cut too (the blocks underfoot themselves are not)
Copy a single item
When no area is selected, Ctrl+C copies the one building, block or road under the cursor, and Ctrl+V places it at the cursor right away (blocks are placed like the Pen, roads like the road Pen). In section view, it picks what you see in this order: a shown building → a block on the current layer → a building on a lower layer → the road underfoot → the block underfoot
Ctrl+V (for areas)
Paste mode. Click to paste (repeatable). R rotates, Esc or right-click finishes

Drawing files

Sharing

Importing from a game save

About this tool