Skyrim

Documentation

Readme

View as plain text

RaceCompatibility For Dawnguard
-------------------------------
https://www.nexusmods.com/skyrim/mods/24168

If you have any problems using this mod, please post in the mod discussion
area on the Skyrim Nexus page of this mod (link above).

Current version: 1.112

IMPORTANT: If you use multiple custom races and/or custom race companions,
please read the "notes on multiple custom races fix" below.

=== CHANGELOG ===
version 1.112: Updated to Better Vampires 8.8

version 1.111: Updated to Better Vampires 8.7 for latest changes in BV

version 1.110: Updated to Better Vampires 8.7

version 1.109: Updated to Better Vampires 8.6 (Finally!). Backported a fix for
beast races from the SSE version.

version 1.108: Updated to Better Vampires 8.5 (Finally!).
Fixed potential crash issue with translations. Not yet fully in-sync with
the SSE version of RaceCompatibility though... :(

version 1.107: Updated to Sacrosanct 5.10 (Finally!).

version 1.106: Better Vampires 8.0 compatibility.

version 1.105: Sacrosanct 4.0 compatibility.

version 1.104: Added Better Vampires 7.9 support.

version 1.103: Fixed a minor issue with one of the BV 7.8 scripts.

version 1.102: Added Better Vampires 7.8 support. Added Sacrosanct 2.03 support.

version 1.101: Added Better Vampires 7.5 support.

version 1.100: Added Better Vampires 7.4 support.

version 1.99: Added Better Vampires 7.3 support. REALLY this time.

version 1.98: Added Better Vampires 7.3 support.

version 1.97: Added Better Vampires 7.2 support. Updated some wording in
installer and documentation to make it clear USLEEP == USKP as far as this mod
is concerned.

version 1.96: Added Better Vampires 7.1 support.

version 1.95: Added Better Vampires 7.0 support.

version 1.94: Added Better Vampires 6.9 support.

version 1.93: Added Better Vampires 6.8 support.

version 1.92: Added Better Vampires 6.7 support.

version 1.91: Moved a few translation files to the correct folder

version 1.90: Updated for the latest USKP

version 1.89: Repackaged mod as some of the translations were missing

version 1.88: Added manual installation instructions.
Added minor missing script fix on the DG+USKP branch.

version 1.87: Added fix for amulet of Julianos from USKP.
Made companionshousekeepingscript more robust against other mods altering the
properties on the quest, such as the aMidianBorn Skyforge Steel optional esp.

version 1.86: Updated to incorporate a minor debugging fix for BV6.6.

version 1.85: Added Better Vampires 6.6 support.

version 1.84: Merged back the dummy translations into the installer for easier
installation.
Added Better Vampires 6.5 support.

version 1.83: Fixed a slight oversight in the fixed amulet and ring armor
addons.
Localized both the esm and the override esp. Added translations for all
languages that I could generate.

version 1.82: Updated to include the latest Unofficial patch changes

version 1.81: Updated to Better Vampires 6.41 (the second one)

version 1.80: Improved compatiblity with alternate start mods when using
multiple custom races (thanks en_hawk for the tip). Reorganized
GenericRaceController script to clean up the code and make maintenance easier
while allowing easier customization (by request).
Updated Better Vampires optional for version 6.4 / 6.41 (the first one)

version 1.73: Updated installer scripting for better compatibility with
Vampiric Thirst

version 1.72: Updated Better Vampires optional for version 6.31

version 1.71: Updated Better Vampires optional for version 6.3

version 1.70: Added optional fix for vampire lord transformation script that
may prevent proper transformation back to normal vampire race. Only install if
you are not using a mod that replaces the dlc1vampiretransformvisual.pex
script. The Unofficial Dawnguard Patch changes are included in this mod, so
either with or without the UDGP this file can be used. (Better Vampires,
Vampiric Thirst and Belua Sanguinaris are all compatible at the time of this
writing.)

version 1.68: Updated Better Vampires optional for version 6.2

version 1.67: Updated Better Vampires optional for version 6.1

version 1.66: Added some updates I forgot to package in the 1.64 update

version 1.65: updated Better Vampires optional for version 6.0

version 1.64: updated USKP/UDGP optionals

version 1.63: added Better Vampires 5.9 support... again...

version 1.62: added Better Vampires 5.9 support

version 1.61: added Better Vampires 5.81 support

version 1.60: added Better Vampires 5.8 support

version 1.50: fixed a few minor annoyances in the NMM installer, added the
vampiric thirst (DG) patch to the NMM installer and added UFO only optionals
(though you really should try USKP).

version 1.41: fixed a minor issue with the esm being compiled against another
version of a script. Update to this version if you don't want 2 messages about
script properties not being there anymore. I'm also taking the NMM version out
of beta, since it seems to work.

version 1.4 Beta: NMM installer with all options.

version 1.3a
- Fixed DB Cook quest dialog bug in combination with default vampire races

version 1.3
- Updated USKP compatibility: added an override esp that should be loaded after
the unofficial patches and updated the companionhousekeepingscript with changes
from USKP 1.2.2
- Fixed some potential issue with Nord vampires not showing the gauldur amulet
fragments
- Added back several unused race properties to the companionhousekeepingscript
to reduce harmless, but annoying, warnings about properties no longer being
present

version 1.2
- Added "Better Vampires 5.7" compatibility files to the main package as an
optional install
- Fixed multi custom race issue

version 1.1
- Added optional compatibility fix for UFO + the Unofficial Skyrim Patch

version 1.0
- Initial release

=== INSTALLATION ===

To make a custom race based on RaceCompatibility by expired6978 compatible with
Dawnguard just overwrite the original mod files with the ones included in this
package.

For users of the unofficial Skyrim (Legendary) patch (which I highly recommend),
you should use the optional compatibility files; just overwrite.

For users of both USKP/USLEEP and UFO (Ultimate Follower Overhaul), there is
another compatiblity patch you should use.

If you use USKP/USLEEP (with or without UFO) please also load the
RaceCompatibilityUSKPOverride.esp. It should end up after the unofficial
patches in the load order. This will ensure that the changes made by this mod
are not overridden by the USKP/USLEEP.

For users of Better Vampires, please overwrite the scripts with the ones found
in the optional Better Vampires folder. Please note there is a separate readme
that explains how you should reset Better Vampires in case you are running
into issues with an existing vampire character.

=== NOTE ON RESETTING THE PLAYERVAMPIREQUEST ===

When installing certain mods that modify vampirism, it may be necessary to reset
the quest managing the vampire transformation. If you aren't a vampire yet, you
can just do the following in the console:

stopquest PlayerVampireQuest
resetquest PlayerVampireQuest
startquest PlayerVampireQuest

That should reset the quest. If you are already a vampire, you may want to first
revert your race to normal and then get reinfected, just to be sure.

=== NOTES ON MULTIPLE CUSTOM RACES FIX ===

Version 1.2 of this mod introduces a fix for an issue I discovered in the
original RaceCompatibility mod:

When you use multiple custom races based on the RaceCompatibility mod (this can
include certain companion mods), there is a possibility that when you transform
into a vampire you end up as the wrong race. The problem is caused by the fact
that RaceCompatibility uses 2 lists to handle the vampire transformation:
one with all normal races and one with all vampire versions of the same race.
When you install a custom race, the mod adds these races to the lists. It is
important that the normal race and the vampire version end up in the same
position in their respective lists. Because Skyrims scripting system is
multi-threaded, multiple custom races can mess up the order of these lists,
as they all try to modify those lists at the same time.
It doesn't mean it WILL happen, only that it CAN, and I have personally
experienced it twice.


This is fixed in version 1.2; this fix will work best if you start a new game,
since this is when the bug occurs. So that is what I would recommend.
If you start a new game you can stop reading here.

If you really want to continue playing with your current character(s), there is
a way to fix it by using the console, it takes some work, but it will fix the
race order for your current playthrough; please keep a backup save handy in
case you make a mistake. It basically involves 4 steps:

Step 1. Stop all racecontroller quests:
open the console and enter the following command:
help racecontroller 4
this should display a list of quests called RaceController;
for each of those quests enter the following command to stop the quest:
stopquest
where you replace with the names of the quests in the
list.

Step 2. Resetting the race lists:
Because the order of the lists is most likely not correct, you will need to
reset the lists; to reset the lists you will need to find out what id the lists
have. This is a bit tricky, since their id is not the same for everyone,
because it is affected by your mod load order.
Enter the following command:
sqv RaceDispatcher
this will output a list of quest script variables, with their ids; look for
PlayableRaceList and PlayableVampireList. Their ids should look like XX000D62
and XX000D63 respectively, where XX is the position of RaceCompatibility.esm
in your load order.
Now enter the following commands, replacing XX with the correct number:
revertformlist XX000D62
revertformlist XX000D63
This will clean out the custom races from the lists so we can start adding them
again in the proper order.

Step 3. Resetting the quests:
For each of the racecontroller quests you stopped in Step 1, now call the
following command, replacing with the actual names:
resetquest

Step 4. Starting the quests:
For each of the racecontroller quests you stopped in Step 1, now call the
following command, replacing with the actual names:
startquest

Done! You should now have a correctly ordered pair of lists. So when you are
now turned into a vampire you don't end up as a completely different race.
If you already were turned into a vampire and you fear you were turned into
the wrong race, you can check with the function "GetPCIsRace " to
see what race you are and use "player.setrace " to correct it if
you were not the correct race. So for example to see if my character was an
Ashen vampire I would use:
GetPCIsRace OraezeRaceVampire
This command will return 1 if my character was indeed a vampire of this race
and 0 if my character was another race. Note that "OraezeRaceVampire" is the
editor name of the Ashen vampire race in the Creation Kit. That is the name
you need to use.