Sivage

Sivage — это серверный мод для Fabric для современных версий Minecraft, который даёт игрокам возможность использовать Custom Image из интернета прямо в игровом мире.

По сравнению с такими модами, как Image2Map или Map4Image, из которых Sivage черпает вдохновение, он старается предложить более дружелюбный к выживанию подход, предоставляя крафтящиеся предметы и GUI, а не команды.

Возможности Sivage

Вот несколько аспектов Sivage, которые также послужат небольшим стартовым руководством:

Дружелюбная к выживанию интеграция!	GUI для простого использования!	Отлично выглядящие изображения!

Поддерживаемые форматы

Одна из частых проблем с изображениями из интернета — убедиться, какой формат они используют. Sivage отлично поддерживает самые используемые форматы: PNG, JPEG, WEBP, GIF, BMP, ICO, QOI, TIFF, FF, HDR и TGA.

Этого должно хватить для большинства, если не почти всех, форматов изображений, которые вы можете встретить в интернете!

🛈 Примечание
Анимации не поддерживаются! Хотя такие форматы, как GIF или WEBP, работают, в игре будет показан только первый кадр.

Переводы

Установив Sivage также на клиент, игроки получают доступ к другим языкам помимо английского.

Если вы хотите помочь с переводом этого мода, перейдите на наш Weblate!

Конфигурация

Этот мод поставляется с TOML-файлом на сервере по пути config/sivage/server.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

🛈 Примечание
И белый, и чёрный список допускают использование подстановочных знаков; если точнее, * для всего и *.example.com для поддоменов. IP-адреса и протоколы, не использующие HTTP(S), всегда будут отклоняться.

Разрешения

Установив мод на права вроде LuckPerms или используя любой мод на защиту территорий на свой выбор, можно настроить в Sivage, кто и где может использовать Custom Image.

Разработка

Чтобы мод работал с как можно большим числом форматов на любой JVM, часть, отвечающая за обработку изображений, написана на Rust и запускается через WebAssembly, скомпилированный в байт-код Java.

Ценой более медленной обработки по сравнению с любым другим обработчиком изображений, разработанным напрямую для JVM, этот подход поддерживает множество форматов и работает практически на любом дистрибутиве Java, так как вообще не зависит от ImageIO.

Подробнее о сборке из исходников читайте в README.me на Codeberg.org.