Настройка

Каждое решение находится в одном из двух мест, и выбор места зависит от одного простого вопроса: будет ли плохо, если это прочитает игрок?

Где	Что внутри	Кто может это видеть
`shared/config.lua` и `shared/config/*.lua`	Всё о том, как ведёт себя телефон	Отправляется клиентам
`shared/server_config.lua`	Ключи, токены, вебхуки, сертификаты	Только на сервере, не отправляется

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

Файлы и за что отвечает каждый из них

shared/config.lua          the item, the key, the prop, the animations, the folding
shared/config/
  apps.lua                 which apps exist, which arrive installed, which cost money
  battery.lua              whether the phone goes flat, and how fast
  boss.lua                 who counts as a boss, and what each rung may do
  calls.lua                voice, video, speakerphone, the numbers that ring a whole job
  camera.lua               photos and video, where they are uploaded, the keys
  cases.lua (in config.lua) the fourteen colours, and whether they are items
  cityid.lua               which licences this city issues
  crypto.lua               the coins, how fast they move, what the house takes
  device.lua               phones as items: backups, and what belongs to a device
  garage.lua               where vehicles come from
  mail.lua                 the domain, and who may write to everybody
  messages.lua             attachments
  music.lua                streaming, speakers, imports
  nearby.lua               how far AirDrop reaches
  properties.lua           housing
  pulse.lua                jobs, events and news, and who may post
  radio.lua                channels, and which of them a job may not have
  restrict.lua             when the phone cannot come out
  services.lua             the businesses in the directory
  social.lua               the four social apps and their limits
  wallet.lua               transfers, invoices, bills
  weather.lua              where the weather comes from
  web.lua                  the phone on a real browser

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

Несколько решений, которые стоит принять до входа игроков

Телефон — это вещь, которую можно потерять?

Config.Device в файле shared/config/device.lua. Если выключено, телефон принадлежит персонажу и остаётся с ним навсегда. Если включено, телефон и есть сам предмет: новый предмет — это новый телефон с новым номером, а устройство, переданное другому человеку, уносит с собой все свои данные.

Это меняет смысл идентификатора во всех остальных системах, поэтому такое решение лучше принять один раз перед открытием, чем переключать на уже живущем сервере.

Какие приложения существуют

Config.AppList в файле shared/config/apps.lua. Три варианта для каждого приложения:

phone     = { How = 'installed' },              -- always there
instapic  = { How = 'store', Price = 0 },       -- downloaded from the App Store
darknet   = { How = 'off' },                    -- gone: not on the phone, not in the store

Параметры Jobs и NotJobs ограничивают доступ к приложению по работам, а Boss = true выдаёт его только тем, кто управляет бизнесом.

Когда телефон нельзя достать

shared/config/restrict.lua. Мёртв, в наручниках, плывёт, горит, в свободном падении, лезет по лестнице — у каждого состояния свой переключатель и параметр Close, определяющий, убирается ли уже открытый телефон в карман или просто блокируется повторное открытие.

Там есть два числа, о которых полезно знать, потому что именно они делают это правило адекватным:

Falling  = { Enabled = true, Close = true, Height = 8.0 },   -- metres of air before a fall counts
Climbing = { Enabled = true, Close = true, After  = 1.0 },   -- seconds before a climb counts

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

Садится ли батарея?

shared/config/battery.lua, по умолчанию выключено. Если включить, индикатор заряда в строке состояния обретёт реальный смысл, появится предмет зарядного устройства, а разряженный телефон перестанет включаться.

Деньги

shared/config/wallet.lua — для переводов и счетов, shared/config/crypto.lua — для крипторынка. Оба принимают название счёта, которое использует ваш фреймворк: bank, money или любое другое, какое вы задали.

Серверный файл конфигурации

shared/server_config.lua — скопируйте в него shared/server_config.example.lua и заполните то, чем пользуетесь.

Загрузка файлов (Uploads) — Fivemanage или вебхук Discord для фотографий и голосовых сообщений.
Вебхуки (Webhooks) — куда телефон отправляет логи о важных событиях.
HTTPS — сертификат для браузерной части. См. сертификат.

Он намеренно подключён в server_scripts. Клиент никогда его не получает.