VoxelWeave 织界

Put Axiom and VoxelWeave in your client’s mods folder and start the game. Enter a world, then press Right Shift to open Axiom. Look for the VoxelWeave icons on the toolbar; hover over an icon to see its name.

Brush or modeling: what changes?

1. Choose an asset. Brush → Personal → Group → 官方预设_原版树林 (Vanilla Forest) . It contains vanilla-generated oak, birch, spruce, acacia and cherry trees.
2. Set the parameters. Radius 30 , spacing 12 , count 8 , distribution Uniform . Start small so you can see what is happening.
3. Check the ghost. Point at loaded ground. The trees follow your cursor as ghosts; the world has not changed yet.
4. Right-click to paint. Wait for one stroke to finish before starting the next. Each stroke uses a new random seed, so successive strokes look different.
5. Undo. Use Axiom’s undo, usually Ctrl + Z , to remove the whole stroke. If nothing happens, click empty space in the node graph; a text field may have keyboard focus.

Why eight requested trees can become five

This top-down simulation shows the radius as a dashed circle and spacing around each point. Reduce the radius or increase spacing to see the placement count change.

Only need one? Switch to Single. It places one asset at a time, so count and spacing are hidden.

Brush nodes Click to enlarge

VoxelWeave saves four kinds of content. Singles store blocks, groups and clusters store asset-selection recipes, and programs store entire modeling graphs.

Build it

1. Select Single in the left node list and add two different trees. You can also right-click empty graph space to open the add menu.
2. Add a Group, connect each tree to a separate group input, then connect the group to Output.
3. Select the group and adjust member weights. 300 and 100 mean the first appears more often, not an exact three-to-one ratio in every stroke.
4. If needed, add processing nodes on the path to Output (see below).
5. Click Save to Personal. To share, choose Save to Server (Public); see Save and share 。

Try it here first. Each Next step connects another node so you can see the result take shape.

Now try it in the game

1. Load the preset. Open Modeling. In the program menu, choose Official Presets (Personal Only) → “Example 1 · Terraced Hills”. Its four nodes are already connected.
2. Choose a location. Point at the ground and right-click to pin the ghost.
3. Adjust the terraces. Select Terrace Height. Change its step from 3 to 1, then 4. Larger values make stronger terraces.
4. Adjust the relief. In Height Noise, change one setting at a time: amplitude controls height variation, scale controls hill width, and base height lifts everything.
5. Adjust position and size. Fine-tune the anchor with X/Y/Z, choosing the center or a corner in the menu. Width X, depth Z and height Y are independent; proportions are not locked.
6. Place it. Once the ghost has updated, press Enter or click Apply. To undo, use Ctrl + Z。

Right-click paints in Brush, but only pins the location in Modeling. Check the instructions on the left when switching tools.

Modeling nodes Click to enlarge

Keep the mountain and change only its processing node. Select a node, adjust parameters and compare with the original. Slider ranges match the game. These simplified algorithms show the same tendencies, not identical terrain.

Match port types: height to height, material to material. Different types need a conversion node.

Try the mountain below. You control where stone is selected. Transition areas mix sandstone and stone blocks by proportion, rather than blending their colors, just as in the game.

Wire it up in the game

1. Connect Continuous Height Noise to Continuous Field Terrain to create the shape. Also connect the same field to World Slope Weight to compute slope.
2. Add two Block Material nodes: sandstone (A) and stone (B). Connect A, B and the slope weight to Weighted Material Mix.
3. Connect the terrain and mixed material to Apply Material, then Output.
4. Set minimum slope 30, maximum 90, feather 5. Above 30° selects stone, below 25° stays sandstone, and the interval between mixes both.

Switch to height bands

Replace World Slope Weight with World Height Weight on the same field. With Y min 78, max 86, feather 4, 78–86 is stone, 74–78 and 86–90 are mixed, and the rest is sandstone. This selects a band, not “higher means more B”. To cover the summit, set max Y above it.

These are world coordinates. Moving the terrain vertically changes where the band crosses it. Entering 78 in the UI means 78 blocks.

