VINFECTION

VINFECTION

Create infections that change the way players survive.

vinfectio is a server plugin for Paper and Purpur that lets you build your own infections in an in-game admin menu. Give each disease a name, design up to 10 stages, and decide how its symptoms develop: subtle particles, recurring weakness, sunlight burning, unusual movement, temporary changes to the world, or creative-style flight.

Use it for survival events, roleplay campaigns and custom mutations. Let infections spread through sneezes, or keep transmission disabled and assign everything yourself with commands. Players join with an ordinary Minecraft client.

At a glance

The current build targets Paper API 26.2. It has been loaded successfully on Purpur 26.2. Other Paper forks have not been verified. Folia, Spigot/CraftBukkit, vanilla servers, Fabric and Forge are not supported by this build.

• Up to 10 stages per disease. Set a name and real-time duration for each stage. Use 0 for manual progression; the final stage remains until treatment.
• Potion symptoms. Choose registered Minecraft effects, levels, icons and particles. Maintain an effect continuously, or roll a configurable chance at an interval for a chosen duration.
• Particles. Combine multiple rules with their own type, count, interval, spread, speed and supported particle data.
• Transmission through sneezes. Configure sneeze timing, chance, range and infection probability. Disable transmission globally or for a particular disease.
• Symptoms for a specific nickname. Bind an individual rule to an account name, without entering a UUID. Other infected players on the same stage can have different symptoms.
• Skin overlays per stage. Apply transparent PNG layers to a player's base skin through SkinsRestorer. Choose separate overlays for classic and slim models.
• Persistent progression. Stage time continues while players are offline. Infections and symptom timers are saved automatically.
• Quiet by default. Infection, stage-change and recovery messages to players are disabled in the default configuration.

Sunlight, controls, vulnerability and flight can be continuous or activate on a schedule with a chance and duration. Block rules have their own interval and chance. Each of these rules can also target a nickname.

Flight time is consumed only while flying. Landing pauses the budget; exhausting it starts the cooldown. Remaining time, cooldown and takeoff reference survive reconnects and normal restarts. The height reference stays the same until landing; teleporting creates a new reference point. Existing creative/spectator flight and flight already granted by another plugin are left under their original control.

The block-support switch requires a solid, full upper face directly beneath the destination. Air, plants and fluids do not count. Temporary block changes are tracked for restoration; permanent block creation is also available.

Installation

1. Stop your Paper/Purpur 26.2 server and make sure it uses Java 25.
2. Put vinfectio-1.5.0.jar in the server's plugins folder. Keep only one vinfectio JAR installed.
3. If you want skin overlays, install SkinsRestorer 15.12.6 and configure its MineSkin access.
4. Start the server. vinfectio creates plugins/vinfectio/.
5. Join as an operator, or grant vinfectio.admin, then run /vi.

Your first infection

1. In /vi, select Создать инфекцию (“Create infection”) and enter a name in chat, for example Violet Fever.
2. Open the infection and its first stage. Give the stage a name and duration.
3. Add effects under Эффекты and particles under Частицы. For other symptoms, open Дополнительные функции (“Additional functions”).
4. Add further stages with Добавить стадию (“Add stage”), up to 10 in total.
5. Decide whether this infection can spread. The global transmission switch and the infection's transmission switch must both be enabled for spread.
6. Assign the first stage to a player who has joined the server:

/infect Steve "Violet Fever" 1

An example configuration to create in the menu:

Time inputs include 10s, 5m, 2h, 3d and 1h30m. A day means 24 real hours. For violet DUST, use particle data #AA55FF,1. A stage duration of 0 keeps progression under admin control.

To end the infection:

/uninfect Steve

Values entered through the menu are saved automatically. The chat input stays private. Use /vi cancel to cancel an input. Editing an infection resets its symptom cycles and flight budget, while preserving the stage start time.

Give one player a specific symptom

Open a symptom and click the player-head Игрок (“Player”) button. Left-click and enter an account name such as Steve. Matching ignores letter case. Right-click to clear the binding; * or все also applies the rule to everyone infected on that stage.

The binding selects who receives that symptom; the player must already have the corresponding infection and stage. Renaming an account requires updating the binding.

Add a skin layer

