Các trợ lý AI dạng chat lên ý tưởng công trình Terraria khá tốt: chúng biết một căn nhà NPC cần những đồ gì, một lâu đài thường bố trí ra sao, khối nào hợp với một ngôi đền sa mạc. Điều chúng không làm được là đặt tile. AI không thuộc ID tile nội bộ của Terraria, frame của từng món nội thất hay giá trị của slope, và chỉ cần đoán sai một con số là cái ghế biến thành cây đuốc.

Structure Studio lấp khoảng trống đó. AI viết một structure spec ngắn bằng chính những cái tên bạn thấy trong game như Gray Brick, Wooden Chair hay Red Dynasty Shingles. Structure Studio đổi các tên đó thành tile thật ngay trong trình duyệt, hiển thị kết quả bằng Real View và xuất ra package .twpack. Không có gì bị tải lên server, không cần cài đặt gì, và dùng được với bản web miễn phí của ChatGPT, Claude, Gemini, kể cả trên điện thoại.

Bước 1: Đưa hướng dẫn TerraWorld cho AI

Hộp thoại Build with AI trong Structure Studio với ô spec trống và nút AI prompt
Nút AI trong Structure Studio mở hộp thoại này. Nút lời nhắn cho AI sẽ chép sẵn một đoạn tin nhắn để gửi cho AI.
  1. Mở Structure Studio và nhấn nút AI trên thanh công cụ.
  2. Nhấn Lời nhắn cho AI. Nút này chép một đoạn tin nhắn ngắn trỏ AI tới https://terraworld.dev/llms.txt, trang viết riêng cho trợ lý AI, giải thích format spec, những cái tên được dùng và các quy tắc nội thất phải tuân theo trong game.
  3. Dán tin nhắn vào cuộc trò chuyện với AI và mô tả công trình bạn muốn.

Nếu muốn tự gõ, chỉ cần tin nhắn có nhắc tới link là được, ví dụ: "Hãy đọc https://terraworld.dev/llms.txt, rồi thiết kế một căn nhà gỗ hai tầng cho Guide và Merchant và gửi tôi link Structure Studio." Nếu AI của bạn không mở được link, hãy tự mở terraworld.dev/llms.txt rồi dán nội dung trang vào cuộc trò chuyện.

Dùng AI thường xuyên? Trang tạo skill AI giúp bạn cài sẵn cho AI một lần: file skill cho Claude, hướng dẫn và file cho ChatGPT Project hoặc Gemini Gem, hoặc prompt khởi đầu cho AI bất kỳ. Sau đó bạn chỉ cần mô tả công trình.

Bước 2: Mô tả công trình thật rõ

AI tự quyết định mọi tọa độ, nên mô tả càng rõ thì càng ít phải sửa đi sửa lại. Một mô tả tốt thường có:

  • Kích thước: ví dụ "rộng khoảng 40 ô, cao 30 ô". Công trình nhỏ và vừa cho kết quả tốt nhất; dự án rất lớn nên chia thành nhiều phần.
  • Phong cách và vật liệu: "gạch xám, mái ngói xanh", "cabin gỗ boreal", "đền sa mạc bằng sandstone".
  • Phòng và công dụng: "ba phòng NPC, mỗi phòng có cửa, bàn, ghế và đuốc", hay "phòng ngai vàng có cờ và đèn chùm".
  • Chi tiết bạn quan tâm: cầu thang bằng platform, cửa sổ kính màu, một rương có sẵn đồ khởi đầu, một tấm biển có chữ.

Spec dùng tên của Terraria gốc; tile của các mod khác hiện chưa được hỗ trợ.

Bước 3: Mở link của AI

AI sẽ trả về một spec và một link bắt đầu bằng https://terraworld.dev/structure-studio#spec= hoặc #z=. Mở link đó, Structure Studio sẽ dựng công trình ngay trên canvas. Thiết kế nằm trong chính link, ở phần sau dấu #, nên không bao giờ được gửi lên server của TerraWorld.

Nếu link quá dài so với app chat hoặc bị hỏng khi sao chép, hãy dùng phần spec: chép khối spec mà AI đã viết, nhấn AI trong Structure Studio, dán vào ô Spec công trình rồi nhấn Dựng công trình. Bạn cũng có thể lưu spec thành tệp .twspec và mở bằng nút Mở.

Bước 4: Kiểm tra bằng Real View

Căn nhà gỗ nhỏ dựng từ spec của AI, hiển thị bằng Real View trong Structure Studio
Real View hiển thị công trình bằng texture của game: mái dốc, cửa, bàn, ghế quay về phía bàn, rương và đuốc.

Bật Real View để xem công trình bằng texture của game. Phóng to và tìm những chỗ AI có thể tính sai: cửa mở vào tường, đồ đạc lơ lửng trên sàn, phòng thiếu tường nền, hay mái không che hết nhà. AI không nhìn thấy hình, nên hãy mô tả chỗ sai bằng lời, hoặc chụp màn hình gửi cho AI. Phần lớn app chat AI đều đọc được ảnh.

