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.