home
Cyberpunk 2077
Terms of Service | Privacy Policy
Copyright © 2024 Robin Scott. All rights reserved.
0 of 0

File information

Last updated

Original upload

Created by

NoraLee

Uploaded by

NoraLee

Virus scan

Safe to use

Tags for this mod

Tag this mod
Current section

About this mod

This framework allows for the use of: multiple framework-ready replacer pose packs at once, multiple framework-ready photomode animation mods at once, certain NPC animation mods on photomode V, custom props with animation mods, framework-dependent standalone pose packs, and more. Now compatible with most other photomode mods!

Requirements
Permissions and credits
Donations


Read all relevant sections below before commenting.

If you find this framework useful, you can support my work on Ko-fi.




M.P.A.F. and Photo Mode Unlocker 2.0 XL are now compatible!
Update Photo Mode Unlocker 2.0 XL and read the compatibility info below!


  If you don't read the compatibility info
you will likely break things. 



Last Updated - December 8th, 2023 - Change Log




Basic Information



What is this mod? What does it do?

This mod is a framework designed to interact with the system that the games uses to load photomode poses.

In short, this framework:

  • Makes it possible to use multiple .anims files to populate the photomode idle poses, facilitating more interesting/less wasteful pose packs

  • Fills idle and action pose slots left empty/broken by pose packs with the game's default poses, ensuring all pose slots remain usable

  • Creates a new Custom Animations photomode category, with special handling, allowing photomode V to have multiple animation mods available at once, and to utilize certain NPC animation mods

  • Establishes a prop framework, allowing props to be loaded to match these new animation slots - props which animate along with V

  • Establishes a framework for standalone additions, facilitating standalone pose pack creation

In more detail:
Spoiler:  
Show
How does modding photomode work without M.P.A.F.?

Without M.P.A.F. installed:

  • Only one replacer-style photomode pose pack mod can be installed at once (one for FV and MV each).

  • Traditional photomode pose pack mods replace vanilla photomode poses.

  • Vanilla photomode poses not replaced by the installed photomode pose pack mod will be "broken", resulting in idling behavior.

  • Only one photomode animation/animated pose mod can be installed at once (one for FV and MV each).

  • Most photomode animation mods either break the UI (inventory & CC) animations or interfere with the animations of NPCs.

  • A photomode pose pack mod with a "broken" pose must be installed in order to use a photomode animation mod.


How does M.P.A.F. improve the modded photomode experience?

With M.P.A.F. installed:

  • Multiple pose packs that replace vanilla photomode poses may be installed at once so long as those pose packs are made to work with M.P.A.F. and use different M.P.A.F. slots. This means that you can install several smaller pose packs that work together to collectively replace a greater number of vanilla photomode poses.

  • A fallback system is in place which prevents the breaking of non-replaced poses when photomode pose pack mods are installed. Instead, the non-replaced poses simply work as usual.

  • There is no need to worry about installing a photomode pose pack mod simply to use a photomode animation mod. M.P.A.F. adds a new photomode category, "Custom Animations", which can be used to access an older style photomode animation mod if one is installed.

  • Multiple photomode animation mods may be installed at once so long as those animation mods are made to work with M.P.A.F. and use different M.P.A.F. slots. These additional animated poses are accessible in M.P.A.F.'s new photomode category, "Custom Animations".

  • Photomode animation mods made specifically to work with M.P.A.F. do not interfere with UI animations or the animations of NPCs.

  • It is now possible to use animation mods made for specific NPC locomotions for V in photomode. For FV, mods made for the Generic Average Female, Judy, and Panam locomotions are now accessible. For MV and Johnny, mods made for the Man Average Civilian and Takemura locomotions are now accessible. These animated poses can be accessed in M.P.A.F.'s new photomode category, "Custom Animations".

  • Prop mods designed for use with M.P.A.F.'s system can now be used with animated poses; when installed, these props load with the animated pose and animate along with the motion of the pose.

  • Standalone pose packs designed for use with M.P.A.F. can be installed and used without replacing vanilla photomode poses.


