## 📸 Camera System
A complete in-game camera that creates real photo objects and synced UI instead of just screenshots.
* Physical camera prop visible in the player’s hands
* Separate animations for idle, aiming, shooting, viewing, and inspecting
* Props and UI stay in sync with the current camera state
* Smooth transitions between all interaction states
---
## 🎥 Taking Photos
Photos are captured through a live viewfinder and saved with metadata.
* Live camera viewfinder for framing shots
* Automatic location and timestamp on every photo
* Shutter sound and flash particle effects
* Camera movement animation when capturing
---
## 🖼️ Gallery & Photo Data
All photos are stored in a personal gallery instead of a simple file list.
* Gallery shows preview, location, and time taken
* Fast browsing and filtering
* View photos in full-screen mode
* Delete or manage photos from the UI
---
## 🖨️ Printed Photos & In-World Viewing
Photos can exist as physical items in the world.
* Print any gallery photo into an inventory item
* Photo is displayed on the item using synced DUI
* Focus mode for inspecting photos in a clean UI
* Parallax-style movement when viewing
---
## ⚙️ Camera Settings
Basic camera behavior can be adjusted in real time.
* ISO control
* Flash zoom and intensity
* Settings apply instantly to the viewfinder
* Per-player configuration
---
## 🤝 Sharing & Evidence
Photos can be transferred between players.
* Send photos directly from your gallery
* Recipients can save photos to their own gallery
* Useful for police, media, and RP evidence systems
* Access limited to shared players
---
## 🌐 Storage & Upload Providers
Flexible image handling for different server setups.
* Supports NoCloud, FiveManage, and No-File-Server
* External hosting via Discord and ImgBox
* Session and restart safe
* Optimized uploads and retrieval
---
## 🔌 API & Integrations
Designed to work standalone or with existing systems.
* Clean exports and documented events
* Inventory integrations for printed photos and camera items
* Framework optional
* Easy to extend
---
## 💡 Feature Summary
| Feature | Notes |
| --------------------------- | -------------------------------------- |
| Physical Camera Prop | Visible and synced with player state |
| State Animations | Idle, aim, capture, view, inspect |
| Live Viewfinder | Real-time photo framing |
| Photo Gallery | Stores images with metadata |
| Printed Photo Items | DUI-based in-world display |
| Sharing System | Player-to-player transfers |
| Storage Providers | Multiple upload backends supported |
| Developer API | Exports and event hooks |
---
## 🎯 Use Cases
* Police evidence and investigations
* Media and journalism RP
* Event and social roleplay
* Criminal RP (intel, proof, leverage)
* Story-based servers