Minecraft Sunucu Konsol Komutları ve Kullanımı

Minecraft sunucu konsol komutları, sunucuyu oyuna girmeden yönetmenizi sağlayan komut setidir: stop ile sunucuyu kapatır, save-all ile dünyayı diske yazar, op ile yetki verir, ban ile oyuncu yasaklarsınız. Konsolda komutlar eğik çizgi olmadan yazılır ve konsol her zaman en yüksek yetki seviyesinde çalışır, yani OP olmanıza gerek kalmaz.

Bu sayfada vanilla sunucunun tüm temel komutlarını, Paper ve Purpur’un eklediği yönetim komutlarını, hedef seçicileri, gamerule listesini ve RCON ile uzaktan komut çalıştırmayı bulacaksınız. Anlatım işletim sisteminden bağımsızdır; konsola nasıl ulaşacağınız işletim sistemine göre değişir, komutların kendisi her yerde aynıdır.

Konsola Nasıl Erişilir?#

Konsol, sunucu sürecinin standart girdisidir. Ona ulaşmanın dört yaygın yolu vardır:

Panel konsolu

Pterodactyl, Pelican, Crafty veya Batihost web paneli üzerinden tarayıcıdan erişirsiniz. En pratik yöntemdir, komut geçmişi ve canlı log akışı sunar. Panel tarafındaki kullanımı Pterodactyl kullanım rehberinde anlatılıyor.

Doğrudan terminal / komut istemi

Sunucuyu kendiniz başlattıysanız komutları o pencereye yazarsınız. Linux tarafında oturumu kapatınca sunucunun düşmemesi için screen veya tmux kullanımı, Windows tarafında ise servis olarak çalıştırma gerekir.

RCON

Ağ üzerinden komut gönderen protokol. Discord botları, otomatik yeniden başlatma betikleri ve harici yönetim panelleri bunu kullanır.

Oyun içi sohbet

OP yetkisi olan bir oyuncu aynı komutları / önekiyle çalıştırabilir. Fark, oyuncunun bir konumu olmasıdır; konsolun yoktur.

Sunucu Yönetimi Komutları#

Günlük yönetimde en sık kullanacağınız komutlar bunlardır. Tablodaki komutların tamamı vanilla dedicated server’da çalışır, işaretli olanlar Paper/Purpur ile gelir.

Oyuncu Yönetimi Komutları#

Yetki verme, atma ve yasaklama işlemlerinin tamamı konsoldan yapılabilir. Bu komutlar sonuçlarını ops.json, banned-players.json ve banned-ips.json dosyalarına yazar; dolayısıyla sunucu taşırken bu dosyaları da götürmeniz gerekir.

Yasaklama süreli yapılamaz; vanilla ban komutunda süre parametresi yoktur. Süreli ban, geçmiş kaydı ve gerekçe arşivi istiyorsanız bir moderasyon eklentisi kurmanız gerekir. Tam OP dağıtmak yerine rollere göre izin vermek istiyorsanız LuckPerms ile yetki sistemi kurmayı okuyun; kimin hangi komutu çalıştırabileceğini tek tek belirleyebilirsiniz.

transfer komutu 1.20.5 ile geldi ve sunucu ağlarında ya da makine değiştirirken çok işe yarar: oyuncuları kapanacak sunucudan yenisine tek komutla aktarabilirsiniz. Makine değiştirme sürecinin tamamı için sunucu taşıma rehberine bakın.

Oyun İçi Müdahale Komutları#

Konsoldan dünyaya ve oyunculara doğrudan müdahale edebilirsiniz. Buradaki tek kural şudur: konsolun bir konumu olmadığı için hedefi her zaman açıkça belirtmelisiniz.

gamemode creative Ahmet
give Ahmet minecraft:netherite_ingot 8
clear Ahmet minecraft:dirt
tp Ahmet Mehmet
tp Ahmet 120 70 -340
kill @e[type=minecraft:item,distance=..64]
effect give Ahmet minecraft:regeneration 30 1
xp add Ahmet 500 points
time set day
weather clear 600
setworldspawn 100 65 200
spawnpoint Ahmet 100 65 200

Zaman ve hava komutları anında etkinleşir. time set day yerine sayısal değer de verebilirsiniz: time set 1000 sabah, time set 13000 gece demektir. weather komutunun üçüncü parametresi saniye cinsindendir.

Hedef Seçiciler ve Argümanları#

Hedef seçiciler, oyuncu adı yazmak yerine bir gruba komut uygulamanızı sağlar. Konsolda mesafeye dayalı seçiciler doğrudan çalışmaz, çünkü konsol dünyanın hiçbir noktasında değildir; bu durumda execute ile bir konum vermeniz gerekir.

Seçicileri köşeli parantez içindeki argümanlarla daraltırsınız. En çok kullanılanlar şunlardır:

@a[gamemode=survival]                 hayatta kalma modundaki oyuncular
@a[limit=1,sort=random]               rastgele tek oyuncu
@e[type=minecraft:zombie,limit=20]    en fazla 20 zombi
@e[type=!minecraft:player]            oyuncu olmayan tüm varlıklar
@a[team=kirmizi]                      kirmizi takimindaki oyuncular
@a[tag=vip]                           vip etiketli oyuncular
@a[scores={puan=10..}]                puani 10 ve uzeri olanlar
@e[distance=..32,type=minecraft:item] 32 blok icindeki yere dusmus esyalar

execute Komutu: Konsolun Eli Ayağı#

execute, bir komutu başka bir bağlamda çalıştırmanızı sağlar ve konsolun konum sorununu çözer. Yapı şudur: önce bağlamı değiştiren alt komutlar (as, at, in, positioned, if, unless), sonra run ve asıl komut.

execute as Ahmet at @s run tp @s ~ ~10 ~
execute in minecraft:the_nether run gamerule doFireTick false
execute positioned 0 64 0 run kill @e[type=minecraft:item,distance=..100]
execute as @a[gamemode=survival] run give @s minecraft:golden_apple 1
execute if entity @a[tag=admin] run say Yonetici cevrimici
execute at @a run particle minecraft:heart ~ ~2 ~ 0.4 0.4 0.4 0 6

İlk satır konsolun en sık ihtiyaç duyduğu kalıptır: "Ahmet gibi davran, onun bulunduğu yerde çalış" demek, göreli koordinatları kullanılabilir hale getirir. Bu kalıbı ezberlerseniz konsolda çalışmayan komutların büyük kısmı çalışır hale gelir.

gamerule Komutları#

gamerule kuralları dünya bazlı çalışır ve anında etkinleşir, yeniden başlatma gerektirmez. Mevcut değeri görmek için değer vermeden çalıştırın: gamerule keepInventory.

Çok oyunculu bir sunucuda performans için en anlamlı üç ayar randomTickSpeed, maxEntityCramming ve spawnChunkRadius’tur. Örnek bir yapılandırma:

gamerule randomTickSpeed 3
gamerule maxEntityCramming 16
gamerule spawnChunkRadius 1
gamerule announceAdvancements false
gamerule playersSleepingPercentage 50

Tick Kontrolü ve Performans Komutları#

Tick komutları, sunucunun oyun döngüsünü doğrudan yönetmenizi sağlar. Hata ayıklarken ve büyük yapıları incelerken çok işe yarar:

tick query          mevcut tick hizini ve ortalamayi gosterir
tick freeze         oyun dongusunu dondurur, oyuncular hareket edebilir
tick step 20        donmus haldeyken 20 tick ilerletir
tick unfreeze       dondurmayi kaldirir
tick rate 20        hedef tick hizini ayarlar (varsayilan 20)
tick sprint 1000    1000 tick'i mumkun oldugunca hizli isler

Paper tarafında ölçüm için tps ve mspt komutlarını kullanırsınız. mspt çıktısı 50 ms’in altındaysa sunucu tick’leri zamanında bitiriyor demektir; üstüne çıkıyorsa TPS düşmeye başlar. Paper Timings sistemini kaldırdığı için ayrıntılı profil çıkarmanın yolu artık spark eklentisidir:

spark profiler start --timeout 300
spark profiler stop
spark tps
spark health

RCON ile Uzaktan Komut Çalıştırma#

RCON, konsola ağ üzerinden komut göndermeyi sağlayan basit bir protokoldür. Discord botları, otomatik yeniden başlatma betikleri ve harici yönetim panelleri onunla konuşur. Açmak için server.properties dosyasına üç satır yazarsınız:

enable-rcon=true
rcon.port=25575
rcon.password=cok-uzun-ve-tahmin-edilemez-bir-parola
broadcast-rcon-to-ops=true

Değişiklikten sonra sunucuyu yeniden başlatın. broadcast-rcon-to-ops ayarı, RCON üzerinden gelen komutları çevrimiçi yöneticilere gösterir; ekip çalışıyorsanız açık bırakın. Dosyadaki diğer satırların ne yaptığını server.properties tam liste sayfasında bulabilirsiniz.

Konsol Çıktısını Okuma#

Konsol satırları belirli bir kalıpta gelir ve bu kalıbı tanımak sorun çözmeyi hızlandırır:

[11:42:07 INFO]: [Server thread/INFO]: Ahmet joined the game
[11:42:19 INFO]: [Server thread/WARN]: Can't keep up! Is the server overloaded? Running 2481ms behind
[11:43:02 INFO]: [Server thread/ERROR]: Could not pass event PlayerJoinEvent to EssentialsX v2.22.0

Köşeli parantez içindeki seviye etiketine bakın: INFO bilgilendirme, WARN dikkat edilmesi gereken bir durum, ERROR ise gerçek bir hata demektir. Hata satırının hemen ardından gelen Caused by: bloğu asıl sebebi söyler. Tüm konsol çıktısı logs/latest.log dosyasına yazılır; sunucu her yeniden başladığında önceki log tarihli bir .gz arşivine alınır. Çökme durumunda ayrıca crash-reports/ klasörü oluşur, bu dosyaları okumanın yöntemi crash report okuma sayfasında anlatılıyor.

Sık Karşılaşılan Konsol Sorunları#

"Unknown command" hatası#

Üç sebebi olur: komutu sağlayan eklenti yüklü değildir, komutun başına gereksiz yere / konmuştur ya da komut o sunucu yazılımında yoktur. plugins komutuyla eklentinin yeşil göründüğünü doğrulayın, sonra help yazıp komut listesini tarayın.

"An unexpected error occurred while trying to perform this command"#

Genellikle konsolun oyuncu bağlamı gerektiren bir komutu çalıştırmasından kaynaklanır. Komutu execute as OyuncuAdi at @s run ... ile sarmalayın. Hata devam ediyorsa logs/latest.log içindeki yığın izini okuyun; sorumlu eklentinin adı orada yazar.

Türkçe karakterler bozuk görünüyor#

Konsol kod sayfası UTF-8 değildir. Windows komut isteminde chcp 65001 ile UTF-8’e geçebilirsiniz. Kalıcı çözüm için sunucu mesajlarını Türkçe karakter içermeyecek biçimde yazmak ya da Windows Terminal kullanmaktır.

Komut çalıştı ama hiçbir şey olmadı#

Hedef seçici hiçbir varlığı eşleştirmemiş olabilir. @a[distance=..10] gibi mesafeye dayalı bir filtre konsolda boş küme döndürür. Ayrıca sendCommandFeedback kuralı false ise başarı mesajı gösterilmez, komut yine de çalışmıştır.

Sunucu stop komutuna yanıt vermiyor#

Ana iş parçacığı kilitlenmiş demektir. 60 saniye bekleyin; yanıt gelmezse süreci sonlandırmadan önce save-all flush denemek çoğu zaman işe yaramaz, çünkü aynı iş parçacığı bloke olmuştur. Bu durumda son yedeğe dönmeye hazır olun; düzenli yedek planı için yedekleme rehberine bakın.

Günlük Bakımda Kullanabileceğiniz Komut Akışı#

1. Sunucu durumunu ölçün#

   Güne tps ve mspt ile başlayın. TPS 19,5’in altına düşmüşse yük analizine geçin, spark health hızlı bir özet verir.

2. Yedek öncesi dünyayı dondurun#

   Otomatik yedek betiğiniz yoksa elle yedek alırken bu üçlüyü kullanın; kopyalama bitince save-on ile otomatik kaydetmeyi geri açın.

   save-off
   save-all flush
   save-on

3. Bakım duyurusu yapın#

   Yeniden başlatmadan önce oyuncuları uyarın. say tüm oyunculara, tell tek kişiye mesaj gönderir.

   say Sunucu 5 dakika icinde yeniden baslatilacak.
   whitelist on

4. Temiz kapatın#

   stop yazın ve konsolda "Saving worlds" ile "Closing Server" satırlarının geçtiğini görün. Bu satırları görmeden süreci sonlandırmayın.

Bu akışı otomatikleştirmek isterseniz RCON üzerinden komut gönderen bir zamanlanmış görev kurabilirsiniz. Panelli bir kurulumda aynı işi arayüzden zamanlayıcı olarak tanımlamak daha kolaydır; hazır panelli çözümler için web panelli sunucu paketlerine göz atabilirsiniz.

Özetle#

Minecraft sunucu konsol komutlarında bilmeniz gereken çekirdek şudur: konsolda / kullanılmaz, konsol en yüksek yetkiye sahiptir ve konsolun dünyada bir konumu yoktur. Günlük yönetimin tamamı stop, save-all, list, op, kick, ban, whitelist ve gamerule komutlarıyla döner. Konum isteyen komutlarda execute as ... at @s run ... kalıbı sorunun tamamını çözer.

Performans tarafında tps ve mspt ilk göstergelerinizdir, ayrıntılı profil için spark kurulur. Yetkileri konsoldan tek tek dağıtmak yerine gruplu bir izin sistemi kurmak uzun vadede çok daha yönetilebilirdir; başlangıç için OP verme ve yetki yönetimi sayfasını okuyun. Konsola tarayıcıdan erişebileceğiniz hazır bir kurulum arıyorsanız Minecraft sunucu paketleri panel erişimiyle birlikte gelir.