🤠 LRRP AINPC — Interactive NPC Knowledge & Voice System

(no ai)

🎙️ Pre-Written Conversations • Gemini STT/TTS • Local Knowledge Engine

🆓 FREE & 💎 PREMIUM | RedM

LRRP AINPC brings interactive, knowledgeable NPCs to your RedM server without allowing an AI model to dynamically write NPC dialogue.

Players can face an NPC and speak naturally using PTT. Their speech is transcribed, then LRRP AINPC handles the actual conversation locally by matching the player's words against server-owner-configured knowledge and selecting an existing pre-written response.

The selected response can then be spoken aloud using male/female voice output.

🚫 NO AI-GENERATED NPC DIALOGUE

This is the most important distinction:

✅ NPC dialogue is pre-written
✅ Server information is configured by the server owner
✅ Keyword & phrase matching happens locally
✅ Conversation context is handled locally
✅ NPC answers are selected locally
✅ Gemini does not write NPC answers
✅ Gemini does not choose the answer
✅ Gemini does not alter the selected answer
✅ Gemini does not invent server information
✅ No dynamically generated quests, stories or server lore

Gemini is restricted to speech input/output:

🎙️ STT — converts player speech into a transcript
🧠 LRRP Local Engine — selects an existing pre-written answer
🗣️ TTS — speaks that already-selected response aloud

Player Voice → STT → Local Matching → Pre-Written Answer → TTS

🧠 CUSTOM SERVER KNOWLEDGE

Configure what your NPCs know.

NPCs can be given information about:

⛏️ Jobs & professions
🔨 Crafting & recipes
🐎 Horses & stables
🌾 Farming & ranching
🎣 Fishing & hunting
🏪 Businesses & shops
💰 Economy & trading
⚖️ Law & criminal systems
🗺️ Locations & travel
📜 Server commands
🧩 Clues & quests
📚 Tutorials & newcomer information
⚙️ Custom server systems

Everything comes from your configured knowledge, rather than an LLM inventing an answer.

💬 NATURAL QUESTIONS & FOLLOW-UPS

Different phrases can lead to the same configured knowledge.

Player: “Where can I find iron?”

Player: “Know where the iron mine is?”

Player: “Where do I mine iron?”

All can resolve to the same pre-written Iron knowledge.

Conversation context also supports follow-ups:

Player: “Where can I find iron?”
NPC: gives the configured Iron location response.

Player: “What level do I need?”
NPC: understands the conversation is still about Iron.

🗺️ CLUE & SERVER HELP

Clue support can recognise distinctive words from configured clues.

A player could say:

“I'm looking for a rock face north of Annesburg.”

The local matcher can identify the relevant configured clue and provide progressive pre-written hints.

Hints can progress from:

💡 Subtle hint
💡💡 Stronger hint
💡💡💡 Clear direction

No AI needs to invent the clue solution.

🗣️ NPC VOICES

🎙️ PTT interaction
♂️ Male NPC voice support
♀️ Female NPC voice support
💬 Subtitles
👄 Talking/mouth behaviour
🎧 Optional original/licensed prerecorded .ogg / .wav lines
🔊 Gemini TTS for configured pre-written responses

Recorded audio can take priority when supplied.

No Rockstar/RDR2 voice recordings are included or modified.

Server owners are responsible for ensuring custom recordings they add are original or properly licensed.

🐎 REDM NPC INTERACTIONS

NPC functionality includes configurable companion behaviour such as:

🤠 Follow
✋ Stay
👋 Release
🧎 Crouch

💎 Premium expands available RedM behaviour with additional posse, horse and wagon-related interactions.

🆓 FREE EDITION

✅ Core NPC conversation system
✅ PTT voice interaction
✅ Typed /ainpc fallback
✅ Local keyword & phrase matching
✅ Pre-written knowledge
✅ Conversation context
✅ Gemini STT + TTS
✅ Male/female voice support
✅ Basic clue support
✅ Basic companion controls
✅ Permanent LRRP Free branding

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

Once the shared allowance is exhausted, additional replies remain unavailable until it resets.

💎 PREMIUM EDITION

♾️ Unlimited NPC conversations
♾️ Unlimited configured knowledge
♾️ Unlimited clue entries
🎙️ PTT + typed interaction
🧠 Full local knowledge system
💬 Follow-up conversation context
🗣️ Male/female voice support
🎧 Custom recorded voice support
🐎 Expanded posse/horse/wagon interaction options
🎨 Editable branding
⚙️ Editable configuration

External Gemini API quotas/rate limits still apply to STT/TTS.

⚙️ REQUIREMENTS

Platform: RedM / RDR2
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 voice interaction
OneSync: Recommended
Premium protection: CFX Asset Escrow
Paid delivery: Tebex / CFX Asset Delivery

Server configuration:

set ainpc_gemini_key "YOUR_GEMINI_API_KEY"
ensure LRRP_AINPC

The Gemini API key is handled server-side and is not intentionally exposed through the NUI.

⚡ PERFORMANCE

The knowledge engine operates when players interact with NPCs. It does not continuously send every NPC to an LLM or dynamically generate background NPC conversations.

✅ Event/interaction-driven knowledge matching
✅ Local dialogue selection
✅ No continuous LLM conversation generation
✅ No remote code loading

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

CFX requires performance indicators for script releases.

📦 DOWNLOAD / PURCHASE

🆓 Free Scripts

💎 Premium Scripts

💬 LRRP Studio Support

⚠️ For the CFX Free release: attach the Free ZIP directly to the topic or replace the Free category link above with the direct Free Tebex package URL. CFX requires Free releases to be immediately obtainable.

📋 CFX RELEASE INFORMATION

FREE

PREMIUM

Code is accessible

Yes

Partially — editable configs/knowledge

Subscription-based

No

No

Lines (approximately)

~7,000

~7,000

Requirements & dependencies

RedM, Gemini API key for STT/TTS

RedM, 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