Bu kılavuz, Resonite sunucunuz için headless konsol komutlarını, oturum yönetimini, mod yükleyici kurulumunu ve sorun gidermeyi anlatır. İlk kurulum için bkz. Resonite Headless Sunucu Kurulum Kılavuzu.
1. Headless Konsol Komutları
Resonite headless sunucusu, GPanel konsolu aracılığıyla komutları kabul eder. Sunucu, düzgün bir kapatma için shutdown komutuna yanıt verir.
| Komut | Açıklama |
|---|---|
worlds |
Tüm etkin dünya oturumlarını listeler. |
focus <world_index> |
Komutlar için belirli bir dünyaya odaklan. |
status |
Odaklanılan dünyanın durumunu göster. |
users |
Odaklanılan dünyadaki kullanıcıları listele. |
kick <username> |
Odaklanılan dünyadan bir kullanıcıyı at. |
ban <username> |
Odaklanılan dünyadan bir kullanıcıyı yasakla. |
silence <username> |
Odaklanılan dünyada bir kullanıcının sesini kapat. |
unsilence <username> |
Bir kullanıcının sesini aç. |
respawn <username> |
Bir kullanıcıyı dünya başlangıç noktasına yeniden doğur. |
role <username> <role> |
Bir kullanıcının rolünü ayarla (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Odaklanılan oturumu yeniden adlandır. |
accessLevel <level> |
Kimlerin katılabileceğini değiştir (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Odaklanılan dünya için maksimum kullanıcı sayısını değiştir. |
save |
Odaklanılan dünyayı kaydet. |
close |
Odaklanılan dünyayı kapat. |
restart |
Odaklanılan dünyayı yeniden başlat. |
invite <username> |
Odaklanılan dünyaya bir kullanıcı davet et. |
message <text> |
Odaklanılan dünyaya bir mesaj gönder. |
shutdown |
Tüm headless sunucusunu düzgün bir şekilde kapat. |
2. Erişim Düzeyleri
accessLevel ayarıyla dünya oturumlarınıza kimlerin katılabileceğini denetleyin:
| Düzey | Açıklama |
|---|---|
| Anyone | Tüm Resonite kullanıcılarına açık. |
| RegisteredUsers | Yalnızca kayıtlı Resonite hesapları. |
| Contacts | Yalnızca headless hesabının kişi listesindeki kullanıcılar. |
| ContactsPlus | Kişiler ve kişilerin kişileri. |
| Private | Yalnızca davetle. |
3. Kullanıcı Rolleri
Kullanıcıların dünyanızda neler yapabileceğini denetlemek için roller atayın:
| Rol | Açıklama |
|---|---|
| Admin | Dünya üzerinde tam denetim. |
| Builder | Nesneleri inşa edebilir ve değiştirebilir. |
| Moderator | Kullanıcıları atabilir/yasaklayabilir ve sohbeti denetleyebilir. |
| Guest | Standart kullanıcı erişimi. |
| Spectator | Gözlemleyebilir ancak etkileşim kuramaz. |
Varsayılan rolleri Config.json içinde defaultUserRoles kullanarak ayarlayın veya role konsol komutuyla kullanıcı başına atayın.
4. Birden Fazla Dünya
Headless sunucusu aynı anda birden fazla dünyayı barındırabilir. Headless/Config/Config.json içindeki startWorlds dizisine ek girişler ekleyin:
"startWorlds": [
{
"isEnabled": true,
"sessionName": "World 1",
"maxUsers": 16,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld"
},
{
"isEnabled": true,
"sessionName": "World 2",
"maxUsers": 8,
"accessLevel": "Contacts",
"loadWorldPresetName": "Grid"
}
]
Dünyalar arasında geçiş yapmak için konsolda focus 0 ve focus 1 kullanın.
5. Mod Yükleyici
Resonite, ResoniteModLoader aracılığıyla modları destekler. Etkinleştirmek için:
- Startup sekmesinde
ENABLE_MODLOADERdeğerinitrueolarak ayarlayın. - Sunucuyu yeniden yükleyin veya yeniden başlatın -- mod yükleyici DLL'leri otomatik olarak indirilecektir.
- Mod DLL'lerini SFTP aracılığıyla
rml_mods/dizinine yerleştirin. - Modları yüklemek için sunucuyu yeniden başlatın.
Mod yükleyici dosyaları:
Libraries/ResoniteModLoader.dll-- Ana mod yükleyici.rml_libs/0Harmony.dll-- Gerekli bağımlılık.rml_mods/-- Mod DLL'lerinizi buraya yerleştirin.
6. Sorun Giderme
- Sunucu başlamıyor:
Config.jsoniçindeki giriş kimlik bilgilerinin doğru olduğunu doğrulayın. Headless'in geçerli bir Resonite hesabıyla kimlik doğrulaması yapması gerekir. - Dünya tarayıcıda görünmüyor:
hideFromPublicListingdeğerinintrueolarak ayarlanmadığını kontrol edin.accessLeveldeğerinin arama yapan kullanıcılara izin verdiğinden emin olun. - "World running..." görünmüyor: Konsolda hata olup olmadığını kontrol edin. Dünya hazır ayar adı yanlış olabilir.
- Modlar yüklenmiyor:
ENABLE_MODLOADERdeğerinintrueolduğunu ve mod DLL'lerininrml_mods/içinde olduğunu doğrulayın. Konsolda mod yükleyici hatalarını kontrol edin. - Yüksek kaynak kullanımı:
Config.jsoniçindekitickRatedeğerini azaltın veyamaxConcurrentAssetTransfersdeğerini düşürün. Karmaşık kullanıcı tarafından oluşturulan içerikler kaynak yoğun olabilir.
İlgili Makaleler
- Resonite Headless Sunucu Kurulum Kılavuzu
- Sunucu IP'nizi ve Portunuzu Nasıl Bulursunuz
- SFTP ile Dosyalar Nasıl Yüklenir
Yardıma mı İhtiyacınız Var?
Daha fazla yardıma ihtiyacınız varsa, sunucu ayrıntılarınız ve GPanel konsolundaki hata mesajlarıyla birlikte bir destek talebi açın.