Configuration

Camera

Camera filters, poses, portrait mode, selfie lens, flash, the lens tuning command and photo library limits.

File: configs/config_camera.lua. What players see is on Camera.

#Filters

Config.Camera.Filters is a list of { id, label, timecycle?, screeneffect?, strength }. timecycle is a timecycle modifier name, screeneffect an animpostfx name.

id Label Effect Strength
original Original none
vivid Vivid timecycle NG_filmic01 0.6
warm Warm timecycle NG_filmic06 0.7
cool Cool timecycle hud_def_desat_cold 0.5
noir Noir timecycle NG_filmnoir_BW01 1.0
neon Neon screen effect DeadlineNeon 1.0

#Pose and movement

Setting Type Default What it does
Camera.Pose.Rear string 'photo' Pose while the rear lens is open. 'photo': the phone raised in front of the face with one hand. 'selfie': the phone held out at arm's length. Any other value is 'photo'
Camera.Pose.Front string 'photo' Same for the front lens
Camera.Pose.Vehicle boolean not set In a vehicle the in-car phone clip is used. true uses the pose of the lens there too. After switching it on, set the vehicle lens sets again with the tuning panel
Camera.HideSelf boolean false On foot the rear lens leaves the player's own character out of the picture, on their own screen only. false: the character is drawn
Camera.WalkOnly boolean true With the camera open the character walks and cannot run. false: it moves at any pace
Camera.Upright.Enabled boolean true For a portrait shot the phone is turned upright in the hand, and laid on its side for landscape. false keeps it on its side in both
Camera.Upright.Rotation vector3 0, -90, 0 Added to Config.Prop.Rotation (degrees) while upright. If the phone stands upside down, use 0, 90, 0
Camera.Upright.Offset vector3 0, 0, 0 Moves the phone in the hand while upright (metres)

HideSelf hides the player's own character locally. The config file notes that anticheats with an "invisible player" check can take this for a cheat, which is why it ships off.

With Config.Animation.Style = 'custom', Config.Animation.Custom.camera and .selfie replace the poses with your own clips.

#Portrait mode

The lens focuses on the subject in front of it and blurs the rest with the game's depth of field.

Setting Type Default What it does
Camera.Portrait.Enabled boolean true Portrait mode on or off
Camera.Portrait.Strength number 1.0 Blur strength, 0.0 to 1.0
Camera.Portrait.Sharp number 0.45 Depth of the sharp zone around the subject in metres. Smaller blurs more of the scene
Camera.Portrait.EdgeBlur boolean false Adds the phone's own blur on top: an oval in the middle stays sharp and everything outside it is blurred. It shows on low graphics settings too, but it does not know what the subject is

The game's blur needs the player's Post FX graphics setting at High or above. Below that Portrait looks like a normal photo unless EdgeBlur is on.

#Selfie lens

Setting Type Default What it does
Camera.SelfieDistance.Photo number 0.45 How far the front lens stands from the face for a selfie, in metres. Kept between 0.25 and 0.8
Camera.SelfieDistance.Video number 0.46 Same in a video call
Camera.SelfieNearClip number 0.17 Front lens: nothing closer to the lens than this (metres) is drawn. This keeps the hand holding the phone out of selfies. Never more than 40 % of the distance above

Lower SelfieNearClip if the tip of the nose is cut off, raise it if fingers still show.

#Flash

Setting Type Default What it does
Camera.FlashPower number 0.4 How hard the flash lights the scene when a photo is taken. 1.0 is the built-in burst, 0.0 no light, up to 3.0. The torch in video mode is not affected
Camera.SelfieFlashPower number 1.0 The front camera's flash: the screen turns white and its glow lights the face. 0.0: no light in the game (the screen still turns white). Up to 3.0. Other players nearby see the glow too

#Lens tuning command

Setting Type Default What it does
Camera.TuneCommand string or false 'phonecam' Command that shows the lens tuning panel. false removes the command
Camera.TuneRole string or false 'god' Who may use it: 'god', 'admin' or 'moderator' (the phone's admin roles). false: nobody

With the phone's camera open, the panel moves the lens in use while you watch the picture. Save applies the set to every player at once and keeps it in camera_lens.json in the resource folder. There is one set per lens and place: front or rear camera, on foot, in a vehicle or on a bike. A saved set wins over SelfieDistance and SelfieNearClip for that lens and place. See Camera.

#Arm

The arm that reaches for the lens and follows it as the camera turns, using the game's arm IK on top of the pose.

Setting Type Default What it does
Camera.Arm.Enabled boolean false true brings the reaching arm back. Off by default: the game moves the hand but the phone stays where the pose put it, so to other players the phone hung in the air. Every option below only applies while this is true
Camera.Arm.Sync boolean true Other players see the arm move too. false: only the player holding the camera does
Camera.Arm.Selfie table { Back = 0.10, Drop = 0.18, Side = 0.08 } Where the hand sits for the front lens, in metres from the lens: behind it, below it, towards the phone hand's shoulder
Camera.Arm.SelfieFollows boolean false false keeps the arm straight ahead while the front lens is swung round the face. true: the arm follows the lens
Camera.Arm.Rear table { Back = 0.04, Drop = 0.13, Side = 0.05 } Same as Selfie for the rear lens
Camera.Arm.Follow number 12.0 How quickly the hand catches up with the lens. Higher is tighter
Camera.Arm.Press number 0.025 The hand dips this far (metres) for a moment as a photo is taken. 0 turns it off

#Config.Media

Setting Type Default What it does
Media.MaxItems number 1000 Photos and videos kept per player. New ones are refused once the gallery is full
Media.MaxAlbums number 50 Albums per player

The longest video recording is Config.Limits.VideoSeconds and the largest upload Config.Limits.UploadBytes, both on Other settings.