Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Details
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.comfor 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.