Update History

Holiday Disclaimer

This is a special, just-for-fun holiday version, which means it might contain a few unexpected bugs! These Easter features are temporary and will be removed from the main game after the holidays, but this specific version will remain available to download forever!

Egg-citing New Additions

• Plain Egg Block: A brand new block that fully supports procedural coloring. Paint it any HEX color you want!
• Egg Decoration Block: Take your Easter eggs to the next level. This block is colorable and comes with 4 selectable patterns (blockstates):
  • Dotted
  • Lacy
  • Line
  • Creeper (Watch out!)
• Chicken Block: Because we finally had to answer the question: which came first, the Easter egg or the Chicken?

Egg-stra Tweaks (Minor Changes)

• The main program logo has been temporarily changed to "EggPaint".
• The "Start Drawing" button on the main menu has been renamed to "Start egg hatching process".
• The "Inventory" button is now officially your "Easter Basket".

Critical Warning: Old Save Files

Because block IDs have transitioned from numeric values (e.g., 1, 2) to symbolic strings (e.g., grass_block), all old .mcpaint save files are unfortunately no longer compatible and will not load in this version.

Main Menu & Splash Screen

• Main Menu: The application no longer boots directly into the canvas. You are now greeted by a modern Main Menu where you can create a New Canvas (with custom dimensions), Load an existing .mcpaint file, access Settings, or Exit.
• Splash Screen: Displays upon startup, showcasing 5 beautiful panoramas created by our community. It can be skipped with any key/mouse click and can be toggled off entirely in the Settings.

Canvas Zooming & Navigation

• Added a new Zoom Panel next to the hotbar to view and adjust your current zoom level.
• The canvas automatically fits to your screen upon creation.
• Controls:
  • + / - keys or Mouse Scroll to zoom in and out.
  • = key to instantly auto-fit the canvas to your screen.
  • Hold Middle Mouse Button (Scroll Click) and drag to seamlessly pan around the canvas.

New Tools & Procedural Coloring

• Bucket Tool: A highly requested tool! Fill enclosed areas or contiguous identical blocks with ease. Use LMB to fill and RMB to erase the area.
• Procedural Block Coloring: Supported blocks can now have dynamically colorable texture layers via HEX codes.
  • A new Color button appears next to the inventory/variants button for supported blocks.
  • Example: You can now create custom-colored grass and leaves to build beautiful Savanna biomes!

DiaxUI v1.3 & Settings

• Background Dimming: The screen now smoothly dims behind active modal windows (Inventory, Custom Background Color, etc.) for better focus.
• FontAwesome Icons: Replaced old system character symbols with clean FontAwesome v6 icons for UI controls (Close, Minimize, Layer Up/Down, etc.).
• Confirmation Dialogs: The app will now prompt you with a warning if you try to exit without saving your changes.
• Settings Window: Accessible from the Main Menu or the gear icon in the editor. You can now toggle the Grid, toggle Rulers, and toggle the Splash Screen from this centralized menu.
• Tool shape buttons have received slight visual polish.

AssetsPacks Evolution

AssetsPacks are officially out of the experimental phase!

• Symbolic IDs: Block and blockstate IDs are now string-based (e.g., grass_block) instead of numbers. Note: Custom AssetsPacks using old numeric IDs will need to be updated.
• Advanced Texture Layers: Block textures can now utilize multiple layers with the following new attributes:
  • Color – Sets the layer to be procedurally colored.
  • Opacity – Adjusts the layer's transparency.
  • Rotate – Rotates the texture (0, 90, 180, 270 degrees).
  • Flip – Mirrors the texture (x, y, xy, yx).
  • Bright – Adjusts brightness (negative values darken the texture).

Massive Content Update (New Blocks)

We've heavily expanded the block catalog:

• Flora: Fern, Large Fern, Dandelion, Poppy, Blue Orchid, Allium, Azalea Leaves, Flowering Azalea Leaves, Pumpkin.
• Wood: Mangrove Log/Leaves, Cherry Log/Leaves, Pale Oak Log/Leaves.
• Nether: Soul Sand, Soul Soil.
• Utility/Glass: Smoker, Blast Furnace, Fletching Table, Glass, Tinted Glass, and all Stained Glass colors.
• Community Contest Additions: A huge shoutout to Stasiek, winner of the "Make Your Own Update" contest! Thanks to him, we've added the: Redstone Lamp, Crafting Table, Loom, Furnace, and Barrel.

