Configuration

Calls

Speaker, conference calls, voicemail and video call settings.

File: configs/config_calls.lua. What players see is on Calls.

#Speaker

Setting Type Default What it does
Config.SpeakerBystanders boolean true Players standing next to someone on speaker join the call. With pma-voice and mumble-voip they can also be heard by the other side, as those voice systems have no listen-only mode. SaltyChat handles the speaker itself and ignores this setting
Config.SpeakerRange number 3.0 Metres from a phone on speaker within which bystanders hear the call. Ringtones use Config.Sound.Range instead
Config.SpeakerFalloff boolean true pma-voice and mumble-voip: the call gets quieter the further a bystander stands from the phone, and so does the bystander for the other side. false plays it at full call volume anywhere inside SpeakerRange

#Config.Calls

Setting Type Default What it does
Calls.MaxParticipants number 4 Conference calls: everyone in one call, the two parties included. 2 turns adding people off

#Config.Voicemail

A caller whose call is not answered may leave a voice message. The owner turns it off in Phone > Voicemail.

Setting Type Default What it does
Voicemail.Enabled boolean true Voicemail on or off
Voicemail.MaxSeconds number 60 Longest message
Voicemail.MaxMessages number 50 Messages kept per character. The oldest go first
Voicemail.OfferSeconds number 90 How long after the missed call the caller may still record

Voicemail messages are deleted after Config.Retention.voicemail days.

#Config.Video

Video calls. The picture travels between the two phones over WebRTC through a TURN relay (ServerConfig.Video in config_server.lua). The voice stays on the voice resource.

Setting Type Default What it does
Video.Enabled boolean true The camera button in calls and the Video app
Video.Fps number 24 Frames per second. Kept between 5 and 30
Video.Size { long, short } { 960, 540 } Picture size. At most { 1280, 720 }. The phone sends it upright
Video.MaxBitrate number 1500 Upper limit per direction in kbit/s, kept between 100 and 2500. Every call uses up to this much of the relay in each direction
Video.RequireItem string or false false Item needed to turn the camera on in a call. false: none
Video.TakeOverView boolean true true: during a video call the phone's own lens is the camera. It stands where the phone is held and looks at its holder; the flip button turns it the other way. false: the call leaves the player's view alone and sends that instead, so the other side sees the caller's normal game view and there is nothing to flip or zoom

On a weak relay or slow connections the config file suggests 15 fps, { 640, 360 } and a bitrate of 600.

The game draws one picture per player, and that picture is what a video call sends. With TakeOverView = true the player's own screen shows the lens while the call's camera is on.

Relay setup: Video relay. Live streams use the same picture size and frame rate; their own settings are on Live and social.