Cinema (Fixed Edition)

Watch videos together in Garry's Mod. Cinema is a multiplayer theater gamemode with synchronized playback, public and private theaters, queues, and support for a wide range of media services.

This community-maintained successor to the original PixelTail Games Cinema focuses on keeping theater servers working on modern Garry's Mod while adding practical features for players and server owners.

At a glance

• Type: Full Garry's Mod gamemode (not a regular addon)
• Workshop: Cinema (Fixed Edition)
• Documentation: GitHub Wiki
• Issues and feature requests: GitHub Issues
• License: GPL-3.0

Features

Theaters and playback

• Public and private theaters with queues, vote-skip, seeking, and pause
• Video history with search, filters, and pagination
• Theater renting with PointShop 1 or 2 points, time extensions, refunds, and player lists
• Per-player volume, mute-on-alt-tab, and hide-player options
• Map-aware theater locations and seat integration
• Optional experimental Sandbox derivation, popcorn weapon, and 3D voice options
• UI translations in 20+ locales

Supported media

YouTube, Twitch, SoundCloud, Dailymotion, Rumble, Kick, Bilibili (VOD, AV, live, and episodes), VK, OK, Internet Archive, Google Drive, MEGA, Jellyfin, and direct URL/protocol playback.

Actual playback support can depend on the provider, URL type, and the Chromium/CEF codecs available in the player's Garry's Mod installation.

Requirements

• Garry's Mod (the x86-64 branch is recommended).
• A supported map: a theater* or cinema* map, or a map with theater entities and location data.
• GModPatchTool is strongly recommended for H.264 and other codec support.

Compatibility: Do not run this gamemode alongside the original PixelTail Cinema addon or its forks. Disable or unsubscribe from those first.

Installation

Steam Workshop

1. Subscribe to Cinema (Fixed Edition).
2. For a dedicated server, add Workshop ID 2419005587 to your collection.
3. Select Cinema (Fixed Edition) (cinema_modded) as the gamemode and start a supported map.

From source

Clone the repository and copy cinema_modded/ into garrysmod/gamemodes/:

git clone https://github.com/PurrCoding/cinema.git

Then select cinema_modded and load a supported map.

See the installation guide for the full walkthrough and troubleshooting.

Configuration

Common server ConVars:

ConVar	Default	Description
cinema_queue_mode	1	Queue voting: 1 upvote only, 2 chronological, 3 up/down voting
cinema_skip_ratio	0.66	Fraction of players required to vote-skip
cinema_video_duration_max	10800	Maximum video duration in public theaters, in seconds
cinema_allow_reset	0	Reset a theater when it becomes empty
cinema_allow_voice	0	Enable voice chat inside theaters
cinema_allow_3dvoice	1	Enable positional voice
cinema_url	Built-in	Base URL for theater HTML pages

For renting options, client settings, and the complete list, see Configuration and Theater renting.

Documentation

Guide	What it covers
Installation	Setup, requirements, troubleshooting
Configuration	Server ConVars and options
Commands	Player, owner, and admin commands
Debug commands	Location visualizers and diagnostics
Location system	Theater bounds and map areas
Creating custom maps	Hammer and Lua mapping guide
Custom video service	Adding a media provider
Theater architecture	THEATER, VIDEO, and SERVICE internals
Seats	Chair models and offsets
Translations	Adding languages
Development	Module layout and contribution notes

Repository layout

cinema_modded/                 Gamemode root
  gamemode/
    modules/
      theater/                 Core theater logic and video services
      rent/                    Private theater renting
      scoreboard/              Queue, request, and owner UI
      location/                Map location system
      seats/                   Seat helpers
    i18n/                      Translations
    maps/                      Per-map theater/location setup
  entities/                    Screens, doors, portable TVs, etc.
  content/                     Materials, fonts, sounds
  cinema.fgd                   Hammer entity definitions

Contributor guidance: AGENTS.md.

Credits

• Original Cinema by PixelTail Games
• YouTube-related work by Veitikka and the media-player ecosystem
• Sandbox-in-Cinema contributions by Ket'Ta-Lani and ArtarOs
• GModPatchTool by Solstice Game Studios / Akiko Kumagara
• Community translators and maintainers of this edition

License

Licensed under the GNU General Public License v3.0. See LICENSE.md for the full license text.