Minor Tweaks & Fixes

• Added a "Back to Main Menu" button next to the exit controls.
• New Shortcut: Press Ctrl + H to instantly clear your entire Hotbar.
• The Inventory search bar now supports querying specific blockstates by name.
• Block Picker Interaction Change: To quickly pick a block under your cursor using tools (Pen, Fill, Bucket, Picker), you must now press Ctrl + Scroll Click instead of just Scroll Click (which is now used for panning).
• Rulers using the 5-block interval mode will now automatically switch to detailed mode (1-block interval) when heavily zoomed in.

DiaxUI v1.2

• Redesigned AssetsPack tiles in the AssetsPack Manager.
• Information is now displayed in a vertical layout (stacked instead of inline).
• AssetsPack version is now highlighted in yellow for better visibility.
• Long text values (name, description, version) are now:
  • Automatically shortened with ...
  • Fully visible via tooltip on hover

Bug Fixes

• Fixed an issue where AssetsPack metadata could contain unintended formatting characters (\r, \n).
• Fixed horizontal scrollbar appearing when AssetsPack information was too long.
• Fixed object settings panel showing the default built-in texture instead of the AssetsPack texture.
• Fixed object scaling issues:
  • Previously, textures smaller or larger than 16x16px caused incorrect scaling.
  • Textures are now automatically normalized to 16x16px.
• Fixed weather texture rendering issues:
  • Incorrect sizes caused visual glitches on the canvas.
  • Weather textures are now normalized to 64x256px.
• Fixed an issue where the Hotbar did not refresh block textures after using the Refresh List button in AssetsPack Manager.

AssetsPacks Improvements

• AssetsPacks can now be loaded from both folders and .zip archives.
• Previously, only unpacked folders were supported.
• The application now automatically detects and loads valid zipped packs.
• Important: For a .zip AssetsPack to work correctly, its structure must be flat:
  • pack.json must be in the root of the archive
  • assets/ and data/ folders must also be in the root
  • No additional parent folder inside the .zip

Bug Fixes

• Fixed a rare issue where enabled AssetsPacks could cause the application to crash during startup.
• #MCP-003 – Fixed incorrect brush size handling for Round Brush:
  • Previously, some values (e.g. 20) could not be set.
  • The system incorrectly adjusted them to higher values (e.g. 31).
  • This behavior has now been corrected.
• #MCP-004 – Fixed inverted HEX color inputs in Custom Background Color Window:
  • The top color field was affecting the bottom background color.
  • The bottom field was affecting the top color.
  • Inputs now correctly match their respective background areas.

End of Alpha Stage

This is the final Alpha release. Beta Release Candidates will start appearing soon and will continue until April 3, 2026. If a candidate contains no critical issues, it will become the first official Beta version: Bt-Y26R01.

DiaxUI v1.1

• Further visual refinements and consistency improvements across the interface.
• Updated windows:
  • Resize Window – improved layout and usability
  • Custom Background Color Window – enhanced color controls
• Inventory redesign:
  • Categories are now displayed vertically on the left side.
  • Block list is displayed on the right.
  • Changed search bar.
  • Better close button.

Object Management Window

• New dedicated window for managing Sun and Moon objects.
• Accessible via right-click while placing an object.
• Allows:
  • Scaling objects from 0.3 up to 6.0
  • Adjusting opacity from 0% to 100%
  • Changing Moon phases
• Right-click no longer cycles Moon phases directly.
• Mouse scroll still controls object scale during placement.

Object Improvements

• Maximum object scale increased from 3.0 to 6.0.
• Added support for object transparency.

Brush Shapes

• Brush shape selection added to the Size panel.
• Available for Pen and Eraser.
• Two brush types:
  • Square Brush (default) – consistent square drawing
  • Round Brush – circular drawing shape
• Size range: 1 – 64.
• Round brush supports only valid sizes (auto-adjusts if unsupported).

Usability Improvements

