version 1.1

Main.java -> GiftAPI.java
This commit is contained in:
ScriptCat 2025-07-30 10:49:46 +03:00
parent 31af80f62e
commit 1bb8d01a67

View File

@ -9,56 +9,57 @@ GiftAPI
Использование Использование
------------- -------------
1. Скачайте релиз или соберите плагин сами. 1. Скачайте релиз или соберите плагин сами.
2. Переместите в папку КОРНЕВАЯ-ПАПКА-СЕРВЕРА/plugins. 2. Переместите в папку `КОРНЕВАЯ-ПАПКА-СЕРВЕРА/plugins`.
3. Скопируйте в рут папку вашего плагина. 3. Скопируйте в рут папку вашего плагина.
4. В вашей IDE импортируете giftapi.jar. 4. В вашей IDE импортируете `giftapi.jar`.
5. *Используйте пример использования и документация для использования API* 5. *Используйте пример использования и документация для использования API*
6. Соберите ваш плагин в JAR. 6. Соберите ваш плагин в JAR.
7. Скопируйте получившися JAR файл в КОРНЕВАЯ-ПАПКА-СЕРВЕРА/plugins. 7. Скопируйте получившися JAR файл в `КОРНЕВАЯ-ПАПКА-СЕРВЕРА/plugins`.
3. Запустите сервер или введите команду /reload. 3. Запустите сервер или введите команду `/reload`.
Документация Документация
------------ ------------
1. 'add(player, item)' ### `add(player, item)`
- Описание: добавляет предмет в кастомные инвентарь игрока. - **Описание**: добавляет предмет в кастомные инвентарь игрока.
- Параметры: - **Параметры**:
- 'player' (Player): игрок которому нужно добавить предмет. - `player` (`Player`): игрок которому нужно добавить предмет.
- 'item' (ItemStack): предмет который должен быть сохранен в инвентарь. - `item` (`ItemStack`): предмет который должен быть сохранен в инвентарь.
2. 'remove(player, item)' ### `remove(player, item)`
- Описание: удаляет предмет из кастомного инвентаря игрока. - **Описание**: удаляет предмет из кастомного инвентаря игрока.
- Параметры: - **Параметры**:
- 'player' (Player): игрок которому нужно удалить предмет. - `player` (`Player`): игрок которому нужно удалить предмет.
- 'item' (ItemStack): предмет который должен быть удалён из инвентаря. - `item` (`ItemStack`): предмет который должен быть удалён из инвентаря.
3. 'openGUI()' ### `openGUI()`
- Описание: открывает кастомный инвентарь игрока. - **Описание**: открывает кастомный инвентарь игрока.
- Параметры: - **Параметры**:
- 'player' (Player): игрок которому нужно открыть кастомный инвентарь. - `player` (`Player`): игрок которому нужно открыть кастомный инвентарь.
Пример Использования Пример Использования
-------------------- --------------------
... ```import tokarotik.giftapi.GiftAPI;
import tokarotik.giftapi.GiftAPI; // Get plugin instance
...
// get plugin
Plugin plugin = Bukkit.getPluginManager().getPlugin("GiftAPI"); Plugin plugin = Bukkit.getPluginManager().getPlugin("GiftAPI");
if (plugin != null && plugin.isEnabled() && plugin instanceof GiftAPI) { if (plugin != null && plugin.isEnabled() && plugin instanceof GiftAPI) {
// set up api // Set up API
GiftAPI giftAPI = (GiftAPI) plugin; GiftAPI giftAPI = (GiftAPI) plugin;
// find first online player
// Get the first online player
Player player = Bukkit.getOnlinePlayers()[0]; Player player = Bukkit.getOnlinePlayers()[0];
// create item stick
// Create an item (stick)
ItemStack item = new ItemStack(Material.STICK); ItemStack item = new ItemStack(Material.STICK);
// add to player stick
// Add item to player's custom inventory
giftAPI.add(player, item); giftAPI.add(player, item);
// open inventory
// Open the custom inventory GUI
giftAPI.openGUI(player); giftAPI.openGUI(player);
} }
```
Требования Требования
---------- ----------