Item

Grants a specified quantity of a Rust item to the player when the reward is claimed.

{
  "type": "Item",
  "title": "",
  "description": "",
  "eligiblePermissions": [],
  "item": "scrap",
  "quantity": 250,
  "skinId": null,
  "itemName": null,
  "itemNameTranslations": null
}

Fields

Field	Type	Description
`type`	string	Exactly 'Item'
`item`	string	Rust item shortNames, lowercase dotted (e.g. rifle.ak, rifle.bolt, wood, stones, metal.fragments, scrap, hqm, lowgradefuel).
`quantity`	integer (min 1)	Number of items granted.
`skinId` ⭐ Premium	integer \| null (min 0)	Skin applied to the granted item, given as the skin's workshop ID. null for the item's default look.
`itemName` ⭐ Premium	string \| null	Custom name to apply to the item. Separate from title, which names the reward in the menu. null or blank leaves the item's own name.
`itemNameTranslations` ⭐ Premium	map \| null	Per-language overrides for itemName, mapping a language code (like "fr" or "zh-CN") to the translated text. Players whose language has no entry (matched case-insensitively, no region fallback) or a blank one see itemName instead. null when there are none.

Shared fields (5)

Field	Type	Description
`title`	string	Display name. May be empty to use the reward type's default name (recommended for most rewards).
`titleTranslations`	map \| null	Per-language overrides for title, mapping a language code (like "fr" or "zh-CN") to the translated text. Players whose language has no entry (matched case-insensitively, no region fallback) or a blank one see title instead. null when there are none.
`description`	string	A short blurb of 1 to 3 sentences. May be empty.
`descriptionTranslations`	map \| null	Per-language overrides for description, mapping a language code (like "fr" or "zh-CN") to the translated text. Players whose language has no entry (matched case-insensitively, no region fallback) or a blank one see description instead. null when there are none.
`eligiblePermissions` ⭐ Premium	string[]	Permission strings that gate this reward, using any-of logic: a non-empty list grants the reward to any player holding at least one of the listed permissions. An empty array means everyone is eligible.

Notes

⭐ Premium skinId, itemName and itemNameTranslations only work on the Full edition. On Lite the item keeps its default look and name, both in the player’s inventory and in the menu. Your values stay in the file and start working when you upgrade.
item must be a valid Rust item shortname (or item id), or the reward is treated as invalid.
If title is left empty, the reward displays a default name.
A skinned or named item does not stack with a plain one. That is the game’s own rule and figuring out custom stacking is out of scope for Contracts.
itemName goes on the item itself, while title names the reward in the menu. Setting only itemName also gives the menu something better than the plain item name.
If using itemNameTranslations, the item’s name will be translated for the player receiving the item. It will stay translated as-is and not re-translated if another player picks it up.

Privacy