Headlights

---

🇬🇧 English

About

Headlights Fullbright attaches two headlight beams to your character's head and lets you flip on full‑bright vision with a single keypress. The beams follow your head's rotation, get cut off by solid blocks, and are visible to everyone else on the server — so people will always know when your lights are on.

Minecraft	1.21.1
Mod loader	NeoForge 21.1.244+
Java	21
Mod ID	headlights_fullbright
Side	Client & server (required on both)
Author	peacefull02 (aka softboundless)

Features

• 🔦 Two head-mounted beams that track your head's yaw and pitch in real time
• 💡 One-key fullbright — loaded chunks within your configured render distance light up for you when the headlights go on
• 🗺️ Render-distance coverage — the fullbright window automatically follows your render-distance setting and current chunk
• ⛰️ Full-height lighting — selected chunk columns are illuminated from the dimension's minimum height to its maximum height
• 🌗 Smooth edge fade — the outer 32 blocks fade through the available light levels instead of ending at a hard chunk border
• 🌐 Fully synced in multiplayer — everyone else sees your beams and knows when they're on
• 👁️ First-person friendly — hidden in your own first-person view, visible in third-person and to other players
• 🧱 Realistic blocking — beams stop at solid blocks, but shine through water, glass, and fog
• ⌨️ Rebindable keybind — defaults to H, changeable in the controls menu
• 🕶️ Shader-oriented compatibility — includes an optional Sodium/Iris lighting path; Complementary and BSL are the primary test targets

How It Works

• Turning your headlights on enables fullbright for you only — nobody else's brightness changes, they just see your beams.
• Turning them off disables both at once.
• Your headlight state survives death, damage, and teleporting (including dimension changes) — it only resets to off when you reconnect to the world or server.
• Each beam starts near the middle of your head, reaches up to 16 blocks, and fades smoothly to transparent along its length. It's a purely visual effect — no actual light is placed on blocks.

Fullbright Area

• The area is a square X/Z chunk window like the client's loading window, not a three-dimensional sphere.
• Its radius matches your configured render distance: 8 chunks covers the current chunk plus 8 chunks in every horizontal direction, 16 covers 16, and so on.
• Every selected chunk column is illuminated over the complete build height of the current dimension, including caves, terrain, mountains, and structures above the surface.
• The outer 32 blocks gradually fade through artificial light levels 1–15. Natural block and sky light are never reduced.
• Crossing a chunk border moves the window and rebuilds only columns whose lighting changed. Changing the render-distance setting updates the area automatically.
• Newly received chunks are compiled with the current fullbright level. If a server sends fewer chunks than the client setting requests, absent chunks cannot be illuminated.
• Entities use the same horizontal area and edge fade as blocks.

Freecam Compatibility

Headlights Fullbright optionally integrates with Freecam Spectator — it's not a hard dependency, the mod works fine without it installed. When Freecam's spectator mode is active, both the headlight beams and the fullbright window follow the free-floating spectator head instead of staying on your original, frozen body.

Shader Compatibility

The mod includes an optional Sodium/Iris chunk-lighting path. Complementary and BSL are the primary shader-pack targets, but the current development profile does not include Sodium/Iris or those shader packs, so the new render-distance gradient still needs an in-game compatibility pass with them.

License

This project is licensed under the Softboundless Mod License 1.0.

Modification, redistribution, forks, ports, and modpack usage are generally permitted. However, use in third-party Minecraft modpacks using the Freakland name is restricted.

See LICENSE for the full terms.

Credits

Created by peacefull02 (aka softboundless).

---

🇷🇺 Русский

О проекте

Headlights Fullbright добавляет персонажу две фары на голове и позволяет включать полное освещение (Fullbright) одним нажатием клавиши. Лучи поворачиваются вместе с головой, обрезаются сплошными блоками и видны всем остальным игрокам на сервере — так что все будут знать, включены ли у вас фары.

