Silly Rat Hunt – Rat Catcher Job for RedM (VORP / RSGCore) 🐀🪤
📌 Description
Silly Rat Hunt gives players a rat catcher job built around traps, cheese bait, and cash rewards. Talk to the quest giver, take an assignment, place your cage, add cheese, and wait for the rats. Collect the catch and return to sell it.
The supplied VORP / RSGCore bridge handles usable items, inventory actions, notifications, and payouts. German / English language packs cover prompts and messages. NPCs, models, timings, trap limits, and rewards are configurable.
✨ Features
- 🧑 Job NPCs with configurable models, names, and locations.
- 🪤 Usable trap item places a cage in front of the player.
- 🧀 Cheese bait starts the catch timer when used near your own empty trap.
- 🐀 Visible rats in the cage — 1 rat after 3–5 seconds by default.
- 🎒 [E] collection turns the catch into a dead-rat inventory item.
- 💵 [G] sale at a job NPC — $3.00 per rat by default, one rat per sale.
- 🔢 3 active traps per player and a 180-second placement cooldown.
- 📏 20 m minimum placement distance from job NPCs.
- ⏱️ 15-minute trap lifetime with configurable catch timing and catch count.
- 🎒 Collection capacity check — a full inventory leaves the catch available in the trap.
- 🌐 Multi-Framework — VORP or RSGCore, automatically detected or selected in config.
- 🌍 Multilingual — DE / EN prompts and notifications.
- 🗄️ Optional automatic item setup — includes the trap, cheese bait, and dead-rat item through oxmysql on supported existing VORP item tables.
🎮 How It Works
- Press [Enter] near a job NPC to take the assignment.
- Move away from the NPC and use
rattenfalleto place a trap. - Use
Kasenear the empty cage to bait it. - Wait for the configured catch delay.
- Press [E] near your caught trap to collect
toteratte; the trap is removed. - Return to a job NPC and press [G] to sell one dead rat for cash.
Trap and bait items are consumed. Selling with no active traps ends the current assignment, allowing the player to take another.
🔧 Installation
-
Place the folder containing
fxmanifest.luain your resources asSilly_RatHunt. -
Start
vorp_core+vorp_inventoryorrsg-core+rsg-inventorybefore the resource:ensure Silly_RatHunt -
VORP: optionally start
oxmysqlfirst. The includeddb_setup.luaadds missingrattenfalle,Kase, andtoteratteentries to a compatible existingitems,vorp_items, orvorp_inventory_itemstable. Restart the inventory after new entries are created. Without automatic setup, add all three manually; the olderitems.sqlcovers the trap and dead rat only. -
RSGCore: define all configured items in
rsg-core/shared/items.luausing lowercase inventory names. The VORP database installer does not create RSG item definitions. -
Enable OneSync and choose the framework, language, NPCs, and item names in
config.lua.
🌐 Multi-Framework & Multi-Language
-
VORP:
vorp_core+vorp_inventory. -
RSGCore:
rsg-core+rsg-inventory, withox_libnotifications. -
Framework selection:
Config.Framework = 'auto','vorp', or'rsgcore'. Automatic detection prefers VORP when both cores are running. -
Language selection:
Config.Language = 'DE'or'EN'; German is the default. -
Custom wording: German and English prompts/messages are supplied in
configlang.lua; individual texts can be overridden throughConfig.Text.
The RSGCore integration is included and is marked untested in game. The item and payout job loop requires a supported framework and inventory.
📦 Dependencies
| Dependency | Required |
|---|---|
| RedM + OneSync | ✅ |
| VORP Core or RSGCore | ✅ — one supported framework |
| vorp_inventory on VORP | ✅ |
| rsg-inventory on RSGCore | ✅ |
| ox_lib on RSGCore | Required for notifications |
| Trap, bait, and reward item definitions | ✅ — automatic VORP setup where available, otherwise manual |
| oxmysql | Optional — automatic VORP item setup |
⚙️ Highlights from config.lua
-
Config.Framework = 'auto','vorp', or'rsgcore';Config.Language = 'DE'or'EN'. -
Config.Items— trap, bait, and reward names. -
Config.NPCs— configurable job NPCs and positions. -
Config.MoneyPerRat— cash reward per sale. -
Config.MaxActiveTraps,PlaceCooldown,MinNpcDistance— placement limits. -
Config.RatSpawnTime,RatCount,TrapLifetime— catch and expiry settings. -
Config.TrapProp,CheeseProp,RatModel— visual models. -
Config.Controls,Config.ItemLabels, and custom wording inConfig.Text.
Assignments and traps reset on resource or server restart; disconnecting removes that player's active traps. Collection checks available inventory space. Inventory or payout results requiring admin review are logged; there is no automatic retry or compensation.
🎬 Video Preview
:writing_hand: Come Join our Discord
🔗 Download
| | | |---|---| | Code is accessible | Yes — currently supplied Lua source | | Framework | VORP or RSGCore | | Languages | German / English — DE / EN | | Requirements | RedM + OneSync + framework inventory + configured items | | Configuration | NPCs, items, catch timing, payouts, models, and controls | | Support | Discord |

