Содержание:
- В чём суть этого плагина?
- Функционал плагина и техническая часть
- Собственное API
В чём суть этого плагина?
Плагин рассчитан на аудиторию из ЕС, подобные идеи не советуем реализовывать в СНГ, однако за границей подобные плагины пользуются спросом.
У вас есть свой NFT, а как мы знаем, у каждой NFT есть своя картинка. Хотите продемонстрировать всему серверу свою крутость, показав, что у вас есть NFT?
Пишите команду, проходите верификацию (чтобы сервер точно понял, что вы имеете в наличие этот NFT и он не чужой) после чего вам выдастся карта с вашим изображением в любом размере, который вы выберите. Эту картинку можно будет повесить возле своего дома, или где-то в мире, после чего весь сервер узнает о вашей крутизне. Можно будет устраивать соревнования, или просто украшать ими сервер.
На сервере нет возможности просто так взять и любую картинку повесить в рамку. Только через верификацию, введя свой токен, если сервер возвращает положительный ответ, вы получаете карту.
Функционал плагина. Техническая часть
Команды:
В плагине присутствуют 4 команды: `verify`, `nft`, `anft`, `nftclean`.
/anft verify:
Отправляет POST запрос на сервер `ip:port/verify` (`ip:port` настраиваются в конфиге), где в BODY помещается `signature`.
Пример использования:
Игрок TRXILBLXXD выполняет команду `/verify 0xe86gu3562919c...`
После которого плагин формирует json:
```json
{
"username": "TRXILBLXXD",
"signature": "0xe86gu3556919c..."
}
```
и отправит запрос серверу выше асинхронно.
/nft - команда для получения NFT игрока с ника. Не включает в себя дополнительные параметры.
Отправляет GET запрос на сервер `ip:port/nft/<player>` (`ip:port` настраиваются в конфиге). Пример ответа:
```json
{
"isError": false,
"errorId": 0,
"nfts": [
{
"title": "Pacemaker #1062",
"description": "Pacemaker is a membership club for fine digital street art, bringing together collectors and artists. Founded by street culture legend TILL JAGLA & fueled by global fashion & tech platform ABOUT YOU. PFP art by LOOPINGLOVERS.",
"tokenId": "1062",
"imageURL": "https://meta.pacemakernft.xyz/qoDHoN/1062.jpg",
"address": "0xf9adb39ae220b187cbe4943fc9af2c86196dd186"
}
]
}
```
Поле `nfts` содержит массив обьектов со следующими параметрами:
`"title"` - название NFT,
`"description"` - его описание,
`"tokenId"` - tokenId,
`"imageURL"` - ссылка на изображение,
`"address"` - адресс.
Пример использования:
Игрок TRXILBLXXD выполняет команду `/nft`.
Плагин отправляет запрос серверу выше и получает ответ. Если ответ будет ошибкой, то отправляет игроку подробности об ошибке (`errors.yml`) полученной по коду.
Если у игрока не будет NFT, то плагин отправит игроку сообщение из конфига в чат.
Если у игрока будет NFT, то плагин построит на их базе настраиваемый в конфиге GUI, где отобразятся все NFT. После которого игрок сможет нажать на них, выбрать его размер и получить как картину.
После запроса данные об количестве и сами NFT кэшируются как `HashedNFT` и `BufferedNFT`, которые сбрасываются через время из конфига.
Так же у NFT есть свой лимит по группам, который устанавливается в конфиге, чтобы у игроков был стимул покупать донат и размещать больше своих NFT. А весь интерфейс изображён в GUI. На видео плагин на русском языке, но на сервере он полностью на английском.
Собственное API
Для написания других плагинов, которые будут использовать проверку/взаимодействие с NFT, наши разработчики написали собственное API, для того, чтобы им пользоваться в других разработках.
Покажем вам немного методов:
