⚽ Silly Kick – Kickable Ball System (RedM)

A fun kickable ball system for RedM. Spawn a physics ball via inventory item, and anyone nearby can kick it with the Q key. Realistic physics, auto-despawn, and server-managed ball state.

Preview: Video

✨ Features

• ⚽ Spawn a ball via usable inventory item

• 🦵 Kick with Q key: any player can kick the ball nearby

• 🎯 Realistic physics: force-based kick in player's forward direction

• 🎭 Kick animation: melee kick animation plays on kick

• 🔢 Single ball limit: only one ball at a time (server-enforced)

• ⏱️ Auto-despawn: configurable time until ball disappears

• 🧹 Disconnect cleanup: ball removed when owner leaves

• ⚙️ Fully configurable: prop model, kick force, range, key binding

• 🗄️ Auto DB setup: item auto-created in database

• 🌐 Multi-Framework: VORP + RSGCore (auto-detected)

• 🛡️ Timeout protection: model & anim loading with timeouts

✅ Dependencies

• RedM

• VORP Core or RSGCore (auto-detected at runtime)

• oxmysql (for auto item setup)

📦 Installation

1. Place Silly_Kick in your server resources folder.

2. Ensure it in your server.cfg:

   ensure Silly_Kick

3. Configure ball settings in config.lua.

4. The item will be auto-created in the database on first start.

⚙️ Configuration (config.lua)

Item & Ball

• Config.ItemName — inventory item name (e.g. "Ball")

• Config.PropModel — ball prop model

• Config.SpawnDistance — distance in front of player

• Config.PropDespawnTime — auto-despawn time in seconds

• Config.MaxBalls — max simultaneous balls

• Config.MaxBallsMessage — limit reached message ({max} placeholder)

Kick Settings

• Config.ForceKey — key hash for kick (default: Q)

• Config.KickRange — range to detect ball

• Config.ForceStrength — horizontal kick force

• Config.ForceUp — vertical kick force (arc)

🌐 Multi-Framework Support

Silly Kick automatically detects whether your server runs VORP or RSGCore and uses the correct API calls. No manual configuration needed.

| Feature | VORP | RSGCore | | ------------- | ----------------------------------- | ------------------------------------- | | Usable Item | vorp_inventory:registerUsableItem | RSGCore.Functions.CreateUseableItem | | Notifications | vorp:TipRight | RSGCore:Notify | | DB Item Table | items / vorp_items | items |

🎮 How It Works

1. Player uses the ball item from inventory
2. Ball spawns in front of the player with physics
3. Anyone nearby can press Q to kick the ball
4. Kick animation plays + force is applied
5. Ball auto-despawns after the configured time