🏚️ Homeless Script for VORP
🌍 A Full Survival & Roleplay Experience
VIDEO : https://www.youtube.com/watch?v=LaWuKiaO-Zw
Immerse your players in a survival and roleplay experience of unparalleled depth with the Homeless Script for VORP .
This script transforms destitution into a true adventure, where every day is a fight filled with opportunities, dangers, and human interactions.
Go beyond simple begging — and discover a complete street-life ecosystem!
✨ Main Features
• 🤲 Active & Visual Begging — Use a cardboard sign to ask NPCs for help.
• 🗑️ Environmental Scavenging — Search trash cans, crates, and other world props for loot.
• 🧰 Dynamic Job Offers — Receive interactive job proposals from NPCs with guided missions.
• 🔪 Betrayal & Robbery System — Not all offers are honest… beware of ambushes!
• 🏃 Intense Chases — Pursue thieves with a real-time, color-changing blip.
• 🎸 Street Musicians — Use instruments from your inventory to earn money.
• 🎩 Interactive Charity Hat — NPCs can drop cash into your hat while you play.
• 🎵 Rhythm Minigame — The better your performance, the more Charity you receive!• 🎵 Songs — Linking YouTube music to instruments
🔍 Detailed Feature Breakdown
🤲 Begging & Scavenging
Visual Beggar Mode: Your character pulls out a cardboard sign with a full animation, making the roleplay immersive and visible to everyone.
Ask for Alms: Approach NPCs with your sign to trigger interactive animations — they might give you money, items, or ignore you.
Search the World: Configure which props (trash cans, barrels, etc.) can be scavenged for resources.
🧰 Dynamic Job System
Unexpected Offers: NPCs may offer you work instead of a handout.
Follow the Guide: Accept a job and follow the NPC with a dynamic map blip — it changes color (🟢 Green → 🟠 Orange → 🔴 Red) based on your distance.
Automatic Detection: If no nearby missions exist, the script won’t offer any jobs.
Create your own jobs.
🔪 Betrayal, Robbery & Chases
The Ambush: Any job can turn into a setup. NPCs may draw weapons and attempt to rob you.
The Chase: Once robbed, the thief flees! A live color-changing blip appears (green when close, red when far), creating a thrilling pursuit.
📈 Mission & Music Tracker
During jobs or performances, a dynamic tracker UI shows your objectives and progress.
For music, it displays your Charity chance and attraction radius, which update in real time as you play the rhythm minigame.
🎸 Street Musician & Rhythm Minigame
🎧 3D Synchronized Sound: Perfectly synced across all nearby players via
xsound.Immersive 3D positional audio — sound fades naturally with distance.
Configure each song’s volume and audible range individually.
🎺 Available Instruments: Pre-configured for harmonica, guitar, banjo, and trumpet.
🎶 Song Selection UI: Choose your tune from a clean, easy-to-use interface.
🎩 Charity Hat: NPCs attracted by your performance approach and drop money.
🕹️ Rhythm Minigame: The better you hit notes, the more Charity and the wider your attraction radius!
⚙️ Complete Configuration Options
Everything in this script is fully customizable through your configuration files.
1️⃣ General Configuration
• Begging Item: Define the inventory item (e.g.,
sign) used to beg.
• Interaction Key: Default isE— changeable.
• Interaction Distance: Adjust the radius for interaction prompts.
2️⃣ Active Begging System
• Success Chance: Base % chance that NPCs give something.
• Cooldowns: Separate timers for player and NPC interactions.
• Animations: Fully customizable for both giver and receiver.
• Loot Table: Configure type (money,item), chance, amount, and prop used.
3️⃣ Rummaging System (Trash, Crates, etc.)
• Enable/Disable scavenging.
• Define searchable 3D models (hashes).
• Set cooldowns for props.
• Configure rummaging animations and durations.
• Create a dedicated loot table for scavenged items.
4️⃣ Job Management
• Job Offer Chance: % chance a beg converts into a job.
• Job Search Radius: Define how far jobs can spawn.
• NPC Following: Control NPC blip behavior and fail distance.
• Modular Jobs: Add unlimited custom jobs with name, dialogues, icons, rewards, animations, and props.
5️⃣ Betrayal & Robbery System
• Toggle globally ON/OFF.
• Betrayal Chance: Adjust robbery probability.
• Choose NPC’s weapon and timing.
• Configure what gets stolen (money, items).
• Add blacklists to protect specific items.
6️⃣ Chase System
• Enable/Disable chase mechanics.
• Escape Distance: Define how far a thief must go to escape.
• Catch Radius: Set how close the player must be to succeed.
7️⃣ Music & Instrument System
• Link instruments (
guitar,banjo, etc.) to inventory items.
• Toggle sound system on/off (for servers not usingxsound).
• Configure each song with name, link, volume, and radius.
8️⃣ Charity Hat System
• Enable/Disable hat feature.
• Choose hat model.
• Configure Charity radius, chance, and amounts.
• Define NPC Charity animations.
9️⃣ Rhythm Minigame
• Enable/Disable globally.
• Customize keys and UI layout.
• Adjust note speed and difficulty scaling.
• Set performance rewards to affect Charity chance and radius.
• Performance dynamically overrides default hat settings.
🔤 Translations
• Every text line is stored in one table for easy translation.
• Translate all UI, notifications, prompts, and messages into any language.
🔗 Dependencies
• 🧩 VORP_CORE
• 📦 VORP_INVENTORY
• 🎧 xsound (Strongly recommended for full music system)
💡 Note:
xsoundis optional — without it, musicians will animate but no audio will play.