👥 BT_PUBLICNPC — Immersive Ambient NPC Generator for RedM

🎬 Demo Video

Watch on YouTube

📚 API & Documentation

Read the full documentation here

✨ Features

• Generate Ambient NPCs for Any Situation

  • Make your world feel alive with customizable NPCs for events, saloons, streets, camps, and more!

• NPC Behaviors

  • Each NPC can:

    • Walk around (with adjustable distance)

    • Carry a weapon

    • Play a scenario/animation (guitar, drink, clean, sit, etc.)

    • Or simply stand in place

• Per-Player NPCs

  • Each player generates and sees their own NPC —

    • NPCs are only visible to the player who created them (true "public" ambient NPCs)

• Easy Scripting & Integration

  • Use client export:
    exports.bt_publicnpc:getNPCEntity("paper-1")
    → Returns the entity of NPC "paper-1"

  • Add or remove NPCs on-the-fly from other scripts, client or server-side!

• 30+ Example NPCs Included

  • Ready-to-use pre-configured examples in config.lua — just copy or modify to fit your scene

• Framework Agnostic

  • Works with any framework — fully adjustable in config.lua

🛠️ Customization

• Fully editable behaviors, scenarios, distance, weapons, and more

• All parameters managed easily in your config

🖼️ Gallery