Code RED

Code RED is a read-first RDR resource workbench. The current safe launch path is:

Code_RED.bat

Python fallback:

py -3 main.py

Decompile / recompile capability check:

Run_CodeRED_Decompile_Recompile_Hub.bat --validate

RPF edit lab / inventory entry point:

Run_CodeRED_RPF_Edit_Lab.bat

Launch rules

Code_RED.bat is the Windows source launcher.
main.py is the canonical Python app entry point.
run_workbench.py is compatibility only.
code_red_main.py is the conservative stable shell/fallback.
python_workbench.py contains the larger research/workbench implementation and script/toolchain lanes.
Do not launch project files, helper captures, generated reports, or archived test data as the app entry point.

Archive rules

RPF archives are first-class game archives and are scanned read-only.
ZIP files are treated as package/transport archives only.
Split ZIP fragments such as .z01 through .z09 are tracked as fragments, not game archives.
Archive mutation/write-back stays staged to copied archives unless a validated backend is attached.
Use tools/codered_rpf_utils.py for RPF inventory/extract and tools/codered_rpf_utils_patch.py for patch-folder apply to copied archives.

Script safety rules

.wsc, .xsc, and .sco stay routed to the Scripts lane.
The stable shell inventories script entries found inside RPF archives without compiling or mutating them.
Source compile is routed through script_compiling/sccl/.
Existing compiled .wsc/.csc/.xsc/.sco bytecode-to-source decompile is not proven yet; Code RED exports readable/pseudo-decompile reports until a real decompiler is available.

Repository hygiene

Keep raw game data, generated reports, local imports, copied RPFs, build folders, logs, and packaged ZIP/RAR/7Z outputs out of Git. Use imports/, game/, logs/, and local drop folders at runtime, but do not commit their contents.

Research and log index

Use docs/research_index/README.md as the current organized map for logs, research notes, readmes, handoffs, milestones, and AI-readable manifests. The index intentionally points to original files instead of moving root logs/ outputs, because many tools use fixed report paths there.

