CodeM xCamera - Premium Polaroid Camera System for FiveM
A full-featured Polaroid camera system where players take photos with a physical camera prop, apply filters and overlays, choose frame colors, hold the developed polaroid in their hand, flip it over to read the back, show it to nearby players, hang it on walls in custom wooden frames with wall-snap placement, pin it onto cork photo boards with a drag-and-drop editor, or collect it in a physical photo album with page turning and free placement. 8 CSS filters, 3 overlays, 6 frame colors, 5 upload providers, day/night photo lighting, watermarks, an NPC frame shop, and a Vue.js NUI. The most immersive camera experience ever built for FiveM.
FEATURES
- Physical camera prop (prop_pap_camera_01) attaches to the hand with a raise animation (700ms configurable), viewfinder UI blends in (900ms), shutter capture with anti-spam cooldown (2000ms default), requires polaroid_paper film item consumed per shot (configurable)
- Photo saved as a unique polaroid inventory item with full metadata: URL, filter, frame color, title (32 char), caption (120 char), capture date, street/zone name, photographer signature, and coordinates
- On ox_inventory the photo's inventory icon automatically becomes the captured image via metadata.imageurl
- 8 CSS filters selectable in the viewfinder: Normal, Vintage (sepia + contrast), Sepia (heavy), Noir (grayscale + contrast), Warm (saturated + sepia tint), Cold (hue-shifted blue), Faded (low contrast + bright), Dramatic (high contrast) - all editable in CameraConfig.Filters
- 3 overlays with per-overlay opacity: film grain (10%), light leak (18%), vignette (25%) - each independently toggleable in CameraConfig.Overlays
- 6 frame colors: Classic White, Black, Orange (gradient), Blue (gradient), Green (gradient), Red - each with border color and text color, gradient frames use color (top) and color2 (bottom) - editable in CameraConfig.Frames
- Camera tiers map camera items to filter sets - restrict which filters a camera type can use (e.g. a disposable camera with only Normal + Vintage)
- Hold your photo in hand as a physical polaroid card (codem_polaroid prop) with the captured image rendered on the front face via DUI texture replacement
- R to flip the photo over (350ms animation) - back side shows the handwritten note/caption
- H to focus - scripted camera locks onto the photo for a close-up view (FOV 42, configurable forward distance, 400ms blend) without touching the gameplay camera
- F for full-screen view panel with large photo, metadata, and action buttons
- Show to nearby players within 8m (configurable) - they see the real image on the card in your hand rendered in real time
- Give to nearby players within 3m (configurable) - item transfers from your inventory to theirs
- Up to 6 remote held photos drawn simultaneously at 18m draw distance (both configurable)
- Hang photos on walls inside a custom wooden frame prop (codem_frame streamed model) with wall-snap placement
- Placement controls: Q/E rotate, arrow up/down for height, R toggle wall snap, left click confirm, Backspace cancel - preview turns red when no wall surface detected (requireSurface configurable)
- Walk-to animation: if the spot is far, character walks there first (configurable speed, distance, timeout), then plays a hanging animation (1200ms) before the photo appears - cancelable with X
- Take-down animation (900ms) returns the photo to inventory
- Day/night photo lighting: photos dim at night (0.32 multiplier) and brighten during day (1.0), indoor fixed (0.70), dawn/dusk fade with configurable transition hours - prevents photos from glowing unrealistically at night
- Wall offset auto-adjusts for outdoor surfaces vs MLO interiors (0.006m outdoor, 0.03m indoor)
- Cork photo boards (prop_cork_board) placeable on walls with the same snap/rotate/height controls
- Board editor NUI: drag-and-drop photos from inventory onto the board surface with free position, rotation, and scale per photo - layout saved as JSON
- Resizable boards from 0.5x to 2x scale with left/right arrow keys (server-validated limits)
- Board render distance 22m, draw distance 28m, place distance 10m
- Physical photo album prop held in both hands with a two-handed carry animation
- Page turning with arrow keys and page-turn sound effect (configurable volume)
- Free photo placement editor on pages - drag, rotate, scale each photo on the spread
- Photos render directly into the album prop's page textures via DUI surface - no floating quads, photos are part of the mesh
- Scripted camera follows the album with smooth damping (configurable lag, settle time, walk push, FOV)
- Default capacity: 6 photos per page, 4 pages = 24 photos total (both configurable)
- Photos removed from inventory when placed in album, returned when taken out - stored in codem_camera_albums with album_uid
- NPC frame shop vendor at configurable locations with map blip (sprite 590, color 5) - walk up, press E, browse your polaroid photos from inventory, select one to frame in the wooden frame prop - framed photos can then be hung on any wall with [G] - configurable price (default free), NPC model, interaction distance (2m), multiple locations supported
- Custom camera body branding: center text (up to 2 lines) and right-side logo (default CodeM mark, custom image URL, or disabled) drawn by the UI, not baked into the model
- Watermarks on every photo: capture date, street/zone name, and photographer signature (each independently toggleable)
- 5 upload providers: self-hosted disk storage with built-in HTTP handler (free, default), Discord webhook (free, server-side), Fivemanage image API (paid, client-side), NoCloud signed-URL storage (paid, server-side), or custom API endpoint with configurable form field, headers, and response path - server-side providers never expose secrets to the client
ITEMS
- polaroid_camera: unique, useable - opens the viewfinder
- polaroid_paper: stackable - consumed per shot (1 paper = 1 photo)
- polaroid: unique, useable - taken photo with metadata
- polaroid_album: unique, useable - physical album holding photos on pages
- photo_board: unique, useable - cork board placeable on walls
- Copy-paste item definitions included for ox_inventory, qb-core, and ESX
- Item images (PNG) included for all 5 items
COMPATIBILITY
- Frameworks: QBCore, QBox, ESX (auto-detected via codem-lib)
- Database: oxmysql - 3 tables (AutoMigrate creates on start)
- Dependencies: codem-lib
- Inventory: auto-detected via codem-lib (ox_inventory recommended for dynamic photo icon)
- UI Theme: 9 color presets or any hex value (auto text contrast)
- Escrow-ignored: config/*.lua, config/**/*.lua, modules/*.lua, items/*.lua
- Custom streamed models: codem_polaroid (photo card), codem_frame (wooden frame)