🎮 Ark Cross-Server Chat System

🌟 Modern, responsive ve kullanıcı dostu Ark Survival Evolved cross-server chat sistemi

Modern ve mobil-uyumlu web arayüzü ile Ark Survival Evolved sunucularının chatlarını birleştiren profesyonel sistem.

📸 Screenshots

🖥️ Ana Chat Arayüzü

Modern gradient tema ile responsive chat arayüzü - Gerçek zamanlı mesajlaşma, sunucu durumları ve istatistikler

📱 Mobil Görünüm

Touch-friendly mobil arayüz - Tüm özellikler mobil cihazlarda mükemmel çalışır

⚙️ Admin Panel

Güçlü admin paneli - Sistem yönetimi, broadcast mesajları ve detaylı istatistikler

✨ Özellikler

🌐 Cross-Server Chat

• Birden fazla Ark sunucusu desteği
• Gerçek zamanlı mesaj senkronizasyonu
• Otomatik bağlantı yönetimi ve yeniden bağlanma
• 🤖 Cross-Server Bot Sistemi: Her sunucuda özel bot karakteri ile diğer sunucuların mesajlarını gösterir

🎨 Modern Web Arayüzü

• Responsive tasarım (mobil, tablet, desktop)
• Real-time Socket.IO bağlantısı
• Modern gradient tema ve animasyonlar
• Touch-friendly butonlar

🛠️ Gelişmiş Özellikler

• RCON protokolü ile güvenli bağlantı
• Türkçe karakter desteği
• Spam ve döngü engelleme sistemi
• Chat geçmişi ve anlık istatistikler
• Admin paneli ile sistem yönetimi
• 🎮 Oyun İçi Cross-Chat: Diğer sunucuların mesajları oyun içinde bot karakterleri aracılığıyla görünür

🐳 Deployment Seçenekleri

• Docker desteği ile kolay kurulum
• Standalone kurulum
• Auto-installer scriptler (Windows/Linux)

🚀 Hızlı Başlangıç

Otomatik Kurulum

Windows:

./install.ps1

Linux/macOS:

chmod +x install.sh
./install.sh

Manuel Kurulum

1. Bağımlılıkları yükleyin:

npm install

2. Yapılandırma dosyasını oluşturun:

cp config.example.json config.json

3. Ark sunucularınızı yapılandırın:

{
  "servers": [
    {
      "id": "server1",
      "name": "Ragnarok Server",
      "host": "192.168.1.100",
      "port": 27020,
      "password": "your_rcon_password",
      "crossServerBot": {
        "enabled": true,
        "botName": "[CROSS-CHAT] Ragnarok",
        "messagePrefix": "🏔️",
        "chatToOtherServers": true
      }
    },
    {
      "id": "server2", 
      "name": "The Island Server",
      "host": "192.168.1.101",
      "port": 27020,
      "password": "your_rcon_password",
      "crossServerBot": {
        "enabled": true,
        "botName": "[CROSS-CHAT] TheIsland", 
        "messagePrefix": "🏝️",
        "chatToOtherServers": true
      }
    }
  ],
  "chatFormatting": {
    "crossServerChat": {
      "enabled": true,
      "broadcastToGameServers": true,
      "messageFormat": "{prefix} {playerName}: {message}",
      "excludeOwnMessages": false,
      "maxMessageLength": 150
    }
  },
  "webPort": 3000,
  "chatPollingInterval": 5000
}

4. Sistemi başlatın:

npm start

📋 Gereksinimler

🖥️ Sistem Gereksinimleri

• Node.js 16+
• 512MB RAM
• 100MB disk alanı
• İnternet bağlantısı

🎮 Ark Sunucu Ayarları

GameUserSettings.ini dosyasına ekleyin:

[ServerSettings]
RCONEnabled=True
RCONPort=27020
ServerAdminPassword=your_rcon_password

🐳 Docker ile Kullanım

# Docker Compose ile
docker-compose up -d

# Manuel Docker
docker build -t ark-chat .
docker run -d -p 3000:3000 -v ./config.json:/app/config.json ark-chat

🎬 Live Demo & Features

🌟 Ana Özellikler Gösterimi

🖥️ Desktop Experience Modern gradient arayüz Real-time chat synchronization Server status monitoring Advanced statistics panel Admin management tools
	📱 Mobile Experience Touch-optimized interface Responsive design adaptation One-handed operation Fast message sending Intuitive navigation
⚙️ Admin Control Panel System administration Broadcast messaging Chat history management Server health monitoring Real-time statistics

🚀 Key Features Demonstrated

Feature	Description	Screenshot
Cross-Server Chat	Messages sync instantly between all connected Ark servers	✅ Screen 1
Mobile Responsive	Perfect adaptation for phones and tablets	✅ Screen 2
Admin Panel	Complete system management and control	✅ Screen 3
Turkish Support	Full UTF-8 encoding with special characters (ğüşıöç)	✅ All screens
Real-time Updates	Live server status and instant message delivery	✅ All screens

📱 Arayüz Kullanımı

