🧼 Silly Soap – Slip Trap Item (RedM / VORP / RSGCore)

Drop a bar of soap in front of you and watch players, NPCs, and animals wipe out in classic slapstick fashion. Built for RedM with a clean multi-framework bridge (VORP or RSGCore, auto-detected), DE / EN / ES / FR locales, and automatic item DB setup.

🎬 Watch Video Preview

✨ Features

• 🧼 Usable item — use seife to place a soap prop (p_soap01x) in front of the player
• 🤸 Slip & ragdoll — players, NPCs, and animals within TriggerRadius (2 m) go flying
• 🔢 Per-player limit — max 3 active soaps per player
• ⏱️ Auto cleanup — soap disappears after 2 slips or 10 minutes
• 🎒 Owner pickup — place owner can press [E] to pick up and get the item back (when RemoveItem is enabled)
• 🌐 Multi-Framework: VORP or RSGCore (auto-detected) + standalone notify fallback
• 🌍 Multilingual: Config.Language → DE / EN / ES / FR
• 📦 DB setup — db_setup.lua auto-creates the item on first start (oxmysql)
• 📦 Escrow-friendly: config.lua + locales are escrow_ignore'd

✅ Dependencies

• RedM
• VORP Core or RSGCore (auto-detected)
• VORP Inventory (when using VORP) / RSGCore inventory (when using RSGCore)
• oxmysql (optional — only for automatic item DB setup)

📦 Installation

1. Place the resource so the folder with fxmanifest.lua is named Silly_Soap.

2. Ensure it in your server.cfg:

   ensure Silly_Soap
   

3. The item seife is auto-created on first start via db_setup.lua (requires oxmysql) — no SQL import needed.

4. Tune placement, slip radius, limits, and pickup in config.lua.

5. Set language: Config.Language = 'DE' | 'EN' | 'ES' | 'FR'.

⚙️ Configuration (config.lua)

Framework & item

• Config.Framework — 'auto' / 'vorp' / 'rsgcore' / 'standalone'
• Config.Language — 'DE' / 'EN' / 'ES' / 'FR'
• Config.Item / Config.ItemName — default seife
• Config.ItemLabels — display label (default Seife)
• Config.Prop — world prop model (p_soap01x)

Placement & slip

• Config.PlaceDistance — how far in front of the player the soap is placed
• Config.TriggerRadius — slip detection radius around the soap (default 2 m)
• Config.RagdollTime / Config.PersonCooldown — ragdoll duration and per-entity cooldown
• Config.AffectNPCs / Config.AffectAnimals — toggle NPC and animal slipping

Limits & pickup

• Config.MaxActivePerPlayer — max soaps placed at once (default 3)
• Config.MaxSlips — soap removed after this many slips (default 2)
• Config.Lifetime — auto-remove after ms (default 10 min)
• Config.RemoveItem — consume item on place; return on owner pickup
• Config.AllowOwnerPickup / Config.PickupDistance / Config.PickupControl

🎮 In-Game Flow

1. Player uses the seife item from inventory.
2. Server validates active soap count and grants a one-time place permission.
3. Client places the soap prop on the ground in front of the player.
4. Anyone (or anything) stepping within 2 m ragdolls — up to 2 times before the soap vanishes.
5. Owner can press [E] to pick the soap back up and regain the item.
6. Soap auto-removes after 10 minutes if not picked up.

🌐 Multi-Framework Support

| Feature | VORP | RSGCore | |---|---|---| | Usable item | ✅ vorp_inventory:registerUsableItem | ✅ RSGCore.Functions.CreateUseableItem | | Remove / add item | ✅ vorp_inventory:subItem / addItem | ✅ Player.Functions.RemoveItem / AddItem | | Notifications | ✅ vorp:TipBottom | ✅ RSGCore:Notify |

📝 Notes

• Internal events use the silly_seife:* namespace.
• Server gates silly_seife:place — only allowed after a successful item use.
• Item is auto-created by db_setup.lua on first start — no items.sql import required.
• Fully escrow-friendly — config.lua and locales/* are in escrow_ignore.