LuawardDocs

Loader Universe

Одна ссылка на группу игр. Игрок вставляет её один раз, а Luaward запускает скрипт для той игры, в которой он находится.

Что это

Loader Universe — это одна ссылка, которая обслуживает целую группу игр. Вместо хаб-скрипта со всеми PlaceId, который приходится загружать заново при каждой новой игре, вы выбираете игру при создании каждого скрипта. Ссылка находит нужный скрипт для игры, в которой находится игрок, поэтому она никогда не меняется и не требует новой загрузки.

https://luaward.com/universe/YOUR_LINK.lua

Можно создать сколько угодно Loader Universe, например по одному на студию или на серию игр.

Как создать

  1. Откройте Loader Universe в панели и нажмите Новый Loader Universe.
  2. Дайте название. Личная ссылка создаётся сама: длинный случайный адрес (вроде luaward.com/universe/d1417f68…), который нельзя угадать. Она не меняется, поэтому игроки продолжают ею пользоваться.
  3. Отметьте проекты, из которых брать скрипты. Скрипты с выбранными играми подключаются сразу.
  4. Оставьте включённым Добавлять новые скрипты сам для проектов, чьи новые скрипты должны подключаться без ваших действий.

Каждый Loader Universe — это раздел на странице, как проект на странице «Проекты». Каждая игра — одна строка со скриптами, которые отвечают за неё, переключателем паузы для этой игры и числом запусков за 30 дней.

Что вставляет игрок

script_key = "KEY";
loadstring(game:HttpGet("https://luaward.com/universe/YOUR_LINK.lua"))()

Кнопка Loader в разделе копирует ровно эти две строки. Строка с ключом нужна только скриптам с ключом.

Страница, которую видят ваши игроки

