https://egmatic.com/ru/blog/json-v-razrabotke-igr

JSON в разработке игр: подход, управляемый данными

30 июля 2026 г. (updated 22 октября 2026 г.) · Владислав Ковнеров · 13

JSON в разработке игр — это способ описывать содержимое игры (уровни, предметы, характеристики врагов, баланс, настройки и файлы сохранений) в виде структурированного текста, который движок считывает во время выполнения, вместо жёсткого прописывания в исходном коде. Это разделение данных и кода называют подходом, управляемым данными (data-driven), и именно оно превращает работу, доступную только программистам, в работу геймдизайнера: тот может перенастроить оружие, добавить уровень или исправить опечатку без пересборки игры инженером. JSON стал самым распространённым форматом для таких данных, потому что это простой текст: его удобно читать, сравнивать в системе контроля версий и разбирать практически на любом языке программирования. Этим же путём передаются и ходы в асинхронном мультиплеере — каждый ход маленький JSON-документ в облаке; на этом приёме построен разбор асинхронного мультиплеера без сервера. В этом разборе — что такое JSON на самом деле, что такое подход, управляемый данными, что стоит класть в JSON-файл, где он проигрывает (и когда лучше взять бинарный формат), как его используют крупные движки и какую путаницу важно избежать: формат JSON и архитектура, управляемая данными, — не одно и то же. Если нужно сравнение движков по этому признаку, его продолжает сравнение движков, управляемых данными.

Что такое JSON на самом деле

JSON — JavaScript Object Notation — это текстовый формат для хранения структурированных данных в виде вложенных объектов и массивов. Он был выделен из синтаксиса объектных литералов JavaScript в начале 2000-х и стандартизирован как ECMA-404 и RFC 8259, но к JavaScript во время выполнения отношения не имеет: парсер JSON есть в каждом крупном языке. Запись оружия выглядит так:

{
  "id": "iron_sword",
  "name": "Iron Sword",
  "damage": 50,
  "weight": 3.5,
  "tags": ["melee", "metal"]
}

Существенны два технических момента — они объясняют, почему команды берут JSON и почему рано или поздно от него уходят.

Идея, которая всё меняет: подход, управляемый данными

Всё полезное, что даёт JSON в играх, вырастает из одного архитектурного решения: держать данные вне кода.

Без подхода, управляемого данными, конкретика игры живёт в исходниках: жёстко заданный int swordDamage = 50;, уровень, вшитый в исполняемый файл, реплика диалога внутри функции. Чтобы что-то изменить, программист правит код, перекомпилирует и выпускает новую сборку. С подходом, управляемым данными, код становится обобщённым — единственный класс Item, который читает урон, вес и теги из файла, — а конкретика живёт в данных, которые движок считывает во время выполнения. Изменить урон меча теперь — правка одной строки в items.json, без перекомпиляции.

Выгода вполне осязаема.

Что стоит класть в JSON

В проекте, управляемом данными, кандидат на перенос в файл — почти всё, что относится к контенту, а не поведению.

Тип данныхПримерПочему подходит
Характеристики предметов, врагов и персонажейЗдоровье, урон, шанс выпаденияПостоянно настраиваются; нужны ручные правки
Уровни и картыТайловая раскладка, расстановка сущностейОбъёмные, делает геймдизайнер; инструменты вроде LDtk экспортируют их в JSON
Диалоги и локализацияСтроки по идентификаторуПо файлу на язык; переводят, не трогая код
Настройки и балансКривые сложности, ставки экономикиЧисла, которые меняются во время плейтеста
Файлы сохраненийПрогресс игрока, инвентарьЗаписываются и читаются во время выполнения; текст помогает при отладке
Манифесты ассетов и данные сборкиЧто грузить и в каком порядкеУправляют пайплайном; удобно сравнивать

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

Почему именно JSON — и где он проигрывает

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

Честные минусы:

Когда размер или скорость начинают подводить, движки дополняют или заменяют JSON бинарными форматами — каждый из них меняет читаемость на производительность.

