Canvas Studio+

## v3.1.2 — The Bigger Paintings Update
**Released 13 October 2026 · Minecraft 26.2 / 26.3 · NeoForge**

Take your artwork beyond a single block. v3.1.2 adds wall paintings from **1×1 up to 8×8 blocks**, with both square and rectangular layouts, while retaining the complete v3.1.0 studio, finder, saved-painting editor and Kurlo Pillow.

### 🖼️ Adjustable wall painting sizes

- Adds **Painting size** to the editor's **Studio menu**.
- Choose width and height independently from **1 to 8 blocks**: all 64 combinations are supported.
- **Keep square** links both dimensions; turn it off for rectangles such as 2×3, 4×2 or 8×4.
- **Reset to 1×1** returns to the original display size.
- The editor footer shows the selected wall dimensions.
- **Save Painting** or **Save edited painting** applies those dimensions to the resulting map.

Artwork remains **128×128 pixels** and scales to fill the selected wall area. Rectangular display sizes stretch the square artwork; this update does not add a higher-resolution pixel canvas.

### 🧱 Placement across multiple blocks

Click the wall at the painting's **lower-left corner as viewed from the front**. It expands **upward and to your right**.

The server checks the complete area for loaded chunks, wall support, placement/build permission, collision clearance and overlapping hanging decorations. Failed placement does not consume the held map.

Rendering and the physical hit box use the selected width and height. Scaling applies to the wall-plane axes while retaining normal depth and Minecraft's native map orientation/rotation. The renderer neutralizes vanilla's offset cancellation so taller paintings stay centered on their enlarged bounds.

Frameless placement, artwork rotation and normal survival pickup/drop behavior remain available.

### 💾 Sizes travel with your artwork

- Wall dimensions are stored on the saved map in the registered `canvasstudio:painting_size` data component.
- Placed paintings synchronize their dimensions to clients and store them with entity save data.
- Picking up a painting retains its chosen size on the map.
- Opening a saved painting restores its size in the editor.
- Saving an edited painting can resize it as well as change its pixels; other copies of the original map remain unchanged.
- **CSP project format 3** stores wall width and height alongside the existing layers and editor settings.
- Existing format-1/format-2 projects and paintings without size data default to **1×1**.
- Invalid or truncated project dimensions are rejected; the maximum remains 8 blocks per side.

Vanilla item frames continue to show a normal one-block map. Large displays use Canvas Studio+'s direct wall-placement feature.

### 🛠️ Server validation and upgrade behavior

Save and painting-edit transfer packets carry the display dimensions. The server validates the 1–8 bounds before accepting a save, and placement is server-controlled.

**Network protocol changes from 4 to 5.** Update client and server to the same v3.1.2 edition. Remove the older Canvas Studio JAR before installing its replacement.

Existing maps, canvas/quill IDs, crafting recipes, creative-tab items, reward rules, Infinity counters and the Kurlo Pillow are retained. No new crafting ingredient is required to select a painting size.

### 🧪 Verification and release coverage

Both Minecraft editions passed **13 Java verification suites**, packaged-artifact checks and builds on their default and tested endpoint dependencies:

| Minecraft edition | Default build target | Tested endpoints | Published NeoForge API/range audit |
|---|---|---|---|
| 26.3 | 26.3.0.51-beta | 26.3.0.0-beta and 26.3.0.76 | 75 builds |
| 26.2 | 26.2.0.88 | 26.2.0.0-beta and 26.2.0.90 | 91 builds |

New checks enumerate all **64 sizes in all four horizontal wall directions**, covering occupied tiles, placement anchors, physical bounds, wall thickness and production rendering plane transforms. They also verify persistent/network codecs, invalid/truncated sizes, project-format migration, copied artwork dimensions and save/edit packet roundtrips.

These results are automated and headless. **No interactive Minecraft rendering, actual wall placement, multiplayer session or live world save/reload test was performed.** API audits verify referenced binary-member availability; they do not guarantee future loader behavior.

**Release files:** [Minecraft 26.3](https://github.com/SupremeGenZ-Github/Canvas-Studio/releases/tag/v3.1.2) · [Minecraft 26.2](https://github.com/SupremeGenZ-Github/Canvas-Studio/releases/tag/v3.1.2-mc26.2)