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

Â'A savage place! / as holy and enchanted / As eâer beneath a waning moon was haunted.'Â - Coleridge
20
55.9
Herocraft Online
RPG‑мережа з багатьма класами, тауншипами, підземеллями та економікою — для фанатів рольового виживання і PvP.
25
55.72
aÎ0° JîI ;DC:#0274 ¶H,1.7.10 [] [îÙ] [îT]
20
52.66
Restarting...
9
52.56
LinkCraft
Ком’юніті‑сервер Minecraft з акцентом на ранкапах, паркур‑курсах, лабіринтах і викликах — легкі міні‑ігри та прогресія.
10
52.49
The Best In The Game
1 456
52.21
Rooted Realm
Whitelisted Java survival SMP: нема запланованих вайпів, економіка гравців, щотижневі події та опційний PvP. Дружня доросла спільнота.
6
51.59
A Minecraft Server
8
51.42
ÂÂDÂÂIÂÂRÂÂKÂÂ.ÂÂUÂÂSÂ ÂÂÂÂÂÂÂTÂÂÂÂÂÂÂoÂÂÂÂÂÂÂwÂÂÂÂÂÂÂnÂÂÂÂÂÂÂy ÂÂÂÂÂÂÂSÂÂÂÂÂÂÂeÂÂÂÂÂÂÂrÂÂÂÂÂÂÂvÂÂÂÂÂÂÂeÂÂÂÂÂÂÂr
5
50.85
Netherlite is loading...
6
50.83
Froggie
Привітний survival SMP із захищеними клеймами, економікою з магазинами гравців і аукціонами, підтримкою кількох версій та cross-play між Java і Bedrock для казуальних будівельників і спільнот.
3
50.2
PMC64aa45a9bb6f43810dc643975f66fd24
3
49.79
GospelCraft
Християнський Towny‑survival з кастомними мобами, mcMMO і Jobs — Писання знайомлять через ігровий процес.
3
49.67
DaemoniaCraft
Towny‑орієнтований RPG Survival із кастомними мобами, економікою та підтримкою Bedrock — для любителів прогресії й гринду.
3
49.67
Survival, exploration and origins reborn
2
49.52
LilBoxPvP
Сервер, орієнтований на BoxPvP, зі швидкими боями на арені, дуелями та сезонним прогресом. Пропонує кастомні предмети, меню на базі NPC і, ймовірно, кросплей Java–Bedrock.
4
49.38
74cfa150c71373fdd9073e5a19aff9d5
8
48.99
CrafterCC Server 1.21.1+ Lucky Pillars (UPDATE) I Survival
2
48.52
A Minecraft Server
1
48.24
www.ÂÂMedievalCraftÂ.org - ÂÂDas OriginalÂ seit 2011 Â> Mittelalter-RPG | StÃ¤dte | Handel | Roleplay | RP <
3
48.11
ÂÂbombaSMP.org ÂÂâ ÂÂMount Olympus ÂÂ» ÂOpen World Vanilla ÂÂ» ÂEnter the Forge of the Gods
1
48.01
Akoot&Co
Затишний SMP, орієнтований на спільноту, із підтримкою Java та Bedrock, публічною live-мапою світу, магазином донатів і зручностями для спокійного будівництва та дослідження.
1
47.97
Smithtainment
Спільнотний survival‑SMP з кастомними плагінами, економікою, mcMMO та міні‑іграми — дружня спільнота й активний форум.
0
47.95
Minecart Rapid Transit
Сервер, орієнтований на спільноту, для будівництва міст і транспорту, з поїздами, на яких можна їздити, великими транспортними мережами, захищеними будівлями, економікою, якою керують гравці, та організованими PvP-аренами.
1
47.79
Â âÂÂ°Ââ¢ ÂWelcome to, ÂÂEÂÂqÂÂuÂÂeÂÂsÂÂtÂÂrÂÂiÂÂfÂÂuÂÂn Ââ¢ÂÂ°ÂâÂ ÂJava McÂ â¨ ÂMinecraft Equestrian CommunityÂ â¦Â 1.21.11
2
47.54
TGG Online
Корейський сервер Minecraft у стилі FPS, що пропонує zombie survival і мініігри bomb/escape, із великою кількістю кастомної зброї, кастомних моделей та досвідом на базі resource pack.
18
47.47
ÂÂQuÃªtes en cours... ÂÂÂJoyeuse FÃªtes !!!
3
46.96
Racsu Planet
Cross-play Survival MMORPG (Java + Bedrock) з навичками, квестами, кастомними підземеллями та внутрішньоігровою економікою, що підтримується офіційним магазином і спільнотним хабом.
1
46.06
EthelMC
Ком’юніті‑виживання з економікою, приватами, аренами та кросплеєм (Java/Bedrock). Ранги, магазини гравців і івенти.
6
45.43
MoodCraft
Французький survival SMP у стилі напів-RP, зосереджений на містах, якими керують гравці, економіці та міських проєктах — дружній прогрес із внутрішньоігровими гайдами, крамницями, роботами та надійним захистом скринь. Підтримуються Java та Bedrock.
0
44.63

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

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

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

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