Thông báo · TikAction Studio App
Dưới đây là bản hoàn chỉnh, trình bày theo dạng bài hướng dẫn để bạn có thể copy trực tiếp lên website.
HƯỚNG DẪN BIẾN DÙNG TRONG RULE & ACTION – TIKACTION STUDIO APP
TikAction Studio App hỗ trợ các biến động trong Rule và Action. Khi một sự kiện TikTok LIVE xảy ra, các biến sẽ tự động được thay thế bằng dữ liệu thực tế của người xem, quà tặng, bình luận hoặc người chơi Minecraft.
Ví dụ bạn tạo Action:
give {player} diamond 5Nếu người chơi mục tiêu hiện tại là:
.THUONG107thì TikAction sẽ tự thực thi:
give .THUONG107 diamond 5Bạn chỉ cần thay đổi người chơi mục tiêu trong ứng dụng, không cần sửa lại từng Action hoặc Rule.
1. BIẾN NGƯỜI CHƠI MINECRAFT
BiếnChức năngVí dụ giá trị{player}Tên người chơi Minecraft đang được chọn trong mục Tên người chơi mục tiêu.THUONG107{n}Viết tắt của {player}.THUONG107{mcplayer}Tên người chơi Minecraft mục tiêu.THUONG107{targetPlayer}Tên người chơi Minecraft mục tiêu.THUONG107Khuyến nghị
Nên sử dụng:
{player}hoặc dạng ngắn:
{n}Ví dụ:
give {player} diamond 5Nếu người chơi mục tiêu là:
.THUONG107lệnh thực tế sẽ là:
give .THUONG107 diamond 5Ví dụ với plugin Minecraft
box {player} tnt 3hoặc:
box {n} tnt 3Khi {player} = .THUONG107:
box .THUONG107 tnt 3Điểm tiện lợi là khi đổi người chơi mục tiêu sang người khác, toàn bộ Action và Rule sử dụng {player} sẽ tự sử dụng tên mới.
2. BIẾN NGƯỜI DÙNG TIKTOK
BiếnChức năngVí dụ{name}Tên hiển thị của người vừa tương tác với LIVETrần Thương{idtiktok}Username/TikTok ID của người tương tácthuong107{userid}User ID nội bộ của tài khoản TikTok nếu hệ thống nhận được7258123456789{name} KHÔNG PHẢI tên người chơi Minecraft
Ví dụ:
{name}có thể trả về:
Trần ThươngTrong khi:
{player}có thể là:
.THUONG107Hai biến này hoàn toàn khác nhau.
Ví dụ thông báo trong Minecraft
tellraw @a {"text":"{name} vừa tương tác với LIVE!"}Kết quả:
Trần Thương vừa tương tác với LIVE!Hiển thị TikTok ID
tellraw @a {"text":"TikTok: @{idtiktok}"}Kết quả:
TikTok: @thuong1073. BIẾN SỰ KIỆN TIKTOK LIVE
BiếnChức năngVí dụ{event}Loại sự kiện đang kích hoạt Rulegift, comment, follow, like{message}Nội dung chính của sự kiệnCho nổ TNT đi{comment}Nội dung bình luận TikTokCho nổ TNT đi{likeCount}Số Like dùng để kích hoạt Rule Like20Ví dụ với bình luận
tellraw @a {"text":"[TikTok] {name}: {comment}"}Nếu:
{name} = Trần Thương {comment} = Cho nổ TNT điMinecraft sẽ hiển thị:
[TikTok] Trần Thương: Cho nổ TNT đi4. BIẾN QUÀ TẶNG TIKTOK
BiếnChức năngVí dụ{gift}Tên quà TikTokHoa hồng{giftId}ID của quà TikTok5655{unitCoins}Giá trị xu của 1 quà1{unitCount}Số đơn vị của lần xử lý hiện tại1{count}Số lượng hiện tại của sự kiện10{comboCount}Số lượng quà trong combo hiện tại10{coins}Tổng xu của combo/sự kiện hiện tại10{comboCoins}Tổng số xu của combo10{totalCoins}Tổng xu của sự kiện tại thời điểm Rule chạy105. VÍ DỤ QUÀ HOA HỒNG
Giả sử người xem tặng:
Tên quà: Hoa hồng Gift ID: 5655 Giá: 1 xu Combo: 10 quàCác biến sẽ có giá trị gần như:
BiếnGiá trị{gift}Hoa hồng{giftId}5655{unitCoins}1{unitCount}1{count}10{comboCount}10{coins}10{comboCoins}10{totalCoins}10Ví dụ:
tellraw @a {"text":"{name} vừa tặng {gift} x{comboCount} - {comboCoins} xu"}Kết quả:
Trần Thương vừa tặng Hoa hồng x10 - 10 xu6. VÍ DỤ QUÀ CÓ GIÁ TRỊ CAO HƠN
Giả sử:
Quà: Gift ABC Giá: 30 xu/quà Combo: 5Khi đó:
{unitCoins} = 30 {comboCount} = 5 {comboCoins} = 150 {coins} = 150 {totalCoins} = 150Ví dụ:
tellraw @a {"text":"{name} đã gửi {gift} x{comboCount}, tổng {comboCoins} xu!"}Kết quả:
Trần Thương đã gửi Gift ABC x5, tổng 150 xu!7. BIẾN {count} HOẠT ĐỘNG NHƯ THẾ NÀO?
{count} có ý nghĩa tùy vào loại sự kiện.
Rule Like
Ví dụ cấu hình:
Cứ 20 Like → chạy Rule 1 lầnKhi đủ 20 Like:
{event} = like {count} = 20 {likeCount} = 20Action:
say Đã đạt thêm {likeCount} lượt thích!Kết quả:
Đã đạt thêm 20 lượt thích!Nếu hệ thống nhận 45 Like:
20 Like → chạy lần 1 20 Like → chạy lần 2 5 Like → giữ lại để cộng tiếp8. RULE FOLLOW THEO SỐ LƯỢNG
Ví dụ:
Cứ 5 Follow → chạy 1 lầnKhi đủ 5 Follow:
{event} = follow {count} = 5Ví dụ Action:
tellraw @a {"text":"LIVE vừa nhận thêm {count} Follow!"}Kết quả:
LIVE vừa nhận thêm 5 Follow!9. RULE COMMENT THEO SỐ LƯỢNG
Ví dụ:
Cứ 3 bình luận → chạy 1 lầnKhi đủ 3 bình luận:
{event} = comment {count} = 3 {name} = người gửi bình luận hiện tại {comment} = bình luận hiện tạiVí dụ:
tellraw @a {"text":"{name}: {comment}"}10. RULE GIFT VÀ COMBO QUÀ
Ví dụ bạn cấu hình:
Quà: Hoa hồng Bắt đầu từ quà thứ: 3Nếu người xem gửi combo:
Hoa hồng x1 → chưa chạy Hoa hồng x2 → chưa chạy Hoa hồng x3 → chạy Hoa hồng x4 → chạy Hoa hồng x5 → chạyỞ lần x5:
{gift} = Hoa hồng {giftId} = 5655 {count} = 5 {comboCount} = 511. CÁC VÍ DỤ ACTION MINECRAFT
Cho vật phẩm
give {player} diamond 5Cho TNT
give {player} tnt 10Teleport
tp {player} 0 100 0hoặc:
tp {n} 100 80 -200Triệu hồi TNT tại người chơi
execute at {player} run summon tnt ~ ~ ~Triệu hồi sét
execute at {player} run summon lightning_bolt ~ ~ ~Triệu hồi Zombie
execute at {player} run summon zombie ~ ~ ~Làm người chơi bị mù
effect give {player} minecraft:blindness 5 0 trueLàm người chơi chậm
effect give {player} minecraft:slowness 5 2 trueĐưa người chơi lên cao
tp {player} ~ ~20 ~12. HIỂN THỊ BÌNH LUẬN TIKTOK TRONG MINECRAFT
tellraw @a {"text":"[TikTok] {name}: {comment}"}Ví dụ:
[TikTok] Trần Thương: Cho nổ TNT điCó thể thêm TikTok ID:
tellraw @a {"text":"[TikTok] {name} (@{idtiktok}): {comment}"}Kết quả:
[TikTok] Trần Thương (@thuong107): Cho nổ TNT đi13. THÔNG BÁO FOLLOW
tellraw @a {"text":"{name} (@{idtiktok}) vừa Follow LIVE!","color":"green"}Ví dụ:
Trần Thương (@thuong107) vừa Follow LIVE!14. THÔNG BÁO QUÀ TẶNG
tellraw @a {"text":"{name} tặng {gift} • {unitCoins} xu","color":"gold"}Ví dụ:
Trần Thương tặng Hoa hồng • 1 xu15. HIỂN THỊ COMBO QUÀ
tellraw @a {"text":"{name} đã gửi {gift} x{comboCount} • tổng {comboCoins} xu"}Ví dụ:
Trần Thương đã gửi Hoa hồng x15 • tổng 15 xu16. RULE 20 LIKE → TNT
Cấu hình Rule:
Loại sự kiện: Like Số lượng: 20 Cách chạy: Lệnh Minecraft trực tiếpLệnh:
execute at {player} run summon tnt ~ ~ ~ tellraw @a {"text":"Đủ {likeCount} Like! TNT xuất hiện tại {player}"}Cứ đủ 20 Like, TikAction sẽ chạy sự kiện một lần.
17. QUÀ TẶNG → TNT
Ví dụ Rule:
Loại: Quà tặng Quà: Hoa hồng Action: TNT tại người chơiAction:
execute at {player} run summon tnt ~ ~ ~Mỗi khi Rule thỏa điều kiện, TNT xuất hiện tại người chơi đang được chọn.
18. QUÀ TẶNG → TITLE TRONG MINECRAFT
Có thể sử dụng:
title @a title {"text":"{name} tặng {gift}!","color":"gold","bold":true}và:
title @a subtitle {"text":"x{comboCount} • {comboCoins} xu","color":"yellow"}Kết quả ví dụ:
TRẦN THƯƠNG TẶNG HOA HỒNG! x10 • 10 xu19. ACTION CÓ THỂ CHẠY NHIỀU LỆNH
Trong TikAction Studio App:
Mỗi dòng là một lệnh Minecraft.
Ví dụ một Action:
title @a title {"text":"{name} tặng {gift}!","color":"gold"} execute at {player} run summon tnt ~ ~ ~ playsound minecraft:entity.generic.explode master @a ~ ~ ~ 1 1 tellraw @a {"text":"Combo x{comboCount} • {comboCoins} xu"}TikAction sẽ thực hiện lần lượt:
1. Hiện Title 2. Triệu hồi TNT 3. Phát âm thanh 4. Gửi thông báo20. ACTION DÙNG CHUNG CHO NHIỀU RULE
Bạn không cần tạo Action mới cho từng quà.
Ví dụ tạo một Action:
Tên Action: TNT tại người chơi Lệnh: execute at {player} run summon tnt ~ ~ ~Sau đó có thể dùng Action đó cho:
Hoa hồng → TNT tại người chơi TikTok → TNT tại người chơi 20 Like → TNT tại người chơi 5 Follow → TNT tại người chơiNếu sau này muốn đổi người chơi mục tiêu, chỉ thay:
Tên người chơi mục tiêukhông cần chỉnh từng Rule.
21. BẢNG BIẾN NHANH
BiếnCông dụng{player}Tên người chơi Minecraft mục tiêu{n}Viết tắt của {player}{mcplayer}Tên người chơi Minecraft mục tiêu{targetPlayer}Tên người chơi Minecraft mục tiêu{name}Tên hiển thị người TikTok{idtiktok}TikTok username/ID{userid}User ID TikTok{event}Loại sự kiện{message}Nội dung chung của sự kiện{comment}Nội dung bình luận{gift}Tên quà{giftId}ID quà{unitCoins}Giá trị xu của một quà{unitCount}Số đơn vị quà của lần xử lý{count}Số lượng sự kiện{comboCount}Số quà trong combo{coins}Tổng xu sự kiện/combo{comboCoins}Tổng xu combo{totalCoins}Tổng xu của event{likeCount}Số Like dùng trong Rule Like22. PHÂN BIỆT NHỮNG BIẾN DỄ NHẦM
BiếnKhông nên nhầm vớiKhác nhau{player}{name}{player} là người chơi Minecraft, {name} là người TikTok{gift}{giftId}Một cái là tên quà, một cái là ID{unitCoins}{comboCoins}Một cái là giá 1 quà, một cái là tổng xu combo{count}{comboCount}{count} là số lượng của event, {comboCount} chuyên dùng cho combo Gift{comment}{message}{comment} dành riêng cho nội dung bình luận23. VÍ DỤ TỔNG HỢP
Giả sử:
Người chơi Minecraft: .THUONG107 Người tặng: Trần Thương TikTok: @thuong107 Quà: Hoa hồng Gift ID: 5655 Giá: 1 xu Combo: 10Action:
title @a title {"text":"{name} tặng {gift}!","color":"gold"} title @a subtitle {"text":"x{comboCount} • {comboCoins} xu","color":"yellow"} execute at {player} run summon tnt ~ ~ ~ tellraw @a {"text":"TikTok @{idtiktok} vừa tặng quà cho {player}"}Sau khi thay biến, TikAction sẽ thực thi tương đương:
title @a title {"text":"Trần Thương tặng Hoa hồng!","color":"gold"} title @a subtitle {"text":"x10 • 10 xu","color":"yellow"} execute at .THUONG107 run summon tnt ~ ~ ~ tellraw @a {"text":"TikTok @thuong107 vừa tặng quà cho .THUONG107"}24. LƯU Ý KHI TẠO ACTION & RULE
Biến phải được viết đúng trong dấu { }.
Ví dụ đúng:
Không viết:
Có thể sử dụng nhiều biến trong cùng một lệnh.
Ví dụ:
tellraw @a {"text":"{name} tặng {gift} x{comboCount} cho {player}"}Một Action có thể chứa nhiều dòng lệnh.
Rule có thể chạy Action đã lưu hoặc lệnh Minecraft trực tiếp.
Khi Rule gọi Action, dữ liệu của sự kiện TikTok hiện tại sẽ được truyền vào Action.
Khi bấm Test Action/Test Rule, TikAction sử dụng dữ liệu thử nghiệm; khi LIVE thật, biến sẽ được thay bằng dữ liệu TikTok LIVE thực tế.
Tóm tắt dễ nhớ
{player} → Người chơi Minecraft {name} → Tên người TikTok {idtiktok} → TikTok ID {comment} → Bình luận {gift} → Tên quà {giftId} → ID quà {unitCoins} → Xu của 1 quà {comboCount} → Số quà combo {comboCoins} → Tổng xu combo {likeCount} → Số Like {event} → Loại sự kiệnTikAction Studio App – TikTok LIVE → Rule → Action → Minecraft, hoàn toàn trực tiếp trên điện thoại.
