From bcd7d462b7d50885a3fd61d7195f95c6cadefc54 Mon Sep 17 00:00:00 2001
From: Nemanja <98561806+EmoGarbage404@users.noreply.github.com>
Date: Sun, 9 Jul 2023 18:36:37 -0400
Subject: [PATCH 1/7] Animal Husbandry (#17140)
* Animal Husbandry
* suffixes and VV
* sanitize
* fix fails
(cherry picked from commit 716fcaa4a3b8a43f3bb2d2808db4f648ee210041)
---
.../Nutrition/EntitySystems/InfantSystem.cs | 34 +++
.../EntitySystems/AnimalHusbandrySystem.cs | 253 ++++++++++++++++++
.../AnimalHusbandry/InfantComponent.cs | 42 +++
.../AnimalHusbandry/ReproductiveComponent.cs | 102 +++++++
.../ReproductivePartnerComponent.cs | 12 +
.../nutrition/components/animal-husbandry.ftl | 3 +
.../Prototypes/Entities/Mobs/NPCs/animals.yml | 98 +++++++
.../Prototypes/Entities/Mobs/NPCs/pets.yml | 2 +
Resources/Prototypes/tags.yml | 15 ++
9 files changed, 561 insertions(+)
create mode 100644 Content.Client/Nutrition/EntitySystems/InfantSystem.cs
create mode 100644 Content.Server/Nutrition/EntitySystems/AnimalHusbandrySystem.cs
create mode 100644 Content.Shared/Nutrition/AnimalHusbandry/InfantComponent.cs
create mode 100644 Content.Shared/Nutrition/AnimalHusbandry/ReproductiveComponent.cs
create mode 100644 Content.Shared/Nutrition/AnimalHusbandry/ReproductivePartnerComponent.cs
create mode 100644 Resources/Locale/en-US/nutrition/components/animal-husbandry.ftl
diff --git a/Content.Client/Nutrition/EntitySystems/InfantSystem.cs b/Content.Client/Nutrition/EntitySystems/InfantSystem.cs
new file mode 100644
index 00000000000..dbda75c58fd
--- /dev/null
+++ b/Content.Client/Nutrition/EntitySystems/InfantSystem.cs
@@ -0,0 +1,34 @@
+using Content.Shared.Nutrition.AnimalHusbandry;
+using Robust.Client.GameObjects;
+
+namespace Content.Client.Nutrition.EntitySystems;
+
+///
+/// This handles visuals for
+///
+public sealed class InfantSystem : EntitySystem
+{
+ ///
+ public override void Initialize()
+ {
+ SubscribeLocalEvent(OnStartup);
+ SubscribeLocalEvent(OnShutdown);
+ }
+
+ private void OnStartup(EntityUid uid, InfantComponent component, ComponentStartup args)
+ {
+ if (!TryComp(uid, out var sprite))
+ return;
+
+ component.DefaultScale = sprite.Scale;
+ sprite.Scale = component.VisualScale;
+ }
+
+ private void OnShutdown(EntityUid uid, InfantComponent component, ComponentShutdown args)
+ {
+ if (!TryComp(uid, out var sprite))
+ return;
+
+ sprite.Scale = component.DefaultScale;
+ }
+}
diff --git a/Content.Server/Nutrition/EntitySystems/AnimalHusbandrySystem.cs b/Content.Server/Nutrition/EntitySystems/AnimalHusbandrySystem.cs
new file mode 100644
index 00000000000..1a9167182f1
--- /dev/null
+++ b/Content.Server/Nutrition/EntitySystems/AnimalHusbandrySystem.cs
@@ -0,0 +1,253 @@
+using Content.Server.Administration.Logs;
+using Content.Server.Interaction.Components;
+using Content.Server.Mind.Components;
+using Content.Server.Nutrition.Components;
+using Content.Server.Popups;
+using Content.Shared.Database;
+using Content.Shared.IdentityManagement;
+using Content.Shared.Mobs.Systems;
+using Content.Shared.Nutrition.AnimalHusbandry;
+using Content.Shared.Nutrition.Components;
+using Content.Shared.Nutrition.EntitySystems;
+using Content.Shared.Storage;
+using Robust.Server.GameObjects;
+using Robust.Shared.Random;
+using Robust.Shared.Timing;
+
+namespace Content.Server.Nutrition.EntitySystems;
+
+///
+/// This handles logic and interactions related to
+///
+public sealed class AnimalHusbandrySystem : EntitySystem
+{
+ [Dependency] private readonly IAdminLogManager _adminLog = default!;
+ [Dependency] private readonly IGameTiming _timing = default!;
+ [Dependency] private readonly IRobustRandom _random = default!;
+ [Dependency] private readonly EntityLookupSystem _entityLookup = default!;
+ [Dependency] private readonly HungerSystem _hunger = default!;
+ [Dependency] private readonly MetaDataSystem _metaData = default!;
+ [Dependency] private readonly MobStateSystem _mobState = default!;
+ [Dependency] private readonly PopupSystem _popup = default!;
+ [Dependency] private readonly SharedAudioSystem _audio = default!;
+
+ private readonly HashSet _failedAttempts = new();
+
+ ///
+ public override void Initialize()
+ {
+ SubscribeLocalEvent(OnUnpaused);
+ SubscribeLocalEvent(OnMindAdded);
+ SubscribeLocalEvent(OnInfantUnpaused);
+ SubscribeLocalEvent(OnInfantStartup);
+ SubscribeLocalEvent(OnInfantShutdown);
+ }
+
+ private void OnUnpaused(EntityUid uid, ReproductiveComponent component, ref EntityUnpausedEvent args)
+ {
+ component.NextBreedAttempt += args.PausedTime;
+ }
+
+ private void OnInfantUnpaused(EntityUid uid, InfantComponent component, ref EntityUnpausedEvent args)
+ {
+ component.InfantEndTime += args.PausedTime;
+ }
+
+ // we express EZ-pass terminate the pregnancy if a player takes the role
+ private void OnMindAdded(EntityUid uid, ReproductiveComponent component, MindAddedMessage args)
+ {
+ component.Gestating = false;
+ component.GestationEndTime = null;
+ }
+
+ private void OnInfantStartup(EntityUid uid, InfantComponent component, ComponentStartup args)
+ {
+ var meta = MetaData(uid);
+ component.OriginalName = meta.EntityName;
+ _metaData.SetEntityName(uid, Loc.GetString("infant-name-prefix", ("name", meta.EntityName)), meta);
+ }
+
+ private void OnInfantShutdown(EntityUid uid, InfantComponent component, ComponentShutdown args)
+ {
+ _metaData.SetEntityName(uid, component.OriginalName);
+ }
+
+ ///
+ /// Attempts to breed the entity with a valid
+ /// partner nearby.
+ ///
+ public bool TryReproduceNearby(EntityUid uid, ReproductiveComponent? component = null)
+ {
+ if (!Resolve(uid, ref component))
+ return false;
+
+ var xform = Transform(uid);
+ var partners = _entityLookup.GetComponentsInRange(xform.Coordinates, component.BreedRange);
+ foreach (var comp in partners)
+ {
+ var partner = comp.Owner;
+ if (TryReproduce(uid, partner, component))
+ return true;
+
+ // exit early if a valid attempt failed
+ if (_failedAttempts.Contains(uid))
+ return false;
+ }
+ return false;
+ }
+
+ ///
+ /// Attempts to breed an entity with
+ /// the specified partner.
+ ///
+ public bool TryReproduce(EntityUid uid, EntityUid partner, ReproductiveComponent? component = null)
+ {
+ if (!Resolve(uid, ref component))
+ return false;
+
+ if (uid == partner)
+ return false;
+
+ if (!CanReproduce(uid, component))
+ return false;
+
+ if (!IsValidPartner(uid, partner, component))
+ return false;
+
+ // if the partner is valid, yet it fails the random check
+ // invalidate the entity from further attempts this tick
+ // in order to reduce total possible pairs.
+ if (!_random.Prob(component.BreedChance))
+ {
+ _failedAttempts.Add(uid);
+ _failedAttempts.Add(partner);
+ return false;
+ }
+
+ // this is kinda wack but it's the only sound associated with most animals
+ if (TryComp(uid, out var interactionPopup))
+ _audio.PlayPvs(interactionPopup.InteractSuccessSound, uid);
+
+ _hunger.ModifyHunger(uid, -component.HungerPerBirth);
+ _hunger.ModifyHunger(partner, -component.HungerPerBirth);
+
+ component.GestationEndTime = _timing.CurTime + component.GestationDuration;
+ component.Gestating = true;
+ _adminLog.Add(LogType.Action, $"{ToPrettyString(uid)} (carrier) and {ToPrettyString(partner)} (partner) successfully bred.");
+ return true;
+ }
+
+ ///
+ /// Checks if an entity satisfies
+ /// the conditions to be able to breed.
+ ///
+ public bool CanReproduce(EntityUid uid, ReproductiveComponent? component = null)
+ {
+ if (_failedAttempts.Contains(uid))
+ return false;
+
+ if (Resolve(uid, ref component, false) && component.Gestating)
+ return false;
+
+ if (HasComp(uid))
+ return false;
+
+ if (_mobState.IsIncapacitated(uid))
+ return false;
+
+ if (TryComp(uid, out var hunger) && _hunger.GetHungerThreshold(hunger) < HungerThreshold.Okay)
+ return false;
+
+ if (TryComp(uid, out var thirst) && thirst.CurrentThirstThreshold < ThirstThreshold.Okay)
+ return false;
+
+ return true;
+ }
+
+ ///
+ /// Checks if a given entity is a valid partner.
+ /// Does not include the random check, for sane API reasons.
+ ///
+ public bool IsValidPartner(EntityUid uid, EntityUid partner, ReproductiveComponent? component = null)
+ {
+ if (!Resolve(uid, ref component))
+ return false;
+
+ if (!CanReproduce(partner))
+ return false;
+
+ return component.PartnerWhitelist.IsValid(partner);
+ }
+
+ ///
+ /// Gives birth to offspring and
+ /// resets the parent entity.
+ ///
+ public void Birth(EntityUid uid, ReproductiveComponent? component = null)
+ {
+ if (!Resolve(uid, ref component))
+ return;
+
+ // this is kinda wack but it's the only sound associated with most animals
+ if (TryComp(uid, out var interactionPopup))
+ _audio.PlayPvs(interactionPopup.InteractSuccessSound, uid);
+
+ var xform = Transform(uid);
+ var spawns = EntitySpawnCollection.GetSpawns(component.Offspring, _random);
+ foreach (var spawn in spawns)
+ {
+ var offspring = Spawn(spawn, xform.Coordinates.Offset(_random.NextVector2(0.3f)));
+ if (component.MakeOffspringInfant)
+ {
+ var infant = AddComp(offspring);
+ infant.InfantEndTime = _timing.CurTime + infant.InfantDuration;
+ }
+ _adminLog.Add(LogType.Action, $"{ToPrettyString(uid)} gave birth to {ToPrettyString(offspring)}.");
+ }
+
+ _popup.PopupEntity(Loc.GetString(component.BirthPopup, ("parent", Identity.Entity(uid, EntityManager))), uid);
+
+ component.Gestating = false;
+ component.GestationEndTime = null;
+ }
+
+ public override void Update(float frameTime)
+ {
+ base.Update(frameTime);
+
+ HashSet birthQueue = new();
+ _failedAttempts.Clear();
+
+ var query = EntityQueryEnumerator();
+ while (query.MoveNext(out var uid, out var reproductive))
+ {
+ if (reproductive.GestationEndTime != null && _timing.CurTime >= reproductive.GestationEndTime)
+ {
+ birthQueue.Add(uid);
+ }
+
+ if (_timing.CurTime < reproductive.NextBreedAttempt)
+ continue;
+ reproductive.NextBreedAttempt += _random.Next(reproductive.MinBreedAttemptInterval, reproductive.MaxBreedAttemptInterval);
+
+ // no.
+ if (HasComp(uid) || TryComp(uid, out var mind) && mind.HasMind)
+ continue;
+
+ TryReproduceNearby(uid, reproductive);
+ }
+
+ foreach (var queued in birthQueue)
+ {
+ Birth(queued);
+ }
+
+ var infantQuery = EntityQueryEnumerator();
+ while (infantQuery.MoveNext(out var uid, out var infant))
+ {
+ if (_timing.CurTime < infant.InfantEndTime)
+ continue;
+ RemCompDeferred(uid, infant);
+ }
+ }
+}
diff --git a/Content.Shared/Nutrition/AnimalHusbandry/InfantComponent.cs b/Content.Shared/Nutrition/AnimalHusbandry/InfantComponent.cs
new file mode 100644
index 00000000000..0baeab5251b
--- /dev/null
+++ b/Content.Shared/Nutrition/AnimalHusbandry/InfantComponent.cs
@@ -0,0 +1,42 @@
+using Robust.Shared.GameStates;
+using Robust.Shared.Serialization.TypeSerializers.Implementations.Custom;
+
+namespace Content.Shared.Nutrition.AnimalHusbandry;
+
+///
+/// This is used for marking entities as infants.
+/// Infants have half the size, visually, and cannot breed.
+///
+[RegisterComponent, NetworkedComponent]
+public sealed class InfantComponent : Component
+{
+ ///
+ /// How long the entity remains an infant.
+ ///
+ [DataField("infantDuration")]
+ public TimeSpan InfantDuration = TimeSpan.FromMinutes(3);
+
+ ///
+ /// The base scale of the entity
+ ///
+ [DataField("defaultScale")]
+ public Vector2 DefaultScale = Vector2.One;
+
+ ///
+ /// The size difference of the entity while it's an infant.
+ ///
+ [DataField("visualScale")]
+ public Vector2 VisualScale = new(.5f, .5f);
+
+ ///
+ /// When the entity will stop being an infant.
+ ///
+ [DataField("infantEndTime", customTypeSerializer: typeof(TimeOffsetSerializer))]
+ public TimeSpan InfantEndTime;
+
+ ///
+ /// The entity's name before the "baby" prefix is added.
+ ///
+ [DataField("originalName")]
+ public string OriginalName = string.Empty;
+}
diff --git a/Content.Shared/Nutrition/AnimalHusbandry/ReproductiveComponent.cs b/Content.Shared/Nutrition/AnimalHusbandry/ReproductiveComponent.cs
new file mode 100644
index 00000000000..4cb1499d4f0
--- /dev/null
+++ b/Content.Shared/Nutrition/AnimalHusbandry/ReproductiveComponent.cs
@@ -0,0 +1,102 @@
+using Content.Shared.Nutrition.Components;
+using Content.Shared.Storage;
+using Content.Shared.Whitelist;
+using Robust.Shared.Serialization.TypeSerializers.Implementations.Custom;
+
+namespace Content.Shared.Nutrition.AnimalHusbandry;
+
+///
+/// This is used for simple animal husbandry. Entities with this component,
+/// given they are next to a particular entity that fulfills a whitelist,
+/// can create several "child" entities.
+///
+[RegisterComponent]
+public sealed class ReproductiveComponent : Component
+{
+ ///
+ /// The next time when breeding will be attempted.
+ ///
+ [DataField("nextBreedAttempt", customTypeSerializer: typeof(TimeOffsetSerializer)), ViewVariables(VVAccess.ReadWrite)]
+ public TimeSpan NextBreedAttempt;
+
+ ///
+ /// Minimum length between each attempt to breed.
+ ///
+ [DataField("minBreedAttemptInterval"), ViewVariables(VVAccess.ReadWrite)]
+ public TimeSpan MinBreedAttemptInterval = TimeSpan.FromSeconds(45);
+
+ ///
+ /// Maximum length between each attempt to breed.
+ ///
+ [DataField("maxBreedAttemptInterval"), ViewVariables(VVAccess.ReadWrite)]
+ public TimeSpan MaxBreedAttemptInterval = TimeSpan.FromSeconds(60);
+
+ ///
+ /// How close to a partner an entity must be in order to breed.
+ /// Unrealistically long.
+ ///
+ [DataField("breedRange"), ViewVariables(VVAccess.ReadWrite)]
+ public float BreedRange = 3f;
+
+ ///
+ /// The chance that, on a given attempt,
+ /// for each valid partner, the entity will breed.
+ ///
+ [DataField("breedChance"), ViewVariables(VVAccess.ReadWrite)]
+ public float BreedChance = 0.15f;
+
+ ///
+ /// Entity prototypes for what type of
+ /// offspring can be produced by this entity.
+ ///
+ [DataField("offspring", required: true)]
+ public List Offspring = default!;
+
+ ///
+ /// Whether or not this entity has bred successfully
+ /// and will produce offspring imminently
+ ///
+ [DataField("gestating")]
+ public bool Gestating;
+
+ ///
+ /// When gestation will end.
+ /// Null if is false
+ ///
+ [DataField("gestationEndTime"), ViewVariables(VVAccess.ReadWrite)]
+ public TimeSpan? GestationEndTime;
+
+ ///
+ /// How long it takes the entity after breeding
+ /// to produce offspring
+ ///
+ [DataField("gestationDuration"), ViewVariables(VVAccess.ReadWrite)]
+ public TimeSpan GestationDuration = TimeSpan.FromMinutes(1.5);
+
+ ///
+ /// How much hunger is consumed when an entity
+ /// gives birth. A balancing tool to require feeding.
+ ///
+ [DataField("hungerPerBirth"), ViewVariables(VVAccess.ReadWrite)]
+ public float HungerPerBirth = 75f;
+
+ ///
+ /// Popup shown when an entity gives birth.
+ /// Configurable for things like laying eggs.
+ ///
+ [DataField("birthPopup"), ViewVariables(VVAccess.ReadWrite)]
+ public string BirthPopup = "reproductive-birth-popup";
+
+ ///
+ /// Whether or not the offspring should be made into "infants".
+ ///
+ [DataField("makeOffspringInfant"), ViewVariables(VVAccess.ReadWrite)]
+ public bool MakeOffspringInfant = true;
+
+ ///
+ /// An entity whitelist for what entities
+ /// can be this one's partner.
+ ///
+ [DataField("partnerWhitelist", required: true)]
+ public EntityWhitelist PartnerWhitelist = default!;
+}
diff --git a/Content.Shared/Nutrition/AnimalHusbandry/ReproductivePartnerComponent.cs b/Content.Shared/Nutrition/AnimalHusbandry/ReproductivePartnerComponent.cs
new file mode 100644
index 00000000000..e18646b0657
--- /dev/null
+++ b/Content.Shared/Nutrition/AnimalHusbandry/ReproductivePartnerComponent.cs
@@ -0,0 +1,12 @@
+namespace Content.Shared.Nutrition.AnimalHusbandry;
+
+///
+/// This is used for denoting entities which are
+/// valid partners for .
+/// This functions outside of the whitelist.
+///
+[RegisterComponent]
+public sealed class ReproductivePartnerComponent : Component
+{
+
+}
diff --git a/Resources/Locale/en-US/nutrition/components/animal-husbandry.ftl b/Resources/Locale/en-US/nutrition/components/animal-husbandry.ftl
new file mode 100644
index 00000000000..6ca108b653a
--- /dev/null
+++ b/Resources/Locale/en-US/nutrition/components/animal-husbandry.ftl
@@ -0,0 +1,3 @@
+infant-name-prefix = baby {$name}
+reproductive-birth-popup = {CAPITALIZE(THE($parent))} gave birth!
+reproductive-laid-egg-popup = {CAPITALIZE(THE($parent))} lays an egg!
diff --git a/Resources/Prototypes/Entities/Mobs/NPCs/animals.yml b/Resources/Prototypes/Entities/Mobs/NPCs/animals.yml
index 2e5b69f7cd8..d7948b92ba1 100644
--- a/Resources/Prototypes/Entities/Mobs/NPCs/animals.yml
+++ b/Resources/Prototypes/Entities/Mobs/NPCs/animals.yml
@@ -169,6 +169,22 @@
- MobMask
layer:
- MobLayer
+ - type: Tag
+ tags:
+ - DoorBumpOpener
+ - Chicken
+ - type: Reproductive
+ breedChance: 0.05
+ birthPopup: reproductive-laid-egg-popup
+ makeOffspringInfant: false
+ partnerWhitelist:
+ tags:
+ - Chicken
+ offspring:
+ - id: FoodEggChickenFertilized
+ maxAmount: 3
+ - type: ReproductivePartner
+ - type: Appearance
- type: DamageStateVisuals
states:
Alive:
@@ -202,6 +218,21 @@
factions:
- Passive
+- type: entity
+ id: FoodEggChickenFertilized
+ parent: FoodEgg
+ suffix: Fertilized, Chicken
+ components:
+ - type: Timer
+ - type: TimedSpawner
+ prototypes:
+ - MobChicken
+ intervalSeconds: 20
+ minimumEntitiesSpawned: 1
+ maximumEntitiesSpawned: 1
+ - type: TimedDespawn #delete the egg after the chicken spawns
+ lifetime: 21
+
- type: entity
name: mallard duck #Quack
parent: SimpleMobBase
@@ -225,6 +256,22 @@
- MobMask
layer:
- MobLayer
+ - type: Tag
+ tags:
+ - DoorBumpOpener
+ - Duck
+ - type: Reproductive
+ breedChance: 0.05
+ birthPopup: reproductive-laid-egg-popup
+ makeOffspringInfant: false
+ partnerWhitelist:
+ tags:
+ - Duck
+ offspring:
+ - id: FoodEggDuckFertilized
+ maxAmount: 3
+ - type: ReproductivePartner
+ - type: Appearance
- type: DamageStateVisuals
states:
Alive:
@@ -294,6 +341,23 @@
Dead:
Base: dead-2
+- type: entity
+ id: FoodEggDuckFertilized
+ parent: FoodEgg
+ suffix: Fertilized, Duck
+ components:
+ - type: Timer
+ - type: TimedSpawner
+ prototypes:
+ - MobDuckMallard
+ - MobDuckWhite
+ - MobDuckBrown
+ intervalSeconds: 20
+ minimumEntitiesSpawned: 1
+ maximumEntitiesSpawned: 1
+ - type: TimedDespawn #delete the egg after the chicken spawns
+ lifetime: 21
+
- type: entity
name: butterfly
parent: SimpleMobBase
@@ -359,6 +423,17 @@
- map: ["enum.DamageStateVisualLayers.Base"]
state: cow
sprite: Mobs/Animals/cow.rsi
+ - type: Tag
+ tags:
+ - DoorBumpOpener
+ - Cow
+ - type: Reproductive
+ partnerWhitelist:
+ tags:
+ - Cow
+ offspring:
+ - id: MobCow
+ - type: ReproductivePartner
- type: Physics
- type: Fixtures
fixtures:
@@ -484,6 +559,18 @@
- MobMask
layer:
- MobLayer
+ - type: Tag
+ tags:
+ - DoorBumpOpener
+ - Goat
+ - type: Reproductive
+ partnerWhitelist:
+ tags:
+ - Goat
+ offspring:
+ - id: MobGoat
+ - type: ReproductivePartner
+ - type: Appearance
- type: DamageStateVisuals
states:
Alive:
@@ -2181,6 +2268,17 @@
- type: Inventory
speciesId: pig
templateId: pet
+ - type: Tag
+ tags:
+ - DoorBumpOpener
+ - Pig
+ - type: Reproductive
+ partnerWhitelist:
+ tags:
+ - Pig
+ offspring:
+ - id: MobPig
+ - type: ReproductivePartner
- type: InventorySlots
- type: Strippable
- type: UserInterface
diff --git a/Resources/Prototypes/Entities/Mobs/NPCs/pets.yml b/Resources/Prototypes/Entities/Mobs/NPCs/pets.yml
index 65af3799ec3..b43caa05bc9 100644
--- a/Resources/Prototypes/Entities/Mobs/NPCs/pets.yml
+++ b/Resources/Prototypes/Entities/Mobs/NPCs/pets.yml
@@ -411,6 +411,8 @@
- type: Tag
tags:
- CannotSuicide
+ - DoorBumpOpener
+ - Pig
- type: entity
name: Renault
diff --git a/Resources/Prototypes/tags.yml b/Resources/Prototypes/tags.yml
index 842931a7ed8..497e054f47d 100644
--- a/Resources/Prototypes/tags.yml
+++ b/Resources/Prototypes/tags.yml
@@ -149,6 +149,9 @@
- type: Tag
id: Catwalk
+- type: Tag
+ id: Chicken
+
- type: Tag
id: Cigarette
@@ -176,6 +179,9 @@
- type: Tag #Ohioans die happy
id: Corn
+- type: Tag
+ id: Cow
+
- type: Tag
id: Crayon
@@ -263,6 +269,9 @@
- type: Tag
id: DroneUsable
+- type: Tag
+ id: Duck
+
- type: Tag
id: Ectoplasm
@@ -344,6 +353,9 @@
- type: Tag
id: GlassShard
+- type: Tag
+ id: Goat
+
- type: Tag
id: Grenade
@@ -607,6 +619,9 @@
- type: Tag
id: Pie
+- type: Tag
+ id: Pig
+
- type: Tag
id: PillCanister
From 366be9687f3013ef40d939daca2936f2121ffab3 Mon Sep 17 00:00:00 2001
From: Abbey Armbruster
Date: Tue, 18 Jul 2023 21:19:31 -0400
Subject: [PATCH 2/7] Fire place ambience (#18134)
* add fireplace ambience (#1692)
* changes for upstream
---------
Co-authored-by: Rane <60792108+Elijahrane@users.noreply.github.com>
(cherry picked from commit 6442db5a1eb997a66fb49d6e461ac471b9bd53ef)
---
.../Audio/Ambience/Objects/attributions.yml | 7 ++++++-
Resources/Audio/Ambience/Objects/fireplace.ogg | Bin 0 -> 428549 bytes
.../Structures/Decoration/fireplace.yml | 5 +++++
3 files changed, 11 insertions(+), 1 deletion(-)
create mode 100644 Resources/Audio/Ambience/Objects/fireplace.ogg
diff --git a/Resources/Audio/Ambience/Objects/attributions.yml b/Resources/Audio/Ambience/Objects/attributions.yml
index e1dec23786e..e5cd81a3725 100644
--- a/Resources/Audio/Ambience/Objects/attributions.yml
+++ b/Resources/Audio/Ambience/Objects/attributions.yml
@@ -56,4 +56,9 @@
- files: ["reclaimer_ambience.ogg"]
license: "CC0-1.0"
copyright: "Taken from source"
- source: "https://freesound.org/people/cmorris035/sounds/319152/"
\ No newline at end of file
+ source: "https://freesound.org/people/cmorris035/sounds/319152/"
+
+- files: ["fireplace.ogg"]
+ license: "CC-BY-4.0"
+ copyright: "Taken and edited from source"
+ source: "https://freesound.org/people/juskiddink/sounds/215658/"
diff --git a/Resources/Audio/Ambience/Objects/fireplace.ogg b/Resources/Audio/Ambience/Objects/fireplace.ogg
new file mode 100644
index 0000000000000000000000000000000000000000..c78a3f4dbbe136725dab5830399f8253c65100c5
GIT binary patch
literal 428549
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