Document tags.yml: A and B (#40673)

* fix alphabetization

* the letter A

* the letter B

---------

Co-authored-by: iaada <iaada@users.noreply.github.com>

diff --git a/Resources/Prototypes/tags.yml b/Resources/Prototypes/tags.yml
index 6b705abf4852bd8728ee31349404098b70006443..92c71a9eaf361dfcd2d880739c0e17ebb3408434 100644 (file)
--- a/Resources/Prototypes/tags.yml
+++ b/Resources/Prototypes/tags.yml
@@ -1,208 +1,215 @@
 # PUT YOUR TAGS IN ALPHABETICAL ORDER
+# ALSO DOCUMENT WHAT THE HELL THEY DO
+
+## A ##
 
 - type: Tag
-  id: AccessBreakerImmune
+  id: AccessBreakerImmune # This tag marks an entity as immune to emagging.
 
 - type: Tag
-  id: AirAlarm
+  id: AirAlarm # Used by AtmosAlarmableComponent for syncing devices
 
 - type: Tag
-  id: AirAlarmElectronics
+  id: AirAlarmElectronics # ConstructionGraph: AirAlarm
 
 - type: Tag
-  id: Airlock
+  id: Airlock # Used in ConstructionGraph "Airlock" to navigate between regular, glass, and highsec airlocks
 
 - type: Tag
-  id: AirSensor
+  id: AirSensor # Used by AtmosAlarmableComponent for syncing devices
 
 - type: Tag
   id: AllowBiomeLoading # Entities with this tag will load terrain, even if a ghost.
 
 - type: Tag
-  id: AllowGhostShownByEvent
+  id: AllowGhostShownByEvent # Used by GhostSystem to show ghosts (usually at round end)
 
 - type: Tag
-  id: Ambrosia
+  id: Ambrosia # ConstructionGraph: flowerwreath
 
 - type: Tag
-  id: AnomalyHost
+  id: AnomalyHost # Targeting whitelist: BaseAnomalyInjector
 
 - type: Tag
-  id: AppraisalTool
+  id: AppraisalTool # Storage whitelist: ClothingBeltUtility
 
 - type: Tag
-  id: Apron
+  id: Apron # ConstructionGraph: scraparmor
 
 - type: Tag
-  id: Arrow
+  id: Arrow # Storage whitelist: ClothingBeltQuiver
 
 - type: Tag
-  id: ArtifactFragment
+  id: ArtifactFragment # Storage whitelist: OreBag, CargoBounty: BountyArtifactFragment, ConstructionGraph: Artifact
 
 - type: Tag
-  id: ATVKeys
+  id: ATVKeys # Unused
 
-- type: Tag
-  id: Backpack
+## B ##
 
 - type: Tag
-  id: Balloon
+  id: Backpack # ConstructionGraph: ClothingBagPet
 
 - type: Tag
-  id: Banana
+  id: Balloon # Used by BalloonPopperComponent/System to viciously maim helpless balloons
 
 - type: Tag
-  id: BananaPeel
+  id: Banana # CargoBounty: BountyBanana
 
 - type: Tag
-  id: Bandana
+  id: BananaPeel # SpecialDigestible by OrganAnimalRuminantStomach, and several BananaClown ConstructionGraphs
 
 - type: Tag
-  id: BaseballBat
+  id: Bandana # CargoBounty: BountyBandana
 
 - type: Tag
-  id: BBQsauce
+  id: BaseballBat # CargoBounty: BountyBaseballBat
 
 - type: Tag
-  id: Bedsheet
+  id: BBQsauce # Storage whitelist: ClothingBeltChef and FoodCartHot, ItemMapper: ClothingBeltChef and FoodCartHot
 
 - type: Tag
-  id: Bee
+  id: Bedsheet # CargoBounty: BountyBedsheet
 
 - type: Tag
-  id: Beer
+  id: Bee # Mode switch whitelisting for BuzzochloricBees (only damages non-bees)
 
 - type: Tag
-  id: BikeHorn
+  id: Beer # CargoBounty: BountyBeer
 
 - type: Tag
-  id: Bloodpack
+  id: BikeHorn # ConstructionGraph: HonkBot, BananiumHorn
 
 - type: Tag
-  id: BlueprintAutolathe
+  id: Bloodpack # Storage whitelist: ClothingBeltMedical
 
 - type: Tag
-  id: BodyBag
+  id: BlueprintAutolathe # Whitelist on BlueprintReceiverComponent on the autolate for linking this entity's BlueprintComponent
 
 - type: Tag
-  id: Boll
+  id: BodyBag # Storage whitelist: BoxBodyBag # TODO cardboard boxes shouldn't have whitelisting
 
 - type: Tag
-  id: Book
+  id: Boll # MaterialStorage whitelist: Sheetifier
 
 - type: Tag
-  id: BorgArm
+  id: Book # Storage whitelist: BorgModuleService, BooksBag, Bookshelf. Blacklisting on various entities whitelisting PaperComponent
 
 - type: Tag
-  id: BorgHead
+  id: BorgArm # ConstructionGraphs for various bots
 
 - type: Tag
-  id: BorgLArm
+  id: BorgHead # Used by PartAssemblyComponent on CyborgEndoskeleton. Also in ConstructionGraphs for various bots
 
 - type: Tag
-  id: BorgLLeg
+  id: BorgLArm # Used by PartAssemblyComponent on CyborgEndoskeleton
 
 - type: Tag
-  id: BorgRArm
+  id: BorgLLeg # Used by PartAssemblyComponent on CyborgEndoskeleton
 
 - type: Tag
-  id: BorgRLeg
+  id: BorgRArm # Used by PartAssemblyComponent on CyborgEndoskeleton
 
 - type: Tag
-  id: BorgTorso
+  id: BorgRLeg # Used by PartAssemblyComponent on CyborgEndoskeleton
 
 - type: Tag
-  id: BorgLeg
+  id: BorgTorso # Used by PartAssemblyComponent on CyborgEndoskeleton
 
 - type: Tag
-  id: BorgModuleCargo
+  id: BorgLeg # Used by PartAssemblyComponent on VimHarness
 
 - type: Tag
-  id: BorgModuleEngineering
+  id: BorgModuleCargo # Cyborg module category for salvage and cargo
 
 - type: Tag
-  id: BorgModuleGeneric
+  id: BorgModuleEngineering # Cyborg module category for engineers and saboteurs
 
 - type: Tag
-  id: BorgModuleJanitor
+  id: BorgModuleGeneric # Cyborg module category for general purpose
 
 - type: Tag
-  id: BorgModuleMedical
+  id: BorgModuleJanitor # Cyborg module category for janitors
 
 - type: Tag
-  id: BorgModuleScience
+  id: BorgModuleMedical # Cyborg module category for doctors
 
 - type: Tag
-  id: BorgModuleService
+  id: BorgModuleScience # Cyborg module category for scientists
 
 - type: Tag
-  id: BorgModuleSyndicate
+  id: BorgModuleService # Cyborg module category for bartenders, botanists, and more
 
 - type: Tag
-  id: BorgModuleSyndicateAssault
+  id: BorgModuleSyndicate # Cyborg module category for evil red robots
 
 - type: Tag
-  id: Bot
+  id: BorgModuleSyndicateAssault # Cyborg module category for extra evil red robots (nukies)
 
 - type: Tag
-  id: BotanyHatchet
+  id: Bot # Unused
 
 - type: Tag
-  id: BotanyHoe
+  id: BotanyHatchet # Storage whitelist: ClothingBeltPlant, ItemMapper: ClothingBeltPlant
 
 - type: Tag
-  id: BotanyShovel
+  id: BotanyHoe # Storage whitelist: ClothingBeltPlant, ItemMapper: ClothingBeltPlant
 
 - type: Tag
-  id: Bottle
+  id: BotanyShovel # Storage whitelist: ClothingBeltPlant, ItemMapper: ClothingBeltPlant
+
+- type: Tag # Used for specifically chemistry bottles
+  id: Bottle # Storage whitelist: ChemMaster, ChemBag, SmartFridge, ClothingBeltJanitor, ClothingBeltMedical, ClothingBeltPlant
 
 - type: Tag
-  id: BoxCardboard
+  id: BoxCardboard # CargoBounty: BountyCardboardBox
 
 - type: Tag
-  id: BoxHug
+  id: BoxHug # Unused
 
 - type: Tag
-  id: Brain
+  id: Brain # Storage whitelist: MMI. CargoBounty: BountyBrain. FoodSequenceElement: Brain
 
 - type: Tag
-  id: BrassInstrument
+  id: BrassInstrument # MachineBoard construction: DawInstrumentMachineCircuitboard
 
 - type: Tag
-  id: Bread
+  id: Bread # CargoBounty: BountyBread. Blacklisted in BountyFruit and BountyVegetable
 
 - type: Tag
-  id: Briefcase
+  id: Briefcase # Unused
 
 - type: Tag
-  id: BrimFlatcapBrown
+  id: BrimFlatcapBrown # ConstructionGraph: BladedFlatcapBrown
 
 - type: Tag
-  id: BrimFlatcapGrey
+  id: BrimFlatcapGrey # ConstructionGraph: BladedFlatcapGrey
 
 - type: Tag
-  id: Brutepack
+  id: Brutepack # Storage whitelist: ClothingBeltMedical
 
 - type: Tag
-  id: Bucket
+  id: Bucket # Storage whitelist: JanitorialTrolley. ItemMapper: JanitorialTrolley. ConstructionGraph: CleanBot, scraphelmet
 
 - type: Tag
-  id: Burger
+  id: Burger # Unused x2 (this is the only place burger tag exists)
 
 - type: Tag
-  id: BulletFoam
+  id: BulletFoam # BallisticAmmoProviderComponent whitelist for WeaponRifleFoam, FoamCrossbow, MagazineFoamBox, BoxDonkSoftBox
 
 - type: Tag
-  id: Burnt
+  id: Burnt # Storage whitelist: ashtray. Seemingly redundant
 
 - type: Tag
-  id: Bun
+  id: Bun # FoodSequenceElement: BunTopBurger, CottonBunTopBurger
 
 - type: Tag
-  id: BypassDropChecks
+  id: BypassDropChecks # Entities with this tag don't care about drop distance or walls (Aghost)
 
 - type: Tag
-  id: BypassInteractionRangeChecks
+  id: BypassInteractionRangeChecks # Entities with this tag don't care about distance or walls when touching things (Aghost)
+
+## C ##
 
 - type: Tag
   id: CableCoil
@@ -440,6 +447,8 @@
 - type: Tag
   id: CubanCarp
 
+## D ##
+
 - type: Tag
   id: DeathAcidifier
 
@@ -509,6 +518,8 @@
 - type: Tag
   id: Duck
 
+## E ##
+
 - type: Tag
   id: Ectoplasm
 
@@ -557,6 +568,14 @@
 - type: Tag
   id: ExplosivePassable
 
+## F ##
+
+- type: Tag
+  id: FakeMindShieldImplant
+
+- type: Tag
+  id: FakeNukeDisk
+
 - type: Tag
   id: Figurine
 
@@ -614,6 +633,8 @@
 - type: Tag
   id: Fruit
 
+## G ##
+
 - type: Tag
   id: Galaxythistle
 
@@ -669,12 +690,6 @@
 - type: Tag
   id: GrenadeFlashBang
 
-- type: Tag
-  id: HudMedical
-
-- type: Tag
-  id: HudSecurity
-
 - type: Tag
   id: GuideEmbeded
 
@@ -687,6 +702,8 @@
 - type: Tag
   id: GunUpgradeReloadSpeed
 
+## H ##
+
 - type: Tag
   id: Hamster
 
@@ -792,6 +809,14 @@
 - type: Tag
   id: Hotsauce
 
+- type: Tag
+  id: HudMedical
+
+- type: Tag
+  id: HudSecurity
+
+## I ##
+
 - type: Tag
   id: Ice
 
@@ -822,9 +847,13 @@
 - type: Tag
   id: InvalidForSurvivorAntag
 
+## J ##
+
 - type: Tag
   id: JawsOfLife
 
+## K ##
+
 - type: Tag
   id: Kangaroo
 
@@ -846,6 +875,8 @@
 - type: Tag
   id: KnockdownImmune
 
+## L ##
+
 - type: Tag
   id: LavaBrig
 
@@ -858,6 +889,8 @@
 - type: Tag
   id: Lime
 
+## M ##
+
 - type: Tag
   id: Machete
 
@@ -955,9 +988,6 @@
 - type: Tag
   id: MimeHappyHonk
 
-- type: Tag
-  id: FakeMindShieldImplant
-
 - type: Tag
   id: MindTransferTarget
 
@@ -991,6 +1021,8 @@
 - type: Tag
   id: Mushroom
 
+## N ##
+
 - type: Tag
   id: NoBlockAnchoring
 
@@ -1003,12 +1035,11 @@
 - type: Tag
   id: Nugget # for chicken nuggets
 
-- type: Tag
-  id: FakeNukeDisk
-
 - type: Tag
   id: NukeOpsUplink
 
+## O ##
+
 - type: Tag
   id: Ointment
 
@@ -1030,6 +1061,8 @@
 - type: Tag
   id: OreUranium
 
+## P ##
+
 - type: Tag
   id: Packet
 
@@ -1159,9 +1192,13 @@
 - type: Tag
   id: ProximitySensor
 
+## Q ##
+
 - type: Tag
   id: QuantumSpinInverter
 
+## R ##
+
 - type: Tag
   id: Radio
 
@@ -1217,6 +1254,8 @@
 - type: Tag
   id: Ruminant
 
+## S ##
+
 - type: Tag
   id: SaltShaker
 
@@ -1391,6 +1430,8 @@
 - type: Tag
   id: Spellbook
 
+## T ##
+
 - type: Tag
   id: TabletopBoard
 
@@ -1448,6 +1489,8 @@
 - type: Tag
   id: TurretControlElectronics # Used in the construction of sentry turret control panels
 
+## U ##
+
 - type: Tag
   id: Unimplantable
 
@@ -1463,6 +1506,8 @@
 - type: Tag
   id: UtilityKnife
 
+## V ##
+
 - type: Tag
   id: Vegetable
 
@@ -1475,6 +1520,8 @@
 - type: Tag
   id: VoiceTrigger
 
+## W ##
+
 - type: Tag
   id: Wall
 
@@ -1550,6 +1597,8 @@
 - type: Tag
   id: WriteIgnoreStamps
 
+## X ##
+
 - type: Tag
   id: XenoborgModuleEngi
 
@@ -1564,4 +1613,7 @@
 
 - type: Tag
   id: XenoborgModuleStealth
+
+## Y ##
+## Z ##
 # ALPHABETICAL