为什么已经有mod可以隐藏武器了，还做一个隐藏武器的mod呢？主要个人想要根据人物动作来显示/隐藏武器，能有更多自定义化配置。其实早在4月更新前就整完了，思来想去还是分享给大家。如果你不喜欢，你就忽略它。
1.可以根据当前人物收刀/拔刀状态 设置武器的显示/隐藏
2.可以根据当前人物动作 设置武器的显示/隐藏
3.可以根据当前猎虫动作 设置武器的显示/隐藏
4.支持设置 投射器/钩爪/猎虫的显示/隐藏
5.可以根据当前武器外观 设置武器的显示/隐藏
6.可以通过设置mesh网格名使当前人物身上对应的mesh网格部件 显示/隐藏
以下理解，均是我个人的理解，不一定准确，有问题的话，请大家私信或者评论指出
1.什么是武器主部件？什么是武器副部件？
例如太刀，主部件就是刀，副部件就是刀鞘。盾斧主部件就是剑，副部件就是盾。而大剑就只有主部件的剑，无副部件。其余武器你大概就能猜到了。(猎虫既不是主部件也不是副部件，但在mod配置中简化配置将其视为副部件)(龙热弹匣既不是主部件，也不是副部件，但在mod配置中简化配置将其视为副部件)。
2.为什么投射器以及钩爪要拆开设置？
因为隐藏投射器的时候，投射器的弹药会随着投射器隐藏而隐藏，但是钩爪不会随投射器隐藏而隐藏。而且我想在特定情况下显示钩爪而不显示投射器(钩爪抓东西时)。所以拆分为两个配置。
3.什么是主/子动作？什么是动作类别/序号？
主动作是人物当前进行的基本动作，比如跑动走动等。子动作是在主动作上进行的一个动作，例如喝绿茶这个动作，可以在跑动和走动等同时进行，所以它是一个子动作。
类别/序号是什么我也不知道。但是一个类别和一个序号可以对应一个动作。例如主动作类别0和主动作序号179对应站立收刀状态下，人物进行磨刀动作。子动作类型0，子动作序号85对应用户骑乘状态下，人物进行磨刀动作。
注意！注意！注意！每次卡婊更新，最好重新观察对比一下，看动作类型/序号对应的动作是否变化。很可能更新一次后，主动作类别0和主动作序号180变成磨刀动作了。
4.那么我怎么知道类别多少多少序号多少多少，对应那个动作呢？
在额外信息里有显示当前人物动作的类别序号值，人物动作变化时注意观察当前动作的类别序号值。那么你就知道当前动作对应的类别序号值。
1.武器/投射器 使用 show/hide/null 设置，分别对应 显示/隐藏/不做处理。
2.猎虫/钩爪 使用 defaultauto/show/hide/null 设置，分别对应 跟随投射器/显示/隐藏/不做处理。
猎虫的默认是指跟随武器副部件设置，即武器副部件隐藏，那么猎虫就隐藏，副部件显示，那么猎虫就显示。钩爪同理，只不过它跟随的是投射器的显示/隐藏
什么是强制显示/隐藏？设置为这个的时候，忽略跟随的配置，强制显示/隐藏猎虫/钩爪。
为什么这样搞，好麻烦。大概是为了放出猎虫攻击时显示猎虫，收回猎虫时隐藏猎虫。使用钩爪抓东西时显示钩爪，不抓时隐藏钩爪。
3.动作对应的配置需要有激活方式。激活方式通过 defaultauto/startenter/finish
exit/not 配置，分别对应 持续/动作开始/动作结束/非配置动作。
常用的应该是持续。例如我想在收刀状态下磨刀时显示武器主部件，那么我就配置一个磨刀动作，设置为defaultauto，将对应武器主部件设置为显示。那么当人物磨刀时，就会应用该配置，显示武器主部件。动作完成后武器就回到磨刀动作之前的状态，继续该隐藏隐藏，该显示显示。
动作开始就是动作开始时会根据这个动作的武器显示/隐藏配置来设置一次武器的显示/隐藏。动作结束同理，只不过在动作结束时设置一次。
非配置动作就是当人物或猎虫动作不是配置的动作时设置武器的显示/隐藏。
3.mesh网格配置 使用 show/hide/null 设置，分别对应 显示/隐藏/不做处理。
未对重复的mesh网格名做检测，所以尽量不要让同名的mesh网格配置同时生效。未对mesh网格是否是属于武器mesh网格做限制，所以可以设置装备的mesh网格，进而隐藏么？未做测试。
mesh网格的显示与隐藏与正常的武器显示与隐藏是属于父子关系。即如果设置了武器隐藏，那么不管设置该武器的mesh网格是否显示或隐藏，你都看不见这个武器，即武器隐藏。如果设置了武器显示，那么设置该武器的mesh网格显示，武器就显示，mesh网格隐藏，武器就隐藏。所以当你要使用武器的mesh网格配置时，最好将武器配置为显示。
1.启用了太刀配置，且你当前装备了太刀，那么你武器的显示/隐藏将应用于太刀中的武器显示/隐藏配置。否则就应用通用配置中的武器显示/隐藏配置。
2.太刀里面还有通用配置呀？这个通用配置是相对于外观配置的，如果你当前装备的太刀外观是配置的外观，那么优先应用外观里配置的武器显示/隐藏配置。否则就应用太刀里的通用配置里的武器显示/隐藏配置。
3.如果我设置两个相同的A/B动作配置，即A/B两个动作配置的动作类别和动作序号都完全相同，即A/B是同一个动作，但A动作配置显示武器，B动作配置隐藏武器。那么人物在这个动作时是显示还是隐藏呢？这种情况是那个先最新配置就应用那个配置，即那个动作配置在配置中靠前后就使用那个。
4.注意：对于动作，在通用配置中配置了磨刀显示武器，那么即使你在太刀配置中未配置磨刀显示武器，还是会应用通用配置中的磨刀显示武器。除非在太刀配置中配置了磨刀隐藏武器，才会应用太刀的磨刀隐藏武器。即相同的动作只会应用一次，动作查找应用优先级为 武器外观中的动作配置>武器通用配置中的动作配置>通用配置中的动作配置
5.为什么猎虫返回和出个人帐篷猎虫攻击返回和进出帐篷是单独的配置，不应该是一种特殊的动作吗？像放出猎虫攻击和进入个人帐篷就是动作配置呀。因为猎虫返回不一定猎人会有收猎虫的动作，出个人帐篷有种情况是帐篷被破坏出帐篷，这种情况就无出帐篷动作能触发的动作太多或有不好检测的特殊情况触发，所以单独形成一个配置，方便使用。
6.如果启用了太刀配置，且你当前装备了太刀，那么你mesh网格的显示/隐藏将应用太刀中的mesh网格显示/隐藏配置。否则就应用通用配置中的mesh网格显示/隐藏配置。对于特殊动作中的mesh网格配置会根据动作依次应用。
7.如果启用了通过mesh网格来触发武器显示隐藏，那么不会再查找对应的武器配置。
1.对于所有武器，默认拔刀显示主武器主/副部件隐藏投射器、收刀隐藏主武器主/副部件隐藏投射器、收刀/骑乘状态下磨刀显示主武器主部件、骑乘切换武器显示主武器主/副部件、射出钩爪强制显示钩爪、装备切换页面显示所有(包含投射器)、进个人帐篷显示主武器主/副部件、出个人帐篷隐藏主武器主/副部件。
2.对于弓箭(隐藏箭袋)，拔刀显示主武器主部件隐藏主武器副部件隐藏投射器、收刀隐藏主武器主/副部件隐藏投射器。
3.对于虫棍，拔刀显示主武器主部件隐藏投射器、收刀隐藏主武器、放出猎虫攻击显示猎虫，收回猎虫隐藏猎虫。
4.对于太刀(隐藏刀鞘)，拔刀显示主武器主部件隐藏主武器副部件隐藏投射器、收刀隐藏主武器主/副部件隐藏投射器、特殊纳刀显示主武器主/副部件(动作)、骑乘武器处决纳刀 显示主武器主/副部件(动作)。还配置了使用泡狐太刀外观时全程显示武器。
5.对于轻重弩，默认装备龙热弹匣时隐藏龙热弹匣。
6.可以多看看我的默认配置。
1.可以配合Layer Any Weapon武器幻化mod，设置特定的外观，特定显示/隐藏武器。
2.如果使用了Female Body Sliders身体滑块mod，需在其中的Extra配置中的weapon配置中勾选使用其他mod来控制武器的显示与隐藏。(已知问题: 刚进游戏时投射器会显示，这是因为身体滑块mod也会控制投射器显示，移动一下人物就行。身体滑块mod在extra的Slinger中配置投射器显示隐藏)
3.更多其他mod未测试。
1.为什么在开始界面、选人界面、公会卡片界面、捏脸界面不生效？因为没做，这几个界面不好获取人物对象。通过研究了Female Body Sliders身体滑块mod，选人界面、公会卡片界面、捏脸界面都需要特殊处理，可以实现，而开始界面武器可以实现隐藏，但是投射器需要隐藏就好像要控制on_frame或者UpdateBehavior，感觉性能影响较大，本来帧数就低。不太完美，所以就都没处理。希望其他大佬能搞搞或者告诉我怎么搞。
2.为什么选武器外观时，武器名乱码？我也想知道为什么乱码，获取武器名这一块我参考的_Catlib和Layer Any Weapon。但是它们获取的武器名就没乱码。希望有大佬告知。
3.机械武器可以分开么？好像机械武器外观共享同一个模型id(例如机械军刀、次元刀都是同一个模型id)，我不知道获取当前装备武器的模型id时区分当前模型属于哪一个的机械武器。希望有大佬告知。
4.为什么设置了显示投射器而投射器未显示？请注意是否正在使用外观mod，有些外观mod本身就无投射器或钩爪。
默认大家都会安装
除了删除HideWeapon.lua文件(盒子取消勾选)之外，记得把reframework\data下的HideWeapon.json配置文件删除。
字体配置大家忽略就好可以使用但没必要，现在最新的ref框架已经支持中文了。启用后，ref可能会弹出popfont多次的错误窗口。
重置按钮慎用，它会将所有配置重置为默认配置，容易丢失你新增的配置。
使用mod，你应该自行承担mod造成的后果。什么被封了，存档崩了，游戏炸了，电脑起火了，人挂了等。莫找我。
无限制。有大佬有闲情逸致的话，可以帮我发N网，我英文废。
2025-04-21 今天发现有大佬打赏金蘑菇给我，我很感谢。但是后续的大佬不要打赏我金蘑菇了。如果你喜欢这个mod，送我影响力或者点赞就行了。最近这几年大环境不太行，还不知道到什么时候好起来，大家多多攒钱。你特别喜欢这个游戏的话，也可多留着钱买其他大佬的mod。话说，有无大佬告诉我，这个金蘑菇怎么退还。
2025-04-25 修复隐藏武器对应部件时，长枪蓄防，属性变换触发时导致的杂音问题。这是因为触发了特殊特效，而特效作用的武器部件被隐藏了，导致的杂音。可能还有其他特效会导致该问题。由于是使用特效ID来判断并隐藏特效的方式修复问题，所以可能卡婊更新后改变特效ID，使这个修复无效。
2025-05-05 修复属性变换的杂音问题。乱码修复。添加可根据mesh网格名隐藏人物身上的部件。优化虫棍的猎虫配置(虫棍太多动作可以放出猎虫，将其简化为攻击返回配置)。由于这次更新代码变化太大，在更新前记得记一下自己新增或修改的配置，然后删掉reframework/data/HideWeapon.json配置文件，再进游戏(自动重新生成配置文件)后改回你自己的配置。
2025-05-06 修复 不打开一次ref界面不生成配置文件 问题。修复 不正确的数组初始化方式导致保存为配置json时将数组保存为table 问题。
2025-05-18 重构代码 优化代码逻辑，减少游戏api的调用，只在有必要时设置武器的显/隐，大概能减少mod性能损耗吧。在额外配置中新增了装备页面中选中武器时显示武器的mesh信息，用来配合mesh隐藏功能。修改了配置结构，在更新前记得记一下自己新增或修改的配置，然后删掉reframework/data/HideWeapon.json配置文件，再进游戏(自动重新生成配置文件)后改回你自己的配置。
2025-05-19 调整默认配置
2025-05-21 修复小问题 个人帐篷装备页面更新装备后，人物坐回去时导致武器武器被隐藏。选中外观护甲时，额外信息中的护甲信息更新不完整。
2025-05-28 更新修复 如果你没有修改过默认配置，可直接使用重置按钮后，显示隐藏一次ref界面，来将配置恢复到适合更新的默认配置。如果你修改过配置，那么就把 “装备页面-显示(主/副)武器(主/副)部件”这个动作配置项的 536 改为 538，更新后动作序号改变了。其余属性变换杂音问题，选中武器时武器信息不显示问题已修复。预估后面武器幻化实装了就需要大改了。
2025-07-06 更新适配6月30日的TU2更新 修改了配置结构，在更新前记得记一下自己新增或修改的配置，然后删掉reframework/data/HideWeapon.json配置文件，再进游戏(自动重新生成配置文件)后改回你自己的配置 可通过设置对应的武器外观激活武器的显示与隐藏。应该不在支持Layer Any Weapon设置的武器幻化了(未测试)。
2025-07-14 新增可设置mesh网格来触发武器的显示与隐藏 修改了配置结构，在更新前记得记一下自己新增或修改的配置，然后删掉reframework/data/HideWeapon.json配置文件，再进游戏(自动重新生成配置文件)后改回你自己的配置。
2025-08-14 适配游戏更新，增加检测配置文件版本，应该支持Layer Any Weapon设置的武器幻化了(未测试)。
2025-10-05 适配游戏更新。已被欧米茄打成狗了，新装备技能特性未测试。
2025-12-07 重构代码，应该能修复使用机械硬盘玩游戏时，加载游戏太慢，导致先加载mod了，后加载游戏资源，使mod失效(未验证，但确实有尊有这个问题，自己的机械硬盘未复现)，新增猎虫动作控制武器显隐，新增展示游戏中所有武器护甲mesh信息(该mesh信息不一定准确，是我自己猜卡婊的命名规则生成的，列如欧米茄男女手臂投射器mesh是相同的，而非不同，当前装备信息中较为准确)。新的配置也解决了，放出显示猎虫时，收刀，导致猎虫在放出状态被隐藏这个小问题。完全修改了配置结构，在更新前一定要记一下自己新增或修改的配置，然后删掉配置文件reframework/data/HideWeapon.json，让mod重新生成新的配置文件。
2025-12-23 应该适配游戏更新了，经测试现在的ref版本有些小BUG，子类不能直接访问父类的属性，但能调用父类的方法，等作者大佬修吧。故该mod可能有些小BUG，我能看到的子类访问父类的属性问题都修了。代码行数较多，大家有问题直接告诉我就行。另外在武器外观中会发现一个名字很奇怪的武器，推测是卡婊本来打算做一把具有 宇宙机装 外观的素材武器的，但后面改成付费的，就删掉了，但没删完全，我这给他读出来了。。。当然也有可能卡婊还计划有新的素材武器？大家有需求的话，我把它排除一下，不然我懒得改，没准什么时候更新，卡婊就给他清理掉了或者整把新素材武器出来。
2025-12-25 应尊的要求，新增隐藏轻重弩的龙热弹匣配置。现在默认装备龙热弹匣时隐藏龙热弹匣。
2026-01-08 修复部分情况下，钩爪未正常显示隐藏的问题。
2026-01-12 修复在游戏中重新加载mod后，使用轻重弩时，mod报错问题。话说，为什么我不能回复评论了，一回复就提示回复出错，只能私信了。踩蘑菇炸了？
2026-01-28 游戏更新，mod未失效。新增姿势动作设置武器的显示隐藏，现在默认展示武器的姿势动作时显示武器。修改了配置结构，在更新前一定要记一下自己新增或修改的配置，然后删掉配置文件reframework/data/HideWeapon.json，让mod重新生成新的配置文件，或者按照提示 重置 一下。
2026-02-19 游戏更新，mod未失效。新增可在设置隐藏的网格配置(最底层)中设置材质序号来隐藏对应材质。如何知道网格有哪些材质序号呢？在额外信息中新增了当前玩家的网格树信息，其中包含各个网格对象对应的网格以及材质序号信息。另新增mod工作模式选择，一个是对象模式，一个是网格模式。对象模式是隐藏网格的游戏对象(默认模式)(隐藏游戏对象会让作用于该对象的特效也被隐藏，如作用于武器的属性吸收特效)，另一个网格模式是设置网格的游戏对象的网格的开关来隐藏或显示武器(这种情况就不会影响作用于网格的游戏对象的特效，卡婊在玩家坐凳子听歌时自动隐藏武器可能就是使用的这种方式，由于卡婊在很多情况会自动使用该方式隐藏玩家武器，我暂时未发现合适的HOOK注入点，所以在这个模式的时候，武器猎虫隐藏使用的是隐藏武器猎虫的所有材质来实现的)。注：隐藏网格对象，设置网格对象的网格的开关，隐藏材质互不冲突。他们是包含关系 网格对象 包含 其网格，网格包含其多个材质。其中只要有一个隐藏，那么你就看不见了。龙热弹匣不再视为武器副部件了。修改了配置结构，在更新前一定要记一下自己新增或修改的配置，然后删掉配置文件reframework/data/HideWeapon.json，让mod重新生成新的配置文件，或者按照提示 重置 一下。
2026-03-02 修复使用衣装后，获取衣装对象错误导致武器不再显示隐藏的问题，不再获取并展示衣装对象信息了。
话说真有其他人用这么麻烦的mod么。而且每次更新还要检查一下。
不准打赏金蘑菇！！！不准打赏金蘑菇！！！不准打赏金蘑菇！！！
链接: https://pan.baidu.com/s/1x3DUOg6k3UMKYKn4oSPlNg?pwd=bz7f 提取码：bz7f
上面的链接就可以下载，无影响力就用上面。
不准打赏金蘑菇！！！不准打赏金蘑菇！！！不准打赏金蘑菇！！！
如果你影响力有多余可以购买附件，和上面没区别。
by saber · 来自踩蘑菇PC端
更新于 2026-03-02
闽公网安备35010302000678号
