Camera FIGS

CameraFIGS adds a small floating webcam display above players' heads, allowing you to see your friends' reactions while playing together.

Video is visible to nearby players in the same dimension, with a default viewing distance of 50 blocks.

The mod is currently in beta. Testing is ongoing during normal gameplay, and compatibility may vary between cameras, operating systems, drivers, and modpacks.

FEATURES

• Live webcam video above players' heads on compatible multiplayer servers.

• Customizable appearance:

• Circular or rectangular frames

• Adjustable display size

• Optional local preview that follows your selected shape and size.

• Adjustable target capture rate:

• 10 FPS

• 15 FPS

• 30 FPS
  Actual FPS may be limited by the server.

• First-person support:

• Your own floating webcam display is hidden in first-person view.

• The corner preview can be enabled or disabled separately.

• Viewer controls:

• Choose whether you want to display other players' video.

• Improved camera handling:

• Background device discovery

• Camera selection saved by device name

• Error messages displayed directly in the settings screen

• English and Russian interface translations.

REQUIREMENTS

• Minecraft 1.21.1

• NeoForge 21.1.244 or newer within the 21.1 series
Development testing was performed using NeoForge 21.1.244.

• Java 21

• A compatible webcam is required only if you want to transmit video.
No webcam is required to watch other players.

Physical and virtual cameras may work if they are detected by the bundled capture library.

Compatibility depends on your camera, operating system, and drivers. Support for every webcam or OBS Virtual Camera configuration is not guaranteed.

INSTALLATION AND SETUP

1. Install CameraFIGSmod on the server.

2. Install CameraFIGSmod on every client that wants to send or view webcam video.

3. Join a world or server.

4. Press apostrophe (') to open the camera settings.

You can change this key in Minecraft controls, or open the settings through:

Mods → CameraFIGSmod → Config

1. Select your camera and click "Turn camera on".

2. Configure:

   • Frame shape

   • Display size

   • Target FPS

   • Local preview

Settings are saved when you close the menu using Done or Esc.

Players without CameraFIGSmod can still join the server if the other installed mods allow it, but they cannot send or view webcam video.

In singleplayer, or on a server without CameraFIGSmod installed, the mod supports local viewing only.

Sharing video with other players requires server-side installation.

CAMERA CONTROLS

Your camera starts only when you explicitly enable it.

Opening the settings menu or joining a server does not automatically activate the camera.

Disconnecting from a server stops the stream.

Reconnecting does not automatically turn the camera back on.

A separate "Turn webcam off" key can be assigned in Minecraft controls. It is unassigned by default.

Camera status and errors are displayed in the settings screen.

SERVER SETTINGS

Operators with permission level 2 can change stream quality using:

/camerafigsmod quality <0|1|2>

Quality levels:

0 — Low
160x120
Maximum 10 FPS

1 — Medium
240x180

2 — High
320x240

Circular frames use a centered square crop.

The selected quality is saved by the server.

The server configuration can also control:

• Maximum FPS

• Bandwidth per player

• Viewing distance from 1 to 50 blocks

The default server FPS limit is 15 FPS.

Low quality is additionally limited to 10 FPS.

Selecting 30 FPS on the client does not override server limits.

On NeoForge 21.1.244, the server configuration file is located at:

config/camerafigsmod-server.toml

NOTES AND KNOWN LIMITATIONS

• Video is transmitted through the Minecraft server to compatible nearby players.

• CameraFIGSmod does not save webcam video frames to disk.

• Higher quality settings increase bandwidth usage.

For slower or limited connections, start with Low quality.

• Compatibility with ragdoll and player-physics mods is currently partial.

Webcam positioning may behave unexpectedly when these mods modify the player's model or animation.

• Busy camera devices or unresponsive drivers may prevent the webcam from working correctly.

Check the settings screen for error messages.

In some cases, a camera driver hang may require restarting Minecraft.

UPDATING

When upgrading from version 1.1.0, update the server and all clients at the same time because the network protocol has changed.

Versions 1.2.0 and 1.2.1 are network-compatible.

Keep only one CameraFIGSmod JAR file inside each mods folder.

CREDITS

CameraFIGSmod bundles the following libraries using Jar-in-Jar:

webcam-capture
https://github.com/sarxos/webcam-capture

Created by Bartosz Firyn (sarxos) and contributors.
Licensed under the MIT License.

BridJ
https://github.com/nativelibs4java/BridJ

Created by NativeLibs4Java.
Used for native interoperability by webcam-capture.

Built with NeoForge:
https://neoforged.net/

DEVELOPMENT DISCLOSURE

This project was developed primarily with generative AI assistance, including assistance with code and documentation.