Установка и первый запуск - major1ink/Beacon-Table GitHub Wiki

Beacon Table выходит в двух вариантах. Сервер — один исполняемый файл без установщика и зависимостей, стол открывается в браузере. Десктоп — тот же стол в своём окне, он ставится как обычная программа. Какой файл скачать под вашу систему, показано в таблице в README.

Дальше на этой странице речь о сервере: его достаточно скачать, положить в пустую папку и запустить.

1. Скачайте файл для своей системы и архитектуры со страницы Releases. Имя у него вида beacon-table_<версия>_<ос>_<архитектура>, например beacon-table_0.9.0_linux_amd64. У файла для Windows в конце .exe.
2. Создайте новую пустую папку и положите файл в неё.
3. Запустите файл двойным щелчком или из терминала.

На Linux и macOS файл сначала нужно сделать исполняемым: GitHub не хранит этот признак.

chmod +x beacon-table_*
./beacon-table_0.9.0_linux_amd64

На Windows:

.\beacon-table_0.9.0_windows_amd64.exe

После запуска рядом с программой появятся папки data/ (база, аккаунты, заметки ведущего) и uploads/ (карты, токены), файл настроек beacon.conf и журнал data/beacon.log.

При запуске скачанного .exe Windows покажет окно «Система Windows защитила ваш компьютер» с пометкой «Издатель: Неизвестный издатель».

Это не вирус и не ошибка сборки. Релизные файлы пока не подписаны сертификатом code signing, а SmartScreen блокирует любой исполняемый файл без подписи и накопленной репутации. Подпись релизов в планах.

Окна у программы нет: Beacon Table работает как сервер. Через секунду после запуска он сам откроет стол в браузере. Если браузер не открылся, зайдите вручную:

• на этом компьютере: http://localhost:8080/
• с телефонов и ноутбуков игроков в той же сети: адрес компьютера в сети, например http://192.168.0.10:8080/. Программа пишет такие адреса в журнал при запуске, ведущий и игроки входят через одну и ту же страницу
• телевизор: тот же адрес с /tv на конце, подробнее в разделе «Как подключить телевизор»

При первом запуске создаётся аккаунт dm с временным паролем. Если открыть страницу входа на том же компьютере, логин и пароль уже будут в форме, останется нажать «Войти». Тот же пароль записан в файл dm-password.txt рядом с beacon.conf (пригодится, если вы заходите с другого устройства) и в журнал.

Сразу задайте свой пароль: форма «Задайте свой пароль» ждёт на экране выбора мира. Пока вы этого не сделали, при каждом запуске выдаётся новый временный пароль, и dm-password.txt придётся открывать каждый раз. После смены пароля файл удалится сам.

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

Если у телевизора или приставки свой браузер:

1. В окне ведущего откройте «Настройки» → «Трансляция». Там крупно написан адрес для телевизора, вида 192.168.0.10:8080/tv.
2. Наберите этот адрес в браузере телевизора. На экране появятся четыре знака.
3. На кнопке «Настройки» в окне ведущего загорится точка, а экран появится в списке «Экраны, ожидающие подтверждения» на той же вкладке. Сверьте знаки с теми, что на телевизоре, и нажмите «Пустить».

Если экран можно открыть, ничего не набирая (второе окно браузера, ноутбук у проектора, телефон), быстрее передать ссылку на трансляцию. Её копирует кнопка «Копировать» на той же вкладке. Кто открыл ссылку, тот видит стол, поэтому не выкладывайте её в общий чат. Кнопка «Перевыпустить» отключает все экраны, которым ссылку уже давали.

В десктопной версии на той же вкладке есть кнопка «Открыть на втором мониторе». Если телевизор подключён к компьютеру вторым монитором, окно трансляции откроется на нём во весь экран. Если оно открылось обычным окном, перетащите его на телевизор и нажмите F11.

Пошагово с фотографиями это описано на сайте, на странице «Карта на телевизоре».

Сервер выключается кнопкой «Выключить сервер». В окне ведущего это значок питания в самом низу левой панели значков. Та же кнопка есть в «Настройки» → «Сервер» и на экране выбора мира, вверху справа. Она завершает работу правильно: мир сохраняется, база закрывается.

Если просто закрыть вкладку браузера, сервер продолжит работать. Если вы запускали программу из терминала, её можно остановить и через Ctrl+C.

Откройте журнал data/beacon.log. В него попадает всё, что программа напечатала бы в терминал, в том числе причина, по которой сервер не поднялся.

Чаще всего там написано «не удалось занять адрес». Значит, программа уже запущена (просто откройте http://localhost:8080/) или порт 8080 занят другой программой. Во втором случае смените BEACON_ADDR в beacon.conf.

Порт, каталоги и уровень журнала меняются на странице Настройка. Как поднять стол на VPS с доменом и HTTPS, описано на страницах Запуск в Docker и Запуск на сервере. Приключение из Foundry переносится по инструкции Импорт из Foundry VTT.