From 4eeb9964566e07bffaf1d357203594ddbe899689 Mon Sep 17 00:00:00 2001
From: Pyogenics <82675800+Pyogenics@users.noreply.github.com>
Date: Thu, 5 Mar 2026 21:42:41 +0000
Subject: [PATCH] Added python arc packing tool

---
 scripts/pack_arc.py | 93 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 93 insertions(+)
 create mode 100644 scripts/pack_arc.py

diff --git a/scripts/pack_arc.py b/scripts/pack_arc.py
new file mode 100644
index 000000000..16d0c20a4
--- /dev/null
+++ b/scripts/pack_arc.py
@@ -0,0 +1,93 @@
+'''
+Copyright (c) 2026 Pyogenics
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+'''
+
+'''
+Simple tool to pack arc files from a target folder
+--------------------------------------------------
+Usage: pack_arc.py path/to/target/files path/to/output.arc
+'''
+
+from sys import argv
+from glob import glob
+from struct import pack
+from dataclasses import dataclass
+
+
+@dataclass
+class FileMetaData:
+    name: str
+    size: int
+    data: bytes
+
+
+def pack_stream(format, stream, *data):
+    packedData = pack(format, *data)
+    stream.write(packedData)
+
+
+def write_string(string, stream):
+    string = string.encode("utf-8")
+    pack_stream(">H", stream, len(string))
+    stream.write(string)
+
+
+target_dir = argv[1]
+output_file_path = argv[2]
+target_file_paths = glob(f"{target_dir}/*")
+
+# Read our target files
+target_files = []
+for target_path in target_file_paths:
+    with open(target_path, "rb") as file: 
+        file_data = file.read()
+        meta_data = FileMetaData(
+            target_path,
+            len(file_data),
+            file_data
+        )
+        target_files.append(meta_data)
+
+# Compute header size so we can later calculate file offsets when writing the header
+header_size = 4 # Start at 4 to include file count field
+for file_meta in target_files:
+    header_size += 2 # File name string length
+    header_size += len(file_meta.name) # File name
+    header_size += 4 # Offset
+    header_size += 4 # File size
+
+# Write arc data
+current_file_offset = header_size
+with open(output_file_path, "wb") as arc_file:
+    # File count
+    pack_stream(">I", arc_file, len(target_files))
+
+    # Write file entries
+    for file_meta in target_files:
+        write_string(file_meta.name, arc_file)
+        pack_stream(">2I", arc_file,
+            current_file_offset,
+            file_meta.size
+        )
+        current_file_offset += file_meta.size
+    # Write file data
+    for file_meta in target_files:
+        arc_file.write(file_meta.data)
\ No newline at end of file