Bước 5: Gửi lỗi lại cho AI

Hộp thoại Build with AI liệt kê một tên tile sai kèm gợi ý và hai cảnh báo về chỗ bám của nội thất
Structure Studio liệt kê tên sai kèm gợi ý, và những món nội thất sẽ bị vỡ trong game.

Structure Studio kiểm tra spec mỗi khi dựng. Khi có vấn đề, hộp thoại AI sẽ mở ra với danh sách:

  • Lỗi là những thứ không dựng được: tên không tồn tại (kèm các tên thật gần nhất), ô nằm ngoài canvas, hoặc một bước sau vẽ khối đè lên đồ đạc.
  • Cảnh báo là những thứ sẽ vỡ trong game: bàn không có sàn bên dưới, đèn chùm không có chỗ treo, cửa thiếu khối ở trên và dưới, hoặc tranh không có tường phía sau.

Nhấn Chép lỗi rồi dán báo cáo vào cuộc trò chuyện. Báo cáo cho AI biết chính xác bước nào sai và vì sao, để AI gửi lại spec đã sửa. Lặp lại cho tới khi danh sách trống. Với những chỗ sửa nhỏ, tự sửa bằng công cụ của Edit Mode thường nhanh hơn, vì công trình đã dựng là một tài liệu Structure Studio bình thường.

Bước 6: Hoàn thiện, xuất và chia sẻ

Khi công trình đã ổn, nó hoạt động giống mọi thiết kế khác trong Structure Studio. Dùng layer, sơn, dây điện và các công cụ chỉnh sửa khác để hoàn thiện, rồi nhấn Xuất .twpack. Bạn có thể đặt package vào world bằng trình chỉnh sửa bản đồ, chia sẻ với bạn bè, hoặc xây nó ngay trong Terraria bằng mod TerraWorld Blueprints.

Muốn chia sẻ bản của AI trước khi chỉnh sửa, hãy nhấn Sao chép link trong hộp thoại AI. Link chứa toàn bộ spec, nên ai mở link cũng nhận được đúng công trình đó.

Một spec trông như thế nào

Bạn không cần tự viết spec, nhưng đọc hiểu được sẽ giúp ích khi muốn chỉnh một con số. Mỗi dòng là một bước. Tọa độ đếm theo ô từ góc trên bên trái, và y tăng dần xuống dưới:

name "Tiny Wooden House"
size 16 16
roof x=0 y=7 w=16 tile=Red_Dynasty_Shingles
rect x=1 y=8 w=14 h=7 tile=Wood hollow=true
rect x=2 y=9 w=12 h=5 wall=Wood_Wall
rect x=0 y=15 w=16 h=1 tile=Gray_Brick
clear x=1 y=11 h=3
object name=Wooden_Door x=1 y=14 at=floor
object name=Wooden_Table x=6 y=14 at=floor
object name=Wooden_Chair x=5 y=14 at=floor facing=right
object name=Wooden_Chest x=10 y=14 at=floor items=Torch_x10,Wood_x50
object name=Torch x=3 y=10
  • rect lấp một vùng bằng khối, tường, sơn hoặc chất lỏng; hollow=true chỉ vẽ viền.
  • roof vẽ mái 45° có viền dốc. clear khoét lỗ, chẳng hạn khung cửa.
  • object đặt đồ nội thất. at=floor nghĩa là "đứng trên hàng này", at=ceiling là "treo từ hàng này", còn facing xoay hướng ghế và giường.
  • grid vẽ chi tiết nhỏ theo từng ký tự, tiện cho cửa sổ và đồ trang trí.
  • Dấu gạch dưới thay cho dấu cách, nên Gray_Brick giống với Gray Brick.

Tài liệu đầy đủ, gồm dạng JSON, sơn, chất lỏng và slope, nằm ở terraworld.dev/llms.txt.

Mẹo để có kết quả tốt hơn

  • Mỗi lần chỉ nhờ một công trình. Một căn nhà hay một tòa tháp sẽ gọn gàng hơn cả một thị trấn trong một tin nhắn.
  • Nhắc AI giữ phòng NPC hợp lệ: tường và tường nền không hở, có nguồn sáng, bàn, ghế và cửa.
  • Nếu AI cứ bịa tên, hãy nhờ nó kiểm tra danh sách tên ở terraworld.dev/ai/blocks.txt, walls.txt và objects.txt.
  • Đồ trong rương ghi trong spec vẫn được lưu vào .twpack, nhưng mod TerraWorld Blueprints không chép chúng vào game, nên người chơi không thể nhân bản item bằng blueprint.
  • Trợ lý AI chạy được code, như các coding agent, còn có thể dùng lệnh npm run structure trong repository TerraWorld để tra tên, kiểm tra spec và render ảnh xem trước mà không cần trình duyệt.