Mods / CustomTableau
- Tags:
- Author:
- Hezekhiel
- Side:
- Client
- Created:
- May 27th at 1:26 PM
- Last modified:
- May 30th at 9:57 PM
- Downloads:
- 140
- Follow Unfollow 19
-
Recommended download (for Vintage Story 1.22.3):
CustomTableaux-1.5.1.zip 1-click install
1.4.5 Hotfix
- Fixed missing plank sound warning.
- Improved Shift + Right Click menu detection.
- Added empty-hand right click fallback.
- Improved menu opening on multi-block paintings.
Update Description - CustomTableaux 1.5.1
CustomTableaux 1.5.1 adds several quality-of-life and customization improvements.
New Persistent User Paintings Folder
Custom images are no longer loaded from inside the mod zip.
The mod now automatically creates and uses a persistent folder:
VintagestoryData/ModConfig/CustomTableaux/userpaintings/Place your .png images in this folder.
This prevents custom images from being removed or overwritten when updating the mod.
Images are still detected when the game starts, so restart Vintage Story after adding or replacing PNG files.
New Painting Plaques
Paintings can now display an optional wooden plaque below the frame.
When editing a placed painting, the interface now includes a text field for plaque text. The text is saved individually for each placed painting, just like the selected image.
If no text is entered, no plaque is displayed.
Improved Painting Selection Interface
The image selection menu has been redesigned and enlarged.
Changes include:
- larger interface window;
- wider image dropdown;
- wider plaque text input;
- better spacing between buttons;
- separated Apply and Cancel buttons;
- improved text handling for plaques.
Improved Plaque Text Rendering
Plaque text now automatically adjusts its font size to fit better on the plaque. Longer text is handled more cleanly and may be shortened with ... if needed.
Important Upgrade Note
If you used an older version of CustomTableaux, move your custom PNG images from the old mod folder:
assets/customtableaux/textures/userpaintings/to the new persistent folder:
VintagestoryData/ModConfig/CustomTableaux/userpaintings/After moving the files, restart the game.
Compatibility
This version targets Vintage Story 1.22.3.
CustomTableau
CustomTableau is a lightweight decorative mod for Vintage Story that adds customizable wall paintings to the game.
Its goal is simple: let players display their own PNG images directly in the world as placeable decorative paintings. The mod is designed to stay simple, immersive, and easy to use, without replacing vanilla paintings.
Current Features
-
Adds several custom painting formats:
- small painting;
- square painting;
- horizontal painting;
- vertical painting.
-
Paintings can be placed on walls.
-
Each placed painting can display its own image.
-
Images are loaded from a folder inside the mod.
-
Players can add their own .png files without editing the mod code.
-
Shift + right click on a placed painting opens an image selection menu.
-
The selected image is saved individually for each placed painting.
-
Includes survival crafting recipes.
-
Recipes support vanilla planks and linen/cloth materials.
-
Uses a simple wooden frame for an immersive look.
-
Does not overwrite or replace vanilla paintings.
How It Works
Place a custom painting on a wall, then Shift + right click it to open the image selection menu.
The menu lists the PNG images found in the mod’s user painting folder. After selecting an image, it will be applied only to that specific painting. Other paintings of the same type will not change.
This allows players to build personalized galleries, decorated homes, museums, libraries, taverns, castles, map rooms, or story-focused builds.
Adding Custom Images
Place your .png files in this folder:
assets/customtableaux/textures/userpaintings/You can use any filename you want. You do not need to replace existing images or follow a fixed naming system.
Example filenames:
my_castle.png
queen_portrait.png
world_map.png
travel_memory.pngAfter adding, removing, or replacing images, restart Vintage Story so the mod can detect them.
Recommended image sizes:
Small painting: 128x128 or 256x256
Square painting: 512x512
Horizontal painting: 512x256 or 768x384
Vertical painting: 256x512 or 384x768Images must be in .png format.
Mod Philosophy
CustomTableau is designed to be:
- lightweight;
- immersive;
- simple to use;
- survival friendly;
- fully customizable by the player;
- separate from vanilla paintings;
- free from unnecessary complexity.
The goal is not to add a complicated system, but to provide a clean and flexible way for players to decorate their worlds with their own images.
Possible Future Features
Future additions could include:
- more wooden frame variants;
- frameless wall art;
- larger wall painting formats;
- image categories;
- favorite images in the selection menu;
- noble or decorative frame recipes;
- a reload command for newly added images;
- optional brightness adjustment for darker images.
----------------------------------------------------------------------------------------------------------------------------------------------
For best performance, use optimized game textures (72–96 DPI recommended).
Very large print-quality images (300 DPI / extremely heavy PNGs) may cause temporary freezes while the game loads the texture.
-----------------------------------------------------------------------------------------------------------------------------------------------
| Mod Version | Mod Identifier | For Game version | Downloads | Released | Changelog | Download | 1-click mod install* |
|---|---|---|---|---|---|---|---|
| 1.5.1 | customtableaux | 61 | May 30th at 9:57 PM | Empty | CustomTableaux-1.5.1.zip | 1-click install | |
| 1.4.5 | customtableaux | 57 | May 27th at 8:17 PM | CustomTableaux-1.4.5.zip | 1-click install | ||
|
1.4.5 Hotfix | |||||||
| 1.4.4 | customtableaux | 22 | May 27th at 1:35 PM | CustomTableaux-1.4.4.zip | 1-click install | ||
|
Initial public release of CustomTableau. | |||||||
| 1.4.4 | 0 | May 27th at 5:09 PM | Release Retracted | ||||
Retraction Reason:yes Changelog: | |||||||
Hi, absolutely love the mod!
I can place my own art in my tiny home it's awesome, as well as paintings from my favorite painters.
I actually edited all of the pictures to pixelate them as well as adjusting the luminosity so it doesn't stand out too much. Would it be okay if I release my custom tableaux collection as a "mod" (just the folder, not a rerelease ofc) so others who have not access to photoshop etc. can have an immersive painting pack?
Keep it up, your mod is a gem!
I'm glad you enjoy the mod! 😊
Yes, that's perfectly fine. As long as you are only sharing your image collection and not redistributing the CustomTableaux mod itself, I have no problem with it.
In fact, I think it's a great idea to create immersive painting packs for the community.
If you share it, a small mention of CustomTableaux would be appreciated, but otherwise feel free to create and share your collection.
Thank you for your kind words and for taking the time to adapt the images to Vintage Story's style!
My room of Albrecht Dürer animal paintings, all thanks to your wonderful mod!
You're welcome 😊
It is normal for me to fix what does not work. Just because everything worked on my side does not mean I should ignore problems on other configurations.
I am really happy the mod now works correctly for you, and your room with the paintings looks beautiful.
I am very glad you enjoy the mod.
Friendly regards.
Great mod! I can create a canvas and place it, but it only shows the first image in the userpaintings library. When clicking shift+right click, nothing happens.
@boxinabox
Hi!
I just tested the issue on my side and I was able to reproduce the same behavior when using JPG images instead of PNG.
The mod currently only supports
.pngfiles.Could you check if:
your images are in PNG format,
and if a red warning message appears above the hotbar saying that no PNG images were found?
Without logs or screenshots I cannot fully identify the issue, because on my side the mod is working correctly.
And
Restart Vintage Story after adding or modifying images; this is very important for the mod to detect the images in-game.Hi! I checked and both are png images. I changed the names, so that tthe second images comes first, and it will show up in new custom paintings instead of the first. Custom paintings already created still showed the original image. Both are recognized, I just can't seem to access the menu. Would you be able to add customization of the keybind for the menu?
Looked at logs, and did a search of customtableaux, and only got this warning about a missing audio file?
27.5.2026 13:28:10 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:28:13 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:28:20 [Warning] Selected block is not wood or leaves.
27.5.2026 13:28:29 [Warning] Selected block is not wood or leaves.
27.5.2026 13:28:29 [Warning] Selected block is not wood or leaves.
27.5.2026 13:28:37 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:28:37 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:28:42 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:28:44 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:28:44 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:28:47 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:28:53 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:28:53 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:29:06 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:29:07 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
27.5.2026 13:29:09 [Warning] Audio File not found: customtableaux:sounds/block/planks.ogg
Here's a screenshot. It can recognize the images fine, I just can't switch them from the first one in the folder.
Thank you for the screenshot and the detailed feedback!
The good news is that the PNG loading system works correctly on your side, since the paintings are displaying properly.
So the remaining issue is specifically related to the Shift + Right Click menu interaction.
I will investigate this on my side and prepare an update after I identify the cause. Thank you for helping test the mod!
Hi!
I published a 1.4.5 hotfix for CustomTableaux.
Changes:
Improved Shift + Right Click detection on all painting parts.
Fixed interaction on multi-block paintings.
Added a fallback interaction:
if Shift + Right Click does not work, you can now simply Right Click the painting with an empty hand.
You should now be able to interact with the paintings from any area of the frame.
I can switch between the images now! Thanks for the work on this 😊
Awesome! I'm really happy it works correctly now 😊
Thank you again for taking the time to test, send logs, screenshots, and feedback. It really helped improve the mod for everyone.
And your rabbit painting looks fantastic in-game 😄
Haha thanks, I took a Durer painting and pixellated it to fit the look of the game!
One thing I noticed is that the userpainting folder gets deleted after an update. Any way to keep the contents during updates? I keep a copy in another folder just in case though!
It was not originally planned for the first versions of the mod, but after your feedback I think this would be a very good improvement.
I already found a way to make the custom image folder persistent between updates, so user images will no longer be deleted during future mod updates.
I will probably add this in a future content update when new painting types and features are added.