@PokeRaiderBot

September 16, 2017

PokeRaider бот в Телеграм: @PokeRaiderBot помогает организовать встречу игроков Pokémon Go на бои с "рейд-боссами".

⊳ См. на других языках. See this help in other languages ⊲

Чтобы инициировать новый рейд, отправьте боту команду /newraid в личку или напишите /newraid@PokeRaiderBot в групповом чате, например:

/newraid@PokeRaiderBot 12:00 50.464663,30.644601 Энтей на метро Лесная.

Если в чате нет других ботов, которые реагируют на команду /newraid, то можно не писать @PokeRaiderBot.

Здесь 12:00 — начало боя (часы и минуты), 50.464663,30.644601 — (широта и долгота) через запятую (или просто ссылка-URL места на любой карте — Google, Gymhuntr, Yandex и т. д., в которой эти координаты присутствуют в URL, например: http://www.google.com/maps?q=50.464663,30.644601), и дальше название рейда. Порядок не имеет значения (можно писать время, координаты и текст в любом порядке). Обязательно только название, но время (в формате hh:mm) и координаты/URL желательно указывать для полноты информации о рейде.

Бот ответит сообщением с информацией о рейде, в которой будет номер рейда, кнопки голосования и карта с отмеченным местом встречи.

(В команде /newraid также может использоваться необязательный параметр -s<цифра> для указания набора иконок фракций, подробнее в описании команды /gamer).

Чтобы отправить этот же рейд в другой чат, напишите в нем: /raid@PokeRaiderBot 1234 или /raid 1234 (где 1234 — номер рейда).

Результаты голосования (список участников) обновляются во всех чатах при каждом нажатии кнопок голосования.

Для проверки, что информация будет показываться правильно, отправьте команды /newraid или /raid боту в личку.

Чтобы указать команду (фракцию, team) и уровень игрока Pokémon Go, используйте команду /gamer, например:

/gamer m 30 или /gamer 25 Valor или /gamer Yellow 33 или /gamer 20 i (название или цвет команды или первую букву цвета или названия, и уровень игрока, в любом порядке), эту команду желательно отправлять боту приватно, а не в чат группы.

Для очистки уровня и команды пользователя (например, если они уже указаны вручную в его имени), отправьте /gamer clear (или /gamer clean).

По умолчанию наборы иконок, указывающие команду игрока, чередуются случайным образом (овощи, сердца, явления природы) при каждом обновлении голосования. Если в команде /newraid можно указать дополнительный параметр -s<цифра> (с пробелом после s или без), то иконки останутся постоянными при обновлениях голосования. Порядок параметра, так же как и другие данные команды, неважен. 1 - овощи, 2 - сердца, 3 - природные явления, 4 - буквы. Пример: /newraid -s 1 название_гима, /newraid название -s2.

Рекомендуемые настройки доступа

Если у бота есть доступ к удалению сообщений (в супергруппе), он будет подчищать команды /raid и /newraid, отправленные игроками (см. скриншот).

Как действует кнопка +1

Для того чтобы указать, что с игроком придут еще другие, которые не участвуют в вашем телеграм-чате, можно нажимать кнопку +1 один или несколько раз. Чтобы избежать путаницы - чтобы не нажимали ее неосознанно, она действует только если нажимающий сам участвует, то есть перед этим нажал Yes. А если после плюса нажать No или Maybe, то приплюсованные исчезнут.

Дополнительные команды

/comment 123 Текст коммментария — допишет ваш комментарий в рейд с номером 123. Доступно только для тех, кто как-то отметился в рейде.

Также доступно упрощенное комментирование, действует аналогично ответу на сообщение в чате: выделить сообщение о рейде "raid 12345", созданное ботом, нажать кнопку "Ответить" и вписать текст. В результате комментарий добавится в голосование как если бы он был создан командой '/comment'. Если в сообщении, отвечающем на голосование, присутствует символ @, то оно не будет добавляться как комментарий (так как @UserName это оповещение, а не комментарий к рейду), но в потоке сообщений оно останется. Если текст сообщения заканчивается на слеш / - тогда бот удалит сообщение, а в голосовалку запишет его без слеша. Также при помощи кнопки "Ответить" можно добавить локацию (нажать кнопку "Вложение" (скрепка) - дальше Location - Send Location), при этом в комменте появится ссылка на гугл-карту.

/cancel 123 — удаляет кнопки голосования в рейде 123 и дописывает Canceled в конце сообщения. Доступно только для инициатора рейда.

/result 123 7 — дописывает Caught: 7 в конце сообщения и удаляет кнопки голосования. Доступно только для инициатора рейда.

/language uk — установить язык, тогда голосования, создаваемые вами, будут на этом языке. Сейчас поддерживаются: uk (украинский), ru (русский), en (английский), fr (французский), pt-br (бразильский португальский), es (испанский), de (немецкий), fi (финский).

/unlock 123 — разблокирование голосования, закрытого автоматически через 36 часов после создания или командами /cancel, /result), при этом интервал автозакрытия продлевается до 15 дней. Доступно только для инициатора рейда.

