Webcam

A mod and plugin that enables players to stream video from their webcams directly within Minecraft.

⚠️ Important Warning

This plugin requires special server setup to function properly. If you are a server administrator, please read the "Server Setup" section first.

Key Features

• High-quality webcam video streaming
• H.264 video codec support
• Video transmission via UDP using custom protocol
• AES encryption for data protection
• Bitrate and video resolution control
• Various webcam display shapes
• Display size and position configuration
• Display on player model face
• Viewing distance limitation
• Permission system for broadcasting and viewing
• Advanced client configuration (requires Mod Menu and Cloth Config API)
• Ability to hide specific players' webcams
• Velocity proxy support
• Compatibility with ReplayMod and Flashback

Client Usage

Place the mod in the mods folder (along with Fabric API if using Fabric). The settings menu can be accessed via hotkey (default C).

Status Icons

Icon	Description
	Your webcam is active
	Your webcam is disabled
	Connecting to Webcam server
	No connection to Webcam server

Security

Webcam connection is encrypted, but we do not guarantee absolute security. Use at your own risk!

Server Setup

The Webcam plugin uses UDP sockets for video packet transmission. You need to open a UDP port in your server's firewall and control panel (if available) for the Webcam server to function. Default port is 25454/udp. The port can be changed in server configuration.

If using Velocity, see the "Proxy Setup" section.

Server Configuration

File locations:

• Fabric / Quilt / NeoForge: config/webcam/server.json
• Bukkit / Spigot / Paper: plugins/webcam/server.json

Default values with descriptions:

{
  "port": 25454,                 // Webcam UDP server port. Should not conflict with other used UDP ports
  "bind_address": "",            // Address to bind Webcam server to. Leave empty for wildcard address
  "host": "",                    // Hostname for client connections. Leave empty to use player's connection address
  "keep_alive_period": 1000,     // Keep alive packet sending period in milliseconds
  "permission_check_period": 60, // Permission check period for webcam.broadcast and webcam.view in ticks
  "max_display_distance": 100.0, // Maximum block distance for displaying other players' webcams
  "display_on_face": false,      // Display webcam on player model face or above head
  "display_shape": "round",      // Webcam display shape. Possible values: "round", "square"
  "display_offset_y": 1.3,       // Y offset for webcams above players' heads
  "display_size": 1.2,           // Display size for webcams above players' heads
  "hide_nicknames": true,        // Hide player nickname when webcam is enabled
  "display_self_webcam": true,   // Show player's own webcam to themselves
  "synced": {                    // These settings sync with clients
    "image_dimension": 360,      // Side dimension of square webcam image
    "mtu": 1100,                 // Maximum transmission unit. Decrease if image appears glitchy
    "bitrate": 500               // Target video bitrate (kbps)
  },
  "messages": {                  // Custom message translations
    "incompatible_mod_version": "Incompatible Webcam version. Yours - %s, server's - %s"
  }
}

Commands

• /webcamconfig <field> [new_value] - command to read/update configuration values. Requires webcam.command.config permission or OP status.

Permissions

• webcam.command.config - permission to modify Webcam server configuration (default: OP level)
• webcam.broadcast - permission to broadcast webcam (default: true)
• webcam.view - permission to view webcams (default: true)

Proxy Setup

Webcam has a Velocity plugin that proxies Webcam servers on backend Minecraft servers and allows connecting to different Webcam servers through a single port.

If running proxy and backend servers on the same machine, configure different ports for them.

Proxy Configuration

Configuration file located at plugins/webcam/config.properties

Default values with descriptions:

# Webcam proxy configuration

# Webcam UDP server port. Should not conflict with other used UDP ports
port=25454

# Address to bind Webcam server to. Leave empty for wildcard address
bind_address=

# Hostname for client connections. Leave empty to use player's connection address
host=

License

This mod is licensed under No Unauthorized Distribution License, full text available at: https://github.com/DimasKama/Webcam/blob/master/LICENSE.md

License Summary

• Modpacks: Can use the mod in modpacks, but cannot include files directly. Instead, specify as dependency pointing to official download source.
• For Developers: Allowed to create addons or integrate mod support, but cannot copy code. Make it external dependency downloaded from official source.
• Distribution Limits: Cannot reupload or share mod code or compiled files publicly without author's explicit permission.
• Personal Use: Can use and modify mod for personal use, but changes must remain private.
• Official Sources: Any dependency or modpack reference must point to official download sources provided by author.