🏠 Ana Sayfa (http://localhost:3000)

• Real-time chat görüntüleme
• Cross-server mesaj gönderme
• Sunucu durumları ve istatistikler
• Mobil-uyumlu responsive tasarım

⚙️ Admin Panel (http://localhost:3000/admin)

• Admin mesajı gönderme
• Sistem istatistikleri
• Chat geçmişi yönetimi
• Sunucu kontrolü

📊 Özellik Detayları

🔒 Güvenlik

• RCON şifre koruması
• Input validation ve sanitization
• Rate limiting ve spam koruması
• XSS ve injection koruması

🌍 Uluslararasılaştırma

• Türkçe karakter desteği (ğ, ü, ş, ı, ö, ç)
• UTF-8 encoding
• Unicode mesaj desteği

📈 Performans

• Connection pooling
• Automatic reconnection
• Memory leak prevention
• Optimized polling system

🧪 Test Scriptleri

Test scriptleri scripts/ klasöründe bulunmaktadır:

# RCON bağlantı testi
node scripts/test-rcon.js

# Chat sistemi testi  
node scripts/test-chat.js

# Türkçe karakter testi
node scripts/test-turkish-chars.js

Ark sunucularınızda aşağıdaki ayarları yapın:

1. GameUserSettings.ini dosyasında:

[ServerSettings]
RCONEnabled=True
RCONPort=27020
ServerAdminPassword=your_admin_password

2. Sunucuyu yeniden başlatın

Web Arayüzü

Sistem başlatıldıktan sonra http://localhost:3000 adresinden web arayüzüne erişebilirsiniz.

🤝 Katkıda Bulunma

1. Fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request açın

📝 Değişiklik Geçmişi

• v1.0.0 - İlk stabil sürüm
  • Cross-server chat sistemi
  • Modern web arayüzü
  • Docker entegrasyonu
  • Responsive mobil tasarım

📄 Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

🆘 Destek

📞 Sorun Bildirimi

• GitHub Issues kullanın
• Detaylı bilgi ve log dosyaları ekleyin
• Sistem bilgilerinizi paylaşın

💡 Özellik İstekleri

• GitHub Discussions kullanın
• Use case ve fayda belirtin
• Mockup veya örnek paylaşın

🛠️ Teknik Destek

• Community Discord'a katılın

🙏 Teşekkürler

• Node.js community
• Socket.IO developers
• Bootstrap framework
• Font Awesome icons
• Ark Survival Evolved modding community

🎨 Visual Showcase

🌟 Complete Feature Overview

Desktop	Mobile	Admin
Modern chat interface with real-time sync	Touch-optimized responsive design	Complete administrative control

🚀 Ready to Transform Your Ark Community?

Join thousands of Ark players enjoying seamless cross-server communication!

🤖 Cross-Server Bot Sistemi

🌟 Oyun İçi Cross-Chat Deneyimi

Bu yenilikçi özellik ile diğer sunuculardan gelen mesajları, oyun içinde özel bot karakterleri aracılığıyla görebilirsiniz!

📱 Nasıl Çalışır?

1. The Island sunucusunda bir oyuncu mesaj yazıyor
2. Mesaj Ragnarok sunucusunda [CROSS-CHAT] TheIsland bot'u tarafından gösteriliyor
3. Her sunucu kendi bot karakterine sahip ve diğer sunucuların mesajlarını iletir

⚙️ Bot Konfigürasyonu

{
  "crossServerBot": {
    "enabled": true,                    // Bot'u aktifleştir
    "botName": "[CROSS-CHAT] Ragnarok", // Bot karakter adı (ARK'ta görünür)
    "messagePrefix": "🏔️",             // Mesaj öneki (emoji/simge)
    "chatToOtherServers": true          // Bu sunucudan diğerlerine mesaj gönder
  }
}

🎮 Oyun İçi Görünüm

• Ragnarok sunucusunda: 🏝️ JohnDoe: Merhaba dostlar! → [CROSS-CHAT] TheIsland tarafından gönderilir
• The Island sunucusunda: 🏔️ JohnDoe: Merhaba dostlar! → [CROSS-CHAT] Ragnarok tarafından gönderilir

🔧 Özelleştirme Seçenekleri

• Bot İsimleri: Her sunucu için özel bot isimleri
• Emoji Prefiksleri: Hangi sunucudan geldiğini göstermek için özel emojiler
• Mesaj Formatı: Özelleştirilebilir mesaj şablonları
• Uzunluk Kontrolü: Uzun mesajları otomatik kısaltma
• Filtreleme: Hangi sunucuların mesajlarının paylaşılacağını belirleme

🛡️ Spam Koruması

• Döngü Engelleme: Bot mesajları tekrar bot mesajı olarak gönderilmez
• Hız Sınırlama: Çok hızlı mesaj gönderimini engeller
• Karakter Limiti: ARK'ın chat limitine uygun mesaj kısaltma

🧪 Test ve Kurulum

# Cross-server bot özelliğini test et
npm run test:crossbot

# Normal test scriptleri
npm run test:chat
npm run test:chars