西瓦奇

Sivage 是一个面向现代 Minecraft 的服务端 Fabric 模组，它让玩家能够在游戏世界中使用来自互联网的自定义图片。

与 Image2Map 或 Map4Image 等模组相比（Sivage 从中汲取了大量灵感），本模组试图通过提供可合成物品和GUI，而非指令，来提供一种更加生存友好的方式。

---

Sivage 的功能

以下是 Sivage 的几个方面，同时也作为一份简短的入门指南：

生存友好集成！	便于使用的 GUI！	效果出色的图片！

帮助翻译 Sivage！

支持的格式

处理来自互联网的图片时，一个常见问题是确定它们使用何种格式。Sivage 对最常用的格式提供了强大的支持：它支持 PNG、JPEG、WEBP、GIF、BMP、ICO、QOI、TIFF、FF、HDR 和 TGA。

这些应该涵盖了你在互联网上可能遇到的大部分（即使不是几乎全部）图片格式！

🛈 注意
不支持动画！虽然 GIF 或 WEBP 等格式可以使用，但在游戏中只会显示第一帧。

配置

本模组在服务端的 config/sivage/server.toml 提供了一个 TOML 文件，允许服务器所有者调整允许的来源：

# 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

🛈 注意
白名单和黑名单都允许使用通配符；更具体地说，* 表示所有内容，*.example.com 表示子域名通配符。IP 地址以及不遵循 HTTP(S) 的协议将始终被拒绝。

开发

为了让本模组能在任何 JVM 上支持尽可能多的格式，图像处理部分使用 Rust 编写，并通过编译为 Java 字节码的 WebAssembly 运行。

与任何直接为 JVM 开发的图像处理器相比，这种方法的处理速度较慢，代价是支持多种格式，并且几乎可以在任何 Java 发行版上运行，因为它完全不依赖 ImageIO。

有关从源码构建的更多信息，请参阅 Codeberg.org 上的 README.me

---

版权所有 © 2025-2026 Sammy L. Koch

Sivage 是自由软件：你可以根据自由软件基金会发布的 GNU 宽通用公共许可证条款（仅限许可证第 3 版）重新分发和/或修改它。

Sivage 的发布是希望它有用，但不提供任何担保；甚至不提供适销性或特定用途适用性的默示担保。有关更多详细信息，请参阅 GNU 宽通用公共许可证。

你应该已随本模组收到 GNU 宽通用公共许可证的副本。如果没有，请参阅 http://www.gnu.org/licenses/ 。