RPGMT - Lamp Update

Update 4.2 - Major Performance & Lamp System Update

Version 4.2 is a major update compared to version 3.3. The lighting system has received significant performance improvements and a completely new lamp preset system that allows developers to create multiple player lights and connect them directly to RPG Maker MZ items.

Major Performance Improvements

The internal shadow and blocker detection system has been reworked to reduce unnecessary calculations, especially on maps with many objects, trees, crates or events.

• Static Light Collision Cache
  Walls, regions and map objects are prepared and cached instead of being completely analyzed again during every individual light-ray check.
• Spatial Event Grid
  Light rays no longer need to check every blocking event on the entire map. Only events close to the current light calculation are considered.
• Event Blocker Cache
  Static event blockers are no longer rebuilt every frame. The blocker data is updated when relevant event properties actually change.
• Conditional Light Redrawing
  The complete light mask is no longer recalculated every frame when nothing has changed. If the player, camera and blockers remain unchanged, the existing light result can be reused.
• Improved Object Tile Caching
  Object tile information and visible object bounds are reused instead of repeatedly analyzing the same tiles.
• Faster Blocker Exit Detection
  Simple rectangular blockers can use their known boundaries instead of requiring many small ray steps to determine where the shadow should begin.
• Performance-Aware Shadow Precision
  Expensive blocker calculations now use different precision levels depending on the selected Light Detail setting.

These changes are especially useful on maps containing several trees, crates, pillars, animated events or other objects that interact with the player's light.

New Lamp Preset System

Version 4.1 introduced a completely new Lamp Preset system.

Instead of having only one permanently configured player light, developers can now create multiple different lamps directly inside the Plugin Manager.

Each lamp can have its own:

• Unique Lamp ID
• Display name
• Circle, Cone or None light mode
• Circle radius
• Cone length
• Cone angle
• Cone X/Y offset
• Forward offset
• Light strength
• Flicker effect
• Assigned RPG Maker MZ item

This makes it possible to create completely different player lights, for example:

Old Lantern
Mode: Circle
Radius: 140
Strength: 220
Flicker: ON
Flashlight
Mode: Cone
Length: 280
Angle: 55
Strength: 255

Assign Lamps to Items

Lamp Presets can now be connected directly to items from the RPG Maker MZ database.

When the player uses the assigned item from the normal item menu, the corresponding lamp is automatically activated.

Example:

Item: Old Lantern
Assigned Lamp: lantern
Item: Flashlight
Assigned Lamp: flashlight

Using the Old Lantern activates the Circle light. Using the Flashlight immediately switches the player to the Cone light.

Lamp items can also work as dedicated light items without requiring an additional RPG Maker item effect.

Normal RPG Maker item consumption rules are still respected, so you can decide whether a lamp item should be consumable or reusable.

New Lamp Plugin Commands

The following Plugin Commands have been added:

• Activate Lamp Preset
  Activates a lamp directly by its Lamp ID.
• Activate Lamp by Item
  Activates the lamp assigned to a selected database item.
• Turn Off Lamp
  Completely disables the current player light.
• Use Default Player Light
  Returns to the normal player light configured in the Plugin Manager.

This allows lamp changes to be controlled through events, cutscenes, switches, equipment systems or other gameplay mechanics.

Initial Lamp Support

A new Initial Lamp ID parameter allows developers to choose which Lamp Preset should automatically be active when a new game starts.

If no Initial Lamp ID is entered, the plugin continues to use the normal default player light settings.

Version 4.2 - Improved Item Switching

Version 4.2 improves the new item-based lamp system and fixes an issue where activating one lamp item and then using another lamp item could fail to switch the active light.

• Lamp items now remember their exact assigned Lamp Preset.
• Switching between multiple lamp items now works correctly.
• Item-based lamp selection remains reliable even if Lamp IDs were accidentally duplicated.
• Plugin Command activation continues to support Lamp IDs.
• Dedicated lamp items no longer require another item effect just to be usable.

For best organization, unique Lamp IDs are still recommended.

Summary

The update from 3.3 to 4.2 focuses on two major areas:

• Better performance through caching, optimized blocker detection and fewer unnecessary lighting calculations.
• More gameplay flexibility through multiple Lamp Presets, item integration and new Plugin Commands.

RPGMT Lamp can now be used not only as a fixed flashlight or lantern system, but also as a gameplay mechanic where players can discover, obtain and switch between different light sources.