腳本常見問題
?彼得兔
更新時間: 2024-05-22 17:54:44
在查閱開發者學院中的腳本API時，若有任何問題或建議，歡迎通過問卷進行反饋！【點我填寫問卷】
1.Block中的data在什么地方使用
data使用有具體需求,此處不建議開發者使用。開發者盡可能使用已封裝過的沒有data的新接口

?

?
2.自定義的Block和Item應該如何獲取ID (或 data?)(用于 setBlock、spawnItem 等)
有兩種辦法可以獲取到自定義類型的ID，<1>使用手持觸發器去點擊獲取 <2>依賴相關的觸發事件去打印ID 比如，如果是自定義的方塊或者生物，可以將其放置在地圖里然后用手持觸發器去點擊獲取信息，也可以通過觸發相關事件去打印出ID。 代碼示例如下：

Callback_ClickBlock = function(event_args)
? ?local blockid = event_args['blockid']
? ?Chat:sendSystemMsg('點擊的方塊ID為'..blockid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], Callback_ClickBlock)
Lua
?

?

3.Block 接口中的 setBlockAllForNotify/setBlockAllForUpdate 方法的參數 flag 需要更多信息
setBlockAllForNotify/setBlockAllForUpdate方法中的flag和data參數對開發者來說都是不可用的，新版wiki描述上已修正

?

?

4.ObjectLib 方法里的 uuid 該如何獲取
目前開發者暫時沒法直接獲取到，我們會在下一版里迭代更新，詳情請關注更新通知

?

?

5.World:playSoundEffectOnPos 方法的 soundId 參數需要更多信息
最新一期Wiki會放出soundId[2]表，與觸發器內的音效庫同步

?

?

6.World 類中可否提供一個獲取有所有 Actor 的方法，或者歷遍其的方法 (非 World:getActorsByBox)
由于游戲機制及效率考慮的原因，此功能不給予提供。但我們會提供觸發器生物庫的ActorId[3]表

?

?

7.Event 需要更詳細的用法及參數解釋
Event即為開發者事件，是指玩家在游戲內進行了某些操作后觸發的對應事件。比如玩家點擊了某個方塊， 這時就會觸發玩家的點擊方塊事件，即名為"Player.ClickBlock"的事件，開發者只要注冊監聽該事件就能進行點擊方塊后的對應操作。 注冊監聽事件的方法如下：ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], function(event_args) ... end)。 而開發者事件在進行回調時會傳回來一些對應的參數，每個開發者事件對應的參數可參考wiki中的事件系統[4]部分。

?

?

8.UI 接口中的 setGBattleUI/setShapeLine/setShapeCircle 方法的參數 name 及 uiname 需要更多信息
1)setGBattleUI方法的參數name是string類型的枚舉值，可選值有如下幾種情況:

name?? ?value type?? ?value describe
'left_title'?? ?string?? ?左標題（第1）
'right_title'?? ?string?? ?右標題（/40）
'left_desc'?? ?string?? ?左描述（大吉大利，我是第一）
'left_little_desc'?? ?string?? ?左簡述（排名1）
'right_little_desc'?? ?string?? ?右簡述（戰勝4）
'battle_btn'?? ?boolean?? ?比分導航欄面板按鈕顯示
'result'?? ?boolean?? ?比賽結果顯示
'result_bkg'?? ?boolean?? ?比賽結果底板顯示
'reopen'?? ?boolean?? ?再來一局按鈕顯示
?

2)setShapeLine及setShapeCircle這兩個接口目前暫時無效果，可不用理會。后面自定義用戶界面(Custom UI)完成后可將其替代

?

?

9.UI:ShowScreenEffect 方法的 type 需要更多信息
該接口是用于顯示屏幕特效，其中type的值為1表示speedline，2表示powerline，3表示fog

?

?

10.Game:addRenderGlobalEffect 方法的 path 參數需要更多信息
path即為全局特效的路徑，目前可用的是path只有"particles/Fog.ent"，詳情可參考范例集合[5]里面給出的例子

