Browse docs

Parts Theft

Configure wheel and catalytic converter theft, dealer payouts, and dispatch alerts.

Overview

The parts theft system uses a lug wrench to remove configured vehicle parts. Stolen wheels and catalytic converters can be sold at a Stolen Parts Dealer interaction created with /workshopcreator.

Review local server rules and economy balance before enabling public theft interactions.

Required items

SettingDefault
Theft toollug_wrench
Stolen wheel itemwheels
Catalytic converter itemcatalytic_converter

The theft tool can be retained or removed after use. Ensure all enabled reward items exist in the inventory system.

Dealer payouts

The dealer supports two payout modes:

  • Account: Adds the sale value to the configured framework account.
  • Item: Gives the configured payout item in the amount of the sale value.

Use item payout for custom item-based currencies such as an inventory implementation of black_money. Do not select an account name merely because its label resembles the desired currency; account and inventory-item economies are separate integrations.

The dealer catalog controls accepted item names, labels, required amounts, and sale prices. Keep prices low enough to avoid making theft a dominant economy source.

Dispatch

Dispatch can alert one or more configured jobs when a theft completes. The title and message support plate and part information, and the cooldown reduces repeated reports for the same activity.

The default integration uses Sky Jobs Base. Servers with another dispatch resource can replace it through the supported open hook in config/sv_functions.lua.

Setup checklist

  • Add lug_wrench, wheels, and catalytic_converter to the inventory.
  • Choose account or item payout deliberately.
  • Verify the configured account or payout item exists.
  • Place and test a Stolen Parts Dealer interaction.
  • Confirm dealer prices and required item amounts.
  • Verify police or other configured jobs receive dispatch alerts.
  • Test the dispatch cooldown.
  • Confirm failed sales do not remove items.