​

Краткое повторение

1. Чтобы создать новую карту: mapping ID, или Чтобы редактировать существующую карту: mapping ID PATH (например, mapping 1000 Maps/saltern.yml) Обратите внимание, что ID должен быть номером карты, которой ещё не существует. Используйте lsmaps для просмотра списка карт, используемых в данный момент. Более высокий ID рекомендуется во избежание конфликтов с существующими.
2. При желании mappingclientsidesetup для использования стандартной настройки картографии.
3. Внесите все изменения на карту.
4. Если были созданы новые комнаты, выполните fixgridatmos GID.
5. Сохраните карту с тем же ID, который вы использовали ранее: savemap ID PATH. Важно: Если вы работаете с утилизационным шаттлом, шаттлом или Центральным Командованием, вам нужно savegrid GRID_ID PATH вместо этого.

6. Создайте прототип карты, если вы создаёте новую карту и её ещё не существует.
7. forcemap ИМЯ-КАРТЫ заставит сервер загрузить вашу карту. В сборке Release вы можете нажать F7 в лобби, чтобы открыть админ-меню, и использовать Round > Start Round, чтобы пропустить ожидание. В Tools вам нужно будет использовать restartroundnow или F7 Админ-меню, затем Round > Restart NOW, чтобы переключиться на вашу карту.
8. Если вы не тестируете энергосеть, entities with Battery do "setbatterypercent $ID 100" заставит все APC быть полностью заряженными без настройки двигателя.
9. Чтобы вернуться к картографии, вернитесь к шагу 1. Не сохраняйте карту во время тестирования.

​

Настройка

​

С окружением разработки

​

Сборка Tools

dotnet run --project Content.Server --configuration Tools
dotnet run --project Content.Client --configuration Tools

​

Без окружения разработки

​

Рабочий процесс

​

Начало картографии

