Sivage

Sivage is a server-side Fabric mod for modern Minecraft which gives players the ability to use Custom Image's from the internet within the in-game world.

Compared to mods like Image2Map or Map4Image from which Sivage takes heavy inspiration, this tries to provide a more survival friendly approach by providing craftable items and GUIs, rather than commands.

---

Features of Sivage

Here are several aspects of Sivage, also serving as a small starting guide:

Survival Friendly Integration!	GUI for Easy Usage!	Great Looking Images!

Supported Formats

One common issue with images from the internet is ensuring which format they use. Sivage comes with great support for the most used formats: It supports PNG, JPEG, WEBP, GIF, BMP, ICO, QOI, TIFF, FF, HDR & TGA.

These should cover most, if not almost all, of the image formats that you may encounter on the Internet!

🛈 Note
Animations are not supported! While formats like GIF or WEBP do work, they will only show the first frame in game.

Configuration

This mod comes with a TOML file on the server at config/sivage/server.toml, allowing to adjust server owners which sources are allowed:

# Controls how this mod interacts with the internet.
[network]
	# List of specifically allowed domains or wildcards. Overrules the blacklist.
	whitelist = []
	# List of specifically disallowed domains or wildcards. Overruled by the whitelist.
	blacklist = ["localhost"]
	# Specifies the maximum size in bytes that images are allowed to have while downloading. (0 means infinite)
	# range: 0 - 2147483647
	# default: 500000000
	fileSizeLimit = 500000000

# This represents aspects of this mod that only have an affect within the game.
[game]
	# When enabled, each player may have only one image generated at a time.
	# default: false
	playerLimit = false
	# With player_limit enabled, this will be shown to players who try to generate more than one image simultaneously.
	# default: ᴘʟᴇᴀsᴇ ᴡᴀɪᴛ ғᴏʀ ᴛʜᴇ ᴘʀᴇᴠɪᴏᴜs ɪᴍᴀɢᴇ ᴛᴏ ғɪɴɪsʜ ɢᴇɴᴇʀᴀᴛɪɴɢ.
	limitReachedMsg = "ᴘʟᴇᴀsᴇ ᴡᴀɪᴛ ғᴏʀ ᴛʜᴇ ᴘʀᴇᴠɪᴏᴜs ɪᴍᴀɢᴇ ᴛᴏ ғɪɴɪsʜ ɢᴇɴᴇʀᴀᴛɪɴɢ."

🛈 Note
Both the white- and blacklist allow the usage of wildcards; To be more specific, * for everything and *.example.com for subdomain wildcards. IP Addresses and protocols not following HTTP(S) will always be rejected.

Development

In order for this mod to work with as many formats as possible on any JVM, the image processing part has been written in Rust and is being run with WebAssembly that has been compiled to java bytecode.

At the cost of slower processing times, compared to any other image processor that has been directly developed for the JVM, this approach supports many formats and runs on pretty much any Java distribution, as it does not depend on ImageIO at all.

For more information about building from source, please refer to the README.me at Codeberg.org

---

Copyright © 2025 Sammy L. Koch

Sivage is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, version 3 only of the License.

Sivage is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this mod. If not, see http://www.gnu.org/licenses/.