?

?

11.Game:getDefString 方法的 id 需要更多信息
不提倡開發者使用上述接口，鼓勵開發者使用自己定義的字符串

?

?

12.Player:setActionAttrState 方法的 actionattr 參數需要更多信息
setActionAttrState是設置玩家特殊屬性的狀態(例如可移動、可攻擊等)的接口，actionattr參數可參考PLAYERATTR_ENABLE[6]

?

?

13.Team 接口中的 teamid 參數需要更多信息
目前我們游戲中最多支持六個隊伍，六個隊伍的ID及顏色對應如下：?

? 隊伍?? ? ?對應顏色?? ? TeamID
?隊伍1?? ? 紅色?? ? 1
?隊伍2?? ? 藍色?? ? 2
?隊伍3?? ? 綠色?? ? 3
?隊伍4?? ? 黃色?? ? 4
?隊伍5?? ? 橙色?? ? 5
?隊伍6?? ? 紫色?? ? 6
?觀戰隊?? ? 無?? ? 999
Team相關接口中，可以teamid使用-1表示全部隊伍。玩家或生物如果不設置隊伍的話默認teamid是為0，也是無隊伍的一種

?

?

14.appendSpeed 接口中的x,y,z參數信息
該接口的參數x,y,z表示設定一個移動距離，需要傳入整數。

案例：假設把Z設定為5，當執行一次該接口后，那么objid就會向+z軸移動5格的距離

寫法：appendSpeed(objid,0,0,5)

?

?

15.getBlockPowerStatus 接口中的pos的使用方法
假設想判斷坐標為（7、7、7）位置的方塊通電狀態

正確的寫法：

local pos = {x=7,y=7,z=7}
Block:getBlockPowerStatus(pos)
Lua
常見錯誤寫法：

local pos = {7,7,7}
Block:getBlockPowerStatus(pos)
Lua
?

?

16.UI接口為什么沒有效果？
ui相關的接口暫時不能用，等后續更新。

?

?

17.如何讓游戲開始5秒后，每隔5秒生成一批生物？
--5秒后開始刷怪 每隔5秒刷一次 坐標(0,7,0) 怪物id3400 生成5只
local function r(e)
? ? local t=e.second
? ? if t>5 and (t-20)%5==0 then
? ? ? ? World:spawnCreature(0,7,0,3400,5)
? ? end
end
ScriptSupportEvent:registerEvent("Game.RunTime",r)
Lua
?

?

18.游戲坐標(x,y,z)分別指什么？
x：橫坐標，y：豎坐標，z：縱坐標；

（x，y，z）代表：坐標（x，z）高度y的位置，如圖：

?

?

19.如何查看某個方塊的坐標？
--點擊方塊顯示坐標
local function f2(e)
? ? local x,y,z=math.floor(e.x),math.floor(e.y),math.floor(e.z)
? ? Chat:sendSystemMsg("( "..x.." , "..y.." , "..z.." )")
? ? print(x,y,z)
end
ScriptSupportEvent:registerEvent('Player.ClickBlock',f2)
Lua
?

?

20.輸出的聊天框消息為什么會是星號(*)？
數字太多會被屏蔽，可以使用print輸出，然后打開“測試”，在運行日志里查看：

?

?

21.可以自定義NPC的AI嗎？
目前沒有相關接口。可以使用插件里自帶的一些AI。

?

?

22.為什么生成方塊接口那么卡？
不要一次性生成太多方塊，不同設備性能不同，一般盡量不要超過100。

?

?

23.如何修改玩家的血量和飽食度？或者跳躍高度、移動速度等屬性？
使用Player:setAttr(uid,attr,value)接口。

?

?

24.如何不允許玩家放置某種特定方塊？
--不允許放置的方塊id為1
local function f3(e)
? ? if e.blockid==1 then
? ? ? ? Block:destroyBlock(e.x,e.y,e.z)
? ? end
end
ScriptSupportEvent:registerEvent('Block.PlaceBy',f3)
Lua
?

?

25.為什么我用腳本生成的生物，離一定距離的話，隔段時間就消失了？
這是bug，已經提交修復，等待后續更新。

?

?

26.如何在游戲開始30秒后，從(0,7,0)到(15,10,15)范圍內隨機生成一些生物？
--30:游戲開始30秒后 (0,7,0)和(15,10,15):生成范圍 {{3400,5},{3401,6},{3402,7}}:生成的生物id和數量
local st=30
local x0,y0,z0=0,7,0
local x1,y1,z1=15,10,15
local actors={{3400,5},{3401,6},{3402,7}}
local function r(e)
? ? local t=e.second
? ? if t==st then
? ? ? ? local i=0
? ? ? ? for i=1,#actors do
? ? ? ? ? ? World:spawnCreature(math.random(x0,x1),math.random(y0,y1),math.random(z0,z1),actors[i][1],actors[i][2])
? ? ? ? end
? ? end
end
ScriptSupportEvent:registerEvent("Game.RunTime",r)
Lua
?

?

27.如何更改玩家模型？
修改狀態插件，在“效果”里選擇“更改玩家模型”。需要改模型的時候使用Actor:addBuff(objid,buffid,bufflv)接口給玩家添加這個狀態即可。

?

?

28.能否讓玩家在某個區域范圍內，自動向前加速？
local x0,y0,z0=0,7,0
local x1,y1,z1=15,10,15
local function r()
? ? local r,n,ps=World:getAllPlayers(1)
? ? local i=0
? ? for i=1,n do
? ? ? ? local r2,x,y,z=Player:getPosition(ps[i])
? ? ? ? if x>x0 and x<x1 and y>y0 and y<y1 and z>z0 and z<z1 then
? ? ? ? ? ? local r3,dx,dy,dz=Actor:getFaceDirection(ps[i])
? ? ? ? ? ? Actor:appendSpeed(ps[i],dx/math.abs(dx+dz),0,dz/math.abs(dx+dz))
? ? ? ? end
? ? end
end
ScriptSupportEvent:registerEvent("Game.Run",r)
Lua
?

?

29.如何查看生物id？
--點擊生物，輸出id
local function c(e)
? ? local r,id=Creature:getActorID(e.toobjid)
? ? Chat:sendSystemMsg(id)
end
ScriptSupportEvent:registerEvent('Player.ClickActor',c)
Lua
?

?

30.如何清空玩家背包？
使用Backpack:clearAllPack(uid)接口。

?

?

31.為什么使用Player:setPosition(uid,x,y,z)接口，玩家會卡在虛空無法移動？
如果設置的坐標距離過遠，不在玩家加載的區塊范圍內（視野范圍），就會導致玩家卡在虛空。可以使用“復活玩家到指定坐標”代替，即Player:reviveToPos(uid,x,y,z)接口。

?

?

32.如何修改生物屬性，比如血量、速度等？
使用Creature:setAttr(objid,attr,value)接口。

?

?

33.如何等待1秒后繼續執行？
threadpool:wait(1)
Lua
?

?

34.如何在指定位置生成生物？
使用World:spawnCreature(x,y,z,actorid,num)接口。

?

?

35.如何攻擊生物時，在生物頭頂顯示剩余血量？
local function Eath(e)
? ? local p,a=e.eventobjid,e.toobjid
? ? local r=Actor:isPlayer(a)
? ? if r~=0 then
? ? ? ? local r1,maxhp=Creature:getAttr(a,1)
? ? ? ? local r2,hp=Creature:getAttr(a,2)
? ? ? ? Actor:shownickname(a,true)
? ? ? ? Actor:setnickname(a,"#G"..math.floor(hp).."#R/"..math.floor(maxhp))
? ? end
end
ScriptSupportEvent:registerEvent('Player.AttackHit',Eath)
Lua
?

