🧠SceneAI

SceneAI allows players to spawn fully customized, interactive NPCs with dialogue trees. Designed for immersive roleplay, SceneAI enables the creation of lifelike characters that can respond to player

📦 Features

• 🔹 Preview and spawn any ped model with on-screen placement

• 👕 Custom clothing and prop configuration

• 🧍 Scenario animations (e.g., leaning, smoking, clipboard use)

• 💬 Fallout-style conversation system with typewriter subtitles

• 🧷 Fine-tuned 3D placement and rotation controls

• 🧠 Supports branching questions and end-of-conversation responses

• 🎯 ox_target integration to talk to NPCs and delete them

• 🌐 Networked peds visible and interactable to all players

---

🧱 Installation

Follow instructions in Getting Started

Ensure that the dependancies are started BEFORE this resource in server.cfg

---

📦 Dependancies

• ox_target

🕹️ Usage

Open the Menu

Use the command:

/sceneai

Talk to Ped

Using the ox_target third eye system, hover over the ped. If they have a conversation model configured when they were spawned, the 'Talk' option will show. Click that, and you'll be presented with fallout-style dialogue!

Spawning a Ped

1. Model Choose a ped from searchable categories. Preview it in real-time.

2. Clothing Customize the ped's upper body, legs, shoes, accessories, and overlays using a live preview.

3. Animation Assign a scenario animation for idle behavior. Examples include:

• WORLD_HUMAN_CLIPBOARD

• WORLD_HUMAN_LEANING

• WORLD_HUMAN_AA_COFFEE

4. Conversation Add a greeting and a list of questions with responses.

• Mark individual answers to end the conversation.

• The NPC will display Fallout-style dialogue with animated subtitles.

5. Review & Confirm Set behavior options:

• ✅ Freeze Ped

• ✅ Invincible

• ✅ Visible on Map (adds a blip)

• ✅ Block Events

1. Click Spawn Ped to place the character in the world.

Placement Controls

After clicking "Spawn Ped", use keyboard input to fine-tune the ped’s position.

Placement Mode:

• E → Fine-tune

• Q → Cancel

Fine-Tune Controls:

• Arrow Keys → Move position

• Q/E → Raise/Lower

• A/D → Rotate Z (spin)

• Z/X → Rotate X (pitch)

• N/M → Rotate Y (roll)

• G → Ground to surface

• ENTER → Confirm

• BACKSPACE → Cancel

Deleting a Ped

Using the ox_target third eye system, hover over the selected ped and select the delete option.

---

🎯 ox_target Integration

• 👤 Talk to the ped by interacting with them using ox_target

• 🗑️ Delete ped via a separate Delete Ped option

• 💬 NPCs show a "Talk" option if they have a conversation configured

All interactions are automatically networked and available to all players.

---

📤 Exports

COMING SOON

---

⚙️ Configuration

Config = Config or {}

-- Persistent peds are stored in this json file (relative to the resource root)
Config.PersistentFile = 'data/persistent_peds.json'

-- If true, only players with the ACE below can open the /sceneai menu.
Config.RequireAceForMenu = true

Server.cg:

Simply add the below to your server.cfg and configure to setup the ACE permissions. You can use any name for the group you want, even admin if you wish! Vespura made a brilliant ace perms guide you can check out here: https://forum.cfx.re/t/basic-aces-principals-overview-guide/90917

add_ace group.sceneai sceneai.menu allow
add_ace group.sceneai sceneai.admin allow

add_principal identifier.[YOUR IDENTIFIER HERE] group.sceneai 

---