← Назад к ресурсам

Sivage

An easy way to generate server-sided images via dialog GUIs and map art.

Modrinth decoration social utility

Описание

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](https://modrinth.com/mod/image2map) or [Map4Image](https://modrinth.com/mod/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: | ![A recipe of 8 sticks around one Name Tag, resulting in a Custom Image.](https://cdn.modrinth.com/data/dMOPQTBa/images/9b56bbfc93ede2c51e940571687ef89bf5c3db64.png) | ![A screenshot of how the dialog looks like. It's a few options like 'URL', 'width' and 'height' and a few booleans like 'transparency'.](https://cdn.modrinth.com/data/dMOPQTBa/images/d6713e222c5c48853fa5ebece6fdedcbdaed33c0.png) | ![A screenshot showing two images, where one is transparent.](https://cdn.modrinth.com/data/dMOPQTBa/images/bfe014bb9cafdff1dfe5c7bc282ed068a20c6bc9.png) | |---|---|---| | _**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. ## Translations By installing Sivage on the client as well, players have more languages besides English available. If you want to help translating this mod, please go to [our Weblate](https://translate.codeberg.org/projects/sivage/)! [![Translation status](https://translate.codeberg.org/widget/sivage/multi-auto.svg)](https://translate.codeberg.org/engage/sivage/) ## 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: ```toml # Specifies 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 # Represents aspects inside the game. [game] # When enabled, each player may have only one image generated at a time. # default: false playerLimit = false # Requires permission for every block in the image, preventing boundary overstepping in claim mods. Performance cost scales with image size. # default: false strict = false # Fallback behavior for these permissions, provided by this mod. (Note: A mod like LuckPerms is recommended to make effective use out of these) [game.permissions] # default: true canPlaceImageFallback = true # default: true canRemoveImageFallback = true ``` > **🛈 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. ### Permissions By installing a permissions mod like [LuckPerms](https://modrinth.com/plugin/luckperms) or using a Claim Protection mod of your choice, Sivage can be configured by who and where Custom Image's can be used. ## 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](https://codeberg.org/SammyForReal/Sivage/src/branch/main/README.md#compiling) *** ###### Copyright © 2025-2026 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/.