Cargo Bounties (#17344)

Co-authored-by: metalgearsloth <31366439+metalgearsloth@users.noreply.github.com>

Content.Shared/Cargo/Prototypes/CargoBountyPrototype.cs

@@ -0,0 +1,60 @@
+using Content.Shared.Whitelist;
+using Robust.Shared.Prototypes;
+using Robust.Shared.Serialization;
+
+namespace Content.Shared.Cargo.Prototypes;
+
+/// <summary>
+/// This is a prototype for a cargo bounty, a set of items
+/// that must be sold together in a labeled container in order
+/// to receive a monetary reward.
+/// </summary>
+[Prototype("cargoBounty"), Serializable, NetSerializable]
+public sealed class CargoBountyPrototype : IPrototype
+{
+    /// <inheritdoc/>
+    [IdDataField]
+    public string ID { get; } = default!;
+
+    /// <summary>
+    /// The monetary reward for completing the bounty
+    /// </summary>
+    [DataField("reward", required: true)]
+    public readonly int Reward;
+
+    /// <summary>
+    /// A description for flava purposes.
+    /// </summary>
+    [DataField("description")]
+    public readonly string Description = string.Empty;
+
+    /// <summary>
+    /// The entries that must be satisfied for the cargo bounty to be complete.
+    /// </summary>
+    [DataField("entries", required: true)]
+    public readonly List<CargoBountyItemEntry> Entries = new();
+}
+
+[DataDefinition, Serializable, NetSerializable]
+public readonly record struct CargoBountyItemEntry()
+{
+    /// <summary>
+    /// A whitelist for determining what items satisfy the entry.
+    /// </summary>
+    [DataField("whitelist", required: true)]
+    public readonly EntityWhitelist Whitelist = default!;
+
+    // todo: implement some kind of simple generic condition system
+
+    /// <summary>
+    /// How much of the item must be present to satisfy the entry
+    /// </summary>
+    [DataField("amount")]
+    public readonly int Amount = 1;
+
+    /// <summary>
+    /// A player-facing name for the item.
+    /// </summary>
+    [DataField("name")]
+    public readonly string Name = string.Empty;
+}