GD656LightCore

Enhance your Minecraft experience with the GD656LightCore mod, a revolutionary addition tailored for TACZ that transforms gameplay by introducing realistic lighting effects. Each shot illuminates the environment with dynamic lights, while explosions and rocket trails create captivating lighting across the terrain. This mod operates entirely client-side, ensuring that while other players can experience the fantastic lighting, synchronization of muzzle flashes requires server cooperation.

Introduction

GD656LightCore is a dynamic lighting mod specifically designed for Minecraft, bringing a new dimension to TACZ firearms. It offers immersive features like real-time muzzle flashes, bullet trails, impacts, and explosion effects with extensive customization options. The latest update to this mod was on July 18, 2026, and some functionalities may still be evolving or not comprehensively documented.

Compatibility Requirements

• Utilizes TACZ version 1.1.7-hotfix or newer;
• Works alongside Explosive Enhancement with partial compatibility, enhancing explosion visuals;
• Supports Minecraft version 1.20.1 Forge exclusively.

Installing on Server

In summary, using it in single-player mode or as a standalone option functions flawlessly. In multiplayer contexts, the absence of server mod means players won’t see each other’s muzzle flash lighting, but all other effects like bullet trails, impacts, and explosions will appear normally. The amount of data needed for server synchronization is minimal, consisting only of coordinates and firearm ID, which places a negligible load on server resources.

Configuration and Commands

The modification parameters can be customized through the Forge mod config menu or via in-game client commands:

/gd656lightcore config list - Display all configuration entries with current settings
/gd656lightcore config edit - Edit a specific configuration entry
/gd656lightcore config reset - Reset all settings to their defaults
/gd656lightcore config reset - Revert an individual setting to its default value

Additionally, the shortcut /gdlc serves the same functions. All modifications are applied instantly and saved automatically.

Important Considerations

• All visual components are rendered on the client side and will not affect overall server performance;
• This mod is still in its early development stage (0.x); features may continue to be advanced;
• Some portions of the code were developed with AI assistance;
• Designed under the MIT License.

Core Features

Muzzle Flash Effects

Upon firing, a brief light source emerges from the muzzle location, with brightness levels being randomly selected between set minimum and maximum values.

• Duration scaling based on weapon type: sniper/DMR default at 3×, heavy/RPG at 7×;
• Single-shot firearms (semi-automatic only) consistently use the maximum brightness level of 15;
• Automatic detection of weapon types via Firearm ID keywords (e.g., sniper, rpg, heavy);
• Standard muzzle flash duration set at 40ms (adjustable between 1 and 200ms);
• Prevents rapid consecutive flashes from stacking through per-block deduplication.

Lighting for Bullet Trails

Dynamic lighting follows bullet paths in-flight, creating the illusion of tracer or friction illumination.

• Seven weapon categories with distinct settings: include rifle, shotgun, SMG, heavy, machine gun, pistol, and sniper, with each brightness adjustable from 0 to 15;
• Light trails sampled at approximately 0.4 block intervals, with a maximum of 24 samples for each bullet, assuring continuous trail illumination for extended shots;
• A 2-block exclusion region around the muzzle prevents conflicts with muzzle flash lighting;
• Default light trail duration is set at 80ms, naturally fading over time.

Impact Lighting for Bullets

When bullets hit a block, bullet hole particles trigger a single burst of light.

• Reads the firearm ID from TACZ bullet hole particles, ensuring accurate brightness configuration;
• Single-shot firearms automatically employ maximum brightness level 15, sharing the logic used for muzzle flashes.

Explosion Lighting Effects

A spherical halo of dynamic light appears around explosion centers, with the intensity decreasing with distance.

• Includes visuals for vanilla explosions (like TNT and Creepers), TACZ weapon explosions, and Explosive Enhancement effects;
• Explosion radius approximately 4.5 blocks, with intensity reducing from level 15 outward, trimming edges below level 2;
• Independent toggles for explosion effects and duration settings (default 0.3 seconds, maximum 60 seconds);
• Frame-by-frame processing allows for up to 3 pending explosions at once, with a total maximum queue of 96, mitigating lag spikes during mass explosions.

Performance Management

• Maximum concurrent lights: adjustable between 64 and 65,536 (default set to 4,096); once this limit is surpass, brighter lights maintain while dimmer ones are eliminated;
• Independent switches for every type of light, enabling the disablement of unwanted effects;
• Switching dimensions clears lighting data automatically to avoid visual artifacts across dimensions.