Canvas Studio+

# Canvas Studio+ · Changelog

## v3.2.2 — Reopen & Edit

- Added a reopening menu for saved/placed locked paintings: **Edit keeping locked**, **Unlock & edit**, or **Cancel**. Shift-right-click a wall painting, or a held saved map in either hand, to reopen it.
- Added immediate server-authorized unlocking of an existing painting. Owners/admins can reopen and edit after saving/locking; other players retain the existing permission restrictions. Public editors cannot relock another owner's painting.
- Unlocking preserves artwork pixels, original map IDs, animation, size, name, layout and material frame. It consumes no canvas or resource; same-frame edits remain free under v3.2.1 rules.
- Access changes persist before replacement, advance revision and issue a fresh edit capability. Expired/wrong-hand/stale-map/replayed unlock requests cannot change access, and persistence failure leaves the original item and lock intact.
- Reopening now reads access settings from the actual saved item rather than shared source-file display settings, preserving independent locks on copies that share map pixels.
- Renamed editor access controls to **Lock painting on save** / **Unlock painting on save** and added an editing hint to newly saved map tooltips. Wall edits keep the painting placed.
- Added a seventeenth automated suite for access policy, immutable persistence, failure paths, preserved map/art/display metadata, old items, codecs and stale sessions. Both editions retain endpoint/API/server release gates; live gameplay/rendering is still untested.
- Network protocol 8 requires matching v3.2.2 clients/servers. Existing CSP/gallery formats, recipes/textures and all Material Frames/Living Gallery features remain. Credit: **made by SuprixZ**.

## v3.2.1 — Material Frames

- Added Stone, Copper, Amethyst, Lapis, Emerald, Quartz and Netherite borders alongside Wood, Iron, Gold and Diamond; each style has a distinct color.
- Applying/changing a frame now costs one corresponding plank, stone block, ingot, gem or shard per painting, regardless of wall size/animation count. The server checks inventory and consumes only after a successful save; Creative mode uses the same rule.
- The display screen cycles through all eleven materials plus None and shows the resource requirement and ready/missing status.
- Same-frame edits/resizes/animation changes are free. Existing v3.2.0 frame IDs/colors are preserved. Removal is free without refunds; reapplication costs again.
- Gallery/project imports retain the chosen design but require materials when saved as a new painting. Publishing, previewing, placing and picking up an existing painting have no additional frame cost.
- Kept both-hand/wall edit validation and upload replay protection; missing resources and failed persistence preserve the original painting and inventory materials.
- Extended frame codec range to 0–11 while preserving CSP4/CSA1 layouts. Network protocol 7 requires matching v3.2.1 clients/servers. Do not downgrade worlds/projects with new frame styles to v3.2.0.
- Added a sixteenth automated suite for material matching/payment, every old/new style transition, inventory regions, rejection/failure paths and old/new file/packet persistence. Default/endpoint builds, artifact checks, family audits and headless-server gates are recorded in release validation. Interactive gameplay/rendering remains untested.
- Preserved all Living Gallery features, existing crafting recipes, saved art and **made by SuprixZ** credit. Separate builds support Minecraft 26.2 / NeoForge 26.2.x and Minecraft 26.3 / NeoForge 26.3.x, including betas.

## Canvas Studio+ v3.2.0 — Living Gallery

**made by SuprixZ**

Living Gallery adds all seven requested features and access to Minecraft's existing paintings while retaining the v3.1.2 editor, 8×8 wall sizes, item finder, crafting progression and Kurlo Pillow.

## Placement and wall editing

Holding a locked map gives a translucent world preview with green/red support and collision feedback. It is local-only, non-pickable and never saved to the server world. Server permissions remain authoritative.

Shift-right-click a placed Canvas Studio painting to edit it directly. The server binds the session to the wall entity, dimension, hand, map identity, revision and a 20-minute deadline. Saving creates new map data and updates that entity; other copies retain their previous art. Invalid or obstructed resizing leaves the original painting in place.