ФорматЧто этоВ чём силён
JSONПростой текст, без схемыЧитаемость, экосистема инструментов, удобство сравнения версий
MessagePack / CBORБинарный JSON — та же модель, компактные байтыСжатие без потери гибкости JSON
Protocol BuffersБинарный, со схемой (.proto плюс генерация кода)Самые компактные данные, типобезопасность, сетевые протоколы
FlatBuffersБинарный, без копирования (создан в Google для игр)Доступ к полям без разбора всего буфера; минимум нагрузки на процессор

Распространённый приём — готовить и править данные в тексте (JSON), а на релиз «собирать» в бинарный формат. Так читаемость JSON остаётся на этапе разработки, а скорость бинарного формата — в руках игрока.

Как JSON применяют крупные движки

Каждый движок выражает подход, управляемый данными, в своём формате — JSON встречается часто, но далеко не везде.

ДвижокФормат данныхЧто управляется данными
GDevelopВесь проект — один JSON-файл (game.json)Всё: объекты, события, сцены — это данные
GameMakerФайл проекта .yyp — JSON; комнаты и объекты — JSON-ресурсыСцены и определения объектов
RPG Maker MV/MZБаза данных — отдельные JSON-файлы (Actors.json, Items.json, …)Вся игра: характеристики, навыки, враги — база данных в JSON
UnityJsonUtility и ScriptableObjectВы сами строите конвейер данных
GodotЧитаемые текстовые ресурсы (.tres, .tscn) и класс JSONРесурсы и сцены — текст; не JSON, но та же идея
MonoGameВстроенного нет — вы подключаете библиотеку вроде System.Text.JsonФреймворк с акцентом на код; модель данных полностью ваша

Два честных уточнения. Godot целиком построен на данных, но его родной формат — собственный текстовый синтаксис, а не JSON; JSON доступен как опция. Construct хранит листы событий и раскладки как XML внутри архива .c3p, так что он управляется данными, но без JSON. Вывод: подход, управляемый данными, — это идея, а JSON, XML и текстовые ресурсы — лишь способы её переносить.

Частые ошибки

ОшибкаЧто идёт не такЧто делать вместо этого
Жёстко прописанные значения, которые часто меняютсяКаждая правка баланса требует программиста и перекомпиляцииВынесите настраиваемые числа в файл данных JSON
Слепое доверие к непроверенному JSONНеверный тип поля или отсутствующий ключ роняет игру во время выполненияПроверяйте данные по схеме; на этапе разработки падайте громко
Отсутствие версионирования схемыИзменение формата незаметно ломает старые сохранения и модыВерсонируйте данные и предусматривайте путь миграции
Разбор JSON в горячем циклеПовторный разбор текста каждый кадр убивает производительностьРазберите данные один раз в объекты; для массовых данных берите бинарный формат
Путаница между JSON и подходом, управляемым даннымиВы выбираете формат вместо того, чтобы отделить данные от кодаСначала решите, что данные, а что код; затем выбирайте JSON или бинарный формат

Роль Egmatic

Egmatic построен вокруг подхода, управляемого данными, на уровне архитектуры. Он чётко разделён на две части: редактор, в котором создают игру, и движок, который её запускает, а единственное, что пересекает эту границу, — контракт на основе версионированного JSON. Редактор порождает игровые данные в JSON; движок их потребляет. Между ними нет общего кода — только данные.

Это подход, управляемый данными, доведённый до конца: игра и есть данные, редактор — инструмент, который их формирует, а движок — интерпретатор, который их запускает. Egmatic работает поверх рантайма MonoGame, который сам по себе — фреймворк с акцентом на код, без встроенной модели данных: именно этот разрыв и заполняет редактор, управляемый данными. О том, как движки соотносятся по этому признаку, рассказывает сравнение движков, управляемых данными, а разбор графа сцены показывает, как описывающие мир данные упорядочиваются после того, как движок их загрузил.

Итог

