/// <summary>
/// Imports <paramref name="sourceEntry"/> (and possibly its children) to <paramref name="destPcc"/> in a manner defined by <paramref name="portingOption"/>
/// If no <paramref name="relinkMap"/> is provided, method will create one
/// </summary>
/// <param name="portingOption"></param>
/// <param name="sourceEntry"></param>
/// <param name="destPcc"></param>
/// <param name="targetLinkEntry">Can be null if cloning as a top-level entry</param>
/// <param name="shouldRelink"></param>
/// <param name="newEntry"></param>
/// <param name="relinkMap"></param>
/// <returns></returns>
public static List <EntryStringPair> ImportAndRelinkEntries(PortingOption portingOption, IEntry sourceEntry, IMEPackage destPcc, IEntry targetLinkEntry, bool shouldRelink,
out IEntry newEntry, Dictionary <IEntry, IEntry> relinkMap = null
, Action <string> errorOccuredCallback = null)
{
relinkMap ??= new Dictionary <IEntry, IEntry>();
IMEPackage sourcePcc = sourceEntry.FileRef;
EntryTree sourcePackageTree = new EntryTree(sourcePcc);
if (portingOption == PortingOption.ReplaceSingular)
{
//replace data only
if (sourceEntry is ExportEntry entry)
{
relinkMap.Add(entry, targetLinkEntry);
ReplaceExportDataWithAnother(entry, targetLinkEntry as ExportEntry, errorOccuredCallback);
}
}
RelinkerCache cache = null;
if (portingOption == PortingOption.MergeTreeChildren || portingOption == PortingOption.ReplaceSingular)
{
newEntry = targetLinkEntry; //Root item is the one we just dropped. Use that as the root.
}
else
{
cache = new RelinkerCache(sourceEntry.FileRef, destPcc);
int link = targetLinkEntry?.UIndex ?? 0;
if (sourceEntry is ExportEntry sourceExport)
{
//importing an export
newEntry = ImportExport(destPcc, sourceExport, link, portingOption == PortingOption.CloneAllDependencies, relinkMap, errorOccuredCallback, cache);
}
else
{
newEntry = GetOrAddCrossImportOrPackage(sourceEntry.FullPath, sourcePcc, destPcc,
forcedLink: sourcePackageTree.NumChildrenOf(sourceEntry) == 0 ? link : (int?)null, objectMapping: relinkMap, relinkerCache: cache);
}
newEntry.idxLink = link;
}
//if this node has children
if ((portingOption == PortingOption.CloneTreeAsChild || portingOption == PortingOption.MergeTreeChildren || portingOption == PortingOption.CloneAllDependencies) &&
sourcePackageTree.NumChildrenOf(sourceEntry) > 0)
{
importChildrenOf(sourceEntry, newEntry, cache);
}
List <EntryStringPair> relinkResults = null;
if (shouldRelink)
{
relinkResults = Relinker.RelinkAll(relinkMap, portingOption == PortingOption.CloneAllDependencies, cache);
}
// Reindex - disabled for now as it causes issues
//Dictionary<string, ExportEntry> itemsToReindex = new Dictionary<string, ExportEntry>();
//foreach (var v in relinkMap.Values)
//{
// if (v is ExportEntry export && export.indexValue > 0)
// {
// itemsToReindex[export.FullPath] = export; // Match on full path. Not instanced full path!
// }
//}
//foreach (var item in itemsToReindex)
//{
// ReindexExportEntriesWithSamePath(item.Value);
//}
cache?.Dispose();
return(relinkResults);
void importChildrenOf(IEntry sourceNode, IEntry newParent, RelinkerCache cache)
{
foreach (IEntry node in sourcePackageTree.GetDirectChildrenOf(sourceNode))
{
if (portingOption == PortingOption.MergeTreeChildren)
{
//we must check to see if there is an item already matching what we are trying to port.
//Todo: We may need to enhance target checking here as fullpath may not be reliable enough. Maybe have to do indexing, or something.
IEntry sameObjInTarget = newParent.GetChildren().FirstOrDefault(x => node.FullPath == x.FullPath);
if (sameObjInTarget != null)
{
relinkMap[node] = sameObjInTarget;
//merge children to this node instead
importChildrenOf(node, sameObjInTarget, cache);
continue;
}
}
IEntry entry;
if (node is ExportEntry exportNode)
{
entry = ImportExport(destPcc, exportNode, newParent.UIndex, portingOption == PortingOption.CloneAllDependencies, relinkMap, errorOccuredCallback, cache);
}
else
{
entry = GetOrAddCrossImportOrPackage(node.FullPath, sourcePcc, destPcc, objectMapping: relinkMap, relinkerCache: cache);
}
entry.Parent = newParent;
importChildrenOf(node, entry, cache);
}
}
}
public static List <EntryStringPair> Relink(ExportEntry sourceExport, ExportEntry relinkingExport, OrderedMultiValueDictionary <IEntry, IEntry> crossPCCObjectMappingList,
bool importExportDependencies = false, RelinkerCache relinkerCache = null)
{
var relinkFailedReport = new List <EntryStringPair>();
IMEPackage sourcePcc = sourceExport.FileRef;
byte[] prePropBinary = relinkingExport.GetPrePropBinary();
//Relink stack
if (relinkingExport.HasStack)
{
int uIndex = BitConverter.ToInt32(prePropBinary, 0);
var relinkResult = relinkUIndex(sourceExport.FileRef, relinkingExport, ref uIndex, "Stack: Node",
crossPCCObjectMappingList, "", importExportDependencies, relinkerCache);
if (relinkResult is null)
{
prePropBinary.OverwriteRange(0, BitConverter.GetBytes(uIndex));
}
else
{
relinkFailedReport.Add(relinkResult);
}
uIndex = BitConverter.ToInt32(prePropBinary, 4);
relinkResult = relinkUIndex(sourceExport.FileRef, relinkingExport, ref uIndex, "Stack: StateNode",
crossPCCObjectMappingList, "", importExportDependencies, relinkerCache);
if (relinkResult is null)
{
prePropBinary.OverwriteRange(4, BitConverter.GetBytes(uIndex));
}
else
{
relinkFailedReport.Add(relinkResult);
}
}
//Relink Component's TemplateOwnerClass
else if (relinkingExport.TemplateOwnerClassIdx is var toci && toci >= 0)
{
int uIndex = BitConverter.ToInt32(prePropBinary, toci);
var relinkResult = relinkUIndex(sourceExport.FileRef, relinkingExport, ref uIndex, "TemplateOwnerClass",
crossPCCObjectMappingList, "", importExportDependencies, relinkerCache);
if (relinkResult is null)
{
prePropBinary.OverwriteRange(toci, BitConverter.GetBytes(uIndex));
}
else
{
relinkFailedReport.Add(relinkResult);
}
}
//Relink Properties
PropertyCollection props = relinkingExport.GetProperties();
relinkFailedReport.AddRange(relinkPropertiesRecursive(sourcePcc, relinkingExport, props, crossPCCObjectMappingList, "", importExportDependencies, relinkerCache));
//Relink Binary
try
{
if (relinkingExport.Game != sourcePcc.Game && (relinkingExport.IsClass || relinkingExport.ClassName == "State" || relinkingExport.ClassName == "Function"))
{
relinkFailedReport.Add(new EntryStringPair(relinkingExport, $"{relinkingExport.UIndex} {relinkingExport.FullPath} binary relinking failed. Cannot port {relinkingExport.ClassName} between games!"));
}
else if (ObjectBinary.From(relinkingExport) is ObjectBinary objBin)
{
List <(UIndex, string)> indices = objBin.GetUIndexes(relinkingExport.FileRef.Game);
foreach ((UIndex uIndex, string propName) in indices)
{
var result = relinkUIndex(sourcePcc, relinkingExport, ref uIndex.value, $"(Binary Property: {propName})",
crossPCCObjectMappingList, "", importExportDependencies, relinkerCache);
if (result != null)
{
relinkFailedReport.Add(result);
}
}
//UStruct is abstract baseclass for Class, State, and Function, and can have script in it
if (objBin is UStruct uStructBinary && uStructBinary.ScriptBytes.Length > 0)
{
if (relinkingExport.Game == MEGame.ME3)
{
(List <Token> tokens, _) = Bytecode.ParseBytecode(uStructBinary.ScriptBytes, sourceExport);
foreach (Token token in tokens)
{
relinkFailedReport.AddRange(RelinkToken(token, uStructBinary.ScriptBytes, sourceExport, relinkingExport,
crossPCCObjectMappingList, importExportDependencies, relinkerCache));
}
}
else
{
var func = sourceExport.ClassName == "State" ? UE3FunctionReader.ReadState(sourceExport) : UE3FunctionReader.ReadFunction(sourceExport);
func.Decompile(new TextBuilder(), false); //parse bytecode
var nameRefs = func.NameReferences;
var entryRefs = func.EntryReferences;
foreach ((long position, NameReference nameRef) in nameRefs)
{
if (position < uStructBinary.ScriptBytes.Length)
{
RelinkNameReference(nameRef.Name, position, uStructBinary.ScriptBytes, relinkingExport);
}
}
foreach ((long position, IEntry entry) in entryRefs)
{
if (position < uStructBinary.ScriptBytes.Length)
{
relinkFailedReport.AddRange(RelinkUnhoodEntryReference(entry, position, uStructBinary.ScriptBytes, sourceExport, relinkingExport,
crossPCCObjectMappingList, importExportDependencies, relinkerCache));
}
}
}
}
relinkingExport.WritePrePropsAndPropertiesAndBinary(prePropBinary, props, objBin);
return(relinkFailedReport);
}
}
catch (Exception e) when(!CoreLib.IsDebug)
{
relinkFailedReport.Add(new EntryStringPair(relinkingExport, $"{relinkingExport.UIndex} {relinkingExport.FullPath} binary relinking failed due to exception: {e.Message}"));
}
relinkingExport.WritePrePropsAndProperties(prePropBinary, props);
return(relinkFailedReport);
}
/// <summary>
/// Imports an export from another package file.
/// </summary>
/// <param name="destPackage">Package to import to</param>
/// <param name="sourceExport">Export object from the other package to import</param>
/// <param name="link">Local parent node UIndex</param>
/// <param name="importExportDependencies">Whether to import exports that are referenced in header</param>
/// <param name="objectMapping"></param>
/// <returns></returns>
public static ExportEntry ImportExport(IMEPackage destPackage, ExportEntry sourceExport, int link, bool importExportDependencies = false, IDictionary <IEntry, IEntry> objectMapping = null,
Action <string> errorOccuredCallback = null, RelinkerCache relinkerCache = null)
{
byte[] prePropBinary;
if (sourceExport.HasStack)
{
var ms = new MemoryStream();
ms.WriteFromBuffer(sourceExport.Data.Slice(0, 8));
ms.WriteFromBuffer(destPackage.Game switch
{
MEGame.UDK => UDKStackDummy,
MEGame.ME3 => me3StackDummy,
_ => me1Me2StackDummy
});
/// <summary>
/// Attempts to relink unreal property data and object pointers in binary when cross porting an export
/// </summary>
public static List <EntryStringPair> RelinkAll(IDictionary <IEntry, IEntry> crossPccObjectMap, bool importExportDependencies = false, RelinkerCache relinkerCache = null)
{
var relinkReport = new List <EntryStringPair>();
//relink each modified export
//We must convert this to a list, as this list will be updated as imports are cross mapped during relinking.
//This process speeds up same-relinks later.
//This is a list because otherwise we would get a concurrent modification exception.
//Since we only enumerate exports and append imports to this list we will not need to worry about recursive links
//I am sure this won't come back to be a pain for me.
var crossPCCObjectMappingList = new OrderedMultiValueDictionary <IEntry, IEntry>(crossPccObjectMap);
//can't be a foreach since we might append things to the list
// ReSharper disable once ForCanBeConvertedToForeach
for (int i = 0; i < crossPCCObjectMappingList.Count; i++)
{
(IEntry src, IEntry dest) = crossPCCObjectMappingList[i];
if (src is ExportEntry sourceExport && dest is ExportEntry relinkingExport)
{
relinkReport.AddRange(Relink(sourceExport, relinkingExport, crossPCCObjectMappingList, importExportDependencies, relinkerCache));
}
}
crossPccObjectMap.Clear();
crossPccObjectMap.AddRange(crossPCCObjectMappingList);
return(relinkReport);
}
private static List <EntryStringPair> RelinkToken(Token t, byte[] script, ExportEntry sourceExport, ExportEntry destinationExport,
OrderedMultiValueDictionary <IEntry, IEntry> crossFileRefObjectMap, bool importExportDependencies = false, RelinkerCache relinkerCache = null)
{
var relinkFailedReport = new List <EntryStringPair>();
Debug.WriteLine($"Attempting function relink on token at position {t.pos}. Number of listed relinkable items {t.inPackageReferences.Count}");
foreach ((int pos, int type, int value) in t.inPackageReferences)
{
switch (type)
{
case Token.INPACKAGEREFTYPE_NAME:
int newValue = destinationExport.FileRef.FindNameOrAdd(sourceExport.FileRef.GetNameEntry(value));
Debug.WriteLine($"Function relink hit @ 0x{t.pos + pos:X6}, cross ported a name: {sourceExport.FileRef.GetNameEntry(value)}");
script.OverwriteRange(pos, BitConverter.GetBytes(newValue));
break;
case Token.INPACKAGEREFTYPE_ENTRY:
relinkAtPosition(pos, value, $"(Script at @ 0x{t.pos + pos:X6}: {t.text})");
break;
}
}
return(relinkFailedReport);
void relinkAtPosition(int binaryPosition, int uIndex, string propertyName)
{
var relinkResult = relinkUIndex(sourceExport.FileRef, destinationExport, ref uIndex, propertyName,
crossFileRefObjectMap, "", importExportDependencies, relinkerCache);
if (relinkResult is null)
{
script.OverwriteRange(binaryPosition, BitConverter.GetBytes(uIndex));
}
else
{
relinkFailedReport.Add(relinkResult);
}
}
}
private static List <EntryStringPair> RelinkUnhoodEntryReference(IEntry entry, long position, byte[] script, ExportEntry sourceExport, ExportEntry destinationExport,
OrderedMultiValueDictionary <IEntry, IEntry> crossFileRefObjectMap, bool importExportDependencies = false, RelinkerCache relinkerCache = null)
{
var relinkFailedReport = new List <EntryStringPair>();
Debug.WriteLine($"Attempting function relink on token entry reference {entry.FullPath} at position {position}");
int uIndex = entry.UIndex;
var relinkResult = relinkUIndex(sourceExport.FileRef, destinationExport, ref uIndex, $"Entry {entry.FullPath} at 0x{position:X8}",
crossFileRefObjectMap, "", importExportDependencies, relinkerCache);
if (relinkResult is null)
{
script.OverwriteRange((int)position, BitConverter.GetBytes(uIndex));
}
else
{
relinkFailedReport.Add(relinkResult);
}
return(relinkFailedReport);
}
private static EntryStringPair relinkUIndex(IMEPackage importingPCC, ExportEntry relinkingExport, ref int uIndex, string propertyName,
OrderedMultiValueDictionary <IEntry, IEntry> crossPCCObjectMappingList, string prefix, bool importExportDependencies = false, RelinkerCache relinkerCache = null)
{
if (uIndex == 0)
{
return(null); //do not relink 0
}
IMEPackage destinationPcc = relinkingExport.FileRef;
if (importingPCC == destinationPcc && uIndex < 0)
{
return(null); //do not relink same-pcc imports.
}
int sourceObjReference = uIndex;
//Debug.WriteLine($"{prefix} Relinking:{propertyName}");
if (crossPCCObjectMappingList.TryGetValue(entry => entry.UIndex == sourceObjReference, out IEntry targetEntry))
{
//relink
uIndex = targetEntry.UIndex;
//Debug.WriteLine($"{prefix} Relink hit: {sourceObjReference}{propertyName} : {targetEntry.FullPath}");
}
else if (uIndex < 0) //It's an unmapped import
{
//objProperty is currently pointing to importingPCC as that is where we read the properties from
int n = uIndex;
int origvalue = n;
//Debug.WriteLine("Relink miss, attempting JIT relink on " + n + " " + rootNode.Text);
if (importingPCC.IsImport(n))
{
//Get the original import
ImportEntry origImport = importingPCC.GetImport(n);
string origImportFullName = origImport.FullPath;
//Debug.WriteLine("We should import " + origImport.GetFullPath);
IEntry crossImport = null;
string linkFailedDueToError = null;
try
{
crossImport = EntryImporter.GetOrAddCrossImportOrPackage(origImportFullName, importingPCC, destinationPcc, relinkerCache: relinkerCache);
}
catch (Exception e)
{
//Error during relink
linkFailedDueToError = e.Message;
}
if (crossImport != null)
{
crossPCCObjectMappingList.Add(origImport, crossImport); //add to mapping to speed up future relinks
uIndex = crossImport.UIndex;
// Debug.WriteLine($"Relink hit: Dynamic CrossImport for {origvalue} {importingPCC.GetEntry(origvalue).FullPath} -> {uIndex}");
}
else
{
string path = importingPCC.GetEntry(uIndex) != null?importingPCC.GetEntry(uIndex).FullPath : "Entry not found: " + uIndex;
if (linkFailedDueToError != null)
{
Debug.WriteLine($"Relink failed: CrossImport porting failed for {relinkingExport.ObjectName.Instanced} {relinkingExport.UIndex}: {propertyName} ({uIndex}): {importingPCC.GetEntry(origvalue).FullPath}");
return(new EntryStringPair(relinkingExport, $"Relink failed for {prefix}{propertyName} {uIndex} in export {path}({relinkingExport.UIndex}): {linkFailedDueToError}"));
}
if (destinationPcc.GetEntry(uIndex) != null)
{
Debug.WriteLine($"Relink failed: CrossImport porting failed for {relinkingExport.ObjectName.Instanced} {relinkingExport.UIndex}: {propertyName} ({uIndex}): {importingPCC.GetEntry(origvalue).FullPath}");
return(new EntryStringPair(relinkingExport, $"Relink failed: CrossImport porting failed for {prefix}{propertyName} {uIndex} {destinationPcc.GetEntry(uIndex).FullPath} in export {relinkingExport.FullPath}({relinkingExport.UIndex})"));
}
return(new EntryStringPair(relinkingExport, $"Relink failed: New export does not exist - this is probably a bug in cross import code for {prefix}{propertyName} {uIndex} in export {relinkingExport.FullPath}({relinkingExport.UIndex})"));
}
}
}
else
{
bool importingFromGlobalFile = false;
//It's an export
//Attempt lookup
ExportEntry sourceExport = importingPCC.GetUExport(uIndex);
string instancedFullPath = sourceExport.InstancedFullPath;
string sourceFilePath = sourceExport.FileRef.FilePath;
if (EntryImporter.IsSafeToImportFrom(sourceFilePath, destinationPcc.Game))
{
importingFromGlobalFile = true;
instancedFullPath = $"{Path.GetFileNameWithoutExtension(sourceFilePath)}.{instancedFullPath}";
}
IEntry existingEntry = null;
if (relinkerCache != null)
{
relinkerCache.destInstancedFullPathToEntryMap.TryGetValue(instancedFullPath, out existingEntry);
}
else
{
existingEntry = destinationPcc.Exports.FirstOrDefault(x => x.InstancedFullPath == instancedFullPath);
existingEntry ??= destinationPcc.Imports.FirstOrDefault(x => x.InstancedFullPath == instancedFullPath);
}
if (existingEntry != null)
{
//Debug.WriteLine($"Relink hit [EXPERIMENTAL]: Existing entry in file was found, linking to it: {uIndex} {sourceExport.InstancedFullPath} -> {existingEntry.InstancedFullPath}");
uIndex = existingEntry.UIndex;
}
else if (importExportDependencies)
{
if (importingFromGlobalFile)
{
uIndex = EntryImporter.GetOrAddCrossImportOrPackageFromGlobalFile(sourceExport.FullPath, importingPCC, destinationPcc, crossPCCObjectMappingList, relinkerCache: relinkerCache).UIndex;
}
else
{
if (!crossPCCObjectMappingList.TryGetValue(sourceExport.Parent, out IEntry parent))
{
parent = EntryImporter.GetOrAddCrossImportOrPackage(sourceExport.ParentFullPath, importingPCC, destinationPcc, true, crossPCCObjectMappingList, relinkerCache: relinkerCache);
}
ExportEntry importedExport = EntryImporter.ImportExport(destinationPcc, sourceExport, parent?.UIndex ?? 0, true, crossPCCObjectMappingList, relinkerCache: relinkerCache);
uIndex = importedExport.UIndex;
}
}
else
{
string path = importingPCC.GetEntry(uIndex)?.FullPath ?? $"Entry not found: {uIndex}";
Debug.WriteLine($"Relink failed in {relinkingExport.ObjectName.Instanced} {relinkingExport.UIndex}: {propertyName} {uIndex} {path}");
return(new EntryStringPair(relinkingExport, $"Relink failed: {prefix}{propertyName} {uIndex} in export {relinkingExport.FullPath}({relinkingExport.UIndex})"));
}
}
return(null);
}
private static List <EntryStringPair> relinkPropertiesRecursive(IMEPackage importingPCC, ExportEntry relinkingExport, PropertyCollection transplantProps,
OrderedMultiValueDictionary <IEntry, IEntry> crossPCCObjectMappingList, string prefix,
bool importExportDependencies = false, RelinkerCache relinkerCache = null)
{
var relinkResults = new List <EntryStringPair>();
foreach (Property prop in transplantProps)
{
//Debug.WriteLine($"{prefix} Relink recursive on {prop.Name}");
if (prop is StructProperty structProperty)
{
relinkResults.AddRange(relinkPropertiesRecursive(importingPCC, relinkingExport, structProperty.Properties, crossPCCObjectMappingList,
$"{prefix}{structProperty.Name}.", importExportDependencies, relinkerCache));
}
else if (prop is ArrayProperty <StructProperty> structArrayProp)
{
for (int i = 0; i < structArrayProp.Count; i++)
{
StructProperty arrayStructProperty = structArrayProp[i];
relinkResults.AddRange(relinkPropertiesRecursive(importingPCC, relinkingExport, arrayStructProperty.Properties, crossPCCObjectMappingList,
$"{prefix}{arrayStructProperty.Name}[{i}].", importExportDependencies, relinkerCache));
}
}
else if (prop is ArrayProperty <ObjectProperty> objArrayProp)
{
foreach (ObjectProperty objProperty in objArrayProp)
{
int uIndex = objProperty.Value;
var result = relinkUIndex(importingPCC, relinkingExport, ref uIndex, objProperty.Name, crossPCCObjectMappingList, prefix, importExportDependencies, relinkerCache);
objProperty.Value = uIndex;
if (result != null)
{
relinkResults.Add(result);
}
}
}
else if (prop is ObjectProperty objectProperty)
{
int uIndex = objectProperty.Value;
var result = relinkUIndex(importingPCC, relinkingExport, ref uIndex, objectProperty.Name, crossPCCObjectMappingList, prefix, importExportDependencies, relinkerCache);
objectProperty.Value = uIndex;
if (result != null)
{
relinkResults.Add(result);
}
}
else if (prop is DelegateProperty delegateProp)
{
int uIndex = delegateProp.Value.Object;
var result = relinkUIndex(importingPCC, relinkingExport, ref uIndex, delegateProp.Name, crossPCCObjectMappingList, prefix, importExportDependencies, relinkerCache);
delegateProp.Value = new ScriptDelegate(uIndex, delegateProp.Value.FunctionName);
if (result != null)
{
relinkResults.Add(result);
}
}
}
return(relinkResults);
}