ProtocolLib — це бібліотека плагінів Minecraft, яка відкриває мережевий протокол для інших плагінів. Вона надає API для читання, зміни, скасування та надсилання сирих пакетів між сервером і клієнтом без потреби залежати від обфускованих внутрішніх класів сервера.

🎯 Призначення

ProtocolLib існує, щоб зробити роботу на рівні пакетів надійною та зручною в підтримці для розробників плагінів. Вона централізує доступ до пакетів через стабільний API, щоб кілька плагінів могли переглядати й змінювати трафік пакетів без прямого підключення до внутрішніх класів сервера.

⚙️ Функції

API у стилі подій для перехоплення вхідних і вихідних пакетів.
Засоби читання/запису для поширених полів пакетів (рядки, цілі числа, вектори тощо).
Можливість скасовувати пакети або змінювати їхній вміст до того, як вони досягнуть адресата.
Інструмент для створення та надсилання пакетів на стороні сервера.
Ховає обфусковані класи сервера за індексною системою читання/запису, щоб підвищити стабільність між версіями.
Поширюється як jar для сервера та може використовуватися як залежність під час компіляції для збірок плагінів.

🧩 Для кого це

Розробники плагінів, яким потрібен контроль на рівні пакетів (косметика, маскування, кастомні ефекти клієнта, мережеві утиліти).
Адміністратори серверів, які запускають плагіни, що залежать від прямого доступу до протоколу.

🏗️ Приклади використання

Прослуховування пакетів чату, щоб реалізувати серверний фільтр до застосування повідомлень.
Надсилання підготовленого пакета вибуху гравцеві, щоб створити ефект на стороні клієнта без зміни стану світу.
Реалізація маскування, кастомних анімацій або інших візуальних ефектів лише для клієнта, які потребують маніпуляції пакетами.

⌨️ Команди

ProtocolLib сам по собі не надає команд для гравців; це бібліотека для розробників, а не функціональний плагін.

⚙️ Встановлення

📥 Налаштування

Завантажте офіційний jar ProtocolLib і розмістіть його в каталозі plugins/ вашого сервера.
Перезапустіть сервер і перевірте консоль сервера, щоб переконатися, що плагін завантажився без помилок.
Під час розробки плагіна, який використовує ProtocolLib, додайте ProtocolLib як залежність під час компіляції та вкажіть його в маніфесті плагіна як залежність або soft-depend.

📦 Залежності

ProtocolLib не потребує інших серверних плагінів для роботи; він призначений для використання іншими плагінами як бібліотека.

🧾 Конфігурація

ProtocolLib створює власні файли конфігурації під час першого запуску. Конфігурацією окремих плагінів займаються самі плагіни, що використовують ProtocolLib.

🧠 Технічні примітки

ProtocolLib надає точку входу ProtocolManager для реєстрації слухачів пакетів і програмного надсилання пакетів.
Проєкт поширюється за ліцензією GPL-2.0.
Координати Maven/Gradle опубліковані для використання як залежність під час компіляції.
ProtocolLib підтримується з урахуванням сумісності з широким спектром версій серверів Minecraft; насамперед він орієнтований на серверне ПЗ, похідне від Bukkit.

🤝 Коли цей плагін корисний

Якщо вашому проєкту потрібно перевіряти або змінювати сирий протокол Minecraft (для ефектів на стороні клієнта, кастомної візуалізації або мережевих хуків), ProtocolLib централізує й стабілізує цю роботу, щоб кілька плагінів могли безпечно взаємодіяти з пакетами.

Сервери з плагіном ProtocolLib

