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"]}Fields
Section titled “Fields”| 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.