FlashlightMod

Flashlight Mod - Gameplay Guide

Mod Introduction
This mod adds a toggleable flashlight to Minecraft. When held and turned on, it generates invisible light sources up to 32 blocks ahead in your line of sight, illuminating dark areas. Each player automatically receives one upon entering the world or respawning.

【模组介绍】
本模组为 Minecraft 添加了一款可开关的手电筒。手持时打开开关，会在你视线方向 32 格范围内生成不可见的光源方块，照亮黑暗区域。每位玩家进入游戏或重生时都会自动获得一把。

Items
Flashlight
- Not stackable, with 1561 durability (same as a diamond sword)
- Right-click to toggle on/off
- Button click sound effect when toggling
- When on, generates invisible light blocks along your line of sight
- Light range of 32 blocks, refreshed every 2 ticks (approx. 0.1 seconds)
- Light disappears when switched to off-hand or moved back to inventory
- Has an animated model: lamp head is dark when off, glows when on

【物品列表】
手电筒
- 不可堆叠，拥有 1561 点耐久（相当于钻石剑的耐久）
- 右键点击切换开/关
- 切换时有按钮音效
- 打开后沿视线方向生成隐形的 light 方块照亮路径
- 光照范围 32 格，每 2 tick（约 0.1 秒）刷新一次
- 切换回副手或放回背包时，光源自动消失
- 附有开关动画模型：关闭时灯头呈灰色，打开时灯头发光

Crafting Recipe
In the crafting table, arrange materials as follows:

  I G I
  I R I
    L

Legend:
I = Iron Ingot
G = Glass
R = Redstone
L = Iron Nugget

This recipe yields 1 Flashlight.

【合成配方】
在工作台中按以下图案摆放：

  I G I
  I R I
    L

符号含义：
I = 铁锭
G = 玻璃
R = 红石
L = 铁粒

按此配方获得 1 个手电筒。

How to Play
- Obtaining: Upon first entering the world or respawning, a flashlight is automatically placed in your inventory. If lost, craft a new one using the recipe above.
- Toggle: Right-click while holding the flashlight to hear a "click" sound, indicating it's on. Right-click again to turn it off.
- Lighting Effect: When on, invisible light sources (equivalent to full-brightness light blocks) appear in the air up to 32 blocks ahead, illuminating caves, mineshafts, underwater areas, and other dark places.
- Dynamic Refresh: The light follows your line of sight in real time. As you turn or move, new areas are lit up while areas behind you fade out.
- Item Switching: If you move the flashlight to your off-hand or back to your inventory, the light disappears immediately.

【玩法说明】
- 获得手电筒：首次进入世界或重生后，手电筒会自动放入你的背包。如果丢掉了，按配方重做即可。
- 开关操作：手持手电筒时右键点击，听到"咔嗒"声即为打开。再次右键关闭。
- 照明效果：打开后，你视线前方 32 格内的空气中会出现隐形光源（等同于完整亮度的 light 方块），照亮洞穴、矿井、海底等黑暗区域。
- 动态刷新：光源会跟随你的视线实时更新，转头或移动时照亮新区域，身后区域自动熄灭。
- 切换物品：将手电筒切到副手或放回背包，光源立刻消失。

Important Notes
- The light blocks are invisible (cannot be seen or touched) and do not block movement.
- The flashlight only works when held in the main hand or off-hand. If it's in the hotbar but not selected, it will turn off.
- The flashlight has durability. When it runs out, it breaks. There is no repair recipe at this time.
- In multiplayer, each player has their own independent light system. They do not interfere with each other.

【注意事项】
- 手电筒的光源方块是隐形的（看不见也摸不着），不会阻挡移动。
- 光源只在主手或副手持有时工作，放在快捷栏但未选中也会熄灭。
- 有耐久度，用尽后手电筒会损坏。目前没有维修配方。
- 多人游戏中每个玩家拥有独立的光源管理，互不干扰。