Selectable Painting Mod — Guide

Mechanics

The mod operates through a simple set of interactions that integrate seamlessly with standard gameplay.

Opening the Selection GUI

To choose a painting, the player must hold a Selectable Painting item and Right-Click in the air (not targeting a block). This action opens the Selection Interface.

Placing Paintings

Once a design is selected in the GUI, the player can Right-Click a block to place it. The mod will attempt to center the painting based on the block clicked. If the selected painting is too large for the available wall space, the painting will not be placed, and an error message will appear on the screen: "The painting is too big for this place!"

Randomization

For players who still enjoy a bit of variety, the GUI includes a "Random Painting" checkbox. When enabled, placing the painting will select a random design from the pool of paintings that match the currently selected size.

Recovery

When a painting placed via this mod is broken or removed, it drops as a Selectable Painting item that remembers the design it previously displayed. This prevents the need to re-select the art if you are simply moving a decoration to a different wall.

User Interface

The Selection GUI is the heart of the mod, designed for ease of use and quick navigation.

GUI Components

1. Size Selector: A series of buttons or a dropdown menu that filters the available paintings by their block dimensions (e.g., 16x16, 32x16, 64x64 pixels).
2. Painting Gallery: A scrollable list of all paintings matching the selected size. Each entry shows a preview of the artwork.
3. Random Toggle: A checkbox to enable random placement within the chosen size category.
4. Search Bar: (In newer versions) Allows players to type the name of a specific painting to find it instantly.

Development History

The mod has undergone several major iterations to improve stability and feature sets across different Minecraft versions.

Version History

• 1.X.X: Initial release focusing on basic size selection and placement.
• 2.X.X: Introduced the dedicated GUI and improved mod compatibility for custom paintings.
• 3.X.X: Added the "Random Painting" toggle and refined the error messaging system for invalid placements.
• 4.X.X (Current): Optimized for Minecraft, featuring a modernized UI and enhanced search capabilities.

Items

The mod introduces one primary item that acts as the catalyst for all selection mechanics.

Selectable Painting

The Selectable Painting is a modified version of the vanilla painting item. It functions identically in terms of placement but holds additional NBT data regarding the specific art piece and size currently selected by the player.

Tooltips

When hovering over a Selectable Painting in the inventory, the tooltip displays the currently selected painting's name and its dimensions (Width x Height). This allows players to quickly identify which painting is ready for placement without opening the menu.

Recipes

The mod provides easy conversion between vanilla paintings and the selectable variant, ensuring players can use the mod's features at any time.

Crafting Selectable Paintings

Place a standard vanilla Painting into any slot of a crafting grid to convert it into a Selectable Painting.

Reverting to Vanilla

If you wish to return a Selectable Painting to its vanilla state, place it back into any slot of a crafting grid.