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
- Requirements: ZunCAD is made for Chrome or Edge (latest version) on a computer, used with a mouse and keyboard. Firefox and other browsers also work, but "Save" downloads a new file every time instead of overwriting (see "Drawing files"). It cannot be operated on phones or tablets (a notice appears if you open it there)
- 3D assumes that hardware acceleration (GPU use) is turned on in the browser. If it is off, zooming in becomes slow (a notice appears under the 3D heading)
- The first time you open ZunCAD, a dialog introduces the basics and the templates. You can open it anytime from "Getting started" in the toolbar
- Choose the display language (日本語 / English / 简体中文) in the selector at the right end of the toolbar (the browser language is used at first). Switching saves the drawing and reloads the page. Building and block names follow the game's English and Chinese text. Drawing files open the same way in every language
- Templates (finished examples) can be opened from "Getting started" or "New": a flatland castle and town (64×64), and a hill castle and town with up to a third bailey (96×96). Once opened, they are ordinary drawings you can change freely
- To start from a castle you built in the game, use "Import from a game save" in "Getting started" (same as "Import from game" in the toolbar). See "Importing from a game save"
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
- Roads cannot be laid on air or water, or on surfaces with blocks or buildings above. A road disappears when you place a block on it or erase the block below it
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")
- As in the game, blocks cannot be placed on buildings (in any column directly above them), and buildings cannot be placed where there are blocks above
- Every cell under a building must rest on a surface of the same height (a block or the top of another building). Buildings cannot be placed over steps or where part of them would float (the same applies to moving, rotating and pasting). Buildings in drawings you open or import from the game are kept as they are
- Tiles with a dotted frame are buildings with placement conditions (Ports go on water, quarries on dirt or sand, etc.)
- Buildings that affect buildings around them, such as Port, L-Shaped House, Shrine and Farmhouse, show their effect range as a circle from the building center when hovered, placed from the palette or moved. Turn on "Show all effect ranges" in the sidebar to show the ranges of all buildings faintly. The radius is also shown in the tile tooltip and the status bar
- Transport network: in plans imported from a game save, what each Transporter carries and where is shown as an arrow from the Transporter to the destination building (the item is written in the middle of the line; items whose names are unknown are shown as "Item #number"). After the item comes the amount carried per trip (such as "Rice 30/trip": the Transporter's level × 30), and the arrow gets thicker with a higher level (re-import plans imported earlier to see this). In the production settings of production buildings, the transport destination is shown as a white "Ships to" arrow (from the building to the destination) and the material storage as a brown "Procures from" arrow (from the storage to the building) (the save does not record the items, so no names are shown; only when the
..txtfile is selected for import). Use "Transporter routes" and "Production ships to / procures from" below "Show transport network" to hide each kind of arrow (turn off "Transporter routes" to see only production buildings; those of the hovered building are still shown). Hover a Transporter to highlight its transport and the collection range (circle); hover a destination to highlight the transports delivered there. The status bar also shows what a Transporter carries and where, or what a destination receives. The highlighted lines flow as dotted lines from the Transporter to the destination; turn on "Animate the flow" below it to make every line flow. Turn off "Show transport network" in the sidebar to show only the transports of the hovered building. If the destination is outside the imported area, the line is dotted. Transport settings are saved in the plan file (they cannot be changed in ZunCAD and are not copied with area copy and paste) - The 3D preview shows buildings with approximate shapes and heights (the Keep has 5 tiers and height 10, towers are as tall as their number of stories, shops and houses have roofs, fields are flat). This is only for looks; for placement every building has height 1
- Gates (Kabuki-mon, Mune-mon, Korai-mon and their small versions, and Yagura-mon) are drawn with posts and double doors, and a thick line marks the door position in the plan. R also changes the door direction of square gates (passes north-south / passes east-west)
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
- Pasting does not overwrite with air. It pastes onto the current layer, keeping the same position relative to the layer you copied from
- Copying, cutting and pasting a range also copies the comments that point inside the range
Drawing files
- "Save" writes a
.zcastle.jsonfile, and "Open" reads one. The drawing you are editing is also saved automatically in the browser - In Chrome and Edge, "Save" overwrites the file you opened with "Open" or saved once (the first save asks where to save; if asked for permission to overwrite, allow it). To save to another file, use "Save as". When a new drawing starts (New, a template, an import or Clear all), the file to overwrite is forgotten. After reloading the page, the first save also asks where to save. In browsers that cannot overwrite (such as Firefox), every save is written as a download
- "Clear all" in the layer bar recreates the drawing at the same size. The ground thickness and surface block are the ones last set in "New" (grassland 4 thick if never set). Buildings are removed too. A confirmation dialog appears. It cannot be undone, so save first if needed
- "Export PNG" turns the plan you are viewing (the layer in section view, or the top view) into an image
Sharing
- "Share" on the toolbar creates a URL to share the drawing. It saves the drawing and an image on the server and gives you a
https://zuncad.seazus-dev.workers.dev/s/…URL. "Post on X" opens the X post screen right away - The image is taken from the 3D view at the moment you press it (the plan view when 3D is paused). It appears when you post the URL on X, etc. To change the view, cancel, move the 3D view, and press "Share" again
- Anyone with the URL can see the drawing. People who open it can remake it as their own, but the shared drawing does not change. Changing your drawing after sharing does not change what was shared (sharing again creates a new URL)
- Opening a shared URL opens that drawing. If you have a drawing in progress in the browser, you are asked before it is replaced
- You can delete shared drawings from the list in the "Share" dialog. You can only delete drawings shared from that browser (it keeps the delete keys; clearing the browser data makes them undeletable). If you cannot delete a drawing, for example because you shared it from another browser or cleared the browser data, ask the author to delete it (X: @seazus_dev), including the shared URL (
https://zuncad.seazus-dev.workers.dev/s/…) - Inappropriate content may be deleted without notice. If you find any, please let the author know (X: @seazus_dev)
Importing from a game save
- "Import from game" in the toolbar turns terrain, water, grass, roads and buildings from the game save data into a drawing. The current drawing is replaced
- Saves are in
%APPDATA%\KiritanCastle. Select the four files that start with the same name together:_terrain.vm,_water.vm,.yamland..txt(autosaves start with_auto_save<number>). The terrain file_terrain.vmalone can also be imported - A map of the whole world appears so you can choose the area to import. Drag inside the yellow frame to move the area, and drag its edges or corners to resize it (you can also enter numbers). Clicking outside the frame centers the area there (keep dragging to move it). At first it is 128×128 cells centered on your home base (if the open plan was imported from the same map, the same area as that plan; "Same area as this plan" brings it back at any time. Importing your latest save while your design plan is open gives the same area. If the open plan was imported with an older version and has no recorded position, "Find this plan on the map" finds it by matching the terrain and records it in the plan). A larger area makes the drawing heavier
- "Import buildings" and "Import trees" can be chosen separately. Buildings on the edge of the area are not imported. Buildings missing from ZunCAD's list (such as ones added by game updates) have unknown sizes, so they are placed on their center cell as 1×1 "Size only" buildings named after the game building. If needed, place them again at the correct size with "Size only" in the palette (the counts of both are reported after importing). Building levels are imported too and shown in the status bar (such as "Lv 20") when you hover a building. In the plan view, buildings of level 2 or higher show their level in a small tag at the bottom right (only when zoomed in; toggle with "Building levels" in the sidebar)
- Saves do not tell blocks placed in the game apart from the original landscape, so everything becomes original terrain (except Ishigaki and Foundation Stone). Sand is imported as dirt, and basalt pavements as Stone Pavement. Stairs of each material (rock stairs such as basalt and granite, dirt stairs such as andosol) are imported as stone stairs or dirt stairs
- If the open drawing was imported from the same country, its comments are moved to the same map positions in the new drawing (comments that end up outside the range are removed)
About this tool
- ZunCAD is an unofficial tool made by a fan as a personal project. It has no connection with the developer of the original game, "Sengoku Voxel Castle With Zundamon" (KC Project), or anyone involved with it
- Please do not contact the original game's developer about this tool. Send feedback and bug reports to the author, Seazus (X: @seazus_dev)
- The rights to the game title, character names, building names and so on belong to their respective owners. The building list, block colors, etc. are based on the game and may differ from the actual game
- Importing from a game save only reads the save files and never writes to them. However, if a game update changes the save format, importing may stop working correctly
- All features of ZunCAD are free to use. If you like it, support for its development through OFUSE (Seazus) would be very encouraging
- This tool comes with no warranty. The author cannot be responsible if drawings are lost or damaged, so write important drawings to a file with "Save"