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.