1. Запустите как клиент, так и сервер. В Windows это можно сделать, запустив файлы “runclient.bat” и “runserver.bat” в каталоге вашего клонированного репозитория после сборки проекта/решения хотя бы один раз.
2. Когда игровой клиент загрузится, подключитесь к серверу.
3. Нажмите клавишу обратной кавычки/тильды `, чтобы открыть отладочную консоль, которая позволяет выполнять консольные команды.
4. Выполните команду mapping [MapID] [MapFile], чтобы создать новую карту или отредактировать существующую.
   • Чтобы создать новую карту, укажите только ID карты. ID должен быть свободным, т. е. сервер в данный момент не может иметь другую карту с таким же ID, поэтому используйте достаточно высокий ID, чтобы избежать конфликта.
   • Чтобы отредактировать существующую карту в папке Maps/, укажите имя файла карты и свободный ID. Например, для редактирования карты Saltern используйте mapping 1000 Maps/saltern.yml
   • Чтобы отредактировать карту, которую вы ранее сохранили, выполните команду mapping 1000 [filename.yml]. Ваши сохранённые карты находятся в папке bin/Content.Server/data, отдельно от карт, используемых репозиторием в папке Resources/Maps.
5. Внесите все желаемые изменения, используя режим песочницы и инструменты администратора. Нажмите F5 для переключения спавнера сущностей и F6 для переключения спавнера тайлов. Стены являются сущностями, поэтому вы найдёте их в спавнере сущностей.
6. Чтобы сохранить изменения, используйте команду savemap [MapID] [MapFile]. Например, savemap 1000 name.yml сохраняет локальную копию изменённой карты в space-station-14/bin/Content.Server/data/name.yml

​

Распространённые инструменты и команды

• SHIFT-Клик: размещает линию тайлов/предметов/всего с сеткой привязки
• CTRL-Клик: размещает квадрат тайлов/предметов/всего с сеткой привязки
• По умолчанию клавиша P (“Pick”) выбирает сущность или тайл, находящийся под курсором, для размещения.
  • Обратите внимание, что это размещает сущности того же прототипа, а не копирует исходную сущность.
• Чтобы раскрасить все трубы в трубной сети, используйте colornetwork [entity id] Pipe [color], где entity id — это uid любой трубы в подключённой сети труб (используйте View Variable на трубе, чтобы найти его, если он не отображается в меню правого клика), а color — это hex-код цвета, начинающийся с #. См. стандартные цвета труб в разделе “Стандартные цвета труб”.
• zoom N для отдаления во время картографии. zoom 3 отдаляет в 3 раза. Используйте zoom 1 для восстановления обычного масштаба.
• Вы можете использовать команду physics shapes в отладочной консоли для визуализации сеток.
• Чтобы исправить ошибочно повёрнутые стены, выполните fixrotations [GridID]
• Чтобы найти ID сетки вашей сущности, нажмите F3 и наведитесь на сетку призраком. ID будет показан в верхнем левом углу.
• Находясь в режиме картографии, вам не нужен свет. Если по какой-то причине всё темно, выполните в консоли команду togglelight.
• Используйте админ-меню (F8) для переключения других вещей, таких как отображение точек появления и подпола. Это может облегчить видимость того, что вы делаете.
• Если вы хотите протестировать освещение на вашей карте, не выходя из редактора, используйте команду “mapinit”. Сохранитесь перед этим, так как это испортит вашу карту, если вы сохранитесь после выполнения этой команды.
• Используйте https://affectedarc07.github.io/SS13WebMap/ для просмотра большинства карт SS13 онлайн
  • (https://game.ss13.moe/minimaps/images/maps/ для /vg/)
• При тестировании карты вы, возможно, не захотите каждый раз настраивать питание. В этом случае используйте: > entities with Battery do "setbatterypercent $ID 100"
• Автосохранение карты включено по умолчанию и происходит в каталог данных сервера каждые 10 минут (cvar mapping.autosave_interval). Вы можете отключить его с помощью toggleautosave [map id] или изменить cvar mapping.autosave.

​

Действия картографии

​

Мульти-сеточные и мульти-станционные карты

​

Создание скриншота станции

​

Первый запуск карты

1. Скопируйте ваш недавно сохранённый файл карты из “space-station-14/bin/Content.Server/data/” в “space-station-14/Resources/Maps/”. Это также необходимо будет сделать для отправки ваших изменений позже.
2. Если это совершенно новая карта, перейдите в “space-station-14/Resources/Prototypes/Maps” и создайте .yml файл для вашей карты (известный как прототип карты). В качестве руководства скопируйте существующий и измените имя, чтобы оно соответствовало вашей новой карте, и отредактируйте содержимое в текстовом редакторе, таком как Notepad++, чтобы ваша новая карта имела уникальный ID и имя. Смотрите раздел о мульти-сеточных и мульти-станционных картах для ID станций (это не то же самое, что ID вашей карты).
3. Теперь вы можете перезапустить клиент и сервер. После подключения выполните команду forcemap [ID], где ID — это ID, указанный в .yml файле, о котором мы говорили ранее. В Release просто нажмите F7 в лобби, чтобы открыть админ-меню, и используйте Round > Start Round, чтобы пропустить ожидание. Если вы используете Tools, выполните команду restartnow или F7 Админ-меню, затем Round > Restart NOW, чтобы перезапустить сервер на вашей карте.
4. Подключитесь к игре, и вы должны оказаться на своей новой карте. Обратитесь к разделу устранения неполадок, если у вас возникли проблемы.

​

Открытие PR и добавление в игру

​

Важно

1. Создайте ветку в вашем клонированном репозитории через ваш Github-клиент.
2. Добавьте файлы вашей карты и прототипа карты в ваш commit и обновите PostMapInitTest.cs, где это применимо. (Проиндексируйте их)
3. Зафиксируйте эти изменения локально и отправьте их в origin.
4. Перейдите в вышестоящий репозиторий SS14 и перейдите на вкладку pull requests. Там должен быть баннер с надписью «recent changes on your branch, pull request?». Сделайте это, чтобы открыть pull request для вашей карты. Альтернативно вы можете открыть pull request из вашего репозитория.
5. Заполните страницу pull request деталями, такими как скриншоты/рендеры карты, укажите, что вы следовали контрольному списку контроля качества, максимальное/минимальное количество игроков и любые другие детали, а также добавьте запись в changelog.

​

Устранение неполадок и ЧаВО

​

Загрузка карты

​

Я получаю ошибку о пропущенных прототипах

​

Я недавно обновился и получаю фатальную ошибку / не могу загрузиться

​

Контент

​

Контрольные списки карты

​

Спавнер тайлов

• При размещении тайлов, как упоминалось, вы можете удерживать ctrl и щёлкнуть, чтобы разместить прямоугольник тайлов, или shift и щёлкнуть для линии.
• Для удаления тайлов используйте тайл “Space”.
• Вам не нужно сначала размещать обшивку, а затем тайлы, вы можете просто разместить любой тайл, и он будет отодран, чтобы показать нижележащий тайл в игре (обычно обшивка).
• Аналогично, вы можете перезаписывать тайлы, размещая новый на его месте — не нужно сначала удалять их.
• Будьте осторожны при размещении новых тайлов, чтобы они были частью правильной сетки — размещайте их поверх существующего тайла при массовом размещении или убедитесь, что они привязываются к существующему тайлу. Периодически выполняйте lsgrid в консоли, чтобы проверить, что вы не создали больше сеток.

​

Спавнер сущностей и размещение

• Ищите сущности по их ID в строке поиска, затем вы можете добавить её на панель действий слева для последующего использования, щёлкнув по ней и выбрав слот.
• Используйте выпадающее меню Snap для изменения режима размещения. Для большинства вещей вам подойдёт значение по умолчанию или snap to centre. Иногда требуется свободное размещение для индивидуального подхода.
• Не забывайте поворачивать определённые сущности. Некоторые, как APC и кнопки, доступны только с одного направления.

​

Атмосферика

• Если вы хотите, чтобы на вашей карте была работающая симуляция атмосферы (газы распространяются и т. д.), используйте addatmos 2, где “2” — это ID сетки.
• Если вы хотите, чтобы на вашей карте была статическая атмосфера (газы не распространяются независимо от обстоятельств), используйте addunsimulatedatmos 2, где “2” — это ID сетки.

​

Размещение атмосферных компонентов

• Vents — используйте их по станции для распределения свежего воздуха.
• Scrubbers — подключайте их к сети труб отходов по станции для очистки воздуха от вредных газов.
• Passive Vents — используйте их в ваших распределительных резервуарах, например, в баке воздушной смеси, для подключения к вашей распределительной сети. Также используются для стравливания в космос при размещении за насосом и клапаном.
• Mixers — используйте их для смешивания газов в распределительную смесь. Убедитесь, что подключили первичную сторону (боковой порт) и вторичную сторону (нижний порт), как вам нужно для вашей смеси в пропорции к UI. Для воздушной смеси нужно примерно 78% азота и 22% кислорода. Выход затем может идти в бак воздушной смеси / хранения или напрямую в распределение.
• Filters — используются для отделения газа от первичного входа через вторичный (нижний) выход и пропускания всех остальных газов через другую сторону. Настройте их для переработки газов из вашей сети отходов обратно в ваши газовые баки.
• Valves — используются для ручного перекрытия участков вашей трубной сети. Полезно размещать перед пассивным вентилем для стравливания в космос.
• Pumps — используются после пассивного вентиля для контроля количества газа, нагнетаемого в сеть. Используйте их после баков хранения газа.
• Atmos Markers — если вы размещаете баки хранения газа, обязательно используйте “Atmos Fix (gas) Marker” в спавнере сущностей, чтобы установить правильный газ в баках. Это гарантирует, что при выполнении команды fixgridatmos в баки будет помещён правильный газ.
• Air Sensor — используется для подключения логики и датчиков к другим устройствам для их активации. Используется специально для аварийных сигнализаций воздуха и пожара.
• Air Alarm — используется с датчиками воздуха для обнаружения опасных атмосферных условий в зонах и отправки предупреждений в Инженерию / Атмосферику. Используйте связь машин для подключения датчиков воздуха в соседних комнатах к сигнализации, а также вентилей и скрубберов в текущей комнате к сигнализации. Также подключите противопожарные двери между комнатами к сигнализации, чтобы она могла активировать их для блокировки участков.
• Fire Alarm — используется для активации противопожарных дверей в текущей зоне. Используйте связь машин для подключения непосредственно к противопожарным дверям в её комнате или секции.
• Gas Recycler — преобразует углекислый газ в кислород, а закись азота в азот, когда входной газ сжат до 3 МПа и нагрет до не менее 300°C.
• Gas Condenser — преобразует газы в реагенты. Вероятно, более важен для химии или науки, чем для атмосферики.

​

Стандартные цвета труб

• Контур отходов: #990000FF (тускло-красный)
• Контур распределения: #0055CCFF (приглушённый синий)
• Воздух: #03FCD3FF (голубой)
• Смесь: #947507FF (коричневатый)

​

Питание

• HV провода — это ваши линии передачи между генераторами, накопителями энергии (SMES) и подстанциями.
• MV провода — соединяют ваши подстанции и APC. Убедитесь, что разместили их под обоими устройствами.
• LV провода или провода APC — подключаются от APC ко всем потребителям в радиусе 3 тайлов (поэтому не размещайте их под вещами, это не нужно).

• Substation — хранит небольшое количество энергии. Подключается к основной сети через HV кабели, принимая энергию, и распределяет её через MV кабели ко многим APC.
• APC — контроллеры питания зоны. Хранят небольшое количество энергии в зависимости от установленной батареи. Подключаются к подстанции через MV кабель. LV кабель под ними используется для подачи питания потребителям. Убедитесь, что они направлены в сторону использования.
• SMES — используются для хранения огромного количества энергии в HV сети. Нельзя соединять кабелями между SMES, поэтому нужно вывести провод наружу и затем обратно.
• Cable Terminal — используются для разделения цепей в вашей HV сети. Ваша первичная цепь находится на стороне с коробкой, а вторичная сторона (выход) — там, куда указывают кабели. Размещайте их, направленными в группу SMES, чтобы ваша генерация была на первичной стороне, а ваша основная сеть выходила из SMES через кабельную сторону клеммной колодки (см. рисунок ниже для визуальной помощи). Вторичная сторона будет отбирать энергию от первичной, поэтому используйте их экономно на вторичной цепи.
• Generators — это могут быть портативные генераторы, коллекторы плазмы, солнечные панели и многое другое. Подсоедините HV кабель под ними для использования генерируемой энергии. Это включает контроллер AME.
• PA Power Box — особое упоминание: для питания ускорителя частиц необходим HV кабель под PA кабелем / блоком питания.

​

Декали

• Левый клик для размещения декаля
• Правый клик для удаления декалей в радиусе

​

Палитры

​

Точки варпа, станционные маяки и карты станции

​

Именование дверей и редактирование табличек

​

Спавнеры транспортных средств

• Для размещения транспортных средств, как и животных, нужно использовать спавнер, а не саму сущность.
• После размещения также обязательно разместите набор ключей.

​

Камеры

• Разместите “Camera Router” для вашего конкретного отдела в защищённой зоне, например, в шкафу с доступом начальника отдела / серверной в отделе, или в серверной/роутерной.
• Разместите камеры наблюдения (вставьте отдел) по станции. При их размещении, чтобы исправить имя, отображаемое на мониторе камер, нужно: Правый клик > Debug > View Variable > Server Components > SurveillanceCameraComponent > отредактируйте CameraID и нажмите Enter.
• Разместите монитор камер, желательно в более защищённом месте, чтобы не каждый мог на него смотреть.
• Если вы хотите протестировать обзор камеры, сохраните карту, затем выполните mapinit. Затем вы можете просматривать монитор камер и проверять их обзор, не забудьте выполнить togglelight в консоли для получения реального обзора.
• Для развлекательных камер следуйте тому же процессу, что и выше, но с камерами, отмеченными (entertainment).

​

Связь

​

Связь машин (мультитул, гермодвери, конвейеры и т. д.)

​

Грузовой шаттл

​

Спасательные капсулы

​

Планеты

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

1. Создайте новую карту обычным способом с помощью mapping. Нет необходимости добавлять генератор гравитации или fixgridatmos (пока) из-за следующих шагов.
2. Откройте админское меню (F7) → Objects → Maps, найдите новую карту, которую вы только что создали, щёлкните по ней, чтобы открыть View Variables. В разделе Server Components → Add Component:
   • Добавьте Gravity.
   • Добавьте FootstepModifier и установите звук через VV.
   • Добавьте Parallax и установите прототип параллакса. Если вы хотите, чтобы это выглядело как земля, вам нужно будет создать новый.
   • Добавьте MapGrid на карту.
   • Добавьте MapAtmosphere
     • Установите Space в False
     • Установите Mixture в соответствии с атмосферой вашей планеты. Поля, на которые стоит обратить внимание: температура (290K — хороший выбор) и начальное количество молей (22 моль O2, 82 моль N2) — хороший выбор.
     • Дополнительное веселье: поле Mixture не редактируется в vv, поэтому вам придётся сохранить карту, открыть текстовый редактор, найти компонент MapAtmosphere и вручную прописать его.
       - space: False
         mixture:
           volume: 2500
           temperature: 290
           moles:
           - 21.824879
           - 82.10312
         type: MapAtmosphere
     
     • После повторной загрузки выполните fixgridatmos
3. Откройте админское меню (F7) → Objects → Grids (не Maps!), найдите новую сетку для карты, которую вы только что создали, щёлкните по ней, чтобы открыть View Variables. В разделе Server Components:
   • Поскольку вы добавили Gravity на карту, эта сетка теперь имеет Gravity. Откройте её:
     • Установите EnableVV в True
4. Сохраните и протестируйте.

​

Стандарты картографии

​

Стыковочные порты / Эвакуация / Спасение

​

Стыковка прибытия

• Ангарный тип, как следует из названия, представляет собой стыковку, которая оборачивается вокруг стыкующегося шаттла в форме буквы U. Она должна стараться придерживаться того же расстояния, что и плоская стыковка, поэтому должен быть буфер в 5 тайлов от станции для стоянки корабля, затем начинаются первые 5 тайлов из 5-3-5. Для прибытия нужен только один набор шлюзов, так что это скорее дизайн из 5 тайлов, 5-ти тайлов.
• Плоский тип должен следовать тому же формату, что и спасательная стыковка: 5-3-5 с зазором в 5 тайлов с каждой стороны.

​

Стыковочная штанга

• Выступать от станции без непосредственных препятствий с каждой стороны как минимум на 20 тайлов с каждой стороны.
• Это необходимо для того, чтобы большие корабли для ивентов могли легко стыковаться.
• Стыковочная штанга должна иметь как минимум 2-та йла ширины стыковочного шлюза, чтобы через него можно было легко протаскивать конструкции.