Skip to content
These docs reflect Contracts v0.6.0, the latest release. Older servers may differ.

Turn In

Requires the player to turn in specified items to the plugin. Turned-in items are removed from the player’s inventory. Counts the number of items submitted.

{
"type": "TurnIn",
"title": "Turn in low grade fuel",
"description": "",
"amountRequired": 500,
"conditions": {},
"items": ["lowgradefuel"]
}
Field Type Description
type string Exactly 'TurnIn'.
title string Short, human-readable name. Must not be empty.
description string A blurb of 1 to 3 sentences. May be empty if the title is self-explanatory.
amountRequired integer (≥ 1) How many units must be completed. What a unit means depends on the objective type. Minimum 1.
conditions map Optional conditions that restrict when progress counts. Progress is recorded only when the objective's main requirement and all of these conditions are met. Use an empty map for none.
items string[] Rust item shortNames, lowercase dotted (e.g. rifle.ak, rifle.bolt, wood, stones, metal.fragments, scrap, hqm, lowgradefuel).
  • Unlike most objectives, turning in is a player-initiated action in the menu, not a passive event. The player can turn in only while the objective is active and incomplete and they hold at least one matching item.
  • Submitting consumes the items: they leave the player’s inventory.
  • Turning in happens inside the Contracts menu, using the “Turn In” button on the objective’s UI entry.