# hammer.SendCommand

- **Ortam:** Sunucu
- **İngilizce aslı:** https://wiki.facepunch.com/gmod/hammer.SendCommand
- **Çeviri tarihi:** 2025-09-08

```lua
string hammer.SendCommand( string cmd )
```

## Açıklama

Eğer Hammer, mevcut harita yüklenmiş bir şekilde çalışıyorsa, Hammer'a komut gönderir.

## Argümanlar

1. [string](https://gmod.tr/wiki/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](https://gmod.tr/wiki/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.

```lua
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()
```

- [GMod Wiki ana sayfası](https://gmod.tr/wiki)

---

[Tüm sunucular](https://gmod.tr/) · [GmodTR Launcher](https://gmod.tr/launcher) · [Rehber](https://gmod.tr/rehber) · [GMod Wiki](https://gmod.tr/wiki) · [GmodTR nedir?](https://gmod.tr/hakkinda) · [Sunucu ekle](https://gmod.tr/sunucu-ekle) · [Discord](https://discord.gg/gmodtr)

Kaynak: https://gmod.tr/wiki/hammer.SendCommand
