# CustomPaintings<\/p>\n
CustomPaintings lets server admins upload PNG images to the server and give players map-based paintings, including multi-map murals (2×2, 4×4, etc.).<\/p>\n
## Features<\/p>\n
– Upload PNG files directly to the server filesystem
\n– Import as:
\n– Single painting (`1×1` map)
\n– Multi-map mural (`2×2` up to `8×8`)
\n– Give painting sets to players with one command
\n– Persistent painting index in `paintings.yml`
\n– Tab-complete for commands and painting names<\/p>\n
## Requirements<\/p>\n
– Paper
\n– Java `21`<\/p>\n
## Build<\/p>\n
From plugin source folder:<\/p>\n
“`bash
\n.\/gradlew build
\n“`<\/p>\n
Output jar:<\/p>\n
“`text
\nbuild\/libs\/CustomPaintings-1.0.0.jar
\n“`<\/p>\n
## Install<\/p>\n
1. Stop your Paper server.
\n2. Copy `CustomPaintings-1.0.0.jar` into your server `plugins\/` folder.
\n3. Start the server.
\n4. Confirm plugin is enabled:
\n– Run `\/plugins`
\n– `CustomPaintings` should be green<\/p>\n
## Created Folders\/Files<\/p>\n
After successful startup, plugin creates:<\/p>\n
– `plugins\/CustomPaintings\/config.yml`
\n– `plugins\/CustomPaintings\/uploads\/` (put upload PNGs here)
\n– `plugins\/CustomPaintings\/paintings\/` (generated map tile PNGs)
\n– `plugins\/CustomPaintings\/paintings.yml` (painting metadata)<\/p>\n
## Command Reference<\/p>\n
Base command:<\/p>\n
“`text
\n\/painting
\n“`<\/p>\n
### 1) List paintings<\/p>\n
“`text
\n\/painting list
\n“`<\/p>\n
Shows all registered painting names and dimensions (example `wallart (4×4)`).<\/p>\n
### 2) Import painting<\/p>\n
“`text – `name`: painting id (`a-z`, `0-9`, `_`, `-`, max 32 chars) Examples:<\/p>\n “`text ### 3) Give painting set(s)<\/p>\n “`text – `name`: registered painting A set contains all map items required for the mural: Examples:<\/p>\n “`text ### 4) Remove painting<\/p>\n “`text Deletes metadata and generated tile images for that painting.<\/p>\n ### 5) Reload painting index<\/p>\n “`text Reloads `paintings.yml` without restarting server.<\/p>\n ## Permissions<\/p>\n – `custompaintings.use` (default: `true`) Admin required for: ## Full Workflow Example (with username `bitz`)<\/p>\n 1. Upload `sunset.png` to: 2. Import as 2×2 mural:<\/p>\n “`text 3. Confirm:<\/p>\n “`text 4. Give one set to yourself:<\/p>\n “`text 5. Place maps in item frames in grid order: ## Notes on Placement Order<\/p>\n Map display names include tile position like:<\/p>\n “`text Meaning: Use that to place frames correctly for murals.<\/p>\n ## Troubleshooting<\/p>\n ### Plugin is red in `\/plugins`<\/p>\n Check console logs on startup for `CustomPaintings` errors.<\/p>\n Common issue fixed in this project: ### Upload folder missing<\/p>\n Folder is:<\/p>\n “`text If it does not exist, plugin likely failed to enable.<\/p>\n ### “Painting not found”<\/p>\n – Ensure painting was imported first ### “Upload file not found”<\/p>\n – Verify file exists in `plugins\/CustomPaintings\/uploads\/` ### “Only .png files are supported”<\/p>\n Convert source to PNG and retry import.<\/p>\n ### Mural too large<\/p>\n Max import size is `8×8` maps.<\/p>\n ## Data Format<\/p>\n `paintings.yml` stores each painting as:<\/p>\n – `width` The plugin also supports loading older legacy single-file entries and treating them as `1×1`.<\/p>\n ## Upgrade\/Replace Jar Safely<\/p>\n 1. Stop server. ## Uninstall<\/p>\n 1. Stop server. ## License<\/p>\n MIT<\/p>\n","protected":false},"excerpt":{"rendered":" This Plugin Ads Custom Paintings in Minecraft<\/p>\n","protected":false},"featured_media":53200,"template":"","meta":{"_minecraft_slug":"custompaintings","_minecraft_project_id":"dkTi0JRZ","_minecraft_author":"bitz","_minecraft_license":"MIT","_minecraft_downloads":146,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"custompaintings.zip","_minecraft_size_bytes":15722,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:39:25.060557Z","_minecraft_date_created":"2026-03-04T22:04:53.226858Z","_minecraft_date_modified":"2026-03-01T14:56:46.045056Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/custompaintings","_minecraft_icon_attachment_id":53200,"_minecraft_imported_at":"2026-06-02T23:01:31+00:00","_minecraft_import_hash":"ca93fac508d0be59675c9ebe61beba39","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,127,867,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-53199","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/painting import
\n“`<\/p>\n
\n– `upload-file.png`: filename placed in `uploads\/`
\n– `widthMaps`: optional, default `1`, range `1..8`
\n– `heightMaps`: optional, default `1`, range `1..8`<\/p>\n
\n\/painting import mona mona.png
\n\/painting import castle castle.png 2 2
\n\/painting import mega_wall panorama.png 4 3
\n“`<\/p>\n
\n\/painting give
\n“`<\/p>\n
\n– `player`: optional target player
\n– `sets`: optional number of full sets (default `1`, clamped `1..64`)<\/p>\n
\n– `1×1` mural = 1 map per set
\n– `2×2` mural = 4 maps per set
\n– `4×4` mural = 16 maps per set<\/p>\n
\n\/painting give mona
\n\/painting give mona bitz
\n\/painting give castle bitz 3
\n“`<\/p>\n
\n\/painting remove
\n“`<\/p>\n
\n\/painting reload
\n“`<\/p>\n
\n– `custompaintings.admin` (default: `op`)<\/p>\n
\n– `\/painting import …`
\n– `\/painting remove …`
\n– `\/painting reload`<\/p>\n
\n– `plugins\/CustomPaintings\/uploads\/sunset.png`<\/p>\n
\n\/painting import sunset sunset.png 2 2
\n“`<\/p>\n
\n\/painting list
\n“`<\/p>\n
\n\/painting give sunset bitz 1
\n“`<\/p>\n
\n– Top row left to right
\n– Then next row left to right<\/p>\n
\nPainting: sunset [1\/2, 1\/2]
\n“`<\/p>\n
\n– first value pair is horizontal position (`x\/width`)
\n– second pair is vertical position (`y\/height`)<\/p>\n
\n– Missing `config.yml` in jar causes:
\n– `The embedded resource ‘config.yml’ cannot be found`<\/p>\n
\nplugins\/CustomPaintings\/uploads
\n“`<\/p>\n
\n– Check exact painting name in `\/painting list`<\/p>\n
\n– Use exact filename including `.png`<\/p>\n
\n– `height`
\n– `prefix` (tile filename prefix)<\/p>\n
\n2. Replace plugin jar in `plugins\/`.
\n3. Start server.
\n4. Run `\/painting reload` if only metadata changed while running.<\/p>\n
\n2. Remove plugin jar from `plugins\/`.
\n3. (Optional) Delete `plugins\/CustomPaintings\/` data folder.<\/p>\n