This is a custom client launcher for the MMORPG TERA that interfaces directly with the client. It's re-implementing the protocol used by the Tl.exe and the EME launcher.
It's main purpose serves as the launcher when using the custom server implementation Almetica.
Visual Studio 2019 Community Edition+. Written in .NET Core C#.
This is a standard .NET Core project. The single file executable creation is enabled by default, so you should use a publish executable. The 32bit client of TERA needs a 32bit launcher. The 64bit client of TERA will need a 64bit launcher later on.
The builds that we distribute are self contained.
Configure the launcher with the help of the provided configuration file (Configuration.json).
You need to set at least the address of the server and may optionally set the standard username and password to use (for development).
Possible values for the language are:
- EUR = English with the EU client
- USA = English with the US client
- FRA = French with the EU client
- GER = German with the EU client
Copy the following file into the client folder (the folder with the Binares, Engine and S1Game folder as well as the version.txt/ini file):
- AlmeticaLauncher.exe
The file is including all dependencies.
The game needs to be launched by the launcher as a child process. The launcher needs to have a window with the window title "LAUNCHER_WINDOW" and window class "LAUNCHER_CLASS". The client checks these conditions and won't start otherwise.
The launcher communicates with the game using Windows Messages (SendMessage
/ WNDPROC
).
The data is passed with the help of the WM_COPYDATA (0x4A) message. The payload is referenced with
the lpData
parameter as a COPYDATASTRUCT
. The dwData
field contains the event ID
used by the game (game event).
A game event equal or over 1000 signals a special event inside the game that is mostly informational and the launcher is not required to handle them in any special way (except sending an 0x1 reply).
Game events for example are:
- 1000: Game started
- 1001: Game loaded
- 1003: Server selection
- 1004: Character selection
- 1020: Game terminates
- ...
The game events lower than 10 are required to be handled by the launcher stalling the request and
NOT sending a reply of 0x1 right away. While stalling the request, the launcher is required to send
the expected data using SendMessage
. The game expects to find the data in it's message queue
when returning from it's SendMessage
function (it's code is synchronous). Events that need
to be handled are:
The launcher needs to reply with a WM_COPY
message with it's dwData field set with 2.
The payload (lpData
) needs to be an UTF-16 encoded string without null termination containing
the account name.
The launcher needs to reply with a WM_COPY
message with it's dwData field set with 4.
The payload (lpData
) needs to be an byte array containing the token.
The launcher needs to reply with a WM_COPY
message with it's dwData field set with 6.
The payload (lpData
) needs to be a protocol buffer (version 2) containins a list with the
servers that should be shown in the server selection screen. For a field description have a look
at the protocol buffer file provided with this repository. You can use protocol buffer version 3
if you make sure that fields of 0 value are serialized. The developers of protocol buffer broke
backward compatability with legacy applications by not supporting required fields anymore. You can
change the generated protocol buffer code manually to send the 0 value fields anyhow.
The TERA client tries to connect to a named pipe when starting. The launcher can create the TERA
client in suspended mode, create the expected named pipe and then resume the main thread of the
TERA client to get it connected to the pipe. This is needed, since the pipe name contains the PID
of the TERA client. The pipe name is: \\.\pipe\$PIDcout
.
The exact function of the pipe is yet unknown
Licensed under GPL version 3.
The GNU General Public License is often called the GNU GPL for short; it is used by most GNU programs, and by more than half of all free software packages. The latest version is version 3.