1. Create a 64×64 transparent PNG using the Minecraft skin layout.
2. Place it in plugins/vinfectio/overlays/, for example rash.png.
3. Open a stage and select the file under Слой classic. Use Слой slim for a separate slim-arm version if needed.
4. Configure MineSkin generation in SkinsRestorer. The first application requires network access and may take time; generated results are cached.
5. Use the stage's test button or check /vi status Steve. Treatment restores the base skin.

External skin processing: when an overlay is generated, the composed skin PNG is sent to MineSkin through SkinsRestorer to obtain a signed Minecraft texture. Service availability and limits apply. Leave skin overlays unused or disable skins.enabled if you do not want this processing.

Commands and permissions

vinfectio.admin grants administration and defaults to operators. vinfectio.immune blocks sneeze transmission; it is not granted automatically, and /infect bypasses it. Infection and treatment commands also work from the console and for offline players who have previously joined.

Practical details

A player has one infection at a time. Assigning another infection replaces the previous one and restarts stage timing. Milk and death do not cure an infection; use /uninfect.

WASD reversal is a server-side impulse effect, rather than a client key remap. Mouse inversion is disabled. Client-only keys and menus such as Esc, F3, F5 and opening the inventory cannot be disabled by this plugin. Inventory restrictions prevent item transfers.

Definitions are stored in infections.yml; infections, progression and flight state are in players.yml. Use /vi reload after manual definition edits. Stop the server before editing player data. Keep temporary-blocks.yml while temporary changes exist.

The mascot artwork is project branding. It is not an in-game mob or a custom model added by the plugin.

Создавай инфекции, которые меняют привычное выживание.

vinfectio — серверный плагин для Paper и Purpur, в котором ты собираешь собственные болезни через игровое меню администратора. Придумай название, создай до 10 стадий и настрой развитие симптомов: от едва заметных частиц и периодической слабости до горения на солнце, необычного движения, временного изменения блоков и полёта как в креативе.

Плагин подойдёт для событий на сервере, ролевых историй и собственных мутаций. Разреши передачу через чих или отключи её и назначай заражения командами. Игрокам достаточно обычного клиента Minecraft.

Главное о сборке

Сборка рассчитана на Paper API 26.2; загрузка проверена на Purpur 26.2. Другие форки Paper отдельно не проверены. Folia, Spigot/CraftBukkit, ванильное ядро, Fabric и Forge этой сборкой не поддерживаются.

Собери свою инфекцию

• До 10 стадий на болезнь. Задай название и длительность каждой стадии в реальном времени. Значение 0 оставляет переход под управлением администратора; последняя стадия сохраняется до лечения.
• Эффекты как симптомы. Выбирай доступные эффекты Minecraft, уровень, значок и частицы. Поддерживай эффект постоянно или задавай шанс проявления раз в определённое время и его длительность.
• Частицы. Совмещай несколько правил со своим типом, количеством, интервалом, разбросом, скоростью и дополнительными данными.
• Передача через чих. Настраивай частоту, вероятность, радиус и шанс заражения. Выключай передачу для одной болезни или для всего плагина.
• Симптом для конкретного ника. Привязывай отдельное правило к имени аккаунта без ввода UUID. Игроки на одной стадии могут получать разные симптомы.
• Слой скина для каждой стадии. Накладывай прозрачный PNG на базовый скин через SkinsRestorer. Для classic и slim можно выбрать разные картинки.
• Сохранение прогресса. Время стадий идёт и вне игры. Заражения и таймеры симптомов сохраняются автоматически.
• Без лишних сообщений игрокам. Уведомления о заражении, переходе стадии и лечении выключены по умолчанию.

Дополнительные симптомы стадии

Солнце, управление, уязвимость и полёт могут действовать постоянно или проявляться по шансу с заданными интервалом и длительностью. Правила блоков имеют собственные интервал и шанс. Каждое такое правило можно привязать к нику.

Время полёта расходуется только в полёте. Посадка ставит счётчик на паузу, а исчерпание запаса запускает КД. Оставшееся время, КД и точка взлёта сохраняются после выхода и штатного перезапуска. Точка отсчёта высоты сохраняется до приземления; телепортация задаёт новую. Полёт креатива/наблюдателя и уже выданная другим плагином способность остаются под прежним управлением.