Откройте ссылку без .lua в браузере (https://luaward.com/universe/YOUR_LINK), и игроки увидят страницу, сделанную для них, а не код:

  • Получить скрипт: две строки для вставки, большая кнопка копирования и три шага. На телефоне это одно нажатие.
  • Мой ключ: игрок вставляет ключ и видит его состояние: сколько осталось, привязано ли устройство, сколько сбросов, сколько запусков, последняя игра. Он может скопировать скрипт с уже подставленным ключом и сам сбросить устройство (если проект позволяет и прошли дни ожидания между сбросами). Аккаунт не нужен: вход — это ключ, его охраняют Cloudflare Turnstile и лимит неверных ключей.
  • Игры: все игры, которые поддерживает Loader Universe, с картинкой, версией и кнопкой открытия на платформе. Игрок, не нашедший свою игру, может запросить её ссылкой на игру или place id; запросы считаются вместе с играми, в которых запускали без поддержки, так вы видите, что делать дальше.
  • Помощь: короткие ответы про заблокированное устройство, телефоны и ошибки.

Страница говорит на языке игрока (те же шесть, что и панель), рассчитана сначала на телефон и не показывается поисковикам. Откройте её из панели кнопкой рядом с Loader у Loader Universe. Runtime, по ошибке запросивший страницу, будет перенаправлен на загрузчик .lua.

Выбор игры для скрипта

При добавлении скрипта первый шаг спрашивает, для какой игры он сделан: одна игра, несколько или все. Введите название, вставьте ссылку на игру или укажите Place ID. Luaward запрашивает у публичных страниц платформы игру, её значок и её плейсы и хранит игру по вселенной, поэтому учитываются все плейсы игры, в том числе добавленные позже. Скрипт может указать до 30 игр.

Переключатель Запускать только в этой игре блокирует скрипт. Запуск из любой другой игры, даже по ссылке собственного загрузчика скрипта, отклоняется со статусом GAME_NOT_SUPPORTED до отправки чего-либо.

Скрипт, не указавший игру («все игры»), Loader Universe никогда не выбирает.

Скрипты подключаются сами

  • Отметьте один или несколько Loader Universe на втором шаге Нового скрипта.
  • Или включите Добавлять новые скрипты сам для проекта в настройках Loader Universe.

Скрипты, которые ждут игру, показываются внизу раздела, чтобы ни один не потерялся.

Как выбирается скрипт

Ссылка спрашивает Luaward, какие скрипты сделаны для игры игрока. Если он один, он и запускается. Если их несколько, например в проектах Premium и Freemium есть одна и та же игра:

  1. Ключ игрока говорит, к какому проекту он относится: сначала выбирается скрипт этого проекта, затем скрипт проекта, который тоже принимает ключи того проекта (настройка, которой ваши проекты уже делятся ключами).
  2. Без ключа или с ключом, которого нет в этих проектах, выбирается скрипт, работающий без ключа, иначе первый в том порядке, в котором его показывает страница.

Загрузчик выбранного скрипта затем проверяет ключ, устройство и тариф как обычно, поэтому ссылка не позволяет никому обойти эти проверки.

Игра, которую ничто не поддерживает

В настройках Loader Universe выберите, что получает игрок в игре, для которой нет ни одного скрипта: сообщение (ваше или наше, если вы ничего не написали) в консоли исполнителя и как уведомление в игре, либо исключение из игры. Страница считает такие запуски и перечисляет игры, которые просили игроки, чтобы вы знали, что делать дальше.

Пауза

Loader Universe на паузе сообщает игрокам, что он на паузе. Пауза одной игры прекращает ответы только для неё. Отключение скрипта или его удаление из Loader Universe прекращает его выбор в течение нескольких секунд.

Оформите страницу игрока

В Loader Universe выберите Оформить страницу игрока, чтобы задать, как выглядит эта страница и что она предлагает. Картинка рядом с настройками меняется по мере ввода; Сохранить применяет её к странице. На телефоне настройки — плитки, открывающие панель.

  • Страница открыта: если выключить, /universe/… сообщит, что страница закрыта. Ссылка .lua, которую игроки запускают в игре, не затрагивается.
  • Макет: Портал (вкладки, страница как раньше), Плитки (большой заголовок, четыре кнопки, карточка ключа, скрипт, игры) или Магазин (сначала карточки тарифов, для тех, кто продаёт ключи). Смена макета сохраняет ваши тексты, ссылки и тарифы.
  • Вид: цвета, выбранный вами акцентный цвет (контраст текста на нём проверяется), углы, шрифт и фон.
  • Каждую часть можно показать, скрыть и переставить: шапка, заголовок, четыре кнопки, поле ключа, карточка ключа, скрипт, игры, объявление, тарифы и покупка, вопросы, ссылки и подвал.
  • Тексты на шести языках: значок, заголовок, подзаголовок, названия кнопок, цена, карточки тарифов, объявление, вопросы и ссылки. Пустой язык показывает английский текст, затем тот, что вы написали первым.
  • Четыре кнопки: Ввести ключ, Получить скрипт, Сбросить устройство и Купить. Переименуйте, скройте или переставьте; кнопка покупки может скрываться, когда у игрока уже есть рабочий ключ.
  • Поле и карточка ключа: выберите, что показывает карточка (устройство, сбросы, запуски, последняя игра, имя пакета для каждого проекта), сколько ключей хранит браузер (1–10) и проверяет ли страница новейший сохранённый ключ при открытии. Список запомненных ключей хранится в браузере игрока. Лицензионные записи и проверки доступа хранятся и обрабатываются на сервере. Кнопку сброса можно скрыть; кто может сбрасывать и как часто — по-прежнему определяют настройки каждого проекта.
  • Игры по одной: значок статуса (автоматически по скриптам, готово, обновляется, приостановлено или новое), строка заметки, скрытие игры и сортировка по состоянию, названию, версии или вручную.
  • Покупка и тарифы: кнопка покупки ведёт в ваш магазин (только https): Luaward не принимает деньги, игрок покупает у вас и получает ключ, например через Shop Bridge. Кнопка бесплатного ключа может вести на одну из ваших страниц ключей. Добавьте до четырёх карточек тарифов с ценой и преимуществами.
  • Объявление: строка вверху с датой окончания. Кто её закрыл, не увидит снова, пока вы не измените текст.

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