Adds equip and unequip animations for some helmets and gas masks.
A small mod that adds equip and unequip animations for some helmets and gas masks. It also adds a hotkey so you can quickly take off or put on a gas mask without having to go into your inventory.
The mod is made more for personal use and is purely cosmetic in nature. I wanted the gas mask to at least feel like a real physical object, and not just a flat PNG on top of the screen.
I'm not an animator, so the animations are far from perfect, and in the future there is a plan to replace them with higher quality ones.
Also not all gas masks currently have a unique model and animation. I hope to solve this problem in the near future if I can find suitable assets.
The hotkey for putting on a gas mask is based on the TOGGLE HELMET HOTKEY by razfarg. I slightly modified this mod to make it more persistent. Now it will remember last headgear that you used even after game restart.
Hold "wipe gasmask" key to quickly equip or unequip current headgear (V by default)
List of features
- Animations when putting on/taking off a gas mask
- Separate unique animations for the respirator and helmets
- An improved version of TOGGLE HELMET HOTKEY for equipping a gas mask on the go (no need to go into your inventory!)
- The mod remembers which helmet you wore last time, even when moving to a new location or exiting the game.
- Additional Strict Headgear mode that prevents you from using food, drinks, pills or cigarettes while wearing gasmask. Disabled by default. You can enable this feature in the mod settings in MCM menu.
Installation
Requirements:
- Modded exes
- Mod Configuration Menu (MCM)
- FDDA
Use MO2 FOMOD to install. Just follow the install instructions.
Compatibility Issues
Won't work with default anomaly item animation enabled. You can disable them in options it won't affect any FDDA animations, only default ones. I know why this is happening. Will fix it as soon as possibleDAR
Preview
New Spartan helmet preview:
candy bar animation preview (turns out without it, strict helmets mode wouldn't be complete):
![candy time small]()
![chocolate preview]()
Helmets that don't have animations:
- bandana
- cloth mask
- balaclava
I made it so all other helmets if they don't have unique animation will fallback to default one or use similar model as a place holder, while I look for proper models:
- helm_ach7 - done
- helm_hardhat - done
- helm_hardhat_snag - done
- helm_metro - done
- helm_ach7ex - done
- helm_battle - done
- helm_exo - done
- helm_spartan - done
- helm_tactic - done
- helm_ppm88 - done
- helm_resp - done
- helm_m40 - done
- helm_m50 - done
- helm_protective - done
- helm_ranger - done
- helm_respirator - uses helm_m40 animation as a placeholder
- helm_respirator_gp5 - uses helm_m40 animation as a placeholder
- helm_respirator_old - uses helm_m40 animation as a placeholder
Version history:
0.9.1
- Fix for a bug that caused CTD error if you try to pickup item while headgear animation is playing and FDDA pickup animations is enabled. Thanks to mysterious Guest for reporting the bug.
0.9
- Added new unic model for Spartan helmet
0.8.12
- fixed bug with wrong animation play timings. Now toggling helmet with hotkey while holding detector won't clash with detector equip animation
- added small compatibility tweak with DAR (devices of anomaly redone). Now when toggling helmet with hotkey, while holding detector will play fast version of hiding detector instead of long one. Thanks to BarryBogs for the suggestion
0.8.11
- unlocalized some variable to make outfit animations work better with headgear animations
- bug fix. When outfit with integrated helmet equipped pressing helmet toggle played last headgear equip animation.
0.8.10
- fixed typo in the config files (thanks Mr.FlashMode)
0.8.9
- made chocolate bar less HUGE. Looks bit better now
- rewrote parts of the main script. As a side effect removed half a second delay before animation starts. It's ain't much, but it's a honest work.
- hopefully fixed equip animation not playing on anomaly 1.5.1
- updated mask effect toggle addon script. (I guess most people don't need this script, so plz read the description in FOMOD before you try to install it)
0.8.8
- added missing eating chocolate animation for fdda. Back to working on helmet animations
0.8.7
- added missing sound and camera animation files for the candy bar.
0.8.6 (brain tumor edition)
- It turns out that the way I checked whether the FDDA animation was playing or not in the previous patch, was very unreliable. Rewrote it a little in a different way, and according to the first tests it works well. It's better not to write code at 5 am.
0.8.5
- added eating candy bar animation for fdda. Chocolate bars will use same animation as a placeholder (better than using meat animation I guess). Reused bread eating animation by MFS team for this one.
- fixed bug when gasmask animation was interrupting fdda backpack animation when equip helmet from inventory screen.
- fixed bug with drink_crow. Found by SniperHellscream
0.8.4
- fixed bug that allowed to equip and unequip headgear in the middle of FDDA item use animation
- some small code fixes
0.8.3
- added helm_ach7ex helmet with standard helmet animation.
- strict helmet config tweaks. Turns out, if you add missing food objects to fdda animations list, they start to play "drink vodka from flask" animation by default. So, for now, crow drink will play drink from black flask animation. Using raw meat or candy/protein bars will play eating sausage animation. It's temporary solution. Added "make candy and protein bars animation" to todo list. Planning to use ZeburG animation as a base and just replace model to a chocolate bar. Shouldn't take too much time.
0.8.2
- Upon request, the headgear status icon can now be customized in the MCM menu at any time. The status icon display mode has 3 options: 1. hidden (default) 2. show icon when helmet is equipped 3. show icon when helmet is unequipped.
0.8.1
- Hopefully fixed bug mr__dude reported. Couldn't reliably replicate it to be 100% sure tho. Need more testing.
- For those who use Strict Helmets: fixed missing config lines in FDDA that allowed eating candy bars, protein bar and raw meat without taking off helmet or gasmask
- Made SSP-99 helmet glass less transparent and added fade transition to gasmask overlay
0.8
- New model and animation for SSP-99 helmet (added preview with new helmet).
0.7.4
- Partially fixed the issue with gasmask overlay disappearing too early that was bugging me for so long. Works as intended when toggle helmet through hotkey. But still happens when unequip helmet through inventory window. Will keep working on it.
- Strict Headgear mode now added to main addon and can be enabled and disabled through MCM menu at any time in game. No need to restart the game, reload save or anything. It's disabled by default, so if you used it before, you will have to active it in MCM mod settings.
- Merged both version of Toggle Helmet Hotkey together. Now if you don't have MCM installed, non MCM version will be used. If you have MCM installed, then MCM version will be used with configurable hotkey through MCM menu.
0.7.3
- By user request I added optional status indicator, that is displayed when a gas mask is worn. The mod is optional and made for those who constantly forget to put on protection before going into the Zone. Made status icon in two styles: default and GAMMA style
- fixed gasmask unequip sound executed when player actor dies
- rewrote Mask effect toggle patch for Toxic Air users from scratch
0.7.2
- small fix that removes black flickering before mask equip animation.
- as a bonus optional micro addon that disables ability to use food, drinks, pills or smokes with mask equipped. Only exception is a few headgears that don't obstruct mouth (bandana, helmets etc.)
0.7.1
- added patch for EFT Modular Helmets addon by DerChrom
- made helm_ranger texture more dark to better correspond with item icon
- made helm_ranger glass texture more transparent. It looked too opaque before
- small code optimizations
0.7
- replacing a helmet in a slot with another helmet should now play the animation of removing the old helmet and the animation of putting on the new helmet sequentially. (hopefully I didn't break anything with this one)
- replaced helm_ach7 model and animation
- added 5 new helmet models (hardhat, hardhat_snag, battle, tactic, exo)
0.6
- new animation for Metro Helmet. In next update (shouldn't take too long) will use this animation as a base for reanimation for all other helmets
0.5.1
- quick little patch that adds ODST Armor addon support
0.5
- new equip/unequip gas mask animation
- added unique models for m50 and ranger gas masks
- replaced default gas mask model
0.4.4
- bugfix toggle helmet hotkey simple button press not working correctly
0.4.3
- crude fix for stuck hands found by BlackPiligrim
- made fade on helmet unequip more smooth
0.4.2
- Upon request, I returned the mcm version of Toggle Helmet Hotkey as an option during installation. In general, this version is not recommended for most people as it requires fiddling with key bindings and the mcm menu.
- Upon request, I added the ability to disable the gas mask overlay without removing the gas mask from equipment slot. The animation should play as usual. To enable this feature, after installation, drop the contents of the folder "OPTIONAL. Mask effect toggle support" from the archive into the folder with the installed mod. Based on mod Mask Effect Toggle and uses same key to toggle mask overlay (K by default). To change keybind open the script "gasmask_anim.script" and change DIK_K to some other key by looking at lua_help.script or google DIK keys table.
0.4.1 Hotfix
- Override Anomaly default headgear equip animation. Now this mod animations should play regardless of whether Anomaly item animations is enabled or not
- Removed MCM Keybind stuff from TOGGLE HELMET HOTKEY. Now you can equip/unequip gas mask by holding "wipe gasmask" (V by default) key as before.
0.4 Initial release
Oh this looks very good ! Will try your mod for sure.
Great job :)
its possible used this for Gamma?
yes
NICE FINALY SHUT UP AND TAKE MY POINTS!
10 great mod tnx!!
Great 10/10
nice 10/10
oh mah gahhhhhdddd
perfect!
Nice work man, would be nice if you add an script for make mask usable only if have filters, adding toxic air animations/trade filter system to this mod would be amazing! Moddb.com
Oooh, I never played with this mod. I need to check it and see what I can do. I like the idea
do you use the toxic air mod with this mod? tell me is it compatible?
yep, seems to be working without any issues so far. I played only couple of hours tho. But so far so good
Awesome addon!!
Im having a issue where only the camera animation is displayed (no hand or mask animation) any tips? (Item animations enabled was the issue, working perfectly!!!)
Ey Yuri, do you have the animations when you have the item animation disabled or enabled? cause i have the animation when i'm with the disabled animation items
He just say what the problem is...
Yes, it must be disabled in order to work, same here
Thanks for confirmation i was wondering cause it feels a little bit contradictory disabled item animation to get item animation but seems like it’s the way the mod works
I have the same problem too!
Dang, my bad. I'm just playing with the default animations turned off. It's never occurred to me that it might be an issue. I'll fix it as quickly as possible
Dang, my bad. I'm just playing with the default animations turned off. It's never occurred to me that it might be an issue. I'll fix it as quickly as possible
yeah, was looking for this comment. will wait for the fix :) great work btw, already tested it by turning off default anims
Really good ****
neat
Нет видимой анимации надевания или снятия противогаза как на превью, проверялось на аномалии 1.5.2+ модифицированные экзешники(последней версии)+MCM
Была такая же проблема, решил её отключением анимацией предметов, не знаю как у других, но у меня в настройках клавиш есть пункт "Анимация предметов" после нажатия кнопки, ответственной за это, всё заработало
Сорян, это мой косяк. Я просто играю с отключенной анимацией по умолчанию. Мне никогда не приходило в голову, что это может быть проблемой. Я исправлю это как можно быстрее
Next level Immersion
Thanks
YES! now all we need is animations for turning on/off the Night Vision Googles
beefs nvg has that
Excellent work, I know many Stalkers have waited for this. Stay motivated, don't listen to any hate. Thanks for your good work
I always praise modders, who add immersion to this franchise, keep up the top work...
In the video, the animation of the dropping is also played without you having to go into the inventory. How does this work?
it's Toggle Helmet Hotkey mod. I modified original mod and included it into this one. In Mod Configuration Menu (aka MCM) you can configure any key you want to equip and unequip headgear on the go
For me, with this mod you can only switch the breathing noises and breathing formation on and off, but unfortunately it doesn't play any animation!
I wonder if this is the same issue with default Anomaly animations overriding the mod. Try to press "]" key to turn off default animations and test gasmask hotkey again.
Press "]" turn default animations back on.
If I turn off the default animation, the animations of the masks from the inventory work! With your or the Toggle Helmet hotkey mod it will not work if the default animation is on or off. I previously used a mod called Mask-Effect-Toggle as a hotkey mod. With this mod, only the breathing sounds and the breathing mist formation worked, but no animation, neither when the default animation was on or off. It's sad that it doesn't work with the hotkey, at least not for me! still I give you a 12/10 it's really a nice mod!
YEAAAAAAAAAAA
incredible work, finally someone makes it happen <3, 10/10!!!
For me it works really strange.
If I turn off animations ("]" by default) — it works but if I turn them on — it doesn't work. Hotkey to equip it without backpack menu doesn't work at all.
Any ideas? Using this mod with Nav's 4K Definitive Masks from GAMMA Discord mods thread.
UPD: а, прочёл комментарии выше, буду ждать фикса. А так идея классная, наконец-то кто-то это реализовал. Ещё бы такой мод для очков ночного видения :)
mine works fine with gamma nav4k mask
For me it works fine too but "inverted" (works with disabled animations) and I am not the only one with this problem here, read above.
Mods works flawlesly except there a minor bug that if you set no input and no modifier it doesnt do anything unless i change one of them, im using with gamma modpack with navs4k mask
My preview: Youtu.be
Good animations, ty
BROOOOO!!!!! 10/10
11/10! Finally we have better animations for helmets rather than just having the character bend over a bit to put them on! Definitely will use this addon with my game, and can't wait to see what else your able to accomplish with this addon goin forward! :)
"the animations are far from perfect"
*Makes perfect animations*
Man your work is amazing
I didn't realize that I wanted it so badly until that moment thank you :D
Ight, I posted an update
hopefully it should fix issues with hot key and not working animations
also thanks everyone. Glad you like it. And sorry for bugs
for a moment I thought I only one who can't live without gasmask animation :D
Oh, good to hear, gonna try it again soon.
Thank you for your work!
Now it works perfectly. thanks buddy. really cool mod