Welcome to cDev PropShot, the automated greenscreen screenshot tool for FiveM prop catalogs. Queue thousands of models, capture raw shots in a bundled studio, then process them into transparent WebP thumbnails.

⚠ EDITION NOTICE — PropShot ONLY
This package includes cDev PropShot only. It does NOT include cDev Map Live Editor (in-game map builder, Go Live, mass tools, world eraser, etc.). PropShot runs standalone with its local catalog. Map Live Editor is optional / recommended if you want the Map Editor catalog + Screenshots button integration — buy Map Live Editor separately or choose the Map Live Editor + PropShot Bundle.

Built for server owners and creators who need clean catalog images at scale — with progress UI, cancel support, and a buyer-friendly Python post-process pipeline.

VIDEO SOON

📸 Features

📦 Works with 13k+ Prop Catalogs
When Map Live Editor is installed and started, PropShot prefers that catalog (13,000+ models + CustomProps). Standalone, it uses cdev_propshot local props.json and CustomProps.

🟢 Bundled Greenscreen Studio
Greenscreen map ships inside the resource (stream/). No separate chroma room required. Teleport, frame, and shoot automatically.

📱 Capture Progress UI
On-screen overlay with:

• Progress, ETA, current model

• Captured / skipped / failed counts

• Catalog source badge

• Cancel (ESC or button) — finishes the current shot cleanly

🖼 Raw → Transparent WebP Pipeline
Raw JPG/PNG land in screenshots/raw/. Run tools/process_propshots.py (Pillow / NumPy) to cut green and export transparent WebPs to screenshots/props/.

• Flags: --watch, --quality, --size, --force, --raw, --out

• tools/ and screenshots/ are buyer editable

🔗 Optional Map Live Editor Integration
If Map Live Editor is started, the editor TopBar shows a Screenshots button that closes the editor and launches PropShot. Not included in this package — Map Editor sold separately or via Bundle.

🔌 Multi-Framework Compatibility
Automatic framework detection with support for:

• QBox (qbx_core)

• QBCore

• ESX Legacy

🌍 Localization
Built-in language files: English, Portuguese, and Spanish — switch via config.

⚙️ Configuration
Single buyer-facing public/shared/config.lua for command, ACE, capture studio, encoding, output folders, catalog paths, and cooldowns.

📤 Developer Exports
Client: Start, Cancel, IsActive — Server: CanUse.

📖 Documentation
Full GitBook PropShot tools page under the Map Live Editor docs set.

📚 Documentation

Complete Documentation HERE

✅ PropShot only — Map Live Editor not included
✅ Standalone greenscreen captures
✅ Transparent WebP post-process
✅ Optional Map Editor catalog when installed