Skip to content

Plugin ​

Plugin là một file Luau của riêng bạn để sửa world thay bạn: những việc làm tay thì chán, viết một lần là xong. Xếp thẳng hàng các part này, tô màu tất cả những cái kia, gắn Prompt vào mọi cánh cửa, thêm dòng đầu cho mọi script.

Plugin nằm ở đâu ​

Trong thư mục plugins của KHIM Engine: Plugins > Open the Plugins Folder. Mỗi file .luau trong đó là một plugin. Thư mục trống sẽ có sẵn một ví dụ để đọc, Line up the selection.luau (Ctrl Alt L).

Chạy plugin từ:

  • menu Plugins,
  • bảng Plugins (View > Plugins),
  • bảng lệnh (Ctrl K, "Run plugin: ..."),
  • hoặc phím tắt riêng của nó.

Viết một plugin ​

lua
-- Puts a Prompt on each selected door and selects the last one.
-- shortcut: Ctrl+Alt+P
for _, door in selection do
    local prompt = new("Prompt", door)
    prompt.text = "Open"
end
studio.select(selection[#selection])
studio.notify("Prompts on " .. #selection .. " doors")
  • Dòng chú thích đầu tiên nói plugin làm gì; nó hiện cạnh plugin trong menu, bảng Plugins và bảng lệnh.
  • -- shortcut: Ctrl+Alt+P trong các dòng chú thích đầu cho nó một phím tắt: Ctrl hoặc Alt (thêm Shift nếu muốn), rồi một chữ cái, chữ số hoặc F1-F12. Chọn phím KHIM Engine chưa dùng (F1 liệt kê chúng). Bảng Plugins tô vàng dòng ghi phím không hợp lệ.

Plugin dùng được gì ​

Plugin chạy trên world đang dựng, với cùng API như script của game - world, new, vec3, rgb, tag và attribute, mọi thứ trong phần Tra cứu - cộng thêm:

TênLà gì
selectionDanh sách các part đang chọn
studio.select(things)Thứ được chọn khi plugin kết thúc: một part, một đối tượng, hoặc danh sách
studio.notify(text)Một thông báo ở góc khung nhìn
script.sourceNội dung một script - đọc và ghi được (chỉ trong plugin và Command Line, không bao giờ trong game)

Nó đổi được part, Lighting, đối tượng trên part (cài đặt, destroy(), new("Prompt", part)) và script (source, name). Mọi thay đổi trở lại world khi plugin kết thúc, thành một bước Undo.

Thêm ví dụ ​

lua
-- Tô vùng chọn bằng một sắc xanh lá ngẫu nhiên.
for _, part in selection do
    part.color = hsv(0.25 + math.random() * 0.1, 0.6, 0.5 + math.random() * 0.3)
end
lua
-- Gắn tag "Coin" cho mọi part tên Coin trong world.
for _, part in world:children() do
    if part.name == "Coin" then part:addTag("Coin") end
end
lua
-- Thêm một dòng đầu vào script của Door.
local door = world.Door.Script
door.source = "-- Mở khi người chơi bấm E\n" .. door.source

Command Line ​

Với việc làm một lần thì không cần file: Command Line dưới Console chạy Luau trên world ngay lập tức, cùng API.

Trình nhập .rbxl ​

Bảng Plugins còn có trình nhập có sẵn của KHIM cho world .rbxl / .rbxlx làm bằng Roblox Studio. Nó tắt cho tới khi bạn bật ở đó; khi bật, File > Import .rbxl / .rbxlx... sẽ xuất hiện. Xem Chuyển từ Roblox sang.