Releases: ischmal/toliss-photon-lighting
Release list
v0.9
ToLiss Photon v0.9
- Now includes overhauled cockpit lighting and light textures by Gus Rodrigues (A319/A320/A321 only)
- Select between Old Halogen, New Halogen, and LED lamp types
- New color-corrected digital displays (i.e. orange-tinted FCU, radios)
- New backlight visual effects on all Display Units, the MCDUs and DCDUs
- Strength can be adjusted or effect can be disabled
- New backlight illumination effect on cockpit
- Strength can be adjusted or effect can be disabled
- New installer with full graphical user interface (using Slint)
- New plugin user interface (using Dear ImGui)
- Adjust or disable effects
- Assess performance impacts of light effects
v0.5
ToLiss Photon v0.5
- All new cross-platform installers. Simply download for your platform, unzip, and run the installer file from your downloads folder.
- New 100% native plugin. XPPython3 is no longer required and can be removed if desired.
- Full support for ToLiss A330-900.
- Full support on A319/A320/A321 for Durantula's Wing Mod (wing-flex + flaps).
- Full support on A319/A320/A321 for RealWings (wings).
- Slightly tweaked strobe and beacon timing on both LED and Xenon versions (special thanks to tuongminh5833).
- Updated automatic light profile detection logic.
What's Changed
New Contributors
Full Changelog: v0.2-beta...v0.5
Contributors
Assets 6
v0.2-beta
Changelog
- Moved all scripting to single Python script (removed Lua).
- Updated A321 lighting (ToLiss A321 v1.8 -> v1.9).
Installation
1. Download and install XPPython3 v4.7
- After installing for the first time, open X-Plane 12 and load into the simulator to complete the first-time install process.
2. Copy the Resources folder into your root X-Plane 12 directory.
- When asked if you want to overwrite existing files, select Yes.
- This installs the Python script that enables light selection and controls beacon/strobe timing.
3. Copy the objects folder for each aircraft into the corresponding X-Plane 12\Aircraft\ToLissA3__V_p_p_ folder.
- When asked if you want to overwrite existing files, select Yes.
4. Reload or relaunch in a supported ToLiss aircraft. A ToLiss Photon configuration sub-menu should now appear in the Plugins menu.
Upgrading
If upgrading from a previous version, you can either manually delete ToLissPhoton.lua or let the new version do it auomatically. Lua is no longer used for this plugin.
v0.1-beta
This is the first beta release of ToLiss Photon version 0.1. ToLiss Photon is a complete overhaul of exterior lighting on ToLiss planes. It currently supports the A319, A320, and A321.
ToLiss Photon
Version 0.1-beta
Overhauled exterior lighting for ToLiss aircraft in X-Plane 12.
Warning
This plugin is in BETA. Stability is not guaranteed as this plugin is actively being tested and worked on. Please use at your own risk.
Supported Aircraft
- ToLiss Airbus A319
- ToLiss Airbus A320 (NEO & CEO)
- ToLiss Airbus A321 (CEO & NEO)
A330-900 support is in progress. A340 support is planned, but I unforunately don't own it.
Installation
1. Download Source code.zip
2. Install Requirements
3. Copy the Resources folder into your root X-Plane 12 directory.
- When asked if you want to overwrite existing files, select Yes.
4. Copy the objects folder for each aircraft into the corresponding X-Plane 12\Aircraft\ToLissA3__V_p_p_ folder.
- When asked if you want to overwrite existing files, select Yes.
5. Open X-Plane and proceed with any first-time install windows.
6. Reload or relaunch in a supported ToLiss aircraft. A ToLiss Photon configuration sub-menu should now appear in the Plugins menu.
Features
- Complete rework of exterior lighting for supported ToLiss aircraft
- Reduced excessive light intensity of default lights
- Realistic red beacon flash behavior
- Improved white strobe flash behavior
- Ability to select between new LED lighting or older halogen/incandescent and Xenon flash-tube lighting
- Optionally change individual lights for a custom lighting configuration
- Instantly adjust lighting options while loaded in the aircraft
- Preferences are saved per aircraft livery
Color Effects
- Halogen lamps emit a visibly warmer color temperature with desaturated navigation lights
- White LEDs present a cool-white appearance while red and green are highly saturated
- The flash-tube beacon trends slightly pink as a result of the bluish Xenon being filtered through the red glass
Improved Beacon and Strobe Flashing
- LED-style beacon blinks realistically instead of fading in and out
- Xenon flash-tubes mimic real-world behavior with instant-on and imperceptible fade-out
- Strobe flash appearance appropriately varies depending on type
Available Light Profiles
- Classic: Full halogen/incandescent lighting with xenon flash-tubes on the strobes and beacons.
- Hybrid LED: LEDs for navigation and anti-collision lights. Halogen/incandescent for illumination. (c. 2015+)
- Full LED: All exterior lights are LED. (c. 2022+)
- Auto: Automatically selects profile based on aircraft equipment.
- Custom: Change each light individually for a custom, mixed configuration:
- Taxi Light: Halogen or LED
- Takeoff Light: Halogen or LED
- Runway Turnoff Lights: Halogen or LED
- Landing Lights: Halogen or LED
- Wing Inspection Lights: Halogen or LED
- Beacon: Xenon or LED
- Strobes: Xenon or LED
- Logo Lights: Halogen or LED
Known Issues
- Nosegear and landing billboard lights on the A321 may still appear as though they're halogen even though they should be LED. This is unfortunately due to ToLiss using an older, less-flexible lighting system for these specific lights. Please report this to ToLiss. As much as I love them, exterior lighting has been a persistent issue for several years now.
About A320 Lighting
The A320 originally used incandescent halogen light bulbs for exterior illumination and navigation lights, and Xenon flash-tubes for both the red beacons and white strobes. The transition to LEDs did not begin until 2015. Initially, only the navigation, beacon and strobe lights were switched to LED. While aftermarket LED bulbs were widely available, Airbus itself did not ship all-LED aircraft until about 2022, corresponding with the launch of the Multifunction Runway Light (MFRL), which merged taxi, takeoff and landing lights into a unified housing on each wing.
For all aircraft manufactured prior to 2022, the actual lighting kits and configurations currently in use vary by operator. Some have retrofitted their fleets to all-LED, some still only use halogen and Xenon flash-tubes, but most are mixed. For that reason, this plugin supports per-light customization.
While LED illumination lights can be readily identified by their cool-white color temperature, Xenon flash-tube strobes can be harder to spot. In general, the red beacon and white tail strobe will remain lit for 0.1s if they are LED. When powered by a conventional Xenon flash-tube, then the flashing is essentially instantaneous. Seen on video during the day, Xenon lights are often flashing too fast to be consistently captured by the camera.
About
I created an emergency lighting system for Garry's Mod called Photon and have extensive experience working with lighting effects in 3D engines.
This project initially began as an attempt to correct the unrealistic fade-in/fade-out appearance of the beacon light. The scope significantly expanded the more I learned about how X-Plane lighting effects work. The light colors, appearance, and behavior were painsakingly adjusted by hand. I then leveraged Claude Code to implement much of the coding and add quality-of-life functionality.
Photon
This plugin is a Photon project. Join the (Photon Community Discord)[http://photon.lighting/discord] and see the #x-plane channel.
How it Works
Light positioning, color and intensity is hard-coded in plain-text .OBJ aircraft files. X-Plane uses two major types of light: "billboards" and "spill lights". Billboards are 2D sprites that give a light source its on-screen glow, while spill lights are what actually illuminate surrounding objects in the 3D environment.
To make billboard lights convincing, they need to have a defined direction. When the camera directly faces them, the light is at its most intense appearance. As the camera pans around away from the light, the intensity drops and eventually the light disappears entirely. Many of the default ToLiss billboard lights skip that second step, which is why they are often visible from all 360 degrees, and it is the primary reason for their low-quality appearance.
ToLiss Photon modifies every single light in the .OBJ and specifies a light direction for everything except the upper and lower beacons (as they are truly visible from 360 degrees). It also uses custom DataRefs to offer a different appearance for halogen/Xenon lights and LED lights.
The strobe and beacon flashing is controlled using a Lua script. The script has a function that executes every frame and overrides specific DataRefs set by ToLiss that control light intensity for both the beacon and the strobe. By default, ToLiss uses a sine wave (or similar equation) to control the brightness of the beacon, which means it smoothly fades in and out. While this kind of fading can occur with halogen bulbs as they quickly warm and cool, the beacon is not halogen. It's either a Xenon flash-tube or LED. Neither option produces anything like the perceptible fade-in/fade-out you see.
Components
- Aircraft .obj files: Modifies light colors, positioning, and appearance.
- Lua (via FlyWithLua): Controls beacon and flash behavior.
- Python (via XPPython3): Used for the GUI, Plugins sub-menu, and profile saving/loading.
- I would have preferred to just use Lua, but FlyWithLua cannot create usable DataRefs for the .obj files nor can it create a sub-menu in Plugins.
Other Recommended Mods
- KOSP Project for audio
- GusRodrigues' A320 Family Light Mod (A319, A320, A321) for additional lighting improvements
- These mods also optionally provide improved exterior lighting. They have a different artistic direction compared to ToLiss Photon and are a good alternative if yu decide you don't like this mod.
o
- These mods also optionally provide improved exterior lighting. They have a different artistic direction compared to ToLiss Photon and are a good alternative if yu decide you don't like this mod.
Credits
The original .obj lighting files were authored by ToLiss Simulations. Scripting was crafted with the assistance of Claude Code (Sonnet 5 and Opus 4.8).
The file you're currently reading was still 100% written by me (schmal), a real human.
Contact
While I am a full-time 911 dispatcher, I specialize in lighting work just like this with over a decade of experience. Have a commercial project you think I could help with? Reach out at (contact@schmal.me)[contact@schmal.me].
Disclaimer
This project is an independent third-party modification and is not affiliated with ToLiss Simulations Solutions Inc.
Usage
ToLiss Photon is licensed under an MIT License. If you've discovered this addon and see that it's been years since I've updated it or fixed any bugs, feel free to fork it, fix it, and reupload it yourself.