WASM Python integration milestone - game.py runs in browser

Major milestone for issue #158 (Emscripten/WebAssembly build target):
- Python 3.14 successfully initializes and runs in WASM
- mcrfpy module loads and works correctly
- Game scripts execute with full level generation
- Entities (boulders, rats, cyclops, spawn points) placed correctly

Key changes:
- CMakeLists.txt: Add 2MB stack, Emscripten link options, preload files
- platform.h: Add WASM-specific implementations for executable paths
- HeadlessTypes.h: Make Texture/Font/Sound stubs return success
- CommandLineParser.cpp: Guard filesystem operations for WASM
- McRFPy_API.cpp: Add WASM path configuration, debug output
- game.py: Make 'code' module import optional (not available in WASM)
- wasm_stdlib/: Add minimal Python stdlib for WASM (~4MB)

Build with: emmake make (from build-emscripten/)
Test with: node mcrogueface.js

Next steps:
- Integrate VRSFML for actual WebGL rendering
- Create HTML page to host WASM build
- Test in actual browsers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
John McCardle 2026-01-31 05:15:11 -05:00
commit 8c3128e29c
222 changed files with 80639 additions and 25 deletions

View file

@ -11,11 +11,13 @@ CommandLineParser::ParseResult CommandLineParser::parse(McRogueFaceConfig& confi
current_arg = 1; // Reset for each parse
// Detect if running as Python interpreter
#ifndef __EMSCRIPTEN__
std::filesystem::path exec_name = std::filesystem::path(argv[0]).filename();
if (exec_name.string().find("python") == 0) {
config.headless = true;
config.python_mode = true;
}
#endif
while (current_arg < argc) {
std::string arg = argv[current_arg];

View file

@ -698,32 +698,64 @@ PyObject* PyInit_mcrfpy()
// init_python - configure interpreter details here
PyStatus init_python(const char *program_name)
{
std::cerr << "[DEBUG] api_init: starting" << std::endl;
std::cerr.flush();
PyStatus status;
//**preconfig to establish locale**
//**preconfig to establish locale**
PyPreConfig preconfig;
PyPreConfig_InitIsolatedConfig(&preconfig);
preconfig.utf8_mode = 1;
std::cerr << "[DEBUG] api_init: Py_PreInitialize" << std::endl;
std::cerr.flush();
status = Py_PreInitialize(&preconfig);
if (PyStatus_Exception(status)) {
Py_ExitStatusException(status);
std::cerr << "[DEBUG] api_init: PreInit failed" << std::endl;
Py_ExitStatusException(status);
}
std::cerr << "[DEBUG] api_init: PyConfig setup" << std::endl;
std::cerr.flush();
PyConfig config;
PyConfig_InitIsolatedConfig(&config);
config.dev_mode = 0;
config.dev_mode = 0;
// Configure UTF-8 for stdio
PyConfig_SetString(&config, &config.stdio_encoding, L"UTF-8");
PyConfig_SetString(&config, &config.stdio_errors, L"surrogateescape");
config.configure_c_stdio = 1;
#ifdef __EMSCRIPTEN__
std::cerr << "[DEBUG] api_init: WASM path config" << std::endl;
std::cerr.flush();
// WASM: Use absolute paths in virtual filesystem
PyConfig_SetString(&config, &config.executable, L"/mcrogueface");
PyConfig_SetString(&config, &config.home, L"/lib/python3.14");
status = PyConfig_SetBytesString(&config, &config.program_name, "mcrogueface");
// Set up module search paths for WASM
config.module_search_paths_set = 1;
const wchar_t* wasm_paths[] = {
L"/scripts",
L"/lib/python3.14"
};
for (auto s : wasm_paths) {
status = PyWideStringList_Append(&config.module_search_paths, s);
if (PyStatus_Exception(status)) {
continue;
}
}
#else
// Set sys.executable to the McRogueFace binary path
auto exe_filename = executable_filename();
PyConfig_SetString(&config, &config.executable, exe_filename.c_str());
PyConfig_SetBytesString(&config, &config.home,
PyConfig_SetBytesString(&config, &config.home,
narrow_string(executable_path() + L"/lib/Python").c_str());
status = PyConfig_SetBytesString(&config, &config.program_name,
@ -770,6 +802,7 @@ PyStatus init_python(const char *program_name)
}
}
#endif
#endif // __EMSCRIPTEN__
status = Py_InitializeFromConfig(&config);
@ -780,11 +813,18 @@ PyStatus init_python(const char *program_name)
PyStatus McRFPy_API::init_python_with_config(const McRogueFaceConfig& config)
{
std::cerr << "[DEBUG] init_python_with_config: starting" << std::endl;
std::cerr.flush();
// If Python is already initialized, just return success
if (Py_IsInitialized()) {
std::cerr << "[DEBUG] init_python_with_config: already initialized" << std::endl;
return PyStatus_Ok();
}
std::cerr << "[DEBUG] init_python_with_config: PyConfig_InitIsolatedConfig" << std::endl;
std::cerr.flush();
PyStatus status;
PyConfig pyconfig;
PyConfig_InitIsolatedConfig(&pyconfig);
@ -849,7 +889,10 @@ PyStatus McRFPy_API::init_python_with_config(const McRogueFaceConfig& config)
return status;
}
// Set Python home to our bundled Python
#ifndef __EMSCRIPTEN__
// Check if we're in a virtual environment (symlinked into a venv)
// Skip for WASM builds - no filesystem access like this
auto exe_wpath = executable_filename();
auto exe_path_fs = std::filesystem::path(exe_wpath);
auto exe_dir = exe_path_fs.parent_path();
@ -880,8 +923,24 @@ PyStatus McRFPy_API::init_python_with_config(const McRogueFaceConfig& config)
pyconfig.module_search_paths_set = 1;
}
}
#endif // !__EMSCRIPTEN__
#ifdef __EMSCRIPTEN__
// WASM: Use absolute paths in virtual filesystem
PyConfig_SetString(&pyconfig, &pyconfig.home, L"/lib/python3.14");
// Set Python home to our bundled Python
// Set up module search paths for WASM
pyconfig.module_search_paths_set = 1;
const wchar_t* wasm_paths[] = {
L"/scripts",
L"/lib/python3.14"
};
for (auto s : wasm_paths) {
status = PyWideStringList_Append(&pyconfig.module_search_paths, s);
if (PyStatus_Exception(status)) {
continue;
}
}
#else
auto python_home = executable_path() + L"/lib/Python";
PyConfig_SetString(&pyconfig, &pyconfig.home, python_home.c_str());
@ -907,6 +966,7 @@ PyStatus McRFPy_API::init_python_with_config(const McRogueFaceConfig& config)
}
}
#endif
#endif // __EMSCRIPTEN__
// Register mcrfpy module before initialization
PyImport_AppendInittab("mcrfpy", &PyInit_mcrfpy);
@ -988,26 +1048,39 @@ void McRFPy_API::api_init(const McRogueFaceConfig& config) {
void McRFPy_API::executeScript(std::string filename)
{
std::string script_path_str;
#ifdef __EMSCRIPTEN__
// WASM: Scripts are at /scripts/ in virtual filesystem
if (filename.find('/') == std::string::npos) {
// Simple filename - look in /scripts/
script_path_str = "/scripts/" + filename;
} else {
script_path_str = filename;
}
#else
std::filesystem::path script_path(filename);
// If the path is relative and the file doesn't exist, try resolving it relative to the executable
if (script_path.is_relative() && !std::filesystem::exists(script_path)) {
// Get the directory where the executable is located using platform-specific function
std::wstring exe_dir_w = executable_path();
std::filesystem::path exe_dir(exe_dir_w);
// Try the script path relative to the executable directory
std::filesystem::path resolved_path = exe_dir / script_path;
if (std::filesystem::exists(resolved_path)) {
script_path = resolved_path;
}
}
script_path_str = script_path.string();
#endif
// Use std::ifstream + PyRun_SimpleString instead of PyRun_SimpleFile
// PyRun_SimpleFile has compatibility issues with MinGW-compiled code
std::ifstream file(script_path);
std::ifstream file(script_path_str);
if (!file.is_open()) {
std::cout << "Failed to open script: " << script_path.string() << std::endl;
std::cout << "Failed to open script: " << script_path_str << std::endl;
return;
}
@ -1018,7 +1091,7 @@ void McRFPy_API::executeScript(std::string filename)
// Set __file__ before execution
PyObject* main_module = PyImport_AddModule("__main__");
PyObject* main_dict = PyModule_GetDict(main_module);
PyObject* py_filename = PyUnicode_FromString(script_path.string().c_str());
PyObject* py_filename = PyUnicode_FromString(script_path_str.c_str());
PyDict_SetItemString(main_dict, "__file__", py_filename);
Py_DECREF(py_filename);

View file

@ -493,8 +493,16 @@ class Texture {
public:
Texture() = default;
bool create(unsigned int width, unsigned int height) { size_ = Vector2u(width, height); return true; }
bool loadFromFile(const std::string& filename) { return false; }
bool loadFromMemory(const void* data, size_t size) { return false; }
// In headless mode, pretend texture loading succeeded with dummy dimensions
// This allows game scripts to run without actual graphics
bool loadFromFile(const std::string& filename) {
size_ = Vector2u(256, 256); // Default size for headless textures
return true;
}
bool loadFromMemory(const void* data, size_t size) {
size_ = Vector2u(256, 256);
return true;
}
Vector2u getSize() const { return size_; }
void setSmooth(bool smooth) {}
bool isSmooth() const { return false; }
@ -545,8 +553,9 @@ public:
};
Font() = default;
bool loadFromFile(const std::string& filename) { return false; }
bool loadFromMemory(const void* data, size_t sizeInBytes) { return false; }
// In headless mode, pretend font loading succeeded
bool loadFromFile(const std::string& filename) { return true; }
bool loadFromMemory(const void* data, size_t sizeInBytes) { return true; }
const Info& getInfo() const { static Info info; return info; }
};
@ -723,8 +732,9 @@ public:
class SoundBuffer {
public:
SoundBuffer() = default;
bool loadFromFile(const std::string& filename) { return false; }
bool loadFromMemory(const void* data, size_t sizeInBytes) { return false; }
// In headless mode, pretend sound loading succeeded
bool loadFromFile(const std::string& filename) { return true; }
bool loadFromMemory(const void* data, size_t sizeInBytes) { return true; }
Time getDuration() const { return Time(); }
};
@ -752,7 +762,8 @@ public:
enum Status { Stopped, Paused, Playing };
Music() = default;
bool openFromFile(const std::string& filename) { return false; }
// In headless mode, pretend music loading succeeded
bool openFromFile(const std::string& filename) { return true; }
void play() {}
void pause() {}

View file

@ -1,5 +1,8 @@
import mcrfpy
import code
try:
import code
except ImportError:
code = None # Interactive console not available in WASM
#t = mcrfpy.Texture("assets/kenney_tinydungeon.png", 16, 16) # 12, 11)
t = mcrfpy.Texture("assets/kenney_TD_MR_IP.png", 16, 16) # 12, 11)
@ -326,7 +329,8 @@ class Crypt:
d = None
if state == "end": return
elif key == "Grave":
code.InteractiveConsole(locals=globals()).interact()
if code: # Only available in native builds, not WASM
code.InteractiveConsole(locals=globals()).interact()
return
elif key == "Z":
self.player.do_zap()