🌆 LRRP AINPC — Interactive NPC Knowledge & Voice System

🎙️ Give Your NPCs Knowledge, Conversation & Voice

🆓 FREE & 💎 PREMIUM | FiveM

Turn ordinary FiveM NPCs into interactive sources of information using server-owner-authored knowledge, local conversation matching and voice interaction.

Players can face an NPC and talk using PTT. Their speech is transcribed before LRRP AINPC's local knowledge engine determines the subject and selects an existing pre-written response.

🚫 NO AI-GENERATED NPC DIALOGUE

Gemini does NOT dynamically create the NPC's answer.

✅ All NPC response text is pre-written
✅ Server owners control the knowledge
✅ Keywords and phrases are matched locally
✅ Conversation context is local
✅ Responses are selected locally
✅ Gemini cannot invent server facts
✅ Gemini does not choose the answer
✅ Gemini does not rewrite the answer
✅ No dynamically AI-written quests or stories
✅ No dynamically AI-written NPC dialogue

Gemini integration is restricted to:

🎙️ Speech-to-Text — player microphone → transcript
🗣️ Text-to-Speech — selected pre-written response → spoken audio

The actual conversation logic remains inside LRRP AINPC:

Player Voice → Gemini STT → Local Matcher → Pre-Written Response → Gemini TTS

🧠 TEACH NPCs ABOUT YOUR SERVER

Create knowledge covering:

👷 Jobs
🔧 Mechanics
🚓 Police systems
🚑 Medical systems
🏪 Businesses
🏠 Housing
💰 Economy
🚗 Vehicles
📍 Locations
🎒 Items
🔨 Crafting
🎮 Activities
📜 Commands
📚 New-player information
🧩 Quests & clues
⚙️ Custom scripts & systems

Knowledge is configurable rather than generated dynamically by an LLM.

💬 NATURAL LOCAL MATCHING

Players don't have to use one exact sentence.

For example:

“Where's the mechanic?”
“Know where I can repair my car?”
“Where do I get my vehicle fixed?”

can all be configured to resolve to the same pre-written knowledge entry.

🧠 FOLLOW-UP CONTEXT

NPCs can retain the current subject.

Player: “Where's the mechanic?”
NPC: gives the configured mechanic answer.

Player: “What time does it open?”
NPC: can continue using the mechanic context.

The follow-up system does not require an LLM to invent a conversation.

🗺️ CLUE / SERVER HELP

Server owners can configure clue phrases with progressive hints.

Players can speak or type distinctive wording from a clue and have LRRP AINPC locally identify the relevant configured entry.

💡 Hint 1 — subtle
💡💡 Hint 2 — stronger
💡💡💡 Hint 3 — clear direction

🔊 VOICE INTERACTION

🎙️ PTT voice input
♂️ Male NPC voices
♀️ Female NPC voices
💬 Subtitle support
👄 NPC talking behaviour
🎧 Optional original/licensed prerecorded .ogg / .wav audio
🔊 Gemini TTS reading the already-selected response

Recorded human audio can be configured to take priority.

No Rockstar/GTA voice recordings are included or modified.

🚶 NPC COMPANION FEATURES

Configurable deterministic commands include:

🚶 Follow
✋ Stay
👋 Release
🧎 Crouch

💎 Premium expands available FiveM behaviour with additional crew and vehicle-related functionality.

🆓 FREE EDITION

✅ Core NPC conversations
✅ PTT voice interaction
✅ /ainpc typed fallback
✅ Local keyword matching
✅ Pre-written server knowledge
✅ Follow-up context
✅ Gemini STT + TTS
✅ Male/female voices
✅ Basic clue system
✅ Basic companion controls
✅ LRRP Free branding

Free limit: 5 successful NPC replies globally/server-wide every 12 hours.

💎 PREMIUM EDITION

♾️ Unlimited NPC conversations
♾️ Unlimited knowledge entries
♾️ Unlimited clue entries
🧠 Full local knowledge system
🎙️ PTT + typed interaction
💬 Follow-up context
🗣️ Male/female voice support
🎧 Custom prerecorded voice support
🚗 Expanded crew/vehicle interaction options
🎨 Editable branding
⚙️ Editable configuration

Gemini account limits and API quotas still apply to STT/TTS.

⚙️ REQUIREMENTS

Platform: FiveM / GTA V
Resource name: LRRP_AINPC
Framework: Standalone conversation core
Database: None required for base operation
Gemini: Google Gemini API key required for STT/TTS
Microphone: Browser/NUI microphone permission required for PTT
OneSync: Recommended
Premium protection: CFX Asset Escrow
Paid delivery: Tebex / CFX Asset Delivery

Installation:

set ainpc_gemini_key "YOUR_GEMINI_API_KEY"
ensure LRRP_AINPC

The Gemini API key remains server-side.

⚡ PERFORMANCE

LRRP AINPC is interaction-driven. It does not continuously generate conversations for ambient NPCs.

✅ Local knowledge matching
✅ Interaction-based processing
✅ No continuous LLM NPC generation
✅ No remote code execution/loading
✅ No AI-generated NPC answer text

📊 CFX PERFORMANCE EVIDENCE:
Attach your current FiveM Resource Monitor/profiler screenshot here before publishing.

CFX specifically requests performance indicators such as Resource Monitor numbers or a profiler screenshot for script releases.

📦 DOWNLOAD / PURCHASE

🆓 Free Scripts

💎 Premium Scripts

💬 LRRP Studio Support

⚠️ For the CFX Free topic: attach the Free resource directly, link to a public repository, or replace the category link with the direct Free Tebex package. The resource has to be immediately available.

📋 CFX RELEASE INFORMATION

FREE

PREMIUM

Code is accessible

Yes

Partially — editable configs/knowledge

Subscription-based

No

No

Lines (approximately)

~2,100

~2,100

Requirements & dependencies

FiveM, Gemini API key for STT/TTS

FiveM, Gemini API key for STT/TTS

Support

Yes

Yes

Protection

None / Free distribution

CFX Asset Escrow

Delivery

CFX upload/public repo/direct Free Tebex package

Tebex / CFX Asset Delivery

Suggested CFX tags: script • standalone • free / paid • escrow where applicable.