Minecraft	1.21.1
Загрузчик	NeoForge 21.1.244+
Java	21
Mod ID	headlights_fullbright
Сторона	Клиент и сервер (обязателен на обеих)
Автор	peacefull02 (он же softboundless)

Возможности

• 🔦 Две фары на голове, в реальном времени следующие за yaw/pitch головы
• 💡 Fullbright по той же клавише — загруженные чанки в пределах вашей дальности прорисовки освещаются именно для вас
• 🗺️ Область по дальности прорисовки — окно Fullbright автоматически следует за настройкой дальности и текущим чанком
• ⛰️ Освещение на всю высоту — выбранные колонки чанков освещаются от минимальной до максимальной высоты измерения
• 🌗 Плавное затухание по краям — во внешних 32 блоках яркость постепенно снижается без резкой границы чанка
• 🌐 Полная синхронизация в мультиплеере — остальные видят лучи и понимают, включены ли фары
• 👁️ Не мешает от первого лица — в первом лице лучи скрыты, но видны от третьего лица и другим игрокам
• 🧱 Реалистичное перекрытие — лучи обрезаются сплошными блоками, но проходят сквозь воду, стекло и туман
• ⌨️ Переназначаемая клавиша — по умолчанию H, меняется в настройках управления
• 🕶️ Совместимость с шейдерами — предусмотрен опциональный путь Sodium/Iris; Complementary и BSL являются основными целями тестирования

Как это работает

• Включение фар активирует Fullbright только у вас — ни на кого другого это не влияет, остальные просто видят ваши лучи.
• Выключение фар одновременно отключает и то, и другое.
• Состояние фар сохраняется при смерти, получении урона и телепортации (в том числе между измерениями) — сбрасывается оно только при переподключении к миру или серверу.
• Каждый луч начинается примерно от середины головы, тянется до 16 блоков и плавно затухает в прозрачность к концу. Это чисто визуальный эффект — фары не расставляют настоящий свет на блоках.

Область Fullbright

• Область представляет собой квадратное окно чанков по X/Z, как клиентское окно загрузки, а не трёхмерную сферу.
• Радиус совпадает с установленной дальностью прорисовки: значение 8 охватывает текущий чанк и по 8 чанков в каждую горизонтальную сторону, 16 — по 16 чанков и так далее.
• Каждая выбранная колонка чанка освещается на всю высоту текущего измерения: пещеры, поверхность, горы и постройки наверху.
• Во внешних 32 блоках искусственный свет плавно проходит через уровни 1–15. Естественный блочный и небесный свет при этом никогда не уменьшается.
• При переходе через границу чанка окно сдвигается, а пересобираются только колонки, в которых изменился свет. Изменение настройки дальности прорисовки обновляет область автоматически.
• Вновь полученные чанки сразу компилируются с текущим уровнем Fullbright. Если сервер передал меньше чанков, чем запрошено клиентской настройкой, отсутствующие чанки осветить невозможно.
• Сущности используют ту же горизонтальную область и то же затухание по краям, что и блоки.

Совместимость с Freecam

Headlights Fullbright опционально интегрируется с модом Freecam Spectator — жёсткой зависимости нет, без него мод тоже прекрасно работает. Когда активен spectator-режим Freecam, и лучи фар, и окно Fullbright следуют за свободно перемещающейся головой наблюдателя, а не остаются на замороженном теле игрока.

Совместимость с шейдерами

В моде предусмотрен опциональный путь освещения чанков Sodium/Iris. Complementary и BSL являются основными целевыми шейдерпаками, но в текущем dev-профиле нет Sodium/Iris и этих шейдеров, поэтому новый градиент по дальности прорисовки ещё требует полноценной проверки с ними в игре.

Лицензия

Данный проект распространяется по лицензии Softboundless Mod License 1.0.

Модификация, распространение, создание форков, портирование и использование в модпаках в целом разрешены. Однако использование в сторонних модпаках для Minecraft с использованием названия Freakland ограничено.

Полный текст условий см. в файле LICENSE.

Авторы

Автор — peacefull02 (он же softboundless).