RidovLegacy

🔷 RidovLegacy

🇬🇧 English | 🇷🇺 Русский

🇬🇧 English

RidovLegacy is a lightweight Minecraft plugin designed to improve item compatibility and display for legacy Minecraft clients connected through ViaBackwards.

The plugin modifies the client-side representation of items without globally changing the original items on the server.

✨ Features

• Removes version prefixes from displayed item names for legacy players
• Works specifically with players connected through ViaBackwards
• Does not modify items globally on the server
• Changes only the client-side representation of items
• Processes items in inventories, slots and equipment
• Automatically detects the required adapter for the server version
• Supports server versions 1.16.5 – 1.21.11
• Separate compatibility handling for 1.16.5 – 1.20.4 and 1.20.5 – 1.21.11
• Can clear the display of unsupported items for legacy clients
• Includes a debug mode for diagnostics
• Can be disabled through config.yml
• Checks required dependencies during startup
• Automatically disables itself if a required dependency is missing

🌐 Compatibility

Server versions: 1.16.5 – 1.21.11

⚠️ Versions below 1.21.6 are currently considered beta support. Bugs and compatibility issues may occur on these versions.

📋 Requirements

• Paper / Purpur
• ViaVersion
• ViaBackwards
• ProtocolLib

All dependencies are required.

RidovLegacy automatically checks for the required dependencies when the server starts and disables itself if one of them is missing.

⚙️ Configuration

RidovLegacy can be configured through:

plugins/RidovLegacy/config.yml

The plugin can be enabled or disabled through the configuration.

A debug mode is available for diagnosing compatibility and item-rewriting issues.

🔧 How It Works

RidovLegacy works only with legacy players connected through ViaBackwards.

The plugin can rewrite the client-side representation of an item when necessary.

The original server-side item is not globally replaced or modified.

Example:

Server: 1.21.11
Client: 1.16.5

The server continues to use its original item data, while RidovLegacy can adjust how the item is displayed to the legacy client.

🐛 Troubleshooting

If you encounter a problem:

1. Check that ViaVersion is installed.
2. Check that ViaBackwards is installed.
3. Check that ProtocolLib is installed.
4. Check the server console for errors.
5. Enable debug mode in config.yml.
6. Reproduce the problem.
7. Include the relevant console/debug information when reporting the issue.

🎮 Demo Server

Our plugins can be tested on the RidovPlugins demo server:

mc.ridovcraft.ru

The demo server is currently under development.

🔷 RidovPlugins

RidovLegacy is part of RidovPlugins, a project focused on developing practical Minecraft plugins and custom systems for Minecraft servers.

More plugins and systems will be released in the future.

RidovPlugins — Creating tools we would want to use ourselves.

Links

Telegram: @RidovPlugins
VK: vk.com/ridovplugins

🇷🇺 Русский

RidovLegacy — лёгкий Minecraft-плагин для улучшения совместимости и отображения предметов у игроков со старыми версиями Minecraft, подключённых через ViaBackwards.

Плагин изменяет клиентское представление предметов, не изменяя оригинальные предметы глобально на сервере.

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

• Убирает версионные префиксы из отображаемых названий предметов у Legacy-игроков
• Работает только с игроками, подключёнными через ViaBackwards
• Не изменяет предметы глобально на сервере
• Изменяет только клиентское отображение предметов
• Обрабатывает предметы в инвентарях, слотах и экипировке
• Автоматически определяет необходимый адаптер для версии сервера
• Поддерживает серверные версии 1.16.5 – 1.21.11
• Имеет отдельную совместимость для 1.16.5 – 1.20.4 и 1.20.5 – 1.21.11
• Может очищать отображение неподдерживаемых предметов для старых клиентов
• Имеет debug-режим для диагностики
• Может быть отключён через config.yml
• Проверяет необходимые зависимости при запуске
• Автоматически отключается при отсутствии обязательной зависимости

🌐 Совместимость

Версии сервера: 1.16.5 – 1.21.11

⚠️ Версии ниже 1.21.6 сейчас считаются бета-поддержкой. На них возможны баги и проблемы совместимости.

📋 Требования

• Paper / Purpur
• ViaVersion
• ViaBackwards
• ProtocolLib

Все зависимости обязательны.

RidovLegacy автоматически проверяет необходимые зависимости при запуске и отключается, если одна из них отсутствует.

⚙️ Настройка

RidovLegacy настраивается через:

plugins/RidovLegacy/config.yml

Плагин можно отключить через конфигурацию.

Также доступен debug-режим для диагностики проблем с совместимостью и переписыванием предметов.

🔧 Как работает плагин

RidovLegacy работает только с Legacy-игроками, подключёнными через ViaBackwards.

При необходимости плагин изменяет клиентское представление предмета.

Оригинальный предмет на сервере глобально не заменяется и не изменяется.

Пример:

Сервер: 1.21.11
Клиент: 1.16.5

Сервер продолжает использовать оригинальные данные предмета, а RidovLegacy изменяет его отображение для игрока со старой версией клиента.

🐛 Если возникла проблема

1. Проверьте наличие ViaVersion.
2. Проверьте наличие ViaBackwards.
3. Проверьте наличие ProtocolLib.
4. Проверьте консоль сервера на наличие ошибок.
5. Включите debug-режим в config.yml.
6. Повторите действие, при котором возникает проблема.
7. При сообщении об ошибке приложите соответствующую информацию из консоли и debug-режима.

🎮 Демо-сервер

Наши плагины можно протестировать на демо-сервере RidovPlugins:

mc.ridovcraft.ru

Демо-сервер сейчас находится в разработке.

🔷 RidovPlugins

RidovLegacy является частью RidovPlugins — проекта по разработке практичных Minecraft-плагинов и собственных систем для серверов.

В дальнейшем будет выпущено больше плагинов и систем.

RidovPlugins — создаём инструменты, которыми сами хотим пользоваться.

Ссылки

Telegram: @RidovPlugins
VK: vk.com/ridovplugins