做射击游戏最尴尬的时刻，不是服务器崩了，是子弹打中墙却找不到弹孔。Unity开发者最近集体吐槽：官方文档里那个Raycast函数，参数多到像填写税表，新手点半天鼠标，连墙在哪都检测不到。

事件导火索是GitHub上一个开源项目。开发者用Physics.Raycast()做了套极简弹孔系统，代码不到20行，却在Reddit被顶了800多次。评论区最高赞一针见血：「Unity把射线检测藏了3年，原来点一下鼠标就能搞定。」

这套方案的核心逻辑意外朴素。从摄像机发射一条隐形射线，碰到带Collider的物体就Instantiate一个贴花预制体，再按法线方向旋转对齐表面。没有物理模拟，没有弹道下坠，FPS游戏最基础的反馈就这么落地了。

资深开发者倒不意外。他们早就发现Unity的物理API像瑞士军刀——功能全，但找刀片得翻半天。新手卡在LayerMask参数上崩溃是常态，官方示例偏偏跳过这步。那位开源作者索性把LayerMask.Default写死，评论区立刻有人提醒：这样打队友也会出弹孔。

项目发布两周后，作者补了句更新说明：「现在支持自定义层过滤，队友安全了。」底下一条回复被点了300多赞——「我的队友从来就不安全。」