Bu kılavuz, NeosVR özel sunucunuz için headless konsol komutlarını, dünya yönetimini, kullanıcı rollerini, NeosModLoader'ı ve sorun gidermeyi kapsar. NeosVR, güçlü oluşturma araçlarına sahip sosyal bir VR metaverse'üdür. İlk kurulum, Config.json yapılandırması ve bağlantı talimatları için NeosVR Sunucu Kurulum Kılavuzu sayfasına bakın.
1. Konsola Erişim
NeosVR headless sunucunuzu GPanel içindeki Console sekmesi aracılığıyla yönetin. Tüm komutlar doğrudan konsola yazılır.
2. Headless Konsol Komutları
Dünya Yönetimi
| Komut | Açıklama |
|---|---|
worlds | Çalışan tüm dünyaları indeksleriyle birlikte listeler. |
focus <world_index> | Odağı indekse göre belirli bir dünyaya geçirir. |
startWorldURL <record_url> | Bir Neos kayıt URL'sinden yeni bir dünya başlatır. |
startWorldTemplate <template> | Yerleşik bir şablondan bir dünya başlatır (örn. SpaceWorld). |
save | Şu anda odaklanılan dünyayı kaydeder. |
close | Şu anda odaklanılan dünyayı kapatır. |
restart | Şu anda odaklanılan dünyayı yeniden başlatır. |
Oturum Yönetimi
| Komut | Açıklama |
|---|---|
sessionURL | Odaklanılan dünya için oturum URL'sini gösterir. |
sessionID | Odaklanılan dünya için oturum kimliğini gösterir. |
name <new_name> | Odaklanılan dünyanın oturum adını değiştirir. |
accessLevel <level> | Erişim seviyesini değiştirir: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Oturum için maksimum kullanıcı sayısını ayarlar. |
hideFromListing <true/false> | Genel oturum tarayıcısında görünürlüğü açar/kapatır. |
description <text> | Oturum açıklamasını ayarlar. |
Kullanıcı Yönetimi
| Komut | Açıklama |
|---|---|
users | Odaklanılan dünyadaki tüm kullanıcıları listeler. |
kick <username> | Bir kullanıcıyı dünyadan atar. |
ban <username> | Bir kullanıcıyı dünyadan yasaklar. |
silence <username> | Bir kullanıcıyı susturur (sesini kapatır). |
unsilence <username> | Daha önce susturulmuş bir kullanıcının susturmasını kaldırır. |
respawn <username> | Bir kullanıcıyı dünyanın doğuş noktasında yeniden doğurur. |
role <username> <role> | Bir kullanıcıya rol atar (bkz. Bölüm 3). |
Sunucu Kontrolü
| Komut | Açıklama |
|---|---|
status | Sunucu durumunu ve kaynak kullanımını gösterir. |
shutdown | Headless sunucuyu düzgün bir şekilde kapatır. |
gc | Bellek boşaltmak için çöp toplamayı zorlar. |
tickRate <rate> | Çalışma zamanında sunucu tick oranını değiştirir. |
3. Kullanıcı Rolleri
NeosVR, dünya izinleri için bir rol hiyerarşisi kullanır:
| Rol | Açıklama |
|---|---|
Admin | Tam dünya kontrolü. Her şeyi değiştirebilir, kullanıcıları yönetebilir ve dünya ayarlarını değiştirebilir. |
Builder | Dünyada nesneler oluşturabilir ve düzenleyebilir. |
Moderator | Kullanıcıları atabilir/yasaklayabilir ve oturum ayarlarını yönetebilir. |
Guest | Temel erişim. Mevcut nesnelerle etkileşime girebilir ancak inşa edemez. |
Spectator | Yalnızca görüntüleme erişimi. Dünyayla etkileşime giremez. |
Rolleri konsol aracılığıyla atayın: role <username> Admin
Ayrıca defaultUserRoles ayarını kullanarak Config.json içinde varsayılan roller de ayarlayabilirsiniz.
4. NeosModLoader
NeosModLoader, topluluk tarafından yapılan modların headless sunucuya yüklenmesine olanak tanır.
- GPanel Startup değişkenlerinde ENABLE_MODLOADER değerini
trueolarak ayarlayın. - Modları NeosModLoader GitHub sayfasından indirin.
- Mod
.dlldosyalarını SFTP aracılığıylanml_mods/dizinine yükleyin. - Modları yüklemek için sunucuyu yeniden başlatın.
5. Sorun Giderme
Sunucu Başlamıyor
- STEAM_USER ve STEAM_PASS bilgilerinizin doğru olduğunu doğrulayın.
- SRCDS_BETAPASS (headless beta parolası) değerinin Neos Patreon Discord'undan güncel olduğundan emin olun.
- Steam Guard 2FA kullanıyorsanız, kodu STEAM_AUTH içinde sağlayın ve hemen yeniden başlatın.
Dünya Yüklenmiyor
Config.jsondosyasının geçerli JSON olduğunu kontrol edin (sondaki virgüller yok, uygun parantezler).Config/Config.jsoniçindeloginCredentialveloginPassworddeğerlerinin doğru ayarlandığını doğrulayın.- Dünya URL'sinin veya ön ayar adının geçerli olduğundan emin olun.
Kullanıcılar Katılamıyor
accessLeveldeğerinin amaçlanmadıkçaPrivateolarak ayarlanmadığını kontrol edin.maxUsersdeğerine ulaşılmadığını doğrulayın.- Headless'in oturum açtığından emin olun (oturum açma onayı için konsol çıktısını kontrol edin).
İlgili Makaleler
- NeosVR Sunucu Kurulum Kılavuzu
- Sunucu IP'nizi ve Portunuzu Nasıl Bulursunuz
- SFTP Aracılığıyla Dosya Nasıl Yüklenir
Yardıma mı İhtiyacınız Var?
NeosVR sunucunuzla burada ele alınmayan sorunlarla karşılaşırsanız, bir destek talebi açın ve sunucu IP'nizi, sorunun bir açıklamasını ve GPanel konsolundaki ilgili hata mesajlarını ekleyin.
