Како направити Minecraft плагин са GUI менијима

Корак по корак

1. 1.Скицирај мени

   Мени у облику сандука има од 1 до 6 редова по 9 слотова (од 9 до 54). Напиши који предмет иде у који слот, шта ради сваки клик и који слотови су само украс, на пример стаклени панели.

2. 2.Направи инвентар са holder-ом

   Отвори га са Bukkit.createInventory(holder, size, title), уз сопствену класу InventoryHolder. По holder-у плагин зна да се клик десио у његовом менију, а не у обичном сандуку.

3. 3.Обради кликове

   У InventoryClickEvent провери holder, поништи догађај, па покрени акцију за тај слот. После акције затвори мени или га освежи.

4. 4.Блокирај сваки други начин померања предмета

   Поништи и InventoryDragEvent и обради shift-кликове, тастере са бројевима и кликове у играчевом инвентару док је мени отворен.

5. 5.Додај странице ако је листа дугачка

   За warp-ове или предмете у продавници који не стају, резервиши доњи ред за дугмад претходно, следеће и затвори.

6. 6.Отвори га командом

   На пример /warps, или преко предмета или NPC-ја. Дај команди дозволу ако мени није за све.

7. 7.Направи билд и прођи кроз њега кликовима

   Пусти Codexe да компајлира плагин, уђи на тест сервер и кликни свако дугме. И тест играчи могу да отворе мени и кликну слотове уместо тебе.

Правила која мени чувају безбедним

• Препознај мени по његовом holder-у, никада по наслову: наслов може да копира сваки преименовани сандук.
• Поништи клик пре било чега другог, да грешка у акцији никада не остави предмет на курсору играча.
• Поништи превлачења и shift-кликове из играчевог инвентара, иначе предмети могу да се убаце у мени.
• Не веруј предмету у слоту: тражи акцију по броју слота или по ознаци на предмету.
• Спор посао (читање из базе, веб захтеви) покрећи ван главне нити и ажурирај мени кад се заврши.

Менији из конфигурације

Власници сервера воле да мењају меније без новог билда. Затражи да сваки мени буде дефинисан у конфигурационом фајлу, са величином, насловом и, за свако дугме, слотом, материјалом, именом, lore-ом и акцијом:

Пример описа

„Paper 1.21.4 плагин под називом WarpMenu. /warps отвара мени од 6 редова са једним дугметом по warp-у, 45 по страници, са дугмадима претходно, следеће и затвори у доњем реду. Админи додају warp-ове са /setwarp <name> <material> и бришу их са /delwarp. Клик на warp телепортује после загревања од 3 секунде које се прекида при кретању. Играчи не могу да узму нити помере ниједан предмет у менију. Warp-ови се чувају у warps.yml, наслов менија, имена дугмади и поруке у config.yml.“

Тестирање менија уз тест играче

Codexe тест играчи могу да отворе мени и кликну слот, па да провере да ли се отворио мени, појавила порука или добио предмет. Додај тест својим речима, на пример „обичан играч покреће /warps, кликне слот 0 и види поруку о телепортовању“, и он ће се поново покретати сваки пут кад Codexe испоручи измену.

Питања