• New confirmation dialog when clearing the canvas (prevents accidental data loss).
• Reset button in Resize window (restores default size: 46x25).
• Added color picker palettes in Custom Background window.
• New Minimize button in the window controls.
• Grid (#) toggle:
  • Helps visualize block placement
  • Disabled by default
  • Not visible in exported PNG files
  • State is saved between sessions
• Rulers (R) toggle:
  • Off
  • Area mode (every 5 blocks)
  • Precise mode (every block)
• Added tooltips to selected UI elements.

Canvas Saving System

• Introduced Save As option.
• Save now overwrites the existing file.
• If no file exists, Save behaves like Save As.

New Keyboard Shortcuts

• Ctrl + Shift + P – Open screenshots folder
• Ctrl + Shift + = – Increase brush size
• Ctrl + = – Reset brush size
• Ctrl + - – Decrease brush size
• Ctrl + Shift + S – Save As

New Blocks

• Tall Grass (2 blockstates), Vines
• Dark Oak Log (3 blockstates), Dark Oak Leaves
• Smooth Basalt
• Moss Block, Moss Carpet
• Pale Moss Block, Pale Moss Carpet (3 blockstates)
• All Overworld ores and Deepslate ores
• Raw Copper, Raw Gold, Raw Iron blocks
• Lava (2 blockstates)
• Prismarine
• Amethyst Block, Budding Amethyst
• Small / Medium / Large Amethyst Bud (4 blockstates)
• Amethyst Cluster (4 blockstates)
• Magma Block

Experimental: Assets Packs

• New system for custom packs.
• Allows:
  • Changing textures (blocks, objects, weather overlays)
  • Adding new blocks, blockstates, and categories
  • Editing or removing existing content
  • Managing block order and categories
• New AssetsPack Manager (button "AP").
• Supports multiple packs with priority order (top = highest priority).
• Includes:
  • Enable/disable packs
  • Reorder packs
  • Refresh list
  • Open assets folder
• Assets location: C:\Users\User\AppData\Roaming\Godot\app_userdata\MinePaint\assets_packs
• Want to learn how to create AssetPacks? See the documentation.

Minor Changes

• Renamed:
  • Blockstates → Variants
  • Load → Open
• Updated layer arrow button visuals.
• Reorganized block order in inventory.
• Improved Short Grass texture.

Technical Changes

• Textures are automatically scaled to 16x16px if larger.
• Added visible flag for blocks and categories.
• All important settings stored in user_settings.cfg.
• Active Assets Packs stored in assets_packs_config.json.
• Data structure reorganized into separate files per block and category.
• Categories are no longer created automatically.
• Cleaned up folder structure.

Bug Fixes

• #MCP-001 – Fixed Inventory button scaling when Variants button is visible.
• #MCP-002 – Fixed incorrect positioning of the Objects panel.

DiaxUI

• Brand-new interface design for MinePaint 1.0.
• Simple, clean aesthetic that improves upon the previous Ice Simple UI.
• Further refinements planned in future updates.

Object System

• New panel for background objects, which can be placed freely on the canvas independent of the layer system.
• Available objects include Sun and Moon:
• Only one object can exist at a time (Sun or Moon).
• Mouse scroll adjusts object scale during placement (scroll up to enlarge, scroll down to shrink).
• Moon has 8 phases selectable with right-click during placement:
  1. Full Moon
  2. Waning Gibbous
  3. Third Quarter
  4. Waning Crescent
  5. New Moon
  6. Waxing Crescent
  7. First Quarter
  8. Waxing Gibbous
• Sun and Moon placement occurs at the clicked position with left mouse button.
• Clear button removes all objects from the canvas.

Weather System

• Independent weather layer visible behind all other layers.
• Three selectable options: Clear, Rain, Snow.
• Only one weather effect can be active at a time.

Time System

• Controls canvas background colors to simulate time of day.
• Three options:
  • Day: Default daytime colors.
  • Night: Nighttime colors.
  • Custom: Define top and bottom colors using HEX codes.

Tool Size

• New size panel available for Pen and Eraser tools.
• Adjustable from 1 (default) to 64.

Keyboard Shortcuts

• Canvas Management:
  • Ctrl + S – Save canvas to .mcpaint
  • Ctrl + P – Export canvas to .png
  • Ctrl + N – Clear canvas
  • Ctrl + L – Load canvas from .mcpaint
  • Ctrl + Shift + R – Resize canvas
• Tools & Inventory:
  • N – Select None tool
  • P – Select Pen tool
  • F – Select Fill tool
  • C – Select Picker tool
  • X – Select Eraser tool
  • E – Open/close Inventory

New Blocks

Added a variety of natural and building blocks:

• Short Dry Grass, Tall Dry Grass, Cactus Flower, Dead Bush, Bush, Cobweb
• Brown Mushroom, Red Mushroom, Coarse Dirt, Rooted Dirt, Snow, Snow Block, Powder Snow
• Ice, Packed Ice, Blue Ice, Clay, Mud
• Birch Log, Jungle Log, Acacia Log (all with 3 blockstates), Birch Leaves, Jungle Leaves, Acacia Leaves
• Granite, Diorite, Andesite, Calcite, Tuff, Dripstone, Deepslate (3 blockstates), Obsidian, Crying Obsidian

Blockstate Updates

• Dirt block now includes a Farmland blockstate.

Bug Fixes & Improvements

• Fixed incorrect saving of certain blocks.
• Smoother canvas loading experience.
• Exporting to PNG no longer causes lag.
• Inventory reliably closes after use.

Core Features

• Layer System: Full multi-layer support!
  • Manage layers via the right-side panel (Add + / Remove -).
  • Reorder layers using up and down arrows.
  • Toggle visibility with checkboxes. Active layer is highlighted.
• Custom Canvas Size: Use the "Resize" button to set dimensions from 1x1 up to 300x300 blocks.
• Smart Hotbar: Stores the last 9 used blocks or states. Select via clicking or keys 1-9.

Tools & Interaction

• New Tool Panel:
  • None: View-only mode (safely navigate).
  • Pen: Draw (LMB), Pick Block (Scroll Click), Destroy (RMB).
  • Fill: LMB (Start & End) fills area. RMB (Start & End) clears area.
  • Picker: Selects block under cursor (works with any button).
  • Eraser: Destroys blocks (LMB or RMB).

Inventory & Blockstates

• Overhauled Inventory:
  • Direct key selection (0-9) removed. Press 'E' or click the bottom-left button.
  • Features: Search (Name/ID), Categories, and Hover Tooltips.
  • Auto-closes upon selection.
• Advanced Blockstates:
  • Inventory previews now animate through available states (e.g., Log rotation, Grass types).
  • Selector: A "Blockstates" button appears next to Inventory when a multi-state block is active.

New Content

Added support for: Sugar Cane, Cactus, Podzol, Mycelium, Red Sand, Red Sandstone, Gravel, Bedrock, Spruce Leaves, Spruce Logs.

New Blockstates added for: Grass (Snowy), Dirt (Path), Water (Level), Oak & Spruce Logs.

Experimental

• Screenshot Utility: Press F2 to save a snapshot to the MinePaint_Screenshots folder.

Technical & Fixes

• Data-Driven Architecture: Blocks are now loaded dynamically from data/blocks.json instead of hardcoded tilesets. This allows easier modification of IDs, names, and textures without engine recompilation.
• UI Polish: Default font changed to Minecraft Five Bold. App logo updated.
• Fixes: Resolved file naming issues during export/save. Fixed Canvas UI scaling.

Back to Alpha

The engine migration required us to rewrite the entire project from scratch. Switching to Godot makes the application run smoother and faster.

New Versioning System

Alp-Y25R01 (Alpha - Year 25 - Rev 01)

Current Features

• Draw (LMB) & Erase (RMB).
• Select blocks using Keys 1-9.
• Pick block with Scroll Wheel.
• Save/Load .mcpaint projects.
• Support for custom canvas size (Code implemented).

New Features

• Tools: None Tool, Dedicated Eraser, Fill Tool.
• UI: Grid Overlay, Rulers, Improved Inventory.
• Core: Layer System, Custom Canvas Size (up to 48x27).
• World: Sun & Moon, Weather Effects (Rain/Snow).

• Added Moss Blocks, Shrieker Blocks, Dark/Pale Oak variants.
• Added Snowy Grass blockstate.
• New: Quick Block Selection (Hover + 1-9).
• New: Loading Screen & Clear Canvas confirmation.

• Refactored quick access inventory logic.
• Removed unused textures.
• Fixed UI disappearing bug.

• Blocks: Stones, Ores, Deepslate, Bedrock, Lava.
• Feature: Block List in inventory categories.
• Feature: Day/Night toggle (Key 'T').

• Fixed brush size resetting.
• Fixed daytime air block glitch at night.
• Fixed inventory not closing with "E".

• Added Podzol, Mycelium, Dirt variants.
• Added Sandstones, Birch/Spruce Leaves, Cactus, Water.
• Updated inventory textures and highlighting.