Переключатель опоры требует твёрдую полную верхнюю грань непосредственно под местом появления блока. Воздух, растения и жидкости не подходят. Временные изменения блоков отслеживаются для восстановления; также доступно постоянное создание блоков.

Установка

1. Останови сервер Paper/Purpur 26.2 и убедись, что он запускается на Java 25.
2. Положи vinfectio-1.5.0.jar в папку plugins. Оставь установленным только один JAR vinfectio.
3. Для слоёв скина установи SkinsRestorer 15.12.6 и настрой в нём доступ к MineSkin.
4. Запусти сервер. Плагин создаст папку plugins/vinfectio/.
5. Зайди с правами оператора или выдай vinfectio.admin, затем выполни /vi.

Первая инфекция

1. В /vi нажми Создать инфекцию и введи название в чат, например Фиолетовая лихорадка.
2. Открой инфекцию и её первую стадию. Задай название и длительность стадии.
3. Добавь эффекты в разделе Эффекты, частицы — в разделе Частицы. Остальные симптомы находятся в Дополнительных функциях.
4. Создай следующие стадии кнопкой Добавить стадию — всего до 10.
5. Реши, будет ли болезнь передаваться. Для передачи должны быть включены глобальный переключатель и переключатель самой инфекции.
6. Назначь первую стадию игроку, который уже заходил на сервер:

/infect Steve "Фиолетовая лихорадка" 1

Пример, который можно собрать в меню:

Время вводится как 10s, 5m, 2h, 3d или 1h30m. Сутки — 24 реальных часа. Данные фиолетовых частиц DUST: #AA55FF,1. Длительность стадии 0 оставляет переход под управлением администратора.

Для лечения:

/uninfect Steve

Изменения через меню сохраняются автоматически. Ввод настроек в чат не виден другим игрокам. /vi cancel отменяет ввод. Редактирование инфекции сбрасывает циклы симптомов и запас полёта, сохраняя время начала стадии.

Привязка отдельного симптома к нику

Открой симптом и нажми на голову игрока Игрок. ЛКМ — ввести имя аккаунта, например Steve; регистр не важен. ПКМ снимает привязку. Ввод * или все также применяет правило ко всем заражённым на этой стадии.

Привязка определяет получателя симптома; у игрока уже должны быть соответствующие болезнь и стадия. После смены ника аккаунта привязку нужно обновить.

Слой скина

1. Подготовь прозрачный PNG 64×64 по развёртке Minecraft-скина.
2. Положи его в plugins/vinfectio/overlays/, например rash.png.
3. В стадии выбери картинку через Слой classic. Для узких рук при необходимости укажи отдельный файл в Слой slim.
4. Настрой генерацию MineSkin в SkinsRestorer. Первое применение требует доступа к сети и может занять время; готовые результаты кэшируются.
5. Используй проверку слоя в меню или /vi status Steve. Лечение возвращает базовый скин.

Внешняя обработка скина: при генерации итоговый PNG отправляется в MineSkin через SkinsRestorer для получения подписанной текстуры Minecraft. Действуют доступность и лимиты сервиса. Если такая обработка не нужна, не назначай слои или выключи skins.enabled.

Команды и права

vinfectio.admin даёт управление плагином и по умолчанию доступно операторам. vinfectio.immune защищает от передачи через чих, не выдаётся автоматически и не мешает /infect. Команды заражения и лечения работают из консоли и для игроков вне сети, если они уже заходили на сервер.

Полезные детали

У игрока одновременно одна инфекция. Назначение другой заменяет предыдущую и заново запускает время стадии. Молоко и смерть не лечат болезнь — для лечения есть /uninfect.

Обратное движение WASD создаётся серверными импульсами, без переназначения клавиш клиента. Инверсия мыши отключена. Esc, F3, F5 и открытие окна инвентаря недоступны серверной блокировке. Ограничение инвентаря запрещает перенос предметов.

Определения хранятся в infections.yml, заражения, прогресс и состояние полёта — в players.yml. После ручной правки определений используй /vi reload. Перед редактированием данных игроков останавливай сервер. Сохраняй temporary-blocks.yml, пока существуют временные изменения.

Вирус на иллюстрациях — маскот проекта. Плагин не добавляет этого моба или отдельную модель в игру.