Herocraft Online
RPG‑мережа з багатьма класами, тауншипами, підземеллями та економікою — для фанатів рольового виживання і PvP.
26
55.81
LinkCraft
Ком’юніті‑сервер Minecraft з акцентом на ранкапах, паркур‑курсах, лабіринтах і викликах — легкі міні‑ігри та прогресія.
15
55
Â'A savage place! / as holy and enchanted / As eâer beneath a waning moon was haunted.'Â - Coleridge
14
54.45
Restarting...
16
53.34
The Best In The Game
1 317
52.23
A Minecraft Server
9
51.9
CrafterCC Server 1.21.1+ Lucky Pillars (UPDATE) I Survival
7
51.62
Rooted Realm
Whitelisted Java survival SMP: нема запланованих вайпів, економіка гравців, щотижневі події та опційний PvP. Дружня доросла спільнота.
6
51.18
Froggie
Привітний survival SMP із захищеними клеймами, економікою з магазинами гравців і аукціонами, підтримкою кількох версій та cross-play між Java і Bedrock для казуальних будівельників і спільнот.
4
51.03
DaemoniaCraft
Towny‑орієнтований RPG Survival із кастомними мобами, економікою та підтримкою Bedrock — для любителів прогресії й гринду.
6
50.99
aÎ0° JîI ;DC:#0274 ¶H,1.7.10 [] [îÙ] [îT]
1
50.8
Smithtainment
Спільнотний survival‑SMP з кастомними плагінами, економікою, mcMMO та міні‑іграми — дружня спільнота й активний форум.
8
50.48
PMC64aa45a9bb6f43810dc643975f66fd24
3
50.2
Akoot&Co
Затишний SMP, орієнтований на спільноту, із підтримкою Java та Bedrock, публічною live-мапою світу, магазином донатів і зручностями для спокійного будівництва та дослідження.
3
49.92
Survival, exploration and origins reborn
3
49.86
Â âÂÂ°Ââ¢ ÂWelcome to, ÂÂEÂÂqÂÂuÂÂeÂÂsÂÂtÂÂrÂÂiÂÂfÂÂuÂÂn Ââ¢ÂÂ°ÂâÂ ÂJava McÂ â¨ ÂMinecraft Equestrian CommunityÂ â¦Â 1.21.11
8
49.33
Netherlite is loading...
1
49.06
ÂÂDÂÂIÂÂRÂÂKÂÂ.ÂÂUÂÂSÂ ÂÂÂÂÂÂÂTÂÂÂÂÂÂÂoÂÂÂÂÂÂÂwÂÂÂÂÂÂÂnÂÂÂÂÂÂÂy ÂÂÂÂÂÂÂSÂÂÂÂÂÂÂeÂÂÂÂÂÂÂrÂÂÂÂÂÂÂvÂÂÂÂÂÂÂeÂÂÂÂÂÂÂr
1
48.38
LilBoxPvP
Сервер, орієнтований на BoxPvP, зі швидкими боями на арені, дуелями та сезонним прогресом. Пропонує кастомні предмети, меню на базі NPC і, ймовірно, кросплей Java–Bedrock.
3
48.35
A Minecraft Server
1
48.22
Minecart Rapid Transit
Сервер, орієнтований на спільноту, для будівництва міст і транспорту, з поїздами, на яких можна їздити, великими транспортними мережами, захищеними будівлями, економікою, якою керують гравці, та організованими PvP-аренами.
5
48.21
GospelCraft
Християнський Towny‑survival з кастомними мобами, mcMMO і Jobs — Писання знайомлять через ігровий процес.
8
48.11
Realm of Elysium - SMP (1.21.10) Hestia Rebirth Incoming
5
47.95
MoodCraft
Французький survival SMP у стилі напів-RP, зосереджений на містах, якими керують гравці, економіці та міських проєктах — дружній прогрес із внутрішньоігровими гайдами, крамницями, роботами та надійним захистом скринь. Підтримуються Java та Bedrock.
2
47.35
TGG Online
Корейський сервер Minecraft у стилі FPS, що пропонує zombie survival і мініігри bomb/escape, із великою кількістю кастомної зброї, кастомних моделей та досвідом на базі resource pack.
1
46.5
Minetown
Голландський Minetopia‑стиль survival‑сервер з економікою, кастомними плагінами та дружньою спільнотою — почни пригоду вже зараз!
8
46.24
ÂÂÂ« ÂÂÂ« KRESS NETWORK Â« ÂÂÂ« ÂÂ1.9 - Latest ÂÂÂ» ÂÂÂ ÂÂLIVING RELUCTANTLY, DIE RELUCTANTLY
4
46.23
EthelMC
Ком’юніті‑виживання з економікою, приватами, аренами та кросплеєм (Java/Bedrock). Ранги, магазини гравців і івенти.
1
45.7
ÂJoin the OC Corporation today. ÂCreating the futureâ¢.
1
45.5
------------[-- Jujutsu Arai --]------------ Perma Death!
1
45.29

Сторінка плагіна ProtocolLib показує, на яких серверах моніторинг знайшов цей плагін, з якими платформами та версіями він зустрічається.

Плагіни можуть додавати команди, економіку, захист, права доступу, міні-ігри, інтеграції або інші механіки. Фактична роль ProtocolLib залежить від конфігурації конкретного сервера.

Дані формуються автоматично з технічних відповідей серверів. Якщо сервер приховує список плагінів, він може не відображатися в цьому розділі, навіть якщо використовує ProtocolLib.

Використовуйте список серверів з ProtocolLib, щоб порівняти проєкти, перевірити сумісні версії або знайти приклади використання плагіна на публічних серверах.