The Witcher 3

File information

Last updated

Original upload

Created by

plasticmetal

Uploaded by

plasticmetal

Virus scan

Safe to use

Tags for this mod

About this mod

Visual mod that can dymaically change eye texture in game. Default behavior changes eyes black with toxicity. Eyes move both when effect is inactive and active. Affects Geralt and NPC Witchers

Requirements
Permissions and credits
Translations
  • Russian
  • Polish
  • German
Changelogs

APPEARANCE VARIANTS:
Scoutbr0's Glowing Witcher Eyes
raderith's 52 And A Half Eyes
Zowbaid's New Toxic 'Black Eyes' for Modular Eyes Mod

DESCRIPTION:
Formerly called Dynamic Toxic Black Eyes, Modular Eyes allows Geralt's eyes to change dynamically in game between 3 sets: the Base eye texture, Black Eyes, and Alt Eyes.  Traditional eye texture mods will change only the Base eye texture.  By default, Alt Eyes just a copy of Black Eyes.  Using one of the compatible mods above in Appearance Variants grants you more options for both Black Eyes and Alt Eyes.

Black Eyes and Alt Eyes activate once one or more of the following Activation Conditions are met:
Toxicity ThresholdDark EnvironmentToxicity Threshold while in Dark EnvironmentAny Potion ActiveCat Potion ActiveWitcher Senses activeIn Combat DayCombat DarkButton TriggerAlways OnAlways Off

These are all configurable in the settings.  Descriptions of those and all other settings are pinned in the posts section.

Additional Features:
  • Fixes for vanilla bugs that break toxic veins from Quen, Euphoria, and world changing Fast Travel
  • Allows remapping when each of the 4 stages of toxic face veins activate.  See the pinned post for more info
  • Allows upgrading toxic vein state by a chosen number of stages whenever Alt or Black Eyes activate - regardless of current toxicity
  • Option to force shaving when an eye activates/deactivates, and blocks the next mounted head from growing a beard
  • As of 2.30 supports changing eyes and having vein textures for NPC witchers

If different Activation Conditions are met for both Black Eyes and Alt Eyes simultaneously, Black Eyes will always win the conflict and override Alt Eyes.  You can reverse this priority with a mod setting

COMPATIBLITY:
By default mods that change the head mesh or texture are compatible - they will also change the alt head meshes (since the alt head entity points to the vanilla head mesh location).  The mod is still compatible with Adnan4444's Henry Cavill and Anya Chalotra Mod, and any retextures of it.

Mods that change the eye texture will only change the default (inactive state) eye texture of this mod.  To change the Black or Alt Eye texture, a compatible mod must be made.

Mods that add new head entities aren't compatible by default.  An exception is New HairStyles and Beards for Geralt.

Compatible with Unique Eyes for All Witchers.

HOW IT WORKS:
The game has a different head entitiy for every beard stage if the player has the tattoo, the demon mark, both, and none.  This mod creates another set of all these heads (names appended with "alt_") that point to the same head mesh as their vanilla counterparts, but point to an alternate eye mesh.  The alternate eye mesh points to an alternate texture mesh.
When the set Activation Trigger is met, the mod swaps the current head entitiy to the appropriate alternate head entitiy with an alternate eye texture, then reverts the appropriate vanilla entity when the condition is no longer met.

FOR MOD MAKERS:
Spoiler:  
Show




UNINSTALLING:
Version 2.30+: 
  • Toggle on Cleanup and Disable Mod in Other while Enable Mod is still on.  Follow on screen instructions to save after Geralt's head is done flickering (about 1-2s if alt/black eyes were active).  Exit the game.
  • Delete dlcModularEyes from your dlc folder, modModularEyes and modToxicFace (if present) from your mods folder.  In your bin, delete [Install Directory]\bin\config\r4game\user_config_matrix\pc\modulareyesconfig.xml.  If you installed button toggle controls, you can remove those entries from your input settings file but nothing breaks if you fail to do so.
Spoiler:  
Show


TROUBLESHOOTING:
  • Make sure you have dlcModularEyes in your dlc folder, and modModularEyes in your mods folder.
  • If it's first launch, make sure you first adjust the mod settings in game, as the settings don't take effect until you mess with it.
  • Alt Eyes look identical to Black Eyes unless you download an appropriate compatible texture mod that targets the eye you want.  Vanilla texture mods will only change the inactive default eye
  • If you have an alt eye texture mod, note that black eyes will always override alt eyes unless toggling the Reverse Priority setting
_______
Thanks to:
raderith - Bug reporting, beta testing, Russian translation, and general help
AgentofFenrir - Bug reporting and beta testing

eragontrible - Bug reporting and beta testing
GodsMistake - Bug reporting and feature suggestions
Meuhoua - Bug reporting and providing save file for testing
Adnan4444 - Feedback and bug reporting
teresatiger - Assistance with code optimization removing the need for console commands in installation
CAPA14's AMM for proof of concept for implementing version 1.40, and general framework for implementing new classes for version 2.0
W3EE Mod Team for demonstrating how to incorporate button toggles
Scoutbr0 for providing Alternate Eye texture
raderith for providing Alternate Eye texture 
MarvelMaster for modding tutorials
Witcher 3 Modding articles on Gamepedia wiki