Compare commits

..

5 Commits
1.1 ... main

Author SHA1 Message Date
njohnson
a398878aaa Fixed stuff. 2026-01-21 01:38:33 -05:00
njohnson
628d8a3c05 Fixed packing/unpacking localization files. 2026-01-21 00:47:04 -05:00
njohnson
bfd5d68f5b Adjust help screen. 2026-01-20 17:20:39 -05:00
njohnson
5cdd08e5d6 Made the app name dynamic. 2026-01-20 17:13:07 -05:00
njohnson
91b043929c Renamed to udk-manip. 2026-01-20 16:14:46 -05:00
4 changed files with 115 additions and 82 deletions

View File

@ -1,6 +1,6 @@
# udk-config-extractor
# udk-manip
A command-line tool for extracting and repacking UDK/UE3 coalesced config and localization files.
A command-line tool for manipulating UDK/UE3 coalesced config and localization files.
Tested with Army of Two: The 40th Day (Xbox 360).
@ -27,11 +27,11 @@ Tested with Army of Two: The 40th Day (Xbox 360).
## Usage
```
udk-config-extractor list <file> - List archive contents
udk-config-extractor unpack <file> [output_dir] - Extract all files
udk-config-extractor pack <input_dir> <output_file> - Create coalesced file
udk-config-extractor info <file> - Show archive info
udk-config-extractor extract <file> <index> [output] - Extract single file
udk-manip list <file> - List archive contents
udk-manip unpack <file> [output_dir] - Extract all files
udk-manip pack <input_dir> <output_file> - Create coalesced file
udk-manip info <file> - Show archive info
udk-manip extract <file> <index> [output] - Extract single file
```
### Drag & Drop
@ -46,7 +46,7 @@ udk-config-extractor extract <file> <index> [output] - Extract single file
Requires Qt 6 and a C++17 compiler.
```bash
qmake udk-config-extractor.pro
qmake udk-manip.pro
make
```

View File