## Display and access controls

Studio menu → Display / access selects Stretch, Fit or Crop and optional Wood, Gold, Iron or Diamond cosmetic borders. Fit preserves the square artwork's proportions within the physical rectangle; Crop fills the area by trimming source edges. Borders remain inside the painting bounds and require no extra crafting ingredients.

New paintings receive a server-owned creator UUID. Public paintings permit editing; locked paintings permit only the owner or an administrator with gamemaster permission to edit, rotate or remove them as a player. Only owners/admins may change the lock. Native environmental drop rules are retained.

## Animation and project files

Studio menu → Animation supports up to 16 frames, each retaining up to 16 editable layers and its fitted reference image. Add blank/copied frames, change the selected frame, delete, undo frame operations, preview playback and choose 0.5/1/2/4/8-second intervals. The fastest playback is 2 FPS, matching the bounded native-map synchronization design.

Animations use native locked map data and loop on the server clock. The item's small map-ID sequence persists and synchronizes; original palette frames are retained in the world's studio folder for later editing.

CSP format 4 stores animation/layer data and display settings, with an 8 MiB file cap. Formats 1–3 still import as static projects, retaining version-3 wall dimensions. Format 4 is not readable by older mod versions.

## Minecraft painting imports

Studio menu → Minecraft paintings reads the active painting registry and texture resources. Search by name/asset ID and import any available registered painting PNG into the active layer. Vanilla artwork is read from the installed game/resource packs, never bundled in the mod.

Hold a Canvas Studio canvas and Shift-right-click an existing vanilla painting to copy its registered texture into the editor. The original entity remains in place. Imported art uses Minecraft map colors and the normal 128×128 per-frame raster, with the variant's dimensions capped at 8×8.

The automated asset checks convert all 51 built-in painting textures. Missing/unavailable modded textures are omitted; resource-pack texture animation is not automatically converted into an editable timeline.

## Shared server gallery

Studio menu → Server art gallery supports browsing, publishing the current artwork, importing a selected entry and owner/admin deletion. Publishing shares flattened palette frames and display settings, not local paths, full-resolution files or editable layers. It creates no item reward and consumes no canvas. Imported artwork can be saved using a held canvas or authorized edit session.

Entries persist in the server world's studio folder. Limits are 64 entries per artist and 1,000 per world; enableServerGallery can disable the gallery. Each source file is bounded, uses managed IDs and rejects unsafe symlink targets. Include the studio folders in world backups alongside vanilla map data.

## Validation and compatibility

Transfers send one bounded 16 KiB palette frame per packet, under Minecraft's serverbound payload limit. Incomplete, reordered, duplicate, expired, changed-header and unauthorized uploads are rejected before a save. Completed uploads are replay-guarded; wall revisions reject stale edits.

Release gates include 15 Java verification suites, packaged artifact checks, default/endpoint builds, published NeoForge binary API/range audits and fresh headless server readiness/save/stop. New tests cover ownership, edit capabilities, transfer limits, all fit/layout sizes, actual rendering geometry, animation layers/CSP migration, gallery storage reload and native painting import.

No interactive Minecraft rendering, multiplayer gameplay or actual placed-painting save/reload was tested. Headless geometry and a ready dedicated server do not prove visual/gameplay behavior. Read the attached validation report and logs.

Use matching v3.2.0 client/server editions: network protocol 6 replaces protocol 5. Separate downloads target Minecraft 26.3/NeoForge 26.3.x and Minecraft 26.2/NeoForge 26.2.x, including beta builds. Future family builds are accepted by metadata, with future API changes requiring verification.

