Configuration

Battery and signal

Battery drain and charging, power banks, and signal bars from tower distance.

File: configs/config_battery.lua. What players see is on Battery.

#Config.Battery

Drain and charge are in percent per minute. Enabled = false keeps every phone at 100 %.

Setting Type Default What it does
Battery.Enabled boolean true Battery on or off
Battery.IdlePerMinute number 0.035 Drain with the phone put away: about 2 % an hour
Battery.OpenPerMinute number 0.2 Drain with the screen on: about 12 % an hour
Battery.HeavyPerMinute number 0.45 Drain while the camera, a video call, a live stream, Snap or Clips is in use
Battery.CallPerMinute number 0.15 Added on top while in a call
Battery.BatteryCaseDrain number 0.7 With a battery case from the case store the phone drains at this share of the normal rate
Battery.ChargePerMinute number 4.0 Charge rate: empty to full in about 25 minutes
Battery.ChargeInVehicles boolean true Charges in any vehicle whose engine is running, driver or passenger
Battery.ChargeAtShops boolean true Charges at the counter of a phone shop (Config.PhoneShop.Shops)
Battery.WarnAt number list { 20, 10 } Low battery warnings in the Dynamic Island at these levels
Battery.WakeAt number 3 A dead phone switches back on at this level
Battery.Chargers list {} Extra charging spots: { coords = vector3(x, y, z), radius = 2.0 }
Battery.PowerBankItem string or nil 'powerbank' Using this item charges the phone for PowerBankMinutes wherever the player is. The item is used up. nil: no power bank
Battery.PowerBankMinutes number 20 How long a power bank charges

Add the power bank item to your inventory first: Item setup.

#Config.Signal

Signal bars come from the distance to the nearest tower. There is one bar fewer indoors, and none underground or under water.

Setting Type Default What it does
Signal.Enabled boolean true Signal on or off
Signal.BlockCalls boolean true Calls need at least one bar on both phones
Signal.Ranges number list { 1400, 2100, 2800, 3600 } Distance in metres at which the phone drops from 4 bars to 3, 2, 1 and 0
Signal.UndergroundZ number 15.0 Inside an interior below this height the phone has at most one bar
Signal.DeepZ number -20.0 Below this height there is no signal, indoors or not
Signal.Towers list 15 towers Tower positions as { x, y }

The shipped towers are placed at Downtown, Vespucci, LSIA, El Burro, Pacific Bluffs, Vinewood Hills, Tataviam, Chumash, Zancudo, Harmony, Sandy Shores, Grapeseed, Mount Chiliad, Paleto Bay and Humane Labs. Add an entry to cover another area.

Scripts read and change the battery through exports: Battery exports.