Name		Name	Last commit message	Last commit date
Latest commit History 537 Commits
.github/workflows		.github/workflows
.vs		.vs
.vscode		.vscode
Code_RED_Make_Ready_Event_Modded_Files_v1		Code_RED_Make_Ready_Event_Modded_Files_v1
Code_RED_ReadyEventTests_v1/ready_to_test		Code_RED_ReadyEventTests_v1/ready_to_test
SC-CL-master		SC-CL-master
Settings		Settings
asi/CodeREDVehicleBridge		asi/CodeREDVehicleBridge
asi_source		asi_source
codered_app		codered_app
codered_wsc		codered_wsc
config		config
configs		configs
data		data
docs		docs
experimental_patch		experimental_patch
inspector_report		inspector_report
logs		logs
patches		patches
public_tests		public_tests
recipes		recipes
related_apps		related_apps
reports		reports
research		research
resources/SC-CL_DROP_HERE		resources/SC-CL_DROP_HERE
samples		samples
scratch		scratch
script_compiling		script_compiling
test_workspace		test_workspace
tests		tests
tools		tools
validation		validation
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
CodeRED_AI_Menu.obj		CodeRED_AI_Menu.obj
Code_RED.bat		Code_RED.bat
Code_RED_Dependency_Installer.bat		Code_RED_Dependency_Installer.bat
Code_RED_Dependency_Installer.ps1		Code_RED_Dependency_Installer.ps1
Code_RED_Dependency_Installer.py		Code_RED_Dependency_Installer.py
Double_Click_CodeRED_Ambush_CarTruck_WSC.bat		Double_Click_CodeRED_Ambush_CarTruck_WSC.bat
Double_Click_CodeRED_ArmPopulation_MicroTests.bat		Double_Click_CodeRED_ArmPopulation_MicroTests.bat
Double_Click_CodeRED_Car1194_WagonThief_WSC.bat		Double_Click_CodeRED_Car1194_WagonThief_WSC.bat
Double_Click_CodeRED_DynamiteTransport_CarTruck_WSC.bat		Double_Click_CodeRED_DynamiteTransport_CarTruck_WSC.bat
Double_Click_CodeRED_EscortTransport_CarOnly_WSC.bat		Double_Click_CodeRED_EscortTransport_CarOnly_WSC.bat
Double_Click_CodeRED_RDR1_Resource_Lab.bat		Double_Click_CodeRED_RDR1_Resource_Lab.bat
Double_Click_CodeRED_Roadside_Robbery_CarTruck_WSC.bat		Double_Click_CodeRED_Roadside_Robbery_CarTruck_WSC.bat
Double_Click_CodeRED_Vehicle_Script_Lab.bat		Double_Click_CodeRED_Vehicle_Script_Lab.bat
Double_Click_CodeRED_WSC_Bounds_Probe.bat		Double_Click_CodeRED_WSC_Bounds_Probe.bat
Double_Click_CodeRED_WSC_Vehicle_Replacer.bat		Double_Click_CodeRED_WSC_Vehicle_Replacer.bat
Double_Click_CodeRED_WagonThief_CarTruck_WSC.bat		Double_Click_CodeRED_WagonThief_CarTruck_WSC.bat
FEATURE_AUDIT.md		FEATURE_AUDIT.md
MAINTENANCE.md		MAINTENANCE.md
MASTER_REPORT.json		MASTER_REPORT.json
README.md		README.md
README_CODERED_WSC_TOOLS.md		README_CODERED_WSC_TOOLS.md
README_START_HERE.md		README_START_HERE.md
README_WORKING_EVENT_SEAT_CONTROL_TESTS.md		README_WORKING_EVENT_SEAT_CONTROL_TESTS.md
Run_CodeRED_Ambush_CarTruck_WSC.bat		Run_CodeRED_Ambush_CarTruck_WSC.bat
Run_CodeRED_ArmPopulation_MicroTests.bat		Run_CodeRED_ArmPopulation_MicroTests.bat
Run_CodeRED_Car1194_WagonThief_WSC.bat		Run_CodeRED_Car1194_WagonThief_WSC.bat
Run_CodeRED_Content_RPF_DeepScan.bat		Run_CodeRED_Content_RPF_DeepScan.bat
Run_CodeRED_Decompile_Recompile_Hub.bat		Run_CodeRED_Decompile_Recompile_Hub.bat
Run_CodeRED_DynamiteTransport_CarTruck_WSC.bat		Run_CodeRED_DynamiteTransport_CarTruck_WSC.bat
Run_CodeRED_EscortTransport_CarOnly_WSC.bat		Run_CodeRED_EscortTransport_CarOnly_WSC.bat
Run_CodeRED_Faction_Wars.bat		Run_CodeRED_Faction_Wars.bat
Run_CodeRED_Faction_Wars_Refresh_And_Scan.bat		Run_CodeRED_Faction_Wars_Refresh_And_Scan.bat
Run_CodeRED_Menu_Workshop.bat		Run_CodeRED_Menu_Workshop.bat
Run_CodeRED_Navres_BattleSet_Scan.bat		Run_CodeRED_Navres_BattleSet_Scan.bat
Run_CodeRED_RDR1_Resource_Lab.bat		Run_CodeRED_RDR1_Resource_Lab.bat
Run_CodeRED_RPF_Edit_Lab.bat		Run_CodeRED_RPF_Edit_Lab.bat
Run_CodeRED_Roadside_Robbery_CarTruck_WSC.bat		Run_CodeRED_Roadside_Robbery_CarTruck_WSC.bat
Run_CodeRED_Short_Update_Seat_Unlocker.bat		Run_CodeRED_Short_Update_Seat_Unlocker.bat
Run_CodeRED_Vehicle_Script_Lab.bat		Run_CodeRED_Vehicle_Script_Lab.bat
Run_CodeRED_WSC_Bounds_Probe.bat		Run_CodeRED_WSC_Bounds_Probe.bat
Run_CodeRED_WSC_Direct_ID_Patcher.bat		Run_CodeRED_WSC_Direct_ID_Patcher.bat
Run_CodeRED_WSC_Edit_Workflow.bat		Run_CodeRED_WSC_Edit_Workflow.bat
Run_CodeRED_WSC_Vehicle_Replacer.bat		Run_CodeRED_WSC_Vehicle_Replacer.bat
Run_CodeRED_WagonThief_CarTruck_WSC.bat		Run_CodeRED_WagonThief_CarTruck_WSC.bat
Run_CodeRED_Working_Event_Seat_Control_Tests.bat		Run_CodeRED_Working_Event_Seat_Control_Tests.bat
SCRIPTING.md		SCRIPTING.md
SC_CL_SORT_MANIFEST.json		SC_CL_SORT_MANIFEST.json
code_red_main.py		code_red_main.py
install_ambush_cartruck_wsc_deps.bat		install_ambush_cartruck_wsc_deps.bat
install_arm_population_microtest_deps.bat		install_arm_population_microtest_deps.bat
install_content_rpf_deep_scan_deps.bat		install_content_rpf_deep_scan_deps.bat
install_dynamite_transport_cartruck_wsc_deps.bat		install_dynamite_transport_cartruck_wsc_deps.bat
install_escort_transport_caronly_wsc_deps.bat		install_escort_transport_caronly_wsc_deps.bat
install_optional_rdr1_resource_lab_deps.bat		install_optional_rdr1_resource_lab_deps.bat
install_roadside_robbery_cartruck_wsc_deps.bat		install_roadside_robbery_cartruck_wsc_deps.bat
install_runtime.bat		install_runtime.bat
install_short_update_seat_unlock_deps.bat		install_short_update_seat_unlock_deps.bat
install_wsc_bounds_probe_deps.bat		install_wsc_bounds_probe_deps.bat
install_wsc_direct_id_deps.bat		install_wsc_direct_id_deps.bat
install_wsc_direct_id_patcher_deps.bat		install_wsc_direct_id_patcher_deps.bat
install_wsc_patch_deps.bat		install_wsc_patch_deps.bat
install_wsc_vehicle_replacer_deps.bat		install_wsc_vehicle_replacer_deps.bat
launch_code_red.py		launch_code_red.py
main.py		main.py
morningstar_blackwater_windows.csv		morningstar_blackwater_windows.csv

Navigation Menu

Repository files navigation

Code RED

Launch rules

Archive rules

Script safety rules

Repository hygiene

Research and log index

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

Code RED

Launch rules

Archive rules

Script safety rules

Repository hygiene

Research and log index

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages