Slash Invite

Slash Invite

В 3 часа ночи тебя будит непрерывно жужжащий телефон:
"эй, можешь добавить в вайтлист аккаунт UserElaina??"
Знакомо? Такие сцены происходят по всей Minecraftia. Ты можешь стать следующим. Если, конечно, не позволишь этому плагину изменить твою жизнь. Скажи друзьям, чтобы приглашали своих друзей сами через простую команду /invite. Больше никаких ночных сообщений! Больше никаких «подожди, пока я приду домой»! Ежегодный летний выживальческий SMP-сервер по Minecraft стал доступен только по приглашениям — без вмешательства админов! Этот плагин / мод только для сервера поддерживает:

• Spigot (Minecraft 1.17 – 26.3)
• Fabric (Minecraft 26.2 – 26.3)
• NeoForge (Minecraft 26.2 – 26.3) Это красивая обёртка над ванильным функционалом. Если ты ждёшь от этого плагина чего-то большего, чем приглашения, — почти наверняка это уже есть в ванилле: чёрные списки (/ban), кик при отзыве приглашения (enforce-whitelist=true) и отзыв приглашений (/whitelist remove). Если это то, что тебе было нужно, то пожалуйста, поделись этим плагином! На Reddit или где-нибудь ещё. Плз :)

Возможности

• Любой может добавить игрока в вайтлист по нику. Больше никаких пингов, чтобы добавить друзей на летний SMP!
• Отменяй ошибочные приглашения в течение настраиваемого окна. Опечатки прощены!
• Держи друзей подотчётными с помощью журнала приглашений. Смотри, кто кого пригласил! (только для операторов)

Установка

1. Скачай файл .jar со страницы релизов на GitHub или с Modrinth.

2. Скачай необходимые зависимости для своей версии.

   • Spigot: нет
   • Fabric: Minecraft SQLite JDBC, Fabric API, (опционально) fabric-permissions-api
   • NeoForge: Minecraft SQLite JDBC
3. Помести его в папку plugins/ (Spigot) или mods/ (Fabric, NeoForge) в корне сервера.
4. Запусти сервер.

Руководство пользователя

Нажми, чтобы посмотреть частые вопросы

Как пригласить кого-то? Используй `/invite **Я случайно пригласил не того человека. Как отозвать приглашение?** Используй /uninvite, чтобы отозвать своё последнее приглашение. В остальных случаях нужен админ, чтобы выполнить /whitelist remove . **Я случайно пригласил кого-то, и теперь он на сервере. Что делать?** Сначала отзови его приглашение, если можешь. Иначе попроси админа убрать его из вайтлиста, а затем кикнуть через /kick . Тебе стоит установить enforce-whitelist=trueвserver.properties, если хочешь кикать неприглашённых игроков сразу. **Как выяснить, кто пригласил грифера на сервер?** Используй /invitelog received с ником грифера. Последняя запись — виновник. **Мой друг постоянно приглашает кого-то, кто мне не нравится. Как запретить приглашать этого игрока?** Это уже есть в ванилле: просто забанить проблемного игрока (не твоего друга, хотя и его тоже можно) через/ban . Его всё ещё можно пригласить, но зайти он не сможет. **Мой друг расстроился и пригласил кучу рандомов. Как откатить вайтлист?** Отката нет. Тебе стоило хранить копию whitelist.json` как бэкап. И, что важнее, тебе стоит серьёзно поговорить с другом. Можно ли использовать это на офлайн-сервере? В смысле, будет ли оно работать? Да. Сделает ли оно то, что ты хочешь? Нет, потому что оно добавляет в вайтлист только настоящие аккаунты Minecraft, а аккаунты в офлайн-режиме таковыми не являются. За Velocity этот плагин будет работать нормально, потому что сервер получает настоящие UUID. На чистом офлайн-сервере? Ну, запустится. Но толку от него почти нет.

## Команды

Нажми, чтобы посмотреть список команд

| Команда | Использование | Право | Кто может использовать по умолчанию | Что делает | | ------------ | -------------------------------------------- | ------------ | ----------------------------------- | --------------------------------------------------------------------------------------------------- | | /invite | `/invite |invite.use| Все | Ищет ник в Minecraft, добавляет игрока в вайтлист сервера и записывает, кто его пригласил. | |/uninvite |/uninvite |invite.use| Все | Отзывает твоё последнее приглашение, если окно отмены ещё активно. | |/invitelog|/invitelog |invite.log| Операторы | Псевдоним для/invitelog recent 1. | | /invitelog|/invitelog recent [page] |invite.log| Операторы | Показывает последние записи журнала приглашений, по 5 на страницу. | |/invitelog|/invitelog sent [page] |invite.log| Операторы | Показывает приглашения, отправленные этим игроком, по 5 на страницу. | |/invitelog|/invitelog received [page] |invite.log` | Операторы | Показывает, кто пригласил этого игрока, по 5 на страницу. |

## Конфигурация

Нажми, чтобы посмотреть параметры конфигурации

Ты можешь редактировать конфигурацию плагина в plugins/Invitation/config.yml: | Ключ | По умолчанию | Что делает | | ------------------- | ------------ | -------------------------------------------------------------------- |

| cooldown-seconds | 7 | Пауза между попытками /invite для каждого игрока. | | undo-seconds | 60 | Сколько времени после приглашения /uninvite (или Undo) можно отозвать это приглашение. |

Участие в разработке

Если вы написали для него код, я с радостью приму pull request, если посчитаю, что он не раздувает рамки этого плагина. Отправляя вклад в этот репозиторий, вы соглашаетесь с тем, что ваш вклад лицензируется под той же лицензией, что и этот репозиторий, опубликованной в файле LICENSE.

Лицензия

Если не указано иное, весь исходный код в этом репозитории лицензирован под Mozilla Public License 2.0 (SPDX: MPL-2.0). Пожалуйста, ознакомьтесь с файлом LICENSE, чтобы узнать условия, предоставляемые вам в рамках MPL-2.0.