How will M.P.A.F. work with my older photomode mods?

  • Older replacer-style photomode pose pack mods that were not created specifically for use with M.P.A.F. will continue to function, but you may still only install and use one such mod at a time. These mods will replace vanilla photomode poses as usual, though if any M.P.A.F.-specific photomode replacer mod is installed and attempting to replace the same pose, the M.P.A.F.-specific mod will be given priority.

  • Older photomode animation mods that were not created specifically for use with M.P.A.F. can now be accessed in M.P.A.F.'s new photomode category, "Custom Animations". In most cases, only one such mod can be installed and used at once, however, as these mods were made with multiple methods, in some cases it will be possible to use two older animation mods at once, with one appearing in the 'Default Animation' animated pose slot and one appearing in either the 'Generic Average Female Animation' or 'Man Average Civilian Animation' animated pose slot.


This framework is the successor to Multi Pose Pack Framework; it provides full support to all mods that depend on that older, original framework while expanding upon the framework's capabilities and features.





Conflicts & Compatibility



Compatibility between mods made for the M.P.A.F. framework:

There is a convenient way to determine whether two mods made to work with M.P.A.F. are compatible. Read More:
Spoiler:  
Show
Simply look at the beginning of the file name. It should appear something like:

MPAF_[V Frame]_[Mod Type]_[Slot Number(s)]_[RestOfTheFileName].archive

If two mods designed to work with the M.P.A.F. framework are created for the same V Frame (FV or MV), are the same Mod Type (AUA, CAS, CMP, or OPR) and take up the same Slot Number (or overlap Slot Numbers), they will not work together.

This file naming convention is somewhat new; please be patient while older M.P.A.F. mods are being updated to match the naming scheme, and if you are unsure what an older M.P.A.F. or Multi Pose Pack Framework mod would be considered, ask in this page's Forum tab, in the appropriate topic.

It should also be noted that OPR mods operate with a specific priority system amongst themselves. For more information on this, and clarifying examples, see the "Instructions - Mod Users" section of this page.


Compatibility with other mods:

M.P.A.F. has varied compatibility with other photomode-impacting mods. Read More:
Spoiler:  
Show
Key:
 - Fully Compatible - No Compatibility Patch or Adjustments Needed
- Partially Compatible - Requires Compatibility Patch or Minor Adjustments, or Minimal Features Unavailable
- Significant Incompatibility - Major Features Unavailable/Unfixable

 - MaximiliumM's Appearance Menu Mod (link) and Associated Pose Mods

 - JSILVERHVND's MV Photomode Shadow Fix (link)
  • The MV Photomode Shadow Fix is included in M.P.A.F..
  • With M.P.A.F. installed, you do not need to install MV Photomode Shadow Fix.

 - xBaebsae's Facial Customisation Rig Fix (link)
  • Install Facial Customisation Rig Fix as usual.
  • If you also use Framework - Unique V Body Shape - Rig, download the M.P.A.F. patch file: MPAF_CompatibilityPatch_FCRF_and_UVBSR.zip.
  • If you do not use Framework - Unique V Body Shape - Rig, download the M.P.A.F. patch file: MPAF_CompatibilityPatch_FCRF.zip.

 - JohnsonsStuff's Framework - Unique V Body Shape - Rig (link)
  • Install Framework - Unique V Body Shape - Rig as usual.
  • If you also use Facial Customisation Rig Fix, download the M.P.A.F. patch file: MPAF_CompatibilityPatch_FCRF_and_UVBSR.zip.
  • If you do not use Facial Customisation Rig Fix, download the M.P.A.F. patch file: MPAF_CompatibilityPatch_UVBSR.zip.

 - xBaebsae's Nibbles to NPCs 2.0 - AMM Add-on (link)
  • Install Nibbles to NPCs 2.0 - AMM Add-on as usual.
  • No M.P.A.F. compatibility patch needed.
  • At present, poses and animations added via M.P.A.F. will not be available to the Nibbles-NPC. Vanilla photomode poses, replacer photomode pose packs, and PMU pose packs will function as expected for the Nibbles-NPC.

 - SilverEzredes's Photo Mode Unlocker 2.0 XL (link)
  • Install Photo Mode Unlocker 2.0 XL as usual; must be October 2nd, 2023 update or more recent.
  • No M.P.A.F. compatibility patch needed.
  • Do NOT install any of the compatibility patches from the M.P.A.F. page; use those from the Photo Mode Unlocker 2.0 XL page if needed.
  • If you install a compatibility patch from the M.P.A.F. page it will break Photo Mode Unlocker 2.0 XL poses.
  • If you previously installed 00_MPAF_CompPatch_FCRF.archive, 00_MPAF_CompPatch_FCRF_and_UVBSR.archive, 00_MPAF_CompPatch_UVBSR.archive, or zz_NLD_MPAF_PMU_OPR_Mod_Hotfix.archive delete those files.
  • Full support may be lacking when attempting to use certain older non-M.P.A.F. photomode animation mods; this issue is documented and a fix is pending.




Instructions - For Mod Users



Installing the Framework:

If you are using the previous version of this framework, Multi Pose Pack Framework, OR if you already use M.P.A.F. and you are newly updating from a version before version 2.0, complete the instructions under "Removing the Framework" before continuing. If you do not do this, the mod will not work right.

  • Review the information in this page's Conflicts & Compatibility section. Download any required M.P.A.F. compatibility patch .zip files. If you require a compatibility patch and do not install it, the mod will not work right.

  • Download and install the required supporting mods:
    - ArchiveXL by psiberx
    - TweakXL by psiberx
    - RED4Ext by WopsS

  • Download the NLD_MPAF_MultiPosePackAndAnimationFramework.zip file.

  • Extract the NLD_MPAF_MultiPosePackAndAnimationFramework.zip and the M.P.A.F. compatibility patch .zip file you have downloaded (if any).

  • Locate your Cyberpunk 2077 installation folder.

  • For each .zip file you have extracted, drag the archive and r6 folders into your Cyberpunk 2077 installation folder. Only the archive folder will be present in compatibility patch .zip files; this is expected.

Do not rename this mod's files; it is important that they load in a specific order.


Removing the Framework:
Spoiler:  
Show
1. Look for and delete all of the following files (if present) in your
Cyberpunk 2077\archive\pc\mod folder:

00_johnsonUniqueVBodyShape_NLDMPAF_CompatibilityPatch.archive
00_johnsonUniqueVBodyShape_NLDMultiPosePackCore10_FrameworkCompatibilityPatch.archive
00_MPAF_CompPatch_FCRF.archive
00_MPAF_CompPatch_FCRF_and_UVBSR.archive
00_MPAF_CompPatch_UVBSR.archive
zz_MPAF_PMU_OPR_Mod_HotFix.archive
zz_NLD_MPAF_MultiPoseAndAnimFramework.archive.xl
zz_NLD_MPAF_MultiPoseAndAnimFramework_Core.archive
zz_NLD_MultiPoseAndAnimFramework.archive.xl
zz_NLD_MultiPoseAndAnimFramework_Core_10.archive
zz_NLD_MultiPosePackFramework_Add_AnimationEnabler_AllAttachments.archive
zz_NLD_MultiPosePackFramework_Add_AnimationEnabler_Complete.archive
zz_NLD_MultiPosePackFramework_Add_AnimationEnabler_KnucklesOnly.archive
zz_NLD_MultiPosePackFramework_Add_AnimationEnabler_Props.archive
zz_NLD_MultiPosePackFramework_Core.archive

2. Delete the NLD_MultiPoseAndAnimFramework.yaml file from your Cyberpunk 2077\r6\tweaks folder if present.

3. Delete the NLD_MPAF folder from your Cyberpunk 2077\r6\tweaks folder if present.

M.P.A.F. OPR Inter-Mod Priority:
Spoiler:  
Show
As OPR mods replace the vanilla photomode poses*, they can sometimes conflict when two OPR mods attempt to replace the same vanilla photomode pose. If you intend to use OPR mods, understanding this priority system may help you get the most out of the mods you use. CAS mods, CMP mods, and AUA mods do not use a priority system.

*"OPR-like" versions of AUA mods made to be compatible with Photo Mode Unlocker 1.6 XL will not interact with this priority system, as they do not replace vanilla photomode poses.

OPR mods are given priority that decreases as their slot number gets higher; this is to say, an OPR mod in slot 000 will have priority over an OPR mod in slot 001, and an OPR mod in slot 003 will have priority over an OPR mod in slot 007, etc.

All OPR mods have priority over a non-M.P.A.F. replacer photomode pose pack mod, if one is installed.

This priority order is used to "fill" photomode pose slots with pose data. A slight simplification:

1. The game starts with the highest priority OPR file installed and reads its contents, searching for pose data that has been labeled to match the game’s photomode pose names.
     A. When it reaches such pose data, it "fills" the matching photomode pose slot with that pose data.

2. Once the game has read all the pose data in the highest priority OPR file, it moves to the next highest priority OPR file and repeats the process, however, it no longer searches for pose data labeled to match pose slots that have already been "filled".

3. This process continues for each OPR file in descending priority / ascending slot number.

4. Once all installed OPR files have been read, the game will repeat this process with the game's vanilla photomode idle pose data file, searching only to "fill" photomode pose slots that have not received pose data from a higher priority file. If you have an older, non-M.P.A.F. replacer photomode pose pack installed, it will be processed here.

5. Any photomode pose slots that were not "filled" with pose data after all of this will be filled with their vanilla pose data by the M.P.A.F. framework's files.


As this is a somewhat odd process to explain, an example may be helpful:

If I install:

  • An OPR mod that occupies slot 000 and that contains data for the poses Tabula Rasa and Talk to the Hand, and

  • An OPR mod that occupies slot 004 and that contains data for the poses Tabula Rasa, V’s Bizarre Pose and On the Trail, and

  • An OPR mod that occupies slot 000 and that contains data for the poses Hard Pass, You’re Breathtaking, and What Can I Get Ya?, and

  • A non-M.P.A.F. replacer photomode pose pack mod that contains data for the poses Tabula Rasa, On The Trail, Serious ‘Tude, Hard Pass, and Needed a Breather.

In photomode, the game will load the pose data for Tabula Rasa and Talk to the Hand from the first file, V’s Bizarre Pose and On the Trail from the second, Hard Pass, You’re Breathtaking, and What Can I Get Ya? from the third, and Serious ‘Tude and Needed a Breather from the final file. 

The framework will also then "fill" the remaining "unfilled" pose slots with their default/vanilla pose data, ensuring that all photomode pose slots remain usable.






Instructions - Mod Creators


To allow for added clarity, better support, and a more robust system of documentation, the information for making M.P.A.F. compatible mods has been moved to its own page: M.P.A.F. Compatible Mod Creation Tutorials and Resources.





Credits:

Much thanks to rfuzzo, the entire dedicated team behind Wolvenkit, and alphaZomega; this framework could not have been made without the use of Wkit, CP77Tools, and the 010 Editor template and scripts.

Many thanks to SilverEzredes for writing the tutorial that first allowed me to explore pose modding and for entertaining (and providing valuable feedback to) the rambling that eventually led to the multiple-animation component of this framework.

A huge thank you to JohnsonsStuff and xBaebsae, as well, for allowing me to make our mods compatible.

Thank you to JSILVERHVND for developing the MV Photomode Shadow Fix and for freely sharing the technique behind it so that the fix could be included in M.P.A.F..

Thanks also to the modding community as a whole, to Halvkyrie for the initial guide that allowed me to get into modding, and to the AMM and Cyberpunk 2077 Modding Discord servers for being excellent sources of information, tips and tricks. 

And as always, much love to my friends in the Cyberpunks, for listening to me whine, providing valuable feedback, and being willing to test these files. In particular, thanks to JSILVERHVND and beanchan2077 for assisting with the test file creation and proofreading processes.