/editraid 123 -t 12:00 — исправление времени начала боя, также появится комментарий об этом исправлении. Доступно только для инициатора.

/nickname Abc Xyz — изменение ника (отображаемого имени пользователя) в сообщениях бота. Например, можно установить ник "настоящее_имя [имя_в_PoGo]". Запрос /nickname без параметров сбросит настройку ника на "first_name list_name", взятые из настроек пользователя Telegram.

Команды можно писать и в групповой чат и боту в личку.

--------------------------------

Обновление 3 авг, 2018:

Теперь команда /gamer не сбрасывает никнеймы.

Обновление 27 июля, 2018:

Для защиты от флуда в голосовалках количество комментов от одного пользователя не более 10, последующие комментарии этого пользователя будут вытеснять самый первый.
Добавлена функциональность приватных рейдов (которые нельзя перепостить в другой чат командой /raid, поэтому пользователи, которые не состоят в вашем чате, не смогут видеть такие рейды).

Обновление 6 июля, 2018:

Добавлена команда /nickname.

Обновление 30 мая, 2018:

Добавлена команда /editraid (для исправления времени начала боя); исправлен баг в обработке команды /newraid, из-за которого удалялось повторное вхождение в тексте времени начала боя.

Обновление 5 мая, 2018:

Сообщения, отвечающие на голосование и содержащие @, не будут добавляться как комментарий.

Обновление 1 мая, 2018:

Установка иконок, указывающих команду (team) игрока в команде /newraid.

Обновление 24 апр, 2018:

Добавлено упрощенное комментирование (выделить голосование и нажать кнопку "Ответить").

Обновление 4 апр, 2018:

Бот говорит на финском.
Частично решена проблема поломки рейда, когда участник, отметившийся в голосовании, позже в своих настройках заблокировал бот. В таких случаях Телеграм не разрешает боту ссылку на пользователя и возвращает ошибку. Теперь в таких случаях в списках голосования все имена пользователей будут некликабельны.
добавлена команда /unlock (разблокировка завершенного голосования).

Обновление 22 мар, 2018:

Бот говорит на немецком.
возможность очистки команды/уровня: /gamer clear (или clean).

Обновление 22 фев, 2018:

Бот говорит на испанском.

Обновление 19 янв, 2018:

Бот говорит на бразильском португальском.

Обновление 26 ноя, 2017:

Бот заговорил по-французски.

Обновление 28 окт, 2017:

Добавлена команда language

Обновление 25 сент, 2017:

Добавлены команды comment, cancel, result.

Обновление 24 сент, 2017:

Публикация рейдов в каналах

Добавлена возможность отправки команды /raid в Телеграм-каналы. Но команда /newraid в каналах не поддерживается, потому что сообщения в каналах не содержат информации об авторе (то есть инициаторе рейда). Таким образом, сначала нужно отправить команду /newraid в групповой чат или непосредственно личным сообщением боту, а после этого послать команду /raid в канал.

--------------------------------

В будущем в боте могут быть реализованы дополнительные возможности.

Если вы нашли неполадку, есть вопросы, хотите перевести бот на другой язык, или бот не работает так, как ожидается, можете написать разработчику.

Если вам очень нравится бот, вы можете сделать добровольное пожертвование.

--------------------------------

Приватные рейды

Приватный рейд означает, что его нельзя перепостить в другой чат при помощи команды '/raid'. Синтаксис: /newraid -x <обычные параметры рейда>

Эта опция платная. Ее можно активировать для пользователя или для группового чата.

Если она активирована для пользователя, то он может создавать приватные рейды в любом чате (где ему вообще разрешено отправлять сообщения и присутствует PokeRaiderBot).

Если она активирована для чата, то все пользователи чата могут создавать приватные рейды (все кто может писать в чат).

Для запроса об активации приватных рейдов отправьте команду /needprivate chat (запрос для текущего чата) или /needprivate user (запрос для автора сообщения). Затем администратор бота свяжется с вами для подтверждения и деталей оплаты.

Демо чат, где разрешены приватные рейды: @demo_private_raids, вы можете попробовать создать тут приватный рейд, а затем проверить, можно ли его командой /raid перепостить куда-то еще.