[26.3 release](https://github.com/SupremeGenZ-Github/Canvas-Studio/releases/tag/v3.2.0) · [26.2 release](https://github.com/SupremeGenZ-Github/Canvas-Studio/releases/tag/v3.2.0-mc26.2)

---

# Canvas Studio+ · Changelog

**made by SuprixZ**

Detailed release notes for the Minecraft 26.2 and 26.3 editions. Features are shared; download the JAR for your Minecraft version. Each release links to its source, validation and checksums.

- [v3.1.2 — The Bigger Paintings Update](#v312--the-bigger-paintings-update)
- [v3.1.0 — The Creative Studio Update](#v310--the-creative-studio-update)

---

## 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)

---

## v3.1.0 — The Creative Studio Update
**Released 12 October 2026 · Minecraft 26.2 / 26.3 · NeoForge**

v3.1.0 expands Canvas Studio+ into a fuller creative workspace: draw with more tools, keep editable layered projects, revisit saved paintings, browse an improved item catalogue and hang your artwork directly on walls. It also introduces the reusable **Kurlo Pillow**.

### 🎨 Drawing tools and editor controls

- **Redo joins Undo.** Revisit an undone stroke with Redo or Ctrl+Y. A complete stroke or shape counts as one history action, with up to 32 operations retained in memory. Starting a new edit clears the redo history.
- **More ways to draw:** brush, eraser, flood fill, straight line, outlined and filled rectangles, outlined and filled ellipses, eyedropper, dotted strokes, dashed strokes and spray.
- **Constrained shapes:** hold Shift for a constrained line, square or circle.
- **Mirror options:** draw symmetrically across the horizontal axis, vertical axis or both.
- **Grid and snapping:** align pixel art and shapes with selectable snapping and a visible grid at sufficiently enlarged scales.
- **Zoom and pan:** switch between 1×, 2× and 4× zoom; middle-drag to pan a zoomed canvas.
- **Palette presets:** Default, Grayscale and Retro 8, while final paintings continue to use Minecraft's map colors.
- **Keyboard shortcuts:** B for brush, E for eraser, I for eyedropper, G for grid, Ctrl+Z for Undo and Ctrl+Y for Redo. Drawing shortcuts are ignored while typing in text fields.
- **Dedicated Studio menu:** access import/export, projects, layers, previews, the finder and catalogue from the editor.

The existing 128×128 painting format, local PNG/JPEG import, fit/center-crop conversion and PNG export remain available.

### 🗂️ Editable projects, layers and recovery

- **Up to 16 named layers**, with visibility, selection, duplication, ordering, deletion and merge-down controls.
- Erasing an upper layer reveals the layers below it; visible layers are combined when saving a painting.
- **Local `.csp` project files** preserve editable layers and drawing settings, plus the fitted original image when one is available.
- **Project gallery** with thumbnails, paging, opening, renaming, duplicating, deleting and sharing. Browsing displays up to 200 valid projects.
- **Project sharing:** export a `.csp` copy or import a shared file through its path. Project files contain bounded artwork data, not executable scripts.
- **Recovery saving:** a reserved recovery project is saved approximately every 30 seconds while the editor is active and on closing. It is one local recovery slot shared across worlds.
- **Bounded project parsing and managed paths:** invalid, truncated and oversized files are rejected; managed project writes check for unsafe symlink targets.

**Save editable project** retains your working document. **Save Painting** produces the finished locked Minecraft map and replaces the held canvas. Saving a painting also replaces an Infinity Canvas; unlimited reuse applies to its item-reward mode.

### 🖼️ Edit paintings you already saved

Hold **one locked painting map** and **Shift-right-click in the air** to reopen its pixels in the editor. Older Canvas Studio paintings and other held locked maps can use this workflow.

Saving the edited painting creates a **new map in the same hand**. Other copies of the original map retain their original artwork. A saved map reopens as a single flattened layer; keep a `.csp` project if you want to preserve your layer structure.

Editing is authorized by the server and tied to the held map and hand. Editing sessions expire after 20 minutes, and map editing does not unlock Get Item rewards.

### 🧱 Frameless wall paintings

- **Hang a painting without an item frame:** right-click a vertical wall with a saved locked map, without sneaking.
- A custom hanging entity displays the map with **no visible frame or border**.
- **Right-click to rotate** the artwork.
- **Break to retrieve** the map under normal survival and entity-drop rules; creative behavior follows normal creative rules.
- Placed paintings use Minecraft's map synchronization and entity persistence.
- Placement checks wall support, clearance and build permission. Unsupported placement is rejected.

v3.1.0 wall paintings are **one block in size**. Adjustable sizes arrive in v3.1.2.

### 🔎 Finder, catalogue and previews

- **Expanded offline catalogue interface** with name/ID search and Items, Blocks, Vanilla and Modded filters.
- Choose **3, 6, 12 or 24 matching results**.
- **Favorites and recent results** are stored locally.
- **Browse without drawing:** catalogue browsing is available independently, but does not grant items.
- Index supported modded PNG textures and simple model texture references. Unsupported special/composite models are skipped, animated textures use their first square frame, and block references approximate cube appearance.
- Catalogue rebuilding responds to resource reloads; indexing is bounded to 5,000 source references.
- **Side-by-side preview** compares a fitted imported image with the final Minecraft map colors.
- **Six-slot 2D wall planner** lets you arrange artwork or saved projects and change mock-up frame styles and display size.

Matching remains approximate and offline. The wall planner is a preview, not world placement, a 3D room renderer or a world-lighting simulation.

### ♾️ Infinity Canvas limits and server administration

- Introduces an optional **lifetime reward limit per individual Infinity Canvas**.
- `maxInfinityCanvasUses = 0` keeps Infinity rewards unlimited by default.
- Successful rewards update a persistent item counter, including while the limit is unlimited.
- A positive limit blocks rewards when that particular canvas reaches its allowance. Lowering the limit below its existing count blocks further rewards; changing it back to zero restores unlimited eligibility.
- Counts stay with the canvas through normal transfers and saves.
- Failed delivery, rejected requests, cancellation and duplicate/replayed packets do not consume successful uses.
- **Molten Canvas remains independent:** one successful reward per canvas, with no Infinity quota applied.
- Servers can enable supported modded rewards with `allowModdedRewards` and block specific IDs with `blockedRewardItems`.
- The mod selects the synchronized server-config type supported by the installed loader.

Rewards are newly created plain items, **one selected item/block per successful exchange**, even when the player does not already own it. Blank Canvas remains painting-only.

### 🛏️ Kurlo Pillow

- Adds a reusable item in the dedicated Canvas Studio+ creative tab.
- **Recipe:** one Enchanted Golden Apple in the center, surrounded by eight White Wool.
- Hold the same pillow in the same main-hand or off-hand slot from entering bed through a completed night's sleep.
- On normal morning wake-up, the server applies the installed game's enchanted golden apple status effects: **Regeneration, Absorption, Resistance and Fire Resistance**.
- Early/interrupted sleep, swapping away the pillow or relogging does not grant these effects.
- The pillow is not consumed, and it does not restore food points.

### Compatibility, upgrades and verification

Existing canvas/quill registry IDs and crafting progression remain, including the legacy `molder_canvas` and `molder_quill` IDs displayed as **Molten**. Existing painting maps remain usable. The dedicated creative tab contains all seven items. Credit remains **made by SuprixZ**.

Separate JARs are supplied for Minecraft 26.2 with NeoForge 26.2.x and Minecraft 26.3 with NeoForge 26.3.x, including beta builds. Java 25 is required. **Network protocol 4** requires matching client/server mod releases.

Release checks passed: **12 Java verification suites**, packaged-artifact checks, default/endpoint builds, and API/dependency-range audits across **75 published NeoForge 26.3 builds** and **91 published NeoForge 26.2 builds** at release time. These are automated checks; **interactive Minecraft, multiplayer, live placement/sleep and world save/reload tests were not performed**.

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