GFXFileManager — Original Clean Source

Original clean source release of GFXFileManager, a C++/Win32 replacement-style file manager for Silkroad Online clients that work with PK2 archive files.

This repository is intended as a clean, readable source-code base for development, research, and maintenance around PK2-backed file loading.

Repository description

Original clean source of GFXFileManager for PK2-based file handling.

Features

• PK2-backed file loading support.
• File-manager interface compatible with the original client-side usage pattern.
• Local filesystem fallback logic for development workflows.
• Debug logging disabled by default for a clean public release.
• Visual Studio solution/project files included.
• Documentation and example screenshots included under doc/.

Project structure

.
├── doc/                         Documentation and screenshots
├── src/                         Main C++ source code
│   ├── pk2/                     PK2 reader and crypto-related helpers
│   ├── CPFileManager.*          PK2/physical file manager implementation
│   ├── CWFileManager.*          Write/container-side file manager implementation
│   ├── IFileManager.*           Interface definitions
│   └── debug.*                  Debug logging controls
├── export.def                   DLL export definitions
├── GFXFileManager.sln           Visual Studio solution
├── GFXFileManager.vcxproj       Visual Studio C++ project
└── .gitignore                   Visual Studio/C++ ignore rules

Build

The project includes the original Visual Studio solution and project files.

Recommended starting point:

1. Open GFXFileManager.sln in Visual Studio.
2. Build the Win32 configuration.
3. The output should be GFXFileManager.dll.
4. Place the compiled DLL where your target client expects the file manager DLL.

Note: This source was originally structured around older Visual Studio project settings. Newer Visual Studio versions may require project retargeting.

Usage notes

• This repository contains source code only.
• PK2 archives, game client files, and compiled binaries are not included.
• Debug output is disabled by default in src/debug.cpp.
• The implementation is intended as a clean base for PK2 loading and further development.

Documentation

Additional notes are available in:

• doc/Using-IFileManager.md
• doc/interface-example-file-listing.md

Clean release notes

This public version has been prepared as a clean source release:

• No generated build output committed.
• No Visual Studio user/cache files committed.
• No PK2 archives or client assets committed.
• No runtime debug log file generation by default.
• Password values are not printed in container debug messages.

GitHub topics

Suggested repository topics:

gfxfilemanager pk2 silkroad-online sro cplusplus win32 visual-studio dll file-manager archive-reader

License

No license file is included yet. Add a license before accepting external contributions or reusing the source in other projects.