hammer.SendCommand
Açıklama
Eğer Hammer, mevcut harita yüklenmiş bir şekilde çalışıyorsa, Hammer'a komut gönderir.
Argümanlar
1 string cmd
Argümanlar dahil gönderilecek komut
Tüm komutlar "komut degisken1 degisken2 vb." formatındadır.
Bir varlığı x y z ile seçen tüm komutlar, ondalık sayılar dahil tam konumu kullanmalıdır. Örneğin: -354.4523 123.4
Komut Listesi
| Komut | Açıklama |
|---|---|
| "session_begin mapName mapVersion" | Düzenleyiciyi kilitleyerek bir Hammer düzenlemesi başlatır. mapName, yol veya sonek olmadan mevcut haritanın adıdır, mapVersion ise .vmf dosyasındaki mevcut sürümdür. |
| "session_end" | Düzenleyicinin kilidini açarak bir Hammer düzenlemesini sonlandırır. |
| "map_check_version mapName mapVersion" | Bu sadece session_begin'den sonra çalışır, bu yüzden doğru sürümü zaten biliyor olursunuz ve bu sadece "ok" döndürür, bu fonksiyon görünüşe göre işe yaramaz. |
| "entity_create entityClass x y z" | x y z konumunda entityClass türünde bir varlık oluşturur. |
| "entity_delete entityClass x y z" | x y z konumundaki entityClass türündeki bir varlığı siler. |
| "entity_set_keyvalue entityClass x y z "key" "value"" | x y z konumundaki entityClass türündeki bir varlığın Anahtar-Değer (KeyValue) çiftini ayarlar. Anahtar adı ve Değer metni tırnak içinde olmalıdır. |
| "entity_rotate_incremental entityClass x y z incX incY incZ" | x y z konumundaki entityClass türündeki bir varlığı incX incY incZ kadar döndürür. |
| "node_create nodeClass nodeID x y z" | x y z konumunda, nodeID'ye sahip nodeClass türünde bir yapay zeka düğümü (AI node) oluşturur. Sorun yaşamamak için nodeID'yi benzersiz tutmalısınız. |
| "node_delete nodeID" | nodeID'ye sahip düğüm(ler)i siler. Eğer aynı nodeID'ye sahip birden fazla düğüm varsa, bu komut hepsini siler. |
| "nodelink_create startNodeID endNodeID" | startNodeID ve endNodeID yapay zeka düğümleri arasında bir bağlantı oluşturur. |
| "nodelink_delete startNodeID endNodeID" | startNodeID ve endNodeID yapay zeka düğümleri arasındaki bir bağlantıyı kaldırır. |
Döndürülen Değerler
1 string
Komut başarılı olursa "ok", aksi takdirde "badcommand" döndürür.
Tüm değişiklikler sadece Hammer'da gerçekleşir, oyun içinde herhangi bir gösterim/geri bildirim YOKTUR.
Örnek
Tüm bu fonksiyonları test ederken yazdığım bir Hammer fonksiyon kütüphanesi.
Lütfen bu kütüphaneyi olduğu gibi veya değiştirerek kullanmaktan çekinmeyin.
if ( !SERVER) then return end
-- Hammer Düzenleyici Lua Kütüphanesi
-- Yazan: Malcolm Greene Jr (Fantym420)
-- Lua kodundan Hammer düzenleyici komutlarına kolay erişim sağlar
-- Tüm komutlar çalıştığında "ok", çalışmadığında ise "badcommand" döndürür
-- Tüm değişiklikler sadece Hammer'da görünür, bu yüzden oyun içinde bir şeyler görmek istiyorsanız
-- kendi hayalet varlıklarınızı (ghost entities) vb. yazmalısınız.
hammerLib = {}
hammerLib.mapName = game.GetMap() -- Harita adını al
hammerLib.vBSPMapVer = game.GetMapVersion() -- Bu, VBSP harita sürümüdür, bize VMF harita sürümü gerekiyor
hammerLib.mapVer = hammerLib.vBSPMapVer -- yer tutucu değer, findGoodVer mevcut vmf sürümünü deneme yanılma yoluyla bulacaktır
-- Hammer'ın sevdiği şekilde boşluklu bir vektör dizesi döndürür
function hammerLib.vectorToString(vec)
return tostring(vec.x) .. " " .. tostring(vec.y) .. " " .. tostring(vec.z)
end
-- mevcut sürümü kullanarak bir oturum başlatmayı dener, başarısız olursa bir sonrakini dener
-- eğer 20 denemede bulamazsa, daha fazla düzenleme yapmadan önce muhtemelen haritanızı derlemelisiniz
function hammerLib.findGoodVer()
local verInc = 0
local result = ""
for verInc = 0, 20 do
hammerLib.mapVer = hammerLib.vBSPMapVer + verInc
result = hammerLib.startSession()
if result == "ok" then
break
end
if verInc == 20 then
print("Uygun Sürüm Bulunamadı, Lütfen Haritanızı Yeniden Derleyin!!!")
end
end
hammerLib.endSession()
end
-- hata ayıklama bilgilerini yazdırabilmem için hammer.SendCommand için basit bir sarmalayıcı (wrapper)
-- komut dizelerini ve sonuçları konsolda görmek için print'lerin yorum satırını kaldırın
function hammerLib.runCommand(cmd)
local result = ""
--print("çalıştırılıyor " .. cmd)
result = hammer.SendCommand(cmd)
--print(cmd .. " sonucu: " .. result)
return result
end
-- Bir düzenleme başlatılırken her zaman çalıştırılır
-- Bu, siz session_end komutunu verene kadar Hammer'ı kilitler
function hammerLib.startSession()
local cmd = "session_begin " .. hammerLib.mapName .. " " .. hammerLib.mapVer
return hammerLib.runCommand(cmd)
end
-- Oturumu sonlandırarak Hammer'ın kilidini açar
function hammerLib.endSession()
local cmd = "session_end"
return hammer.SendCommand(cmd)
end
-- işe yaramaz fonksiyon, eğer doğru bir ad ve sürüm verirseniz "ok" döndürür
-- ancak çalıştırmak için zaten iyi bir sürüme sahip olmanız gerekir çünkü session_start'ı çalıştırdınız
-- eksiksiz olması için burada uygulandı, eğer hiçbir değişken vermezseniz sadece saklanan bilgiyi kullanır.
function hammerLib.mapCheckVersion(mcName, mcVer)
mcName = mcName or hammerLib.mapName
mcVer = mcVer or hammerLib.mapVer
local cmd = "map_check_version " .. mcName .. " " .. mcVer
local result = ""
hammerLib.startSession()
result = hammerLib.runCommand(cmd)
hammerLib.endSession()
return result
end
-- bu, verilen pozisyonda entityClass türünde bir varlık oluşturur
-- Fırça (brush) komutuna bir bağlantı olmadığı için bunun sadece nokta varlıklarla (point entities) çalıştığına inanıyorum
function hammerLib.entityCreate(entityClass, entityPos)
if (entityClass == nil) or (entityPos == nil) then return end
local cmd = "entity_create " .. entityClass .. " " .. hammerLib.vectorToString(entityPos)
local result = ""
hammerLib.startSession()
result = hammerLib.runCommand(cmd)
hammerLib.endSession()
return result
end
-- bu, entityPos'taki entityClass türündeki bir varlığı siler
-- NOT: Varlığın TAM konumu olmalıdır, ondalık sayılar ve hepsi dahil, yoksa başarısız olur
function hammerLib.entityDelete(entityClass, entityPos)
if (entityClass == nil) or (entityPos == nil) then return end
local cmd = "entity_delete " .. entityClass .. " " .. hammerLib.vectorToString(entityPos)
local result = ""
hammerLib.startSession()
result = hammerLib.runCommand(cmd)
hammerLib.endSession()
return result
end
-- entityPos'taki entityClass türündeki varlık üzerinde bir Anahtar/Değer (Key/Value) çifti ayarlar
-- NOT: Varlığın TAM konumu olmalıdır, ondalık sayılar ve hepsi dahil, yoksa başarısız olur
function hammerLib.entitySetKeyValue(entityClass, entityPos, key, value)
if (entityClass == nil) or
(entityPos == nil) or
(key == nil) or
(value == nil) then return end
local cmd = "entity_set_keyvalue " .. entityClass .. " " .. hammerLib.vectorToString(entityPos) .. " \"" .. key .. "\" \"" .. value .. "\""
local result = ""
hammerLib.startSession()
result = hammerLib.runCommand(cmd)
hammerLib.endSession()
return result
end
-- bu, entityPos(vektör) konumundaki entityClass(dize) türündeki bir varlığı rotationInc(vektör) kadar döndürür
-- NOT: Varlığın TAM konumu olmalıdır, ondalık sayılar ve hepsi dahil, yoksa başarısız olur
function hammerLib.entityRotateIncremental(entityClass, entityPos, rotationInc)
if (entityClass == nil) or (entityPos == nil) then return end
local cmd = "entity_rotate_incremental " .. entityClass .. " " .. hammerLib.vectorToString(entityPos) .. " " .. hammerLib.vectorToString(rotationInc)
local result = ""
hammerLib.startSession()
result = hammerLib.runCommand(cmd)
hammerLib.endSession()
return result
end
-- Bu, nodePos'ta nodeID kimliğine sahip nodeClass türünde bir düğüm oluşturur
-- nodeID'yi benzersiz tutun, eğer tutmazsanız ve node_delete kullanırsanız, verilen kimliğe sahip tüm düğümleri siler
function hammerLib.nodeCreate(nodeClass, nodeID, nodePos)
if (nodeClass == nil) or (nodeID == nil) or (nodePos == nil) then return end
local cmd = "node_create " .. nodeClass .. " " .. nodeID .. " " .. hammerLib.vectorToString(nodePos)
local result = ""
hammerLib.startSession()
result = hammerLib.runCommand(cmd)
hammerLib.endSession()
return result
end
-- verilen nodeID'ye sahip düğüm(ler)i siler, ancak nodeID'ye sahip birden fazla düğüm varsa hepsi
-- silinir
function hammerLib.nodeDelete(nodeID)
if (nodeID == nil) then return end
local cmd = "node_delete " .. nodeID
local result = ""
hammerLib.startSession()
result = hammerLib.runCommand(cmd)
hammerLib.endSession()
return result
end
-- Bu, iki düğüm arasında bir bağlantı oluşturur, bağlantı sayısında bir sınır olup olmadığından emin değilim
-- şimdiye kadar düğüm başına en az 2 tane yapıyor
function hammerLib.nodeLinkCreate(node1ID, node2ID)
if (node1ID == nil) or (node2ID == nil) then return end
local cmd = "nodelink_create " .. node1ID .. " " .. node2ID
local result = ""
hammerLib.startSession()
result = hammerLib.runCommand(cmd)
hammerLib.endSession()
return result
end
-- Bu, iki düğüm arasındaki bir bağlantıyı siler
function hammerLib.nodeLinkDelete(node1ID, node2ID)
if (node1ID == nil) or (node2ID == nil) then return end
local cmd = "nodelink_delete " .. node1ID .. " " .. node2ID
local result = ""
hammerLib.startSession()
result = hammerLib.runCommand(cmd)
hammerLib.endSession()
return result
end
-- Hepsi yüklendi, mevcut VMF sürümünü saklamak için findGoodVer'i çalıştırın
hammerLib.findGoodVer()
Tüm sunucular · GmodTR Launcher · Rehber · GMod Wiki · GmodTR nedir? · Sunucu ekle · Discord