|
|
(8 intermediate revisions by 3 users not shown) |
Line 1: |
Line 1: |
| Author: Leon
| | UCC is a command line utility for early Unreal engine games. Star Wars: Republic Commando ships without one, but a custom one has been made available as a result of reverse engineering. |
|
| |
|
| Used Tools: [[MS Visual Studio 2003]] | | Description: A custom UCC.exe for Republic Commando. Used for executing Unreal Commandlets. |
|
| |
|
| Description: A self written UCC for Republic Commando. Used for executing Unreal Commandlets.
| | Latest Build: [https://github.com/SWRC-Modding/CT/releases here] |
|
| |
|
| Github: [https://github.com/Leon280698/Republic-Commando-UCC here]
| |
|
| |
|
| Latest Build: [http://www.moddb.com/games/star-wars-republic-commando/downloads/star-wars-republic-commando-ucc-exe here]
| | [[File:Uccshow.PNG]] |
|
| |
|
| | ===== Batchexport Commandlet ===== |
|
| |
|
| ==UCC.cpp==
| | The batchexport commandlet is made available by UCC. This commandlet can parse the game's resource archives in order to export any exportable type in bulk. Here is the syntax for converting some texture package, called "exampletexturepackage.utx" from the game into a set of tga files in ExampleOutputFolder: |
|
| |
|
| <source lang="cpp" line"> | | '''<sup>./ucc.exe batchexport exampletexturepackage.utx texture tga ".\\ExampleOutputFolder"</sup>''' |
| /* | |
| * This is a custom UCC.exe for Star Wars Republic Commando since the game shipped without one.
| |
| * Everything compiles fine with Visual Studio .NET 2003 which is being used to achieve maximum compatibility
| |
| * since it was also used to compile RC
| |
| * The following settings are required in order to compile everything without errors:
| |
| * - Character Set = Not Set //Important as RC does not use unicode
| |
| * - Struct Member Alignment = 4 Bytes //Probably not necessary, but just in case...
| |
| * - Calling Convention = __fastcall //RC uses __fastcall as default calling convention
| |
| */
| |
|
| |
|
| #include <cstdio>
| | In particular, UCC can extract batches of sounds from the UAX archives where Republic Commando's voice lines and sound effects are stored. The batchexport commandlet does this. See [[Extract_Game_Audio_Using_UCC|how to extract game audio using UCC]] for details. |
| | |
| #include "../../Engine/Inc/Engine.h" //Core and Engine
| |
| | |
| #include "../../Core/Inc/FOutputDeviceFile.h"
| |
| FOutputDeviceFile Log;
| |
| | |
| #include "../../Core/Inc/FOutputDeviceWindowsError.h" //Error handling using message boxes which is just nicer than having everything in the console
| |
| FOutputDeviceWindowsError Error;
| |
| | |
| #include "../../Core/Inc/FFeedbackContextAnsi.h"
| |
| FFeedbackContextAnsi Warn;
| |
| | |
| #include "../../Core/Inc/FConfigCacheIni.h"
| |
| | |
| //Variables for ServerCommandlet
| |
| | |
| FString CurrentCmd; //Contains the next command that is to be passed to UEngine::Exec gathered by the input thread
| |
| //the command is then executed by the main thread to avoid issues
| |
| | |
| /*
| |
| * Allows user input in the console while running a server
| |
| * This function runs in a separate thread in order to not having
| |
| * to pause the main loop while waiting for input
| |
| */
| |
| DWORD WINAPI UpdateServerConsoleInput(PVOID){
| |
| TCHAR Cmd[1024];
| |
| | |
| while(GIsRunning && !GIsRequestingExit){
| |
| if(std::fgets(Cmd, sizeof(Cmd), stdin)){
| |
| Cmd[appStrlen(Cmd) - 1] = '\0'; //Removing newline added by fgets
| |
| CurrentCmd = Cmd; //Updating CurrentCmd so that it can be executed by the main thread
| |
| //Nothing has been done in terms of thread safety as so far there haven't been any issues...
| |
| | |
| //Returning in case user requested exit in order to not get to fgets again
| |
| if(CurrentCmd == "EXIT" || CurrentCmd == "QUIT")
| |
| return 0;
| |
| }
| |
| }
| |
| | |
| return 0;
| |
| }
| |
| | |
| /*
| |
| * Replacement for UServerCommandlet::Main since the one from Engine.dll crashes because it doesn't assign a value to GEngine
| |
| */
| |
| void UServerCommandletMain(){
| |
| FString Language;
| |
| | |
| if(GConfig->GetString("Engine.Engine", "Language", Language, "System.ini"))
| |
| UObject::SetLanguage(*Language);
| |
| | |
| UClass* EngineClass = LoadClass<UEngine>(NULL, "ini:Engine.Engine.GameEngine", NULL, LOAD_NoFail, NULL);
| |
| | |
| //Literally the only reason for this function to be rewritten
| |
| //The original one doesn't assign a value to GEngine which leads to a gpf...
| |
| GEngine = ConstructObject<UEngine>(EngineClass);
| |
| | |
| GEngine->Init();
| |
| | |
| //Creating input thread
| |
| CreateThread(NULL, 0, UpdateServerConsoleInput, NULL, 0, NULL);
| |
| | |
| double OldTime = appSeconds();
| |
| | |
| GIsRunning = 1;
| |
| | |
| //Main loop
| |
| while(GIsRunning && !GIsRequestingExit){
| |
| double NewTime = appSeconds();
| |
| | |
| //Executing console commands that are gathered by UpdateServerConsoleInput in a different thread
| |
| if(CurrentCmd.Len() > 0){
| |
| GEngine->Exec(*CurrentCmd, Warn);
| |
| CurrentCmd.Empty();
| |
| }
| |
| | |
| //Update the world
| |
| GEngine->Tick(NewTime - OldTime);
| |
| OldTime = NewTime;
| |
| | |
| //Enforce optional maximum tick rate
| |
| float MaxTickRate = GEngine->GetMaxTickRate();
| |
| | |
| if(MaxTickRate > 0.0f){
| |
| float Delta = (1.0f / MaxTickRate) - (appSeconds() - OldTime);
| |
| | |
| appSleep(Delta > 0.0f ? Delta : 0.0f);
| |
| }
| |
| }
| |
| | |
| GIsRunning = 0;
| |
| }
| |
| | |
| void ShowBanner(){
| |
| Warn.Log("=======================================");
| |
| Warn.Log("ucc.exe for Star Wars Republic Commando");
| |
| Warn.Log("made by Leon0628");
| |
| Warn.Log("=======================================\n");
| |
| }
| |
| | |
| | |
| int main(int argc, char** argv){
| |
| try{
| |
| GIsStarted = 1;
| |
| GIsGuarded = 1;
| |
| | |
| FString CmdLine;
| |
| | |
| for(int i = 1; i < argc; i++)
| |
| CmdLine += FString(argv[i]) + " ";
| |
| | |
| appInit("SWRepublicCommando", *CmdLine, &Log, &Error, &Warn, FConfigCacheIni::Factory, 1);
| |
| UObject::SetLanguage("int");
| |
| | |
| if(argc > 1){
| |
| //Initializing global state
| |
| GIsUCC = GIsClient = GIsServer = GIsEditor = GIsScriptable = GLazyLoad = 1;
| |
| | |
| FString ClassName = argv[1];
| |
| TArray<FRegistryObjectInfo> List;
| |
| | |
| UObject::GetRegistryObjects(List, UClass::StaticClass(), UCommandlet::StaticClass(), 0); //Loading list of commandlets declared in .int files
| |
| | |
| for(int i = 0; i < List.Num(); i++){ //Looking Token up in list and autocompleting class name if found
| |
| FString Str = List[i].Object;
| |
| | |
| if(ClassName == Str || ClassName + "Commandlet" == Str){ //Checking against "PackageName.ClassName (+ Commandlet)"
| |
| ClassName = List[i].Object;
| |
| | |
| break;
| |
| }
| |
| | |
| while(Str.InStr(".") >= 0) //Removing package name so that only class name remains
| |
| Str = Str.Mid(Str.InStr(".") + 1);
| |
| | |
| if(ClassName == Str || ClassName + "Commandlet" == Str){ //Checking against "ClassName (+ Commandlet)" and adding "PackageName"
| |
| ClassName = List[i].Object;
| |
| | |
| break;
| |
| }
| |
| }
| |
| | |
| DWORD LoadFlags = LOAD_NoWarn | LOAD_Quiet;
| |
| | |
| if(ClassName == "Editor.MakeCommandlet")
| |
| LoadFlags |= LOAD_DisallowFiles;
| |
| | |
| UClass* Class = LoadClass<UCommandlet>(NULL, *ClassName, NULL, LoadFlags, NULL);
| |
| | |
| if(!Class) //If class failed to load appending "Commandlet" and trying again
| |
| Class = LoadClass<UCommandlet>(NULL, *(ClassName + "Commandlet"), NULL, LoadFlags, NULL);
| |
| | |
| if(Class){
| |
| UCommandlet* Commandlet = ConstructObject<UCommandlet>(Class);
| |
| UCommandlet* Default = static_cast<UCommandlet*>(Class->GetDefaultObject());
| |
| | |
| if(Default->ShowBanner)
| |
| ShowBanner();
| |
| | |
| Warn.Logf("Executing %s\n", Class->GetFullName());
| |
| | |
| GIsClient = Default->IsClient;
| |
| GIsEditor = Default->IsEditor;
| |
| GIsServer = Default->IsServer;
| |
| GLazyLoad = Default->LazyLoad;
| |
| | |
| //Contains only the command-line options that are passed to the commandlet to avoid problems with some commandlets
| |
| FString CommandletCmdLine;
| |
| | |
| for(int i = 2; i < argc; i++)
| |
| CommandletCmdLine += FString(argv[i]) + " ";
| |
| | |
| Commandlet->InitExecution();
| |
| Commandlet->ParseParms(*CommandletCmdLine);
| |
| | |
| if(Default->LogToStdout){ //Redirecting commandlet output to console
| |
| Warn.AuxOut = GLog;
| |
| GLog = &Warn;
| |
| }
| |
|
| |
| if(ClassName == "Engine.ServerCommandlet")
| |
| UServerCommandletMain(); //The ServerCommandlet has a special Main function
| |
| else
| |
| Commandlet->Main(CommandletCmdLine);
| |
| | |
| if(Default->ShowErrorCount)
| |
| Warn.Logf("\n%s - %i error(s), %i warning(s)", Warn.ErrorCount == 0 ? "Success" : "Failure", Warn.ErrorCount, Warn.WarningCount);
| |
| | |
| if(Default->LogToStdout){
| |
| Warn.AuxOut = NULL;
| |
| GLog = &Log;
| |
| }
| |
| }else{
| |
| ShowBanner();
| |
| Warn.Logf("Commandlet %s not found", argv[1]);
| |
| }
| |
| }else{
| |
| ShowBanner();
| |
| Warn.Log("Usage:");
| |
| Warn.Log(" ucc CommandletName <parameters>");
| |
| }
| |
| | |
| appPreExit();
| |
| | |
| GIsGuarded = 0;
| |
| }catch(...){
| |
| GIsGuarded = 0;
| |
| GLog = &Log;
| |
| Error.HandleError();
| |
| }
| |
| | |
| appExit();
| |
| }
| |
| </source>
| |