From fc70da875eee44e0622da84f51b11929431c78f1 Mon Sep 17 00:00:00 2001
From: joshuarwood <joshua.randall.wood@gmail.com>
Date: Fri, 13 Mar 2026 18:01:10 -0500
Subject: [PATCH] add a comment describing PC specific shield handling

---
 src/game/chr.c | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/game/chr.c b/src/game/chr.c
index d3454a608..c9ba3ed50 100644
--- a/src/game/chr.c
+++ b/src/game/chr.c
@@ -4545,6 +4545,13 @@ void chrTestHit(struct prop *prop, struct shotdata *shotdata, bool isshooting, b
 			if (hitpart) {
 				if (chrGetShield(chr) > 0.0f) {
 #ifndef PLATFORM_N64
+					/**
+					 * var8005efc0 > 0.0f adds a padding to bbox hit detection
+					 * in modelTestBboxNodeForHit() that accounts for a character's
+					 * surrounding shield. We skip this step on PC when checking
+					 * line-of-sight hits to light artifacts because lights should
+					 * be visible through the transparent shield.
+					 */
 					if (g_BgHitXluDisabled == false)
 #endif
 						var8005efc0 = 10.0f / model->scale;