/utils

A bunch of utilities for ProTanki.

Primary LanguageJavaScriptMIT LicenseMIT

ProTanki Utilities

A bunch of utilities for ProTanki.

Patch-Library-LegacySocket.ps1

PowerShell script that patches library.swf (http://s2.protanki-online.com/library.swf) to use game and resource server configuration from Prelauncher.swf.
Requires JPEXS Free Flash Decompiler to be installed.
The minimum supported game version is library-20220501-221826.

Argument Type Description Default value
InputFile string Game SWF to patch
OutputFile string Patched SWF file
FFDec string Path to ffdec.jar file C:\Program Files (x86)\FFDec\ffdec.jar

Example usage (PowerShell):

./Patch-Library-LegacySocket -InputFile 'library-original.swf' -OutputFile 'library.swf'

# Use custom ffdec.jar
./Patch-Library-LegacySocket -InputFile 'library-original.swf' -OutputFile 'library.swf' -FFDec 'ffdec.jar'

Patch-Prelauncher-Local.ps1

PowerShell script that patches Prelauncher.swf (http://s2.protanki-online.com/Prelauncher.swf) to use custom loader, game library, game and resource server configuration.
Requires JPEXS Free Flash Decompiler to be installed.

Argument Type Description Default value
InputFile string Prelauncher SWF to patch
OutputFile string Patched SWF file
FFDec string Path to ffdec.jar file C:\Program Files (x86)\FFDec\ffdec.jar
ConfigFile string? Path / URL to the configuration file socket.cfg

Example configuration file:

{
  "ip": "127.0.0.1",
  "port": 1337,
  "loader": "Loader.swf",
  "library": "library.swf",
  "resources": "http://127.0.0.1:8080/resource"
}

Example usage (PowerShell):

# Default configuration file (socket.cfg)
./Patch-Prelauncher-Local -InputFile 'Prelauncher-original.swf' -OutputFile 'Prelauncher.swf'

# Local configuration file
./Patch-Prelauncher-Local -InputFile 'Prelauncher-original.swf' -OutputFile 'Prelauncher.swf' -ConfigFile 'my-config.json'

# Configuration file on the remote server
./Patch-Prelauncher-Local -InputFile 'Prelauncher-original.swf' -OutputFile 'Prelauncher.swf' -ConfigFile 'http://127.0.0.1/socket.cfg'

# Use custom ffdec.jar
./Patch-Prelauncher-Local -InputFile 'Prelauncher-original.swf' -OutputFile 'Prelauncher.swf' -FFDec 'ffdec.jar'

Patch-Library-PacketLog.ps1

PowerShell script that patches library.swf (http://s2.protanki-online.com/library.swf) to log network packets into a file.
Requires JPEXS Free Flash Decompiler to be installed.

Argument Type Description Default value
InputFile string Game SWF to patch
OutputFile string Patched SWF file
FFDec string Path to ffdec.jar file C:\Program Files (x86)\FFDec\ffdec.jar
LogFile string Path to log file (in the Desktop directory) packets.txt

Example usage (PowerShell):

./Patch-Library-PacketLog -InputFile 'library-original.swf' -OutputFile 'library.swf'

# Custom log file
./Patch-Library-PacketLog -InputFile 'library-original.swf' -OutputFile 'library.swf' -LogFile 'commands.txt'

# Use custom ffdec.jar
./Patch-Library-PacketLog -InputFile 'library-original.swf' -OutputFile 'library.swf' -FFDec 'ffdec.jar'

Patch-Library-Socket.ps1

PowerShell script that patches library.swf (http://s2.protanki-online.com/library.swf) to use custom game and/or resource server.
Requires JPEXS Free Flash Decompiler to be installed.
The minimum supported game version is library-20220501-221826.

Argument Type Description Default value
InputFile string Game SWF to patch
OutputFile string Patched SWF file
FFDec string Path to ffdec.jar file C:\Program Files (x86)\FFDec\ffdec.jar
GameServer string? Game server endpoint in IP:port format (e.g. 127.0.0.1:1337)
ResourceServer string? Resource server URL (e.g. http://127.0.0.1:8080/resource)

Example usage (PowerShell):

# Change game server
./Patch-Library-Socket -InputFile 'library-original.swf' -OutputFile 'library.swf' -GameServer '127.0.0.1:1337'

# Change resource server
./Patch-Library-Socket -InputFile 'library-original.swf' -OutputFile 'library.swf' -ResourceServer 'http://127.0.0.1:8080/resource'

# Change both game and resource server
./Patch-Library-Socket -InputFile 'library-original.swf' -OutputFile 'library.swf' -GameServer '127.0.0.1:1337' -ResourceServer 'http://127.0.0.1:8080/resource'

# Use custom ffdec.jar
./Patch-Library-Socket -InputFile 'library-original.swf' -OutputFile 'library.swf' -FFDec 'ffdec.jar' -GameServer '127.0.0.1:1337'

packet-log.patch.txt

Patch (manual applying via JPEXS Free Flash Decompiler) to log incoming and outgoing game packets.
Log file is located at $Desktop/packets.txt.

packet2map.js

Converts battle join packets to the server map file (data/maps/$name/$theme.json).

Input format:

{"resources":[...]}
{"resources":[...]}
{"resources":[...]}
{"kick_period_ms":125000,"map_id":...}

Alternative input format:

[...]
[...]
[...]
{"kick_period_ms":125000,"map_id":...}

Example usage (PowerShell):

Get-Content battle.txt | node ./packet2map.js | Set-Content map.json

strip-packets.js

Extracts resource and battle model init packets from dump.

Example usage (PowerShell):

Get-Content battle.txt | node ./strip-packets.js | node ./packet2map.js | Set-Content map.json