Make the transition more distinct

Insert Weight Remap before the material mix. The input range selects part of the original weights; the output range sets their strength: 0% selects A, 100% selects B. Invert Weight swaps them.

Drag sliders or enter exact values; confirm with Enter or by leaving the field. Right-click a parameter to copy, paste or reset its default.

Shape first, material second. Slabs and stairs change geometry; Surface Paint changes only material. This cutaway exposes the interior.

Six block families support slabs and stairs: stone, sandstone, cobblestone, stone bricks, bricks and oak planks. The grass palette uses stone for refined areas. These nodes accept terrain plans, not tree or house instance plans.

Use a small area while experimenting. Small previews are solid; large ones may show only surfaces. Place the result and inspect front and sides before judging the interior.

Modeling placements answer two questions: what to place (asset source) and where to place it (point set). Instantiate joins them, placing once per point. Try changing the asset and the points independently below.

1. Add Asset Source and choose a single, group or cluster from a personal or server library.
2. Add a point node: Grid, Path or Ring for regular layouts; Brush Distribution for brush-like controls.
3. Connect the source and points to Instantiate, then Output. For several different sources, build separate branches and join them with Merge Instance Plans.
4. Adjust point parameters and watch the ghost. Moving or spreading points changes positions, not asset sizes.
5. Save the program to keep connections, parameters and asset references.

If the layout cannot fit, the game rejects the values, explains why and keeps the previous ones. Reduce count or spacing. Brush Distribution accepts center points and an area mask; all centers share one count limit.

Save locally

Use Save to Personal in Brush, or Save Program in Modeling. Files go in the Axiom blueprint directory’s VoxelWeave folder, normally at config/axiom/blueprints/VoxelWeave . It is created on first use. If you moved Axiom’s blueprint folder, use its actual location.

• Saving again updates the current program and keeps older versions in history.
• A new program with the same name asks which one to overwrite or lets you save a numbered copy.
• Right-click a program in the list to rename or delete it. Deleted files move to VoxelWeave/.trash/models instead of being erased immediately.

Sharing local BPs with Axiom

1. Put native BP files in the local blueprint library’s VoxelWeave subfolder, then refresh both libraries.
2. Check that the single previews and places correctly before using it in a group or program.
3. Convert SCH files to BP through Import / Convert in the asset library. Keep the originals and check blocks and orientation afterward.

Axiom cannot read groups, clusters or programs even in the same folder as BPs. To turn a program’s result into BP, place it in the world, then select and save it with Axiom.

Uploading to the server means publishing

On a server with the matching plugin, choose Save to Server (Public). Before doing so, know these three things:

Browse the server library by type or search asset names, player names or UUIDs. Reference a result in your brush or program to continue building.

Asset library Click to enlarge

Be specific: “Make low terraced hills, sandstone on flat areas and stone on steep slopes.” You can edit the resulting draft like any hand-built graph. You still confirm placement yourself.

Configure the API in the game

1. Enter an editable single-player world or a paired server. In the AI panel, fill endpoint, model and key. Use the full Chat Completions endpoint, usually ending in /chat/completions .
2. Save the API settings, then describe the desired size, materials and shape.
3. Click Review Payload and inspect what will be sent. Then confirm sending; the provider may charge for the request.
4. When the draft arrives, click Accept to add it to Modeling. If it uses assets, bind the desired source locally first.
5. Inspect the ghost, adjust parameters, then place with Enter Place it.

Connect an external agent over MCP

1. Enter a world and click MCP On in the AI panel. Enable Allow Agent to Edit Local Graph/Preview for direct editing; otherwise it can only submit drafts for review.
2. Copy the MCP address. Add an HTTP server in your agent’s MCP settings with that URL and authorization header. Keep the token out of chats and game servers.
3. Ask the agent to read the current world and graph first, then describe your goal. You can copy the request below.
4. Return to the game, inspect and adjust the ghost, then press Enter or click Apply.

AI panel Click to enlarge

Start with common nodes and wire a simple chain. Later, browse the game’s categories or search for what you want to do.