准心

.workbuddy/memory/2026-10-09.md

@@ -0,0 +1,11 @@
+# 2026-10-09
+
+## 简易准心（Crosshair）
+- 新增 `ui/crosshair.gd`：`@tool extends Control`，用 `_draw()` 画十字（gap/length/thickness/dot 可导出调参），`mouse_filter = IGNORE`，监听 `NOTIFICATION_RESIZED` 重绘。
+- 挂载约定：`CanvasLayer > Crosshair(Control)`，Control 锚点为 Full Rect，中心即屏幕中心；推荐挂在 `CameraRig` 之下 —— 因为 `player.gd _ready()` 对非 authority 会 `camera_rig.queue_free()`，远端玩家准心随之一并释放，无需额外代码。
+- 项目 stretch 模式为 `canvas_items` + `expand`，CanvasLayer 会自动跟随缩放。
+
+### 后续改动：只保留「点」
+- 最终形态：准心 = 屏幕中心一个点，无十字、无样式开关（`enum Style` 已移除）。
+- 导出参数：`dot_color` / `dot_radius`(默认 2.5) / `outline` / `outline_color` / `outline_width`。
+- `_draw()` 先画描边圆再画主体圆，保证浅背景可见。

character/player/player.tscn

@@ -1,6 +1,7 @@
 [gd_scene format=3 uid="uid://bekuuw153mv03"]
 
 [ext_resource type="Script" uid="uid://f5ptp3is4agf" path="res://character/player/player.gd" id="1_gtsfv"]
+[ext_resource type="Script" uid="uid://baid7qspg2mla" path="res://ui/crosshair.gd" id="2_vuhga"]
 [ext_resource type="PackedScene" uid="uid://css1vk3u8gt7o" path="res://character/player/assets/mouse.glb" id="2_wu8e1"]
 [ext_resource type="Script" uid="uid://roaqmma0vjon" path="res://character/player/player_animator.gd" id="3_g20gq"]
 [ext_resource type="SceneReplicationConfig" uid="uid://c4ubbxjfrrs47" path="res://character/player/player_sync.tres" id="3_wu8e1"]
@@ -38,6 +39,19 @@ target_position = Vector3(0, 0.45, 0)
 [node name="InteractionPos" type="Marker3D" parent="CameraRig/Camera" unique_id=816323614]
 transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, -0.44393378)
 
+[node name="HUD" type="CanvasLayer" parent="CameraRig" unique_id=2008353247]
+
+[node name="Crosshair" type="Control" parent="CameraRig/HUD" unique_id=1606201608]
+layout_mode = 3
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+size_flags_horizontal = 4
+size_flags_vertical = 4
+script = ExtResource("2_vuhga")
+
 [node name="Body" type="Node3D" parent="." unique_id=394283421]
 
 [node name="mouse" parent="Body" unique_id=1995806863 instance=ExtResource("2_wu8e1")]

ui/crosshair.gd

@@ -0,0 +1,57 @@
+@tool
+extends Control
+## 简易准心：屏幕正中央的一个点，用 _draw() 实时绘制，不依赖任何贴图。
+##
+## 挂法：CanvasLayer > Crosshair(Control)，Control 的锚点设为「Full Rect」
+## （anchor 全 0/1），这样 size 就等于视口尺寸，中心即屏幕中心。
+## 因为是 CanvasLayer 子节点，在 window/stretch/mode=canvas_items 下会自动跟随缩放。
+
+## 点的颜色
+@export var dot_color: Color = Color(1, 1, 1, 0.9):
+	set(v):
+		dot_color = v
+		queue_redraw()
+
+## 点的半径（像素）
+@export_range(0.5, 12.0, 0.5) var dot_radius: float = 2.5:
+	set(v):
+		dot_radius = v
+		queue_redraw()
+
+## 是否给点画一圈描边（浅色背景上也看得清）
+@export var outline: bool = true:
+	set(v):
+		outline = v
+		queue_redraw()
+
+## 描边颜色
+@export var outline_color: Color = Color(0, 0, 0, 0.6):
+	set(v):
+		outline_color = v
+		queue_redraw()
+
+## 描边宽度（像素）
+@export_range(0.5, 4.0, 0.5) var outline_width: float = 1.0:
+	set(v):
+		outline_width = v
+		queue_redraw()
+
+
+func _ready() -> void:
+	# 准心不吃鼠标事件，否则会挡住后面的 UI / 拖拽
+	mouse_filter = Control.MOUSE_FILTER_IGNORE
+	queue_redraw()
+
+
+func _notification(what: int) -> void:
+	# 窗口尺寸变化时重画（stretch 模式下实时跟着变）
+	if what == NOTIFICATION_RESIZED:
+		queue_redraw()
+
+
+func _draw() -> void:
+	var c := size * 0.5  # 控件中心 = 屏幕中心
+
+	if outline and outline_width > 0.0:
+		draw_circle(c, dot_radius + outline_width, outline_color)
+	draw_circle(c, dot_radius, dot_color)

ui/crosshair.gd.uid

@@ -0,0 +1 @@
+uid://baid7qspg2mla