Kết nối HUD từ AI Studio với sự kiện máu bằng Unity MCP
Sau khi AI Studio xuất prefab HUD Unity, dùng Cursor + Unity MCP để đăng ký sự kiện máu, cập nhật thanh và chữ sát thương, kèm checklist Play-mode và sửa lỗi t…
- Unity MCP
- AI Studio
- HUD
- Unity
- Cursor
- AI game development
- tutorial
HUD đã nằm trong Unity, thanh trông ổn, nhưng chiến đấu không làm nó chuyển động—thường prefab không sao và UI và gameplay không dùng chung sự kiện máu. Thiết kế đã xuất HUD chính dưới dạng Canvas / Prefab từ VberAI Studio. Gameplay nên dùng Unity MCP trong dự án đang mở để kết nối thay đổi PlayerHealth với Slider / Image.fillAmount, sau đó kiểm tra trong Play mode.
Bài viết này chỉ đề cập đến việc kết nối đó—không bao gồm xuất Figma hay cài đặt MCP.
| Bước | Công cụ | Kết quả |
|---|---|---|
| Đưa cấu trúc HUD vào engine | AI Studio | Prefab HUD với tên ổn định |
| Gắn script, ràng buộc tham chiếu, chỉnh scene | Cursor (hoặc Claude Code) + Unity MCP | PlayerHealth ↔ HudHealthView |
| Chấp nhận | Unity Play | Thanh thay đổi độ dài khi nhận sát thương / hồi máu |
Liên quan:
Thống nhất tên trước khi tinh chỉnh
Sau khi xuất từ AI Studio, code phải tìm thanh qua đường dẫn hoặc tham chiếu tuần tự hóa. Trước khi xuất (hoặc ngay sau khi nhập), giữ tên ổn định:
| Vai trò | Tên gợi ý | Ghi chú |
|---|---|---|
| Gốc HUD | HUD_Root | Duy nhất trong scene |
| Thanh máu | HUD_HealthFill | Image (Filled) hoặc nằm trong Slider.fillRect |
| Text giá trị (tùy chọn) | HUD_HealthText | TextMeshProUGUI, ví dụ 80/100 |
| Hiệu ứng sát thương (tùy chọn) | HUD_DamageFlash | Image toàn màn hình hoặc viền, mặc định trong suốt |
Tránh tên mặc định của thiết kế như Rectangle 42 hoặc Group 3—cả MCP và script viết tay sẽ kế thừa sự lộn xộn.
Bước 1: Xác nhận HUD có trong scene
- Mở scene người chơi (ví dụ
Game) - Hierarchy nên hiển thị
HUD_Root(hoặc tương đương) với Image / Slider máu bên dưới - Canvas Render Mode và camera được thiết lập đúng (Screen Space - Overlay là đơn giản nhất)
Kiểm tra nhanh chỉ đọc qua MCP (không chỉnh sửa scene):
List GameObjects in the active scene whose names contain HUD, and the UI component types on them. Do not modify anything.
Nếu danh sách trống: xuất lại/đồng bộ từ AI Studio, hoặc kiểm tra Prefab đã được thả vào sai scene.
Bước 2: Gameplay phơi bày thay đổi máu—không bao giờ tìm UI
Giữ máu trên người chơi và phát qua sự kiện C# (hoặc UnityEvent). HUD chỉ đăng ký; nó không được điều khiển logic qua Find("Player").
Yêu cầu Unity MCP từ Cursor (đường dẫn có thể khớp với dự án của bạn):
Create Assets/Scripts/Combat/PlayerHealth.cs:
- maxHealth, currentHealth (float)
- event Action<float,float> OnHealthChanged(current, max)
- TakeDamage(float), Heal(float); clamp to 0..max
- If current<=0 after damage, fire OnHealthChanged again and optionally OnDied
- Attach to the scene Player; broadcast once in Start
Do not modify any HUD nodes.
Triển khai tham chiếu (tạo, sau đó xem xét):
using System;
using UnityEngine;
public class PlayerHealth : MonoBehaviour
{
[SerializeField] float maxHealth = 100f;
float currentHealth;
public event Action<float, float> OnHealthChanged;
public event Action OnDied;
void Awake() => currentHealth = maxHealth;
void Start() => OnHealthChanged?.Invoke(currentHealth, maxHealth);
public void TakeDamage(float amount)
{
if (amount <= 0f || currentHealth <= 0f) return;
currentHealth = Mathf.Max(0f, currentHealth - amount);
OnHealthChanged?.Invoke(currentHealth, maxHealth);
if (currentHealth <= 0f) OnDied?.Invoke();
}
public void Heal(float amount)
{
if (amount <= 0f || currentHealth <= 0f) return;
currentHealth = Mathf.Min(maxHealth, currentHealth + amount);
OnHealthChanged?.Invoke(currentHealth, maxHealth);
}
}
Phím sát thương tạm thời cho việc kết nối (xóa sau):
Add temporary DebugDealDamage.cs on Player: pressing H deals 10 damage to PlayerHealth on the same object. Wiring acceptance only.
Bước 3: View HUD chỉ lắng nghe và cập nhật thanh
Thêm script view với tham chiếu tuần tự hóa. Không GameObject.Find mỗi frame trong Update.
Create Assets/Scripts/UI/HudHealthView.cs:
- Serialize Image healthFill (Filled, Horizontal)
- Optional TMP_Text healthText
- Serialize PlayerHealth playerHealth (or resolve the unique PlayerHealth at Awake)
- OnEnable subscribe OnHealthChanged; OnDisable unsubscribe
- In the callback: healthFill.fillAmount = current/max; text $"{current:0}/{max:0}"
- Attach to HUD_Root; assign HUD_HealthFill Image to healthFill
- Assign Player's PlayerHealth to playerHealth
Tham chiếu:
using TMPro;
using UnityEngine;
using UnityEngine.UI;
public class HudHealthView : MonoBehaviour
{
[SerializeField] PlayerHealth playerHealth;
[SerializeField] Image healthFill;
[SerializeField] TMP_Text healthText;
void OnEnable()
{
if (playerHealth == null) return;
playerHealth.OnHealthChanged += HandleHealthChanged;
// If you subscribe after Start, pull once; here we rely on PlayerHealth.Start
}
void OnDisable()
{
if (playerHealth == null) return;
playerHealth.OnHealthChanged -= HandleHealthChanged;
}
void HandleHealthChanged(float current, float max)
{
float t = max > 0f ? current / max : 0f;
if (healthFill != null) healthFill.fillAmount = t;
if (healthText != null) healthText.text = $"{Mathf.CeilToInt(current)}/{Mathf.CeilToInt(max)}";
}
}
Nếu Image không phải Filled: yêu cầu MCP đặt Image Type = Filled, Fill Method = Horizontal, sau đó gán fillAmount. Với Slider, ghi slider.value = t (minValue=0, maxValue=1)—cùng mẫu.
Bước 4: Để Unity MCP điền tham chiếu tuần tự hóa
Sau khi biên dịch, hãy nói rõ trong Cursor:
In the active scene:
1. Confirm Player has PlayerHealth; HUD_Root has HudHealthView
2. Point HudHealthView.healthFill at the Image named HUD_HealthFill
3. Point HudHealthView.playerHealth at Player's PlayerHealth
4. If HUD_HealthText exists, assign the TMP_Text
5. Save the scene
Then list any remaining None serialized fields on those two components.
Kiểm tra chỉ đọc:
Inspect HudHealthView and PlayerHealth references: any missing scripts or None fields? Report only—do not edit the scene.
Bước 5: Checklist chấp nhận Play
Vào Play và đánh dấu tất cả các mục sau trước khi coi là hoàn tất:
- Khi vào: thanh đầy (hoặc khớp
current/max), không trống/không cũ - Nhấn H (hoặc đánh người chơi):
fillAmountgiảm; text cập nhật nếu có - Sát thương về 0: thanh trống; trạng thái chết ổn định; HUD không nhấp nháy
- Hồi máu: thanh tăng (phím tạm hoặc vật phẩm)
- Thoát Play và vào lại: tham chiếu vẫn hợp lệ; không có Missing Script
Lời nhắc chấp nhận:
I am accepting HUD wiring in Play mode. If Console shows NullReferenceException, say whether it is PlayerHealth or HudHealthView and which serialized field is None. Diagnose first, propose the minimal fix, wait for my OK before editing.
Điểm hỏng thường gặp
| Triệu chứng | Kiểm tra đầu tiên |
|---|---|
| Thanh không bao giờ chuyển động trong Play | OnHealthChanged chưa đăng ký; hoặc sát thương không gọi TakeDamage |
| NRE khi vào Play | healthFill / playerHealth vẫn None |
| Thanh ngược hoặc nhảy | Image không Filled; dùng sai Rect làm fill |
| Text kẹt | Sai TMP; thiếu font asset trên component |
| AI chỉnh sai đối tượng | Nhắc: “Only touch HUD_Root / Player; do not move level geometry” |
Quy tắc: gameplay thay đổi máu; UI chỉ lắng nghe. Không Find("HUD_HealthFill") bên trong PlayerCombat—lần xuất lại AI Studio đổi tên sẽ phá vỡ cả chiến đấu.
Sống chung với việc xuất lại HUD
Khi thiết kế xuất lại từ AI Studio:
- Giữ tên
HUD_HealthFill/HUD_Rootkhi có thể - Sau khi nhập lại, chỉ chạy lại kiểm tra tham chiếu bước 4—không để MCP viết lại
PlayerHealth - Giữ script view trong dự án; gán lại nếu tham chiếu Prefab variant bị xóa
Lời nhắc ranh giới một dòng:
This pass only fixes lost UI Prefab references. Do not change any gameplay scripts under Assets/Scripts/Combat.
Tóm tắt
- AI Studio cung cấp cấu trúc HUD vào Unity
PlayerHealthphát(current, max)HudHealthViewđăng ký và cập nhậtfillAmount/ text- Unity MCP gắn component, điền tham chiếu tuần tự hóa, áp dụng sửa lỗi Console tối thiểu
- Chấp nhận với phím sát thương + checklist Play—không phải “script generated successfully”
Điều đó khép lại một vòng lặp lặp lại: UI vào engine → kết nối sự kiện → chấp nhận Play. Túi đồ, thanh mana và thanh boss có thể sao chép cùng mẫu.
Đọc tiếp
Các bài hướng dẫn bạn có thể thích
Unity Generate UI so với đưa thiết kế vào engine: Khi nào Generate trong Editor, khi nào xuất từ canvas
So sánh AI/UI Generate trong Unity 6 Editor với Figma·PSD→canvas Studio→Prefab: ranh giới, tiêu chí fail, bước nghiệm thu. Bài chọn pipeline—không phải tutoria…
- game-ui-design
- game-dev-ai
- ui-to-engine
- unity
Hướng dẫn cài đặt Unity MCP: Thêm gói từ đĩa và kết nối AI IDE
Cài đặt VberAI Unity MCP Pro từng bước—Package Manager Add package from disk, kích hoạt tài khoản, khởi động MCP Server (cổng 6589), và xác minh kết nối trong …
- unity
- mcp
- cursor
- tutorial
VberAI Studio: Tách Ảnh Thiết Kế UI Game và Nhập vào Unity / Godot / Cocos
VberAI Studio tách ảnh thiết kế UI game toàn màn hình thành các phần tử UI tại chỗ, giữ bố cục và kích thước, xuất hoặc đẩy sang Unity, Godot, Cocos.Tạo một tá…
- vberai
- ai-studio
- game-ui
- game-art