Lighthouse

Product Introduction

1. Definition: Lighthouse is a free, open-source game engine specifically designed for building 3D games and interactive experiences. It is a technical port and reimplementation of the engine powering the classic Nintendo 64 game Banjo-Kazooie.
2. Core Value Proposition: Lighthouse exists to solve the problem of complex, proprietary game engines by providing a high-performance, accessible, and moddable alternative for indie developers, hobbyists, and educators. Its primary value lies in its open-source nature, enabling deep customization and learning.

Main Features

1. Multi-Platform & Multi-Backend Rendering: Lighthouse supports Windows, Linux, and macOS. It features a modular graphics backend system, allowing users to switch between DirectX 11 (Windows), OpenGL (cross-platform), and Metal (macOS) APIs for optimal performance and compatibility on different hardware.
2. Advanced Asset Pipeline & Modding Support: The engine uses a custom .o2r/.otr archive format for packaging game assets. It features an in-game tool to generate these archives from original game ROMs. Crucially, it has built-in support for mods, language packs, and romhacks, allowing users to load custom assets and game modifications directly through a menu interface.
3. Extensive Input Configuration: Lighthouse ships with a comprehensive default controller mapping profile. It includes a built-in input mapper within its Settings menu, allowing for deep customization of keyboard, gamepad, and other controller bindings to suit any user's preference or hardware.
4. Preservation & Enhancement Features: As a decompilation-based project, Lighthouse acts as a game preservation tool. It enhances the original experience with modern quality-of-life features, including high-resolution rendering, customizable controls, and the ability to integrate community-created content and fixes.

Problems Solved

1. Pain Point: The high cost, licensing complexity, and closed-source nature of mainstream commercial game engines like Unity and Unreal Engine create barriers for hobbyists, students, and indie developers.
2. Target Audience: The primary user personas are indie game developers seeking a lightweight engine, retro gaming enthusiasts and modders interested in Banjo-Kazooie, computer science students studying game engine architecture, and preservationists focused on classic Nintendo 64 games.
3. Use Cases: Essential scenarios include: developing new 3D games or experiences using a proven N64-era engine architecture; creating and testing romhacks or custom mods for Banjo-Kazooie; using the source code as an educational reference for low-level graphics and game programming; and playing the classic game with modern enhancements on current PC hardware.

Unique Advantages

1. Differentiation: Unlike monolithic engines like Godot or Unity, Lighthouse is a focused, single-game engine rebuilt from the ground up via reverse engineering. It offers unparalleled authenticity for modding the specific game it's based on, while being far more accessible and performant than attempting to modify the original closed-source ROM directly.
2. Key Innovation: The core innovation is the complete decompilation and clean-room reimplementation of a commercial Nintendo 64 game into portable, readable C++ code. This process enables native execution on modern systems, native high-resolution rendering, and a fully open codebase that can be studied, debugged, and extended in ways impossible with the original binary.

Frequently Asked Questions (FAQ)

1. Is Lighthouse a standalone game engine or does it require the original game? Lighthouse is a standalone game engine, but it requires you to legally provide your own copy (ROM) of Banjo-Kazooie to generate the necessary asset files (bk.o2r). The engine itself is free and open-source, but the game assets are not included.
2. What are the system requirements for running the Lighthouse game engine? Requirements are modest, as the engine is optimized. It requires a 64-bit Windows, Linux, or macOS system with a graphics card supporting DirectX 11, OpenGL 3.3, or Metal. Specific needs vary based on the chosen graphics backend and desired rendering resolution.
3. Can I create my own games with the Lighthouse engine, or is it only for Banjo-Kazooie? While its primary and most stable use case is running and modding Banjo-Kazooie, the engine is a general-purpose 3D game engine. Technically, you can create new games with it, but it lacks the extensive toolsets and documentation of broader engines like Godot, making it more suitable for experienced developers or educational projects.
4. How do I add mods or custom textures to Lighthouse? Custom assets are packaged in .o2r or .otr files. You place these files in the mods folder within the Lighthouse directory. The engine will automatically load them. Tools like retro (OTR generator) and fast64 (Blender plugin) are used by the community to create these mod packs.
5. What is the difference between an .o2r file and an .otr file in Lighthouse? Both are archive formats for game assets. .o2r is the newer format used by Lighthouse and related projects. .otr is the legacy format from the earlier Ship of Harkinian (Zelda OOT) project. Lighthouse supports both for compatibility with existing mods from the broader decompilation community.