@ -48,53 +48,32 @@ bool CoalescedFile::load(const QString& path)
m_isCoalesced = true;
m_loadedPath = path;
// Parse the coalesced format
const char* ptr = data.constData();
const char* end = ptr + data.size();
QDataStream stream(data);
stream.setByteOrder(QDataStream::BigEndian);
// Read version (big-endian)
if (ptr + 4 > end) {
setError("Unexpected end of file reading header");
return false;
}
quint32 entryCount;
stream >> entryCount;
m_version = qFromBigEndian<quint32>(reinterpret_cast<const uchar*>(ptr));
ptr += 4;
entryCount /= 2;
// Read entries until EOF
while (ptr + 4 <= end) {
quint32 filenameLen = qFromBigEndian<quint32>(reinterpret_cast<const uchar*>(ptr));
ptr += 4;
// Sanity check filename length - 0 or very large means we've hit end of entries
for (uint i = 0; i < entryCount; i++)
{
quint32 filenameLen;
stream >> filenameLen;
if (filenameLen == 0 || filenameLen > 1024) {
break;
}
// Read filename
if (ptr + filenameLen > end) {
break;
}
QByteArray filename(filenameLen - 1, Qt::Uninitialized);
stream.readRawData(filename.data(), filenameLen - 1);
stream.skipRawData(1);
// Filename includes null terminator
QString filename = QString::fromLatin1(ptr, filenameLen > 0 ? filenameLen - 1 : 0);
ptr += filenameLen;
quint32 contentLen;
stream >> contentLen;
// Read content length
if (ptr + 4 > end) {
break;
}
quint32 contentLen = qFromBigEndian<quint32>(reinterpret_cast<const uchar*>(ptr));
ptr += 4;
// Read content
if (ptr + contentLen > end) {
break;
}
QByteArray content(ptr, contentLen);
ptr += contentLen;
QByteArray content(contentLen - 1, Qt::Uninitialized);
stream.readRawData(content.data(), contentLen - 1);
stream.skipRawData(1);
IniEntry entry;
entry.filename = filename;
@ -116,10 +95,11 @@ bool CoalescedFile::save(const QString& path) const
stream.setByteOrder(QDataStream::BigEndian);
// Write version
stream << m_version;
stream << (quint32)m_entries.size() * 2;
// Write each entry
for (const IniEntry& entry : m_entries) {
for (uint i = 0; i < m_entries.size(); i++) {
const IniEntry& entry = m_entries.at(i);
// Convert filename to Latin1 with null terminator
QByteArray filenameBytes = entry.filename.toLatin1();
filenameBytes.append('\0');
@ -131,7 +111,7 @@ bool CoalescedFile::save(const QString& path) const
stream.writeRawData(filenameBytes.constData(), filenameBytes.size());
// Write content length
stream << static_cast<quint32>(entry.content.size());
stream << static_cast<quint32>(entry.content.size() + 1);
// Write content
stream.writeRawData(entry.content.constData(), entry.content.size());
@ -237,10 +217,38 @@ bool CoalescedFile::packDirectory(const QString& dirPath, const QString& basePat
filters << "*.ini" << "*.int" << "*.jpn" << "*.deu" << "*.esn"
<< "*.fra" << "*.ita" << "*.kor" << "*.pol" << "*.rus"
<< "*.cze" << "*.hun" << "*.esm" << "*.ptb";
QDirIterator it(dirPath, filters, QDir::Files, QDirIterator::Subdirectories);
while (it.hasNext()) {
QString filePath = it.next();
int entryCount = 0;
QDirIterator entryIt(dirPath, filters, QDir::Files, QDirIterator::Subdirectories);
while (entryIt.hasNext())
{
entryIt.next();
entryCount++;
}
// Read temp file for entry records
QFile tempFile(dirPath + "/temp");
if (!tempFile.open(QIODevice::ReadOnly))
{
setError(QString("Failed to open temp file: %1").arg(tempFile.errorString()));
return 1;
}
// Parse filenames
QStringList entryStrings;
for (int i = 0; i < entryCount; i++)
{
QByteArray entryStr(64, Qt::Uninitialized);
qint64 lineLen = tempFile.readLine(entryStr.data(), 64);
entryStrings.push_back(entryStr.mid(0, lineLen - 1));
}
tempFile.close();
for (int i = 0; i < entryStrings.size(); i++)
{
QString entryString = entryStrings.at(i);
const QString& filePath = dirPath + entryString.replace("..", "");
QFile file(filePath);
if (!file.open(QIODevice::ReadOnly)) {

View File

@ -17,22 +17,22 @@ void printError(const QString& message)
void showUsage()
{
cout << "UDK Config Extractor v1.1\n";
cout << "Extract and pack UDK/UE3 coalesced INI/INT files\n\n";
cout << QString("UDK Config/Localization Manipulator %1\n").arg(QCoreApplication::applicationVersion());
cout << "Extract and pack UDK/UE3 coalesced Config/Localization files\n\n";
cout << "Usage:\n";
cout << " udk-config-extractor <command> [arguments]\n\n";
cout << QString(" %1 <command> [arguments]\n\n").arg(QCoreApplication::applicationName());
cout << "Commands:\n";
cout << " list <file> List files in archive\n";
cout << " info <file> Show archive metadata\n";
cout << " unpack <file> [output_dir] Extract all INI files\n";
cout << " pack <input_dir> <output_file> Pack directory into coalesced file\n";
cout << " extract <file> <index|name> [output] Extract single file\n\n";
cout << " list <file> List files in archive\n";
cout << " info <file> Show archive metadata\n";
cout << " unpack <file> [output_dir] Extract all INI files\n";
cout << " pack <input_dir> <output_file> Pack directory into coalesced file\n";
cout << " extract <file> <index|name> [output] Extract single file\n\n";
cout << "Options:\n";
cout << " -h, --help Show this help message\n";
cout << " -v, --version Show version\n\n";
cout << " -h, --help Show this help message\n";
cout << " -v, --version Show version\n\n";
cout << "Drag & Drop:\n";
cout << " Drag a coalesced file onto exe Extracts to ./<name>_<ext>/\n";
cout << " Drag a folder onto exe Packs to ./<name>.<ext>\n";
cout << " Drag a coalesced file onto exe Extracts to ./<name>_<ext>/\n";
cout << " Drag a folder onto exe Packs to ./<name>.<ext>\n";
cout << " (folder coalesced_ini -> coalesced.ini)\n";
cout.flush();
}
@ -40,7 +40,7 @@ void showUsage()
int cmdList(const QStringList& args)
{
if (args.isEmpty()) {
printError("Usage: udk-config-extractor list <file>");
printError(QString("Usage: %1 list <file>").arg(QCoreApplication::applicationName()));
return 1;
}
@ -78,7 +78,7 @@ int cmdList(const QStringList& args)
int cmdInfo(const QStringList& args)
{
if (args.isEmpty()) {
printError("Usage: udk-config-extractor info <file>");
printError(QString("Usage: %1 info <file>").arg(QCoreApplication::applicationName()));
return 1;
}
@ -120,28 +120,34 @@ int cmdInfo(const QStringList& args)
int cmdUnpack(const QStringList& args)
{
if (args.isEmpty()) {
printError("Usage: udk-config-extractor unpack <file> [output_dir]");
if (args.isEmpty())
{
printError(QString("Usage: %1 unpack <file> [output_dir]").arg(QCoreApplication::applicationName()));
return 1;
}
CoalescedFile coalesced;
if (!coalesced.load(args[0])) {
if (!coalesced.load(args[0]))
{
printError(coalesced.lastError());
return 1;
}
QString outputDir;
if (args.size() > 1) {
if (args.size() > 1)
{
outputDir = args[1];
} else {
}
else
{
// Default: use filename with _ instead of . (e.g., coalesced.ini -> coalesced_ini)
QFileInfo fi(args[0]);
outputDir = fi.completeBaseName() + "_" + fi.suffix();
}
QDir dir(outputDir);
if (!dir.exists() && !dir.mkpath(".")) {
if (!dir.exists() && !dir.mkpath("."))
{
printError(QString("Cannot create output directory: %1").arg(outputDir));
return 1;
}
@ -149,11 +155,28 @@ int cmdUnpack(const QStringList& args)
int extracted = 0;
qint64 totalBytes = 0;
for (const IniEntry& entry : coalesced.entries()) {
QFile tempFile(outputDir + "/temp");
if (!tempFile.open(QIODevice::WriteOnly))
{
printError(QString("Failed to open temp file: %1").arg(tempFile.errorString()));
return 1;
}
for (int i = 0; i < coalesced.entries().size(); i++)
{
QString entryStr(coalesced.entries().at(i).filename + "\n");
tempFile.write(entryStr.toUtf8());
}
tempFile.close();
for (int i = 0; i < coalesced.entries().size(); i++)
{
const IniEntry& entry = coalesced.entries().at(i);
QString localPath = entry.filename;
// Remove leading ".." components for safety
while (localPath.startsWith("..\\") || localPath.startsWith("../")) {
while (localPath.startsWith("..\\") || localPath.startsWith("../"))
{
localPath = localPath.mid(3);
}
localPath.replace('\\', '/');
@ -161,13 +184,15 @@ int cmdUnpack(const QStringList& args)
QString fullPath = dir.filePath(localPath);
QFileInfo fi(fullPath);
if (!fi.dir().exists() && !QDir().mkpath(fi.path())) {
if (!fi.dir().exists() && !QDir().mkpath(fi.path()))
{
printError(QString("Cannot create directory: %1").arg(fi.path()));
continue;
}
QFile file(fullPath);
if (!file.open(QIODevice::WriteOnly)) {
if (!file.open(QIODevice::WriteOnly))
{
printError(QString("Cannot write file: %1").arg(fullPath));
continue;
}
@ -190,7 +215,7 @@ int cmdUnpack(const QStringList& args)
int cmdPack(const QStringList& args)
{
if (args.size() < 2) {
printError("Usage: udk-config-extractor pack <input_dir> <output_file>");
printError(QString("Usage: %1 pack <input_dir> <output_file>").arg(QCoreApplication::applicationName()));
return 1;
}
@ -216,7 +241,7 @@ int cmdPack(const QStringList& args)
int cmdExtract(const QStringList& args)
{
if (args.size() < 2) {
printError("Usage: udk-config-extractor extract <file> <index|name> [output]");
printError(QString("Usage: %1 extract <file> <index|name> [output]").arg(QCoreApplication::applicationName()));
return 1;
}
@ -273,8 +298,8 @@ int cmdExtract(const QStringList& args)
int main(int argc, char *argv[])
{
QCoreApplication app(argc, argv);
QCoreApplication::setApplicationName("udk-config-extractor");
QCoreApplication::setApplicationVersion("1.1");
QCoreApplication::setApplicationName("udk-manip");
QCoreApplication::setApplicationVersion("1.2");
QStringList args = app.arguments();
args.removeFirst(); // Remove program name
@ -292,7 +317,7 @@ int main(int argc, char *argv[])
}
if (cmd == "-v" || cmd == "--version" || cmd == "version") {
cout << QString("udk-config-extractor %1\n").arg(QCoreApplication::applicationVersion());
cout << QString("%1 %2\n").arg(QCoreApplication::applicationVersion()).arg(QCoreApplication::applicationName());
cout.flush();
return 0;
}

View File

@ -5,7 +5,7 @@ TEMPLATE = app
CONFIG += console c++17
CONFIG -= app_bundle
TARGET = udk-config-extractor
TARGET = udk-manip
SOURCES += \
main.cpp \