> For the complete documentation index, see [llms.txt](https://sl-scritps.gitbook.io/sl-scripts-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sl-scritps.gitbook.io/sl-scripts-documentation/products/sl-auto-news-camera.md).

# SL Auto News Camera

## SL Auto News Camera

**Code:** CAM-31\
**Resource:** `sl_auto_news_camera`\
**Version:** Current Release\
**Category:** Media RP / News Camera / Cinematic Tool\
**Status:** Stable

**Structured tools for serious roleplay servers.**

***

### Overview

SL Auto News Camera is a news camera roleplay tool for FiveM servers.

It is designed for reporters, media crews, event staff and content creators who want a cleaner way to create news-style scenes, interviews, coverage moments and cinematic camera setups inside the world.

The resource helps media roleplay feel more intentional by giving players a dedicated camera-style tool instead of relying only on normal gameplay view or generic screenshots.

***

### What is this script for?

SL Auto News Camera gives servers a dedicated media RP tool for news coverage and camera-based scenes.

It is useful for:

* News reporter roleplay
* Weazel News-style jobs
* Event coverage
* Interviews
* Press conferences
* Business openings
* Public announcements
* Staff-hosted events
* Cinematic roleplay moments
* Server media content
* Screenshots and promotional scenes

The main goal is:

```txt
Reporter or camera operator prepares the camera → scene is framed → media RP feels more believable
```

***

### Roleplay Experience

SL Auto News Camera is designed around a clear IC idea:

```txt
A media crew arrives at a scene.
The camera is prepared.
The reporter or camera operator frames the subject.
The scene becomes a news-style moment.
```

This can make public roleplay feel more alive, especially when the server has media jobs, event coverage, community announcements or cinematic RP scenes.

Examples:

```txt
A reporter interviews a business owner.
A camera operator records a city event.
Staff creates a press conference scene.
A media crew covers a vehicle meet or public opening.
```

The tool should support the RP moment without becoming a complicated production system.

***

### Player IC Usage

For normal players, SL Auto News Camera can be used when their character is part of a media, reporting or event coverage scene.

Common player IC uses:

* Record or frame an interview
* Cover a public event
* Take news-style shots
* Create a media moment for a business
* Support press roleplay
* Help with cinematic storytelling
* Act as a camera operator
* Act as a reporter or journalist

Normal player flow:

```txt
Arrive at scene → activate camera tool → frame subject → roleplay coverage → exit camera mode
```

Example IC lines:

```txt
“We are live from the scene.”
“Can you stand closer to the camera?”
“I’ll get the shot from this angle.”
“Let’s start the interview.”
“This will be part of tonight’s report.”
```

Players should use the camera to support roleplay, not to gain unfair information or interrupt serious scenes.

***

### Reporter IC Usage

The reporter is the character leading the story, interview or public coverage.

Common reporter actions:

* Interview players
* Introduce the scene
* Ask questions
* Present a business opening
* Cover an event
* React to what is happening
* Coordinate with the camera operator

Example reporter flow:

```txt
Choose subject → prepare questions → position near camera → start interview → close report
```

Example IC lines:

```txt
“We are here with the owner of the new business.”
“What happened here today?”
“Can you tell us more about this event?”
“Back to you in the studio.”
```

The reporter does not always need to control the camera directly. In a team, another player can act as camera operator.

***

### Camera Operator IC Usage

The camera operator focuses on the visual side of the scene.

Common camera operator actions:

* Prepare the camera
* Frame the reporter
* Frame the interview subject
* Adjust the angle
* Move around the event carefully
* Capture crowd or environment shots
* Support the reporter during the scene

Example camera operator flow:

```txt
Set camera position → frame reporter and subject → adjust angle → hold shot → exit when finished
```

Example IC lines:

```txt
“Camera is ready.”
“Move slightly to the left.”
“I’ve got the shot.”
“Hold that position.”
“Recording angle is set.”
```

This role is especially useful for servers with media jobs, news crews or content creators.

***

### Player / IC Flow

#### 1. The player opens the camera tool

Depending on configuration, the player may open the tool with a command, keybind or allowed interaction.

Common command examples:

```txt
/newscam
/newscamera
```

Check your configuration for the exact command.

***

#### 2. The player enters camera mode

Once active, the camera tool gives the player a more suitable view or camera-style workflow.

Expected result:

```txt
Camera mode activates.
The player can frame the scene.
```

The exact behavior depends on server configuration.

***

#### 3. The player frames the subject

The player positions the camera around:

* Reporter
* Interview subject
* Crowd
* Vehicle
* Business entrance
* Stage
* Event area
* Emergency scene
* Announcement point

Good framing helps the RP scene feel more professional.

***

#### 4. The roleplay scene happens

The reporter, subject and camera operator continue the scene.

Examples:

```txt
interview
live coverage
event recap
public announcement
business promotion
```

***

#### 5. The player exits camera mode

When finished, the player exits the camera tool.

Expected result:

```txt
Camera returns to normal.
Controls return to normal.
The player continues roleplay.
```

***

### Admin / Owner IC Usage

For admins, owners and event staff, SL Auto News Camera can be used to create more polished public scenes.

Common admin/owner IC uses:

* Prepare a press conference
* Cover a server event
* Create official event screenshots
* Support media job RP
* Stage a news scene
* Capture business openings
* Create promotional content
* Give trusted players better media tools
* Help staff document community events

Example admin/event flow:

```txt
Prepare event area → assign reporter/camera operator → test camera → start event → capture coverage
```

Example event scenario:

```txt
Staff hosts a mayor speech.
A reporter stands near the podium.
A camera operator frames the shot.
Players watch the announcement as part of the scene.
```

For server owners, this helps the server produce better public content and stronger media-style roleplay.

***

### Admin / Owner Technical Flow

Admins and owners should configure access, controls and safe usage before enabling the tool publicly.

Common admin actions may include:

* Configure command names
* Configure keybinds
* Configure permissions
* Configure camera behavior
* Configure camera limits
* Configure UI or overlay behavior
* Configure job restrictions
* Configure safe exit/reset behavior
* Test with media jobs
* Test during events
* Restrict advanced camera access if needed

Recommended admin checks:

```txt
1. Confirm the resource starts correctly.
2. Open the camera tool with the configured command.
3. Test camera activation.
4. Test movement or framing behavior.
5. Test exit/reset behavior.
6. Confirm player controls return normally.
7. Test permissions and job restrictions.
8. Test with at least one reporter and one subject.
9. Check F8 and server console for errors.
```

***

### Example IC Scenarios

#### News interview

A reporter interviews a business owner.

```txt
“We are here at the grand opening of the new café.”
```

#### Public event coverage

A media crew covers a city event.

```txt
“The crowd is gathering near the stage.”
```

#### Emergency scene coverage

A reporter covers the aftermath of an incident from a safe distance.

```txt
“We are staying behind the police line.”
```

#### Vehicle meet

A camera operator captures cars and crowd reactions.

```txt
“Pan across the lineup.”
```

#### Staff announcement

Admins stage a public announcement with a camera crew.

```txt
“Camera is ready. You can start.”
```

***

### What this resource is not

SL Auto News Camera is not intended to be a full live television system, video editor or streaming platform by itself.

It is focused on:

```txt
news-style camera roleplay
media crew scenes
interviews
event coverage
cinematic framing
camera operator workflow
```

For advanced video editing, livestreaming or full broadcast systems, servers may combine this resource with external recording tools or other media systems.

***

### Main Features

* News camera roleplay workflow
* Reporter and camera operator use cases
* Camera-style framing support
* Event coverage support
* Interview scene support
* Useful for media jobs and staff events
* Command or keybind access depending on configuration
* Configurable permissions
* Configurable camera behavior
* Safe exit/reset behavior
* Optional job restrictions depending on configuration
* Useful for screenshots and promotional media
* Clean SL Scripts style
* Designed for serious RP servers with media scenes

***

### Dependencies

#### Required

```txt
FiveM server
```

#### Recommended / Optional

```txt
ox_lib
QBCore
Qbox
ESX
Standalone mode
```

The exact dependency setup depends on server configuration.

SL Auto News Camera usually does not require inventory, target or database systems unless your installed version or custom configuration adds them.

***

### Installation Notes

1. Place the resource folder inside your server resources folder.

Example:

```txt
resources/[sl_scripts]/sl_auto_news_camera
```

2. Make sure the folder name is:

```txt
sl_auto_news_camera
```

3. Configure:

```txt
config.lua
custom.lua
locales/
```

4. Add the resource to your `server.cfg`.

Example:

```cfg
ensure ox_lib

ensure sl_auto_news_camera
```

If your build does not require `ox_lib`, configure fallback behavior in `config.lua`.

***

### How to Use

#### Basic Player Flow

1. The player opens the news camera tool.
2. Camera mode activates.
3. The player frames the scene.
4. The reporter/interview scene happens.
5. The player captures screenshots or records using their chosen method if needed.
6. The player exits the camera tool.

#### Basic Media Crew Flow

1. Reporter prepares the topic.
2. Camera operator prepares the camera.
3. Subject stands in position.
4. Camera operator frames the shot.
5. Reporter starts the interview or coverage.
6. Camera operator exits when the scene is finished.

#### Basic Admin Flow

1. Admin configures access and permissions.
2. Admin tests the camera tool.
3. Admin assigns media/event roles if needed.
4. Admin monitors safe usage during events.
5. Admin resets camera state if needed.

#### IC Summary

```txt
Media crew arrives → camera is prepared → coverage starts → scene is captured
```

#### OOC / Technical Summary

```txt
Command/keybind opens tool → camera mode activates → player frames scene → screenshot/recording handled externally → camera resets
```

***

### Controls

Exact controls may depend on configuration.

Common camera controls may include:

```txt
W / A / S / D = move camera or adjust position
Mouse = look around
Scroll = zoom or adjust distance
Q / E = adjust height or rotation depending on mode
SHIFT = faster movement
CTRL = slower movement
H = hide/show UI if configured
BACKSPACE / ESC = exit camera mode
```

Check `config.lua` and in-game hints for the exact control layout.

Recommended:

```txt
Keep controls simple and show clear hints while the camera tool is active.
```

***

### Commands

Command names may depend on configuration.

Common command examples:

```txt
/newscam
/newscamera
/sl_newscam
/sl_news_camera
```

Possible admin/reset command examples:

```txt
/newscam_reset
/sl_newscam_admin
```

Check `config.lua` for the exact command names used by your installed version.

Commands are useful for opening the tool, testing camera behavior or resetting the camera if needed.

***

### Permissions

Permission setup depends on server configuration.

Common permission levels may include:

```txt
view
use
media
admin
owner
```

Recommended access logic:

```txt
Players = no access or basic access depending on server style
Media jobs = use camera tool
Staff = use for event coverage
Admins = full access and reset tools
Owners = full access
```

Permissions may use:

* Ace permissions
* Framework groups
* Jobs
* Job grades
* Config admin list
* Custom permission bridge

Recommended:

```txt
Restrict advanced camera access to media jobs, staff or trusted players.
```

This helps avoid camera abuse during serious roleplay.

***

### Usage Guidelines

#### Good uses

```txt
interviews
event coverage
business openings
press conferences
server announcements
vehicle meets
community recaps
media RP scenes
cinematic screenshots
```

#### Avoid

```txt
using the camera to spy through walls
interrupting police/EMS scenes
using camera mode during combat
blocking other players during serious RP
using camera tools to gain unfair information
staying in camera mode longer than needed during live scenes
```

Servers should define clear media rules depending on how public or restricted the tool is.

***

### Configuration

Open:

```txt
config.lua
```

Common settings may include:

```txt
Product information
Locale
Debug mode
Startup logs
Command settings
Keybind settings
Permission settings
Job restrictions
Camera behavior
Camera speed
Camera distance
Zoom settings
UI settings
Control settings
Exit/reset behavior
Admin settings
```

Recommended for production:

```lua
Config.Debug = false
```

Use debug mode only while testing or troubleshooting.

***

### Custom Integrations

Open:

```txt
custom.lua
```

Use this file for server-specific functions such as:

* Custom notifications
* Custom permission checks
* Custom framework integration
* Custom job checks
* Custom admin checks
* Custom logging
* Custom camera restrictions
* Custom media job validation

If your server uses standard permission systems, you may only need to configure access.

***

### Startup Logs

When the resource starts correctly, you may see logs similar to:

```txt
[sl_auto_news_camera][INFO] Server ready: SL Auto News Camera
[sl_auto_news_camera][INFO] Client ready: SL Auto News Camera | Use /newscam
```

If startup logs are disabled, check `config.lua`.

***

### Best Practices

#### Use it with media jobs

SL Auto News Camera works best when tied to a reporter, journalist or media crew role.

Recommended:

```txt
Create a media job or trusted staff role.
Let those players use the tool during events and interviews.
```

***

#### Keep scenes organized

For interviews and press coverage, assign simple roles.

Example:

```txt
Reporter = speaks and asks questions
Camera operator = frames the shot
Subject = answers questions
Staff = controls scene safety if needed
```

***

#### Respect active RP

The camera should support roleplay, not interrupt it.

Recommended:

```txt
Ask before filming close-up scenes.
Stay behind police/EMS lines.
Do not block movement.
Do not use camera mode during combat or chases.
```

***

#### Capture content for the community

Use the tool to create better server media.

Good outputs:

```txt
Discord event recaps
Tebex screenshots
YouTube clips
server announcements
business promotion
news-style posts
```

***

### Troubleshooting

#### News camera does not open

Check:

```txt
- The resource is started.
- You are using the correct command.
- Commands are enabled in config.lua.
- You have permission to use the camera.
- F8 console has no errors.
- Server console has no errors.
```

***

#### Camera does not move

Check:

```txt
- Camera mode activated correctly.
- Controls are configured.
- Another NUI or camera resource is not blocking controls.
- Player state allows camera usage.
- F8 console has no camera/control errors.
```

***

#### Player gets stuck after exiting camera mode

Check:

```txt
- Exit/reset behavior is enabled.
- ESC/BACKSPACE exit control is configured.
- Camera reset function is working.
- Player controls are restored after exit.
- Another resource is not taking camera control.
```

Try the configured reset command if available.

***

#### Camera feels too fast or too slow

Check:

```txt
- Camera speed settings.
- Slow/fast modifier settings.
- Zoom settings.
- Control sensitivity.
```

Adjust movement gradually and test in game.

***

#### UI does not hide

Check:

```txt
- UI hide/show key is configured.
- NUI callbacks are working if used.
- Another UI is still visible.
- F8 console has no JavaScript errors.
```

***

#### Black box or dark rectangle appears behind the UI

Check:

```txt
- html/body background is transparent.
- #app or #root background is transparent.
- No fullscreen wrapper has a solid black background.
- Panel opacity is controlled with rgba instead of global opacity.
```

Recommended CSS pattern:

```css
html,
body,
#app,
#root {
    background: transparent !important;
}
```

Avoid using `opacity` on the full UI container because it also fades text, icons and buttons.

***

#### Normal players can access the camera tool

Check:

```txt
- Permission settings.
- Ace permissions.
- Framework group detection.
- Job/grade restrictions.
- custom.lua permission bridge.
- Config admin list.
```

Recommended:

```txt
Restrict access to media jobs, staff or trusted users if camera freedom is sensitive on your server.
```

***

#### Screenshots or recordings do not save

SL Auto News Camera helps frame the scene, but the final capture may depend on the player’s screenshot or recording tool.

Check:

```txt
- FiveM screenshot settings.
- Steam screenshot settings.
- Windows capture settings.
- Recording software settings.
- Disk space and save folder.
```

***

### Version Notes

#### Current Release

* News camera roleplay workflow for media scenes.
* Supports reporter, camera operator and staff event use cases.
* Focused on cleaner news-style framing and roleplay coverage.
* Useful for media jobs, public events and server content creation.

***

### Support

When asking for support, include:

```txt
Product: SL Auto News Camera
Resource name: sl_auto_news_camera
Version:
Framework:
Issue:
Steps to reproduce:
Command used:
Permission setup:
Job setup if restricted:
Server console error:
Client F8 error:
Screenshot/video:
```

Example:

```txt
Product: SL Auto News Camera
Resource name: sl_auto_news_camera
Version: Current Release
Framework: Qbox
Issue: Camera opens but player controls do not return after exit
Steps to reproduce: Use /newscam, move camera, press ESC
Command used: /newscam
Permission setup: media job only
Job setup if restricted: reporter
Server console error: none
Client F8 error: attached
Screenshot/video: attached
```

***

### Final Notes

SL Auto News Camera works best as a media roleplay and event coverage tool.

For best results, use it with trusted media players, clear server rules and organized scenes where the camera supports the RP instead of interrupting it.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://sl-scritps.gitbook.io/sl-scripts-documentation/products/sl-auto-news-camera.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