?

36.能否監聽玩家放置生物蛋的事件？
可以，玩家放置生物蛋會觸發“生物生成”事件。

?

?

37.如何實現玩家長按Shift加速？
監聽“長按按鍵事件”，判斷事件中的按鍵如果是Shift，就增加玩家速度。

?

?

38.如何獲取玩家手持道具的id？
使用Player:getCurToolID(uid)接口。

?

?

39.為什么計時器窗口會消失？
打開背包后計時器的文字會消失，目前不能解決。可以把顯示計時器放在“游戲運行”事件里。

?

?

40.如何設置玩家坐標？
使用Actor:setPosition(objid,x,y,z)或Player:setPosition(objid,x,y,z)接口。

?

?

41.能否在游戲運行中更改地圖游戲人數上限？
不能。但是可以監聽玩家進入游戲事件，然后判斷當前游戲人數是否大于某個值，是的話就傳送玩家到地圖外面。

?

?

42.能否把玩家踢出游戲？
可以設置玩家游戲結果為負，或者在“游戲運行”事件里設置玩家坐標的高度為負，讓玩家在地圖下方無法移動。

?

?

43.為什么設置了方塊無法被破壞，但還是會被炸掉？
目前“方塊無法被破壞”無法避免炸彈、激光等的破壞，只能在插件設置方塊抗性為-1，或者監聽方塊被破壞事件，破壞后重新生成。

?

?

44.玩家離開一定距離后，NPC會消失，這個bug可以解決嗎？
已經提交，等待后續更新。目前可以改成“玩家進入區域，生成NPC；玩家離開區域，移除NPC”來代替。

?

?

45.如何改變生物模型？
目前沒有這種接口。只能先移除再創建。

?

?

46.能否獲取整個地圖的生物數量？
無法獲取整個地圖的，但是可以獲取指定區域的生物數量。

?

?

47.如何清除某個生物？
使用World:despawnCreature(objid)或Actor:killSelf(objid)接口。

?

?

48.能否獲取指定坐標上的生物id？
不能從坐標獲取生物。可以從范圍獲取，獲取到的是整個區域內的生物。

?

?

49.如何讓生物出現幾秒后消失，如何再出現，一直循環？
as={}
function r2(e)
? ? if e.second%4==0 then
? ? ? ? _,as=World:spawnCreature(0,7,0,3400,5)
? ? elseif e.second%4==2 then
? ? ? ? for _,a in pairs(as) do
? ? ? ? ? ? World:despawnActor(a)
? ? ? ? end
? ? end
end
ScriptSupportEvent:registerEvent([=[Game.RunTime]=],r2)
Lua
?

?

50.能否移除家園寵物？
local function depet(e)
? ? local p,a=e.eventobjid,e.toobjid
? ? if Actor:isPlayer(p)==1001 then a=p end
? ? local _,id=Creature:getActorID(a)
? ? if id>10000 then
? ? ? ? World:despawnActor(a)
? ? end
end
ScriptSupportEvent:registerEvent([=[Player.ClickActor]=],depet)
ScriptSupportEvent:registerEvent([=[Actor.Collide]=],depet)
Lua
?

?

51.如何設置生物的隊伍？
--玩家點擊生物，設置生物隊伍
--當點擊生物時會執行此函數
local function Player_ClickActor(event)
?? ?--設置生物所屬的隊伍
?? ?--第一個參數為要設置的生物在存檔中的id
?? ?--第二個參數為要設置為的隊伍id
?? ?Creature:setTeam(event.toobjid,1)
?? ?--在聊天框顯示
?? ?Chat:sendSystemMsg("objid為"..event.toobjid.."的生物被設置到了隊伍1")
end
--注冊監聽器，點擊生物時執行Player_ClickActor函數
ScriptSupportEvent:registerEvent([=[Player.ClickActor]=],Player_ClickActor)