JSON в разработке игр — это практика переноса содержимого игры в виде структурированного текста, который движок считывает во время выполнения, то есть конкретное воплощение подхода, управляемого данными: данные держат вне кода, чтобы дизайнеры могли менять игру без пересборки инженером. JSON силён читаемостью, универсальностью и удобством контроля версий — поэтому так много движков и инструментов используют его: файл проекта в GDevelop, база данных в RPG Maker, ресурсы в GameMaker, JsonUtility в Unity и редакторы уровней вроде LDtk. Его минусы — размер, скорость разбора и отсутствие встроенной схемы, поэтому там, где важна производительность, переходят на бинарные форматы: FlatBuffers, Protocol Buffers или MessagePack, часто после подготовки данных в текстовом виде.

Главное, что стоит запомнить, — это различие: JSON — формат, а подход, управляемый данными, — архитектура. Управляться данными можно и через XML, и через текстовые ресурсы, и через бинарный формат; JSON — просто самый популярный носитель. Сначала отделите данные от кода, а формат выбирайте потом.


Источники

  1. Спецификация JSON — лёгкий, не зависящий от языка, читаемый человеком текстовый формат данных — RFC 8259: The JSON Data Interchange Syntax
  2. Подход, управляемый данными — отделение содержимого и параметров геймплея от кода, при котором движок интерпретирует данные во время выполнения — Википедия: Data-driven programming
  3. GDevelop — весь проект сохраняется одним JSON-файлом — GDevelop wiki: Project manager
  4. Формат проекта GameMaker — файл .yyp хранит проект в JSON — GameMaker Manual: Project format
  5. База данных RPG Maker MV/MZ — актёры, предметы, враги и навыки хранятся отдельными JSON-файлами в папке data/ — RPG Maker Wiki: Database
  6. Unity ScriptableObject и JsonUtility — проектирование данных через ассеты и сериализация в JSON — Unity Manual: JSON Serialization
  7. Ресурсы Godot — .tres и .tscn как читаемые человеком текстовые форматы, удобные для контроля версий — Godot docs: TSCN file format
  8. LDtk — современный открытый редактор 2D-уровней, сохраняющий уровни в чистом JSON — LDtk JSON documentation
  9. FlatBuffers — библиотека бинарной сериализации, созданная для разработки игр и поддерживающая чтение без копирования — FlatBuffers documentation

Частые вопросы

Для чего нужен JSON при разработке игр?

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

Что такое подход, управляемый данными, в играх?

Это практика отделения содержимого игры и его параметров от кода. Код остаётся обобщённым — единственный класс предмета, один загрузчик уровней, — а конкретика (урон меча, планировка уровня, реплика диалога) лежит в файлах данных, которые движок интерпретирует во время выполнения. Тогда дизайнер правит данные напрямую, без пересборки игры инженером.

JSON и подход, управляемый данными, — это одно и то же?

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

Почему выбрать JSON, а не бинарный формат?

Потому что он читается человеком, его удобно сравнивать в системе контроля версий и разбирает практически любой язык. Команды создают и правят данные в JSON во время разработки, а на релиз часто «собирают» их в бинарный формат — FlatBuffers, Protocol Buffers или MessagePack, — где размер и скорость разбора важнее читаемости.

Какие игровые движки используют JSON?

Многие. GDevelop сохраняет весь проект одним JSON-файлом. GameMaker хранит проект и ресурсы в JSON. RPG Maker MV и MZ держат всю базу данных игры в JSON-файлах. В Unity есть JsonUtility для сериализации. В MonoGame нет встроенного формата, поэтому подключают библиотеку вроде System.Text.Json. Godot тоже управляется данными, но использует собственный читаемый текстовый формат, а не JSON.

В чём минусы JSON в играх?

Текст больше по размеру и разбирается медленнее бинарного формата, у JSON нет встроенной схемы, поэтому ошибки типов всплывают во время выполнения, а изменение структуры данных ломает старые сохранения и моды, если не ввести версионирование и миграцию. Для контента, который грузится один раз, эти расходы незаметны; для данных, читаемых в горячем цикле, они могут стать решающими — тогда и переходят на бинарный формат.