Как оптимизировать разработку и тестирование настольной игры

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

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

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

Предложу две связки:

Ниже подробно расскажу о первом решении, которое использую сам. Со вторым я пока не смог полноценно разобраться, может со временем напишу о нём тоже.

Google Sheets - здесь мы храним все наши данные об игре, считаем баланс, агрегируем данные и формируем названия файлов изображений, к которым мы будем обращаться.

Dextrous — это наш онлайн верстальщик. Сайт можете найти по названию в поиске. В нём мы будем автоматически получать и обновлять данные из Гугл таблиц, собирать их в шаблоны карт и прочих серийных элементов настольной игры, и сохранять свёрстанные страницы для передачи в настольную игру.

Tabletop simulator - здесь мы раскладываем виртуально поле нашей настольной игры, задаём правила и создаём автоматизации, для удобства, и играем.

Теперь дам пошаговую инструкцию на примере карт для моей игры.

Делаем таблицу - исходник в Google Sheet. В этой таблице у меня в строке - игровая карта. Как видно на скриншоте, у каждой карты есть множество параметров. И параметры бывают как текстовые, так и числовые (например, урон или дальность), так и картинки (например элемент или схема поражения).

Так же вычисление некоторых параметров происходит на других таблицах и сюда передаются через функцию.

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

Наша задача создать такой лист, на котором будут все необходимые данные для всех карт. Технические колонки я называю на английском, чтобы потом их использовать без проблем. У меня в игре 12 персонажей, у каждого персонажа есть 6 карт, которые формируют колоду персонажа. Поэтому строки располагаются в той же логике, в блоках по 6 строк.

С числовыми и текстовыми колонками всё просто, их мы напрямую будем забирать из таблицы, а вот для изображений нужно будет сформировать название файла, на которое мы будем в дальнейшем ссылаться.

Разберём на примере «элемента» карты. Бывает 3 элемента: Freedom (Свобода), True (Истина) и Chaos (Хаос).

Теперь подготавливаем 3 изображения и называем их Freedom.png, True.png, Chaos.png соответственно, сохраняем их.

Это можно сделать в любом редакторе изображений, я использую CorelDraw.

После того как загрузили нужные файлы, формируем названия файлов в Google. Добавляем колонку Element и вставляем формулу

=IFS(G2="Свобода";"ARHTN/Freedom.png";G2="Истина";"ARHTN/True.png";G2="Хаос";"ARHTN/Chaos.png")

В формуле мы проверяем какое слово у нас хранится в колонке G на русском, и в зависимости от значения выводим путь к файлу. Протягиваем формулу вниз, и теперь у нас есть полное название файла элемента для каждой карты.

По аналогии поступаем с другими параметрами карты. Теперь наша задача для каждой колоды карт сделать отдельный файл, чтобы мы могли в дальнейшем для каждой колоды сделать и назначить свой шаблон в Dextrous. В моём случае для каждого героя я создавал отдельную колоду.

Создаём новую таблицу, и вставляем часть данных из исходной таблицы. В первую строку заголовки, в строки 2-7 данные карт конкретного героя. Для этого используем формулу =IMPORTRANGE

Теперь эту таблицу публикуем в интернете для доступа к данным.

Сохраняем ссылку, которую нам выдаёт гугл, она нам пригодиться.

Теперь регистрируемся в Dextrous. Затем заходим во вкладку images и создаём папку с названием нашей игры (у меня это «ARHTN»). Здесь мы будем хранить все наши изображения которые мы будем использовать на картах.

Должен сразу предупредить, что в Dextrous бесплатно можно хранить до 50Мб файлов, поэтому если у вас большие изображения на картах, нужно их будет оптимизировать и сохранить в более низком качестве. Тем не менее, этого размера достаточно для полноценной игры, например мои 100 карт я сохранил в большом разрешении, сжав до 160Кб, и качество осталось вполне приемлемое. Получилось, что все фоновые иллюстрации заняли около 17Мб.

Теперь нужно создать шаблон карты. Нам нужна вкладка Layout. Можно создать шаблон на основе заготовки, но я советую делать самостоятельно, потому что Dextrous очень странно работает с размерами, и сжимает наши уже сжатые изображения еще раза в четыре. Из-за этого получается очень плохо. Поэтому я советую делать шаблон в два раза больше, чем будут карты физически у вас распечатываться, а в TTS мы просто уменьшим их масштаб.

Тут нужен отдельный туториал как создавать шаблоны, я думаю при необходимости на ютубе можно найти. Я предлагаю делать так - сохраняем для фона одну карту, на которой обозначаем внутренние выносы (обычно это 3 мм от края карты) и дальше на это изображение добавляем все наши элементы шаблона, которые будем визуализировать. Посоветую только брать карту с максимальным заполнением, либо использовать текст максимальной длины, чтобы быть уверенным, что все текстовые описания точно поместятся.

Так же советую создать изображение Null - с одним прозрачным пикселем, чтобы использовать его как заглушку, если мы не хотим выводить изображение по умолчанию, а на шаблоне оно у нас есть, и иногда нужно этот элемент отображать.

На этом этапе очень важно называть все элементы точно так же как мы называли колонки в Google, так как связываться они будут именно по названию! Для ранее созданных файлов элементов я добавил объект изображение и задал ему название Element.

Как только готов шаблон, во вкладке Projects создаём новый проект. В проекте у нас будут лежать наши колоды.

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

Теперь будет самое волшебство. Нажимаем внизу Import CSV и в открывшемся окне вставляем ту ссылку, которую нам предоставил Google когда мы публиковали таблицу.

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

На скриншоте видно что я использовал различные иконки прямо в тексте карты - это тоже не сложно делается, гайд есть на сайте Dextrous.

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

Так же мы видим, что Dextrous понял где необходимо вставить какой элемент, получив данные из колонки Elements. Эти элементы я расположил в левом верхнем углу карты.

Подскажу еще одну хитрость: обратите внимание на колонку Card Nickname – это название карты, которое будет отображаться в TTS. В дальнейшем я это использую в скриптах TTS, расскажу об этом в отдельной статье.

Когда мы подготовим все колоды которые будут участвовать у нас в проекте, останется добавить рубашки картам - есть несколько вариантов как это сделать, в простом случае где у нас одна рубашка для всех карт, выбираем в правом меню common и подгружаем шаблон рубашки.

Осталось экспортировать наш файл в TTS. Нажимаем на значок принтера🖨️ в правом верхнем углу и на следующей странице снова нажимам на принтер 🖨️ и выбираем Create Tabletop Simulator file.

Ждём окончания генерации и скачиваем JSON в папку TTS в ваших Документах:C:\Users\liardy\Documents\My Games\Tabletop Simulator\Saves\Saved Objects

Теперь открываем TTS, создаём новую игру и открываем вкладку objects. Нам нужен блок SAVED OBJECTS. Это как раз та папка, в которую мы положили наш JSON файл с картами.

Перетягиваем файл на область игрового поля и получаем наши колоды. Дальше с этими колодами мы делаем всё что угодно: раскладываем игру, пишем автоматизации для выбора героев или карт итд. И сохраняем файл с игрой.

Если нам нужно будет внести какие-то изменения в наши карты, нам не нужно будет заново переделывать макеты, пресоздавать колоды, переписывать код с автоматизацией, перераскладывать все исправленные карты!

Нужно будет сделать 2 вещи, которые занимают пару минут:
1. Внести изменения в таблицу Google
2. В Dextrous нажать import all CSVs и сохранить новый файл JSON с заменой старого в папке Saved Objects.
После этого открываем игру в TTS и все изменения уже есть на всех картах в игре!

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

Надеюсь статья найдёт своего читателя и будет полезна хотя бы начинающим разработчикам. Если будут вопросы под постом, постараюсь всем ответить. Так же оставлю ссылку на свою группу в тг, чтобы вы могли со мной связаться лично или задать вопросы по вашим настройкам)
https://t.me/Archytheon