Українська
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

Розіграші, квитки й призові бали

Уперше користуєтеся інструментом розіграшу? Почніть із Ваш перший розіграш: покроковий посібник зі знімками екрана.

Використовуйте один хост для проведення розіграшу. Спливне вікно, Stream Deck і Event Flow керують цим хостом; глядацькі екрани показують його зафіксований результат.

Проведіть перший безкоштовний розіграш

  1. У спливному вікні відкрийте Параметри розіграшу. Залиште ID як default, ключове слово — !enter, а ціна квитка та приз у балах — нульові.
  2. Виберіть картку переможця, барабан імен або колесо спільноти. Перегляньте екран, потім скопіюйте його посилання в джерело браузера OBS.
  3. Виберіть Відкрити прийом заявок. Глядачі долучаються, надсилаючи ключове слово в захопленому чаті.
  4. Виберіть Закрити прийом заявок, потім Вибрати переможця. Вибір також закриває прийом заявок, якщо ви забули зробити це раніше.
  5. Виберіть Новий раунд щоб почати інший розіграш. Попередні переможці залишаються в історії хоста.

Залиште хост SSN запущеним. Взаємодія з джерелом браузера OBS не потрібна. Окреме колесо спільноти залишається доступним без &managed; бали й віддалене керування використовують керований режим.

Квитки за бали SSN

  1. Увімкніть наявну Система балів лояльності у спливному вікні. Це бали SSN, окремі від балів каналу Twitch і очок окремих ігор.
  2. У розділі Квитки й призові бали, задайте кількість балів за квиток і максимальну кількість квитків на глядача. Ціна 1 означає один квиток за бал.
  3. Відкрийте прийом заявок. Для розіграшу з назвою friday, глядач купує п’ять квитків за допомогою !ticket friday 5.
  4. Перевірте учасників у Керування розіграшами й історією. Успішна покупка одночасно списує бали й додає глядача. За недостатнього балансу квитки не створюються.

Купівля квитків одразу резервує бали, тому ті самі бали не можуть також купити стікери або долучитися до іншого платного розіграшу. Визначення результату витрачає ці бали. Скасувати й повернути кошти повертає зарезервовані бали. Видалення одного учасника перед вибором повертає його резерв. Платні раунди не можна непомітно відкинути через New round.

Правила фіксуються після першої заявки. Закриття/відкриття може призупинити раунд із наявними правилами. Щоб змінити ціну або вимоги участі, скасуйте його й створіть інший раунд. Глядач не може змінювати гаманець або сторону банку після приєднання.

Розігруйте бали

Установіть Приз у балах на переможця і Кількість призів перед відкриттям. Кожен приз додає вказану кількість балів SSN до наявного облікового запису вибраного глядача. Це створює бали, а не бере їх із доходу від квитків або гаманця оператора. Загальний випуск обмежений налаштованою сумою призу й кількістю переможців.

Для кількох призів вибирайте переможців по одному. Кожен зафіксований переможець записується до анімації екрана. Завершений вибір не можна скасувати, щоб прибрати відомий результат. Виправляйте помилки свідомим коригуванням балів на хості; зміна екрана або повторне підключення ніколи не нараховує винагороду знову.

Ігри з винагородами в балах

Керований Number Hunt

Виберіть Number Hunt (під керуванням ведучого), ціна квитка 0, один приз і необов’язковий приз у балах. Ведучий вибирає число від 1 до 100. Гравці використовують !guess friday 50, підставивши ID розіграшу. Правильна відповідь одноразово винагороджує першого придатного учасника; неправильні відповіді звужують діапазон для всіх. Кожен глядач може відповідати раз на п’ять секунд.

Використовуйте керований екран розіграшу або games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. Звичайний Number Hunt та інші наявні ігри зберігають початкову локальну поведінку. Їхні локальні очки й позначки переможців не надають бали SSN автоматично.

Спільний банк орла й решки (Coin Flip Pot)

Це гра на випадковість. Виберіть Спільний банк орла й решки (Coin Flip Pot), ціна 1, один результат і додатковий приз 0. Глядачі роблять ставки через !ticket friday 3 heads або !ticket friday 3 tails. З обох боків має бути учасник. Закрийте прийом і визначте результат: хост вибирає орла або решку з однаковою ймовірністю незалежно від загальних ставок.

Глядачі-переможці повертають власні ставки й ділять програні ставки пропорційно своїм. Залишки цілих балів дістаються найбільшим дробовим часткам, а за рівності — у порядку входу. Комісії немає, додаткові бали не створюються. Для переможних ставок 2 і 1 проти 5 програних балів банк із 8 балів виплачує 5 і 3. Скасуйте до визначення результату, щоб повернути бали всім. Якщо один бік порожній, визначення результату відхиляється й можна скасувати з поверненням.

Кілька розіграшів

Дайте кожному розіграшу короткий ID із літер, цифр, дефісів або підкреслень. Покупки глядача в усіх ID використовують один доступний баланс гаманця. Кожен URL OBS містить &giveaway=ID. Команди квитків і відповідей явно називають розіграш. Дайте одночасним безкоштовним розіграшам різні ключові слова: неоднозначне безкоштовне ключове слово не додає випадково до кількох розіграшів.

Поля спливного вікна є значеннями налаштування. Оновіть або відкрийте менеджер, щоб перевірити правила, зафіксовані на хості. Зміна глядацького посилання змінює лише параметри відображення; вона не переписує правила квитків активного раунду.

OBS і подання

Типовий фон керованого екрана прозорий. За бажанням виберіть тематичну панель. Картка, барабан і колесо спільноти мають однаковий результат і шість кольорових стилів. Налаштування зменшення руху пропускає анімації розкриття. Колесо показує максимум 120 імен; це анімація результату, а не повне представлення шансів кожного квитка. Вибір використовує повний пул придатних квитків.

При повторному підключенні екран показує збережений результат. Підключений екран не повідомляє SSN, чи сцена OBS зараз видима. Зберігайте URL контролерів, ID сесій і резервні копії в таємниці.

Потоки подій

Додайте Розіграш / квитки серед дій балів. Виберіть Enter free giveaway, Buy tickets, Grant free tickets, Close entries, Draw winner, Cancel and refund або Query state. Виберіть ID і кількість квитків; для покупки в банку виберіть heads/tails. Дія використовує захоплену ідентичність глядача. Використовуйте довірений тригер/фільтр перед наданням або операторським керуванням.

Buy tickets уже витрачає бали. Не ставте Spend Points перед нею. Збій зупиняє залежні дії, не приховуючи початковий чат. Результат доступний у meta.giveawayControlResult. Тестова панель Event Flow імітує цю дію без покупки справжніх квитків. Для наскрізних перевірок зі справжніми змінами раундів використовуйте ізольований хост/профіль.

Право на покупку визначається за зафіксованим балансом на момент дії. Не покладайтеся на те, що саме повідомлення заявки заробить останній потрібний бал. Власні ID повідомлень джерела забезпечують постійний захист від повторного відтворення; джерела без них мають слабші гарантії ідентичності між перезапусками. Загальні заплановані події без захопленого ID глядача/повідомлення не можуть купувати від чийогось імені.

Stream Deck і API

Власний плагін містить Open Giveaway, Close Giveaway, Draw Giveaway, Cancel & Refund, New Giveaway Round і Giveaway State. Їхній типовий ID — default. Введіть {"giveawayId":"friday"} у полі значення, щоб вибрати інший раунд. Open також може приймати config об’єкт; інакше наявний раунд зберігає зафіксовані правила, а новий ID використовує типові параметри спливного вікна.

Використовуйте наявне P2P-з’єднання або налаштований транспорт WebSocket. Клавіша повідомляє відповідь SSN; вона не стверджує, що OBS у прямому ефірі. Якщо відповідь перевищує час очікування, запитайте стан перед новою спробою вибору.

{"protocol":2,"action":"buygiveawaytickets","get":"callback-1","value":{"giveawayId":"friday","roundId":"ROUND_ID","operationId":"purchase-123","count":5,"actor":{"chatname":"Avery","type":"youtube","userid":"SOURCE_USER_ID"}}}

ID операції визначає господарську операцію; ID зворотного виклику визначає відповідь. Зберігайте ID операції при повторних спробах. Повторне використання з іншими параметрами завершується помилкою. Для навмисної нової покупки використовуйте новий ID операції. Операторський доступ API може витрачати бали від імені вказаного учасника: не відкривайте його як публічну форму покупки без автентифікації.

Історія, резервні копії та відновлення

Менеджер перелічує раунди, учасників та історію переможців. Експортуйте історію переможців як JSON або збережіть повну резервну копію балів/розіграшів версії 2. Повні копії містять разом баланси, резервування, раунди й квитанції операцій. Нічого не завантажується на сервер.

Після перезапуску хоста збережені відкриті раунди закриваються для перевірки. Їхні квитки залишаються зарезервованими. Відкрийте знову з тими самими правилами, визначте результат або скасуйте з поверненням. Перервані транзакції бази даних або фіксуються повністю, або не залишають часткової покупки/виплати. Резервування стікерів без зафіксованого підтвердження доставки відновлюються після завершення тайм-ауту.

Повне відновлення доступне на новому хості без наявних балансів або записів розіграшів. Відновлює весь знімок і залишає відновлені раунди закритими. Відмовляється перезаписувати хост із наявними даними. Відновіть початковий ID трансляції/сесії у спливному вікні перед поновленням її раундів; результат відновлення перелічує сесії резервної копії. Ця копія не замінює загальних налаштувань спливного вікна. Ніколи не запускайте старий і відновлений хост як незалежні керівні вузли тієї самої економіки. Резервна копія є знімком: вона не може містити транзакцій, що відбулися після її збереження.

Імпорт лише балансів не може відновити непогашені резервування. Скидання балів і ручне перезаписування відхиляються, якщо відповідні кошти зарезервовані. Скидання балів не стирає квитанцій/історії розіграшів. Баланси належать цьому профілю браузера/застосунку, а раунди обмежені сесією. Окремі профілі/пристрої не синхронізуються автоматично. Очищення даних браузера може видалити локальні записи, тому зберігайте резервні копії поза цим профілем.

Необов’язкове серверне резервне копіювання/синхронізація — майбутня функція, не частина цього випуску. Ця реалізація не додає завантажень на сервер, серверних облікових даних, купленої валюти або виведення коштів.

Коли щось не працює

довідник API · Контракти подій · Опитування та списки очікування

Покрокове відновлення резервної копії

  1. Залиште старий хост зупиненим. Відкрийте SSN у новому профілі браузера й відкрийте менеджер розіграшів.
  2. У розділі Відновлення на новому хості, виберіть повну резервну копію. Дочекайтеся повідомлення відновлення й занотуйте вказаний початковий ID сесії.
  3. У розділі спливного вікна Параметри сесії, введіть цей початковий ID сесії.
  4. Поверніться до менеджера, виберіть ID розіграшу й натисніть Оновити. Перевірте правила, учасників та історію переможців. Відновлені відкриті раунди закриваються для перевірки.
  5. Відкрийте знову з тими самими правилами, визначте результат або виберіть Скасувати й повернути кошти щоб повернути зарезервовані квитки. Збережіть нову резервну копію після перевірки результату.

Для OBS почніть із джерела браузера 1280 × 720. Кероване колесо вписується в решту висоти джерела. Типовий фон прозорий без власного CSS; усі звичайні засоби керування залишаються у спливному вікні, менеджері або Stream Deck.