# Minecraft Tutorial Line Of Sight

> Minecraft Tutorial: Sight Magic 视线魔法数据包教程（Java 1.21.2+）：Goal 目标（右键物品在玩家注视的方块处触发事件：爆炸+蜂巢/蜂箱检查成年/幼蜂数量）、Raycast Improvements 射线投射改进（步长0.5 减少递归、#raycast_check_times计数器 对比#raycast_max_check_times 1000、方块停止检查 #generic:raycast/can_pass、实体检查 @n[dx=0,dy=0,dz=0] 微小盒子、从执行者眼睛位置开始 anchored eyes、可选调试粒子/交互实体）、Right-Click Detection 右键检测（minecraft:consume_item 进度 custom_data 匹配 {listen_event:'right_click'}、奖励函数 revoke进度 模拟协程 存储执行者和手持物品 等待1刻 恢复物品不真正消耗）、Sight Explosion Magic 视线爆炸魔法（爆炸在瞄准点：召唤TNT或苦力怕、generic/tags/function/right_click.json 函数标签接口、function right_click.mcfunction 守卫条件 域标志对 按手持物品分支）、Bee Finder Magic 蜜蜂查找魔法（相同骨架 cause_event:'get_bees' start/end、读取方块实体 /data get block bees 计数 成年/幼蜂 Age -1=幼蜂 输出 tellraw）、Carrot-on-a-Stick Toggle 胡萝卜钓竿切换（可选 记分板切换 胡萝卜钓竿作为遥控器 consume_item 进度方法更优）。

- Skill: `zmjjkk123-hub/minecraft-tutorial-line-of-sight` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zmjjkk123-hub/minecraft-tutorial-line-of-sight`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zmjjkk123-hub/minecraft-tutorial-line-of-sight/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ZMJJKK123-hub (https://skillmd.com/u/zmjjkk123-hub)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zmjjkk123-hub/minecraft-tutorial-line-of-sight

---


# Tutorial: Datapack Example — Sight Magic

Java Edition only; requires 1.21.2+ (the raycast tutorial it builds on is the base). Prerequisites: the raycasting tutorial, datapack/resourcepack tutorials.

## Goal

Right-clicking an item causes events at the block the player is looking at:

- an **explosion**, and
- if the target is a **beehive or bee nest**, print the counts of adult and baby bees inside.

## Raycast Improvements

The base raycast (`generic/function/raycast/`) is enhanced:

- Step length 0.5 instead of 0.1 (fewer recursions).
- `#raycast_check_times` counter vs `#raycast_max_check_times` (max 1000) → `return run function generic:raycast/end`.
- Stop when the block at `~ ~ ~` is not `#generic:raycast/can_pass`.
- Entity check at `~ ~-0.5 ~` with `@n[dx=0,dy=0,dz=0]`-style tiny box (flag `#raycast_pass_entity`).
- Start from the executor's eye position: `execute as @s anchored eyes run ...`.
- Optional debugging: `particle minecraft:end_rod ~ ~ ~ 0 0 0 0 0`; interaction entity `execute positioned ~ ~-0.5 ~ run summon interaction ^ ^ ^ {Tags:["test","source_entity"]}`.

## Right-Click Detection

A `minecraft:consume_item` advancement fires only when the consumed item matches a `custom_data` predicate (`{listen_event:'right_click'}`), and rewards a function:

```json
{
  "criteria": {
    "generic:right_click_event": {
      "trigger": "minecraft:consume_item",
      "conditions": { "item": { "predicates": { "custom_data": "{listen_event:'right_click'}" } } }
    }
  },
  "rewards": { "function": "generic:event/right_click" }
}
```

`generic/function/event/right_click.mcfunction` revokes the advancement, then **simulates a coroutine**: store the executor and its held item (e.g. into a storage or a marker entity), wait 1 tick, then restore the item so it is not actually consumed (the consume_item trigger fires before the stack is truly eaten).

## Sight Explosion Magic

Explosion at the aim point: summon an instant-igniting TNT or a Creeper at the ray end.

- `generic/tags/function/right_click.json` — function-tag interface: `{ "values": ["test:sight_magic/extender/right_click"] }`.
- `test/sight_magic/extender/right_click.mcfunction` — implements the interface:
  - Guard: `execute unless items entity @s weapon.mainhand * [custom_data ~ {id:'sight_magic'}] run return fail`.
  - Domain flag pair: `tag @s add used_sight_magic` ... `tag @s remove used_sight_magic` (closed around the branch).
  - Branch by held item: `execute if items entity @s weapon.mainhand * [custom_data ~ {cause_event:'explosion'}] run function test:sight_magic/explosion/start`.
- `explosion/start` — tags the player, sets `#raycast_max_check_times`, calls the raycast; `explosion/end` (via the raycast end interface) summons the TNT/Creeper at `~ ~ ~` and cleans up.

## Bee Finder Magic

Same skeleton, new branch: `cause_event:'get_bees'` → `test:sight_magic/bee_finder/start`.

- start: `tag @s add get_bees`, set raycast max checks, run raycast.
- end: check the block at the ray end — if it is `beehive`/`bee_nest`, read the block entity with `/data get block ~ ~ ~ bees` and count entries; adult vs baby by each bee's `entity_data.Age` (`-1` = baby); output e.g. `tellraw @a "Adults: X, Babies: Y"`. Clean up tags and counters.

## Carrot-on-a-Stick Toggle (optional, older pattern)

Scoreboard-based toggle for using carrot-on-a-stick as a "remote":

- `nuke:entities/player`: `execute as @s[scores={nukeUseCSt=1..}] at @s run function nuke:use_carrot_on_a_stick/type`.
- `type`: checks `weapon.mainhand` / `weapon.offhand` for `carrot_on_a_stick`, dispatches to mainhand/offhand functions, then `scoreboard players reset @s nukeUseCSt`.
- `mainhand`/`offhand`: check `carrot_on_a_stick {id:'nuke:remote'}` custom data to enable the effect, else the plain carrot-on-a-stick behavior (pig riding); toggling sets the score. (Note: this section is flagged as outdated for current versions — prefer the consume_item advancement approach.)