SCUM Server · Discord Bot · v2.1 Modular

🤖 Lodos SCUM Bot — Özellikler & Komutlar

Sunucu yönetimi, Discord ekonomisi, oy sistemi, savaş bölgeleri, kural uygulayıcılar ve oyuncu takibi için hepsi bir arada modüler bot. Aşağıda tüm özellikler ve örnek komutlar.

⭐ Neden Lodos SCUM Bot? Why

🧩

Modüler & Kolay Kurulum

Modular architecture

Tek config.json ile kurulur; her sistem bağımsız modüldür, istediğini açıp kapatabilirsin.

🩹

Kendini Onaran Bağlantılar

Self-healing RCON & Discord

RCON ve Discord bağlantıları koptuğunda otomatik yeniden bağlanır; bot çökmeye dayanıklıdır.

🌍

İki Dilli (TR/EN)

Bilingual

Komutlar ve yardım metinleri Türkçe + İngilizce hazır; topluluğuna göre uyarlanır.

🔁

Kalıcı Butonlar

Persistent buttons

Menü ve butonlar bot yeniden başlasa bile çalışmaya devam eder.

🛡️

Anti-Hile Odaklı

Anti-cheat focused

ESP/sandık hilesi, ban geçmişi ve tuzak/PVE kural ihlalleri otomatik izlenir ve raporlanır.

💰 Discord Ekonomisi Economy

🏦

Bakiye Sorgula

Check your Discord coin balance

Discord coin bakiyeni DM olarak gönderir. Banka menüsündeki 💳 Bakiye Sorgula butonu da aynı işi yapar.

Kullanıcı
!bank
💱

Coin → Nakit Çevir

Convert Discord coins to in-game cash

Discord coinlerini oyun içi paraya (cash) çevirir. Nakit, oyundaki karakterinin ayağına basılır — yerden alırsın.

Kullanıcı
!convert 1000
!convert 500
Aliases: !exchange, !deposit. Karakterin oyunda olmalı.
🛒

Mağaza

Item shop with buttons

Satın alınabilir eşyaları butonlu menüyle listeler. Fiyat, cooldown ve etkinlik bölgesi bilgisi gösterilir.

Kullanıcı
!shop
📦

Satın Al

Buy an item

Mağazadan ürün satın alır ve teslimatı oyun içinde yapar. VIP indirimi varsa otomatik uygulanır.

Kullanıcı
!buy <item_id> [adet]
!buy quad
!buy ak47 2
🎁

Başlangıç Paketi

One-time welcome pack

Her karakter için tek seferlik başlangıç paketini (silah, ekipman, araç) teslim eder. Önce kayıt olmalısın.

Kullanıcı
!welcomepack
👤

Profil

Linked character info

Bağlı SCUM karakterini, UPID'ini ve coin bakiyeni gösterir.

Kullanıcı
!profile
📈

Pasif Gelir

Activity & voice income

Discord'da çevrimiçi kalan ve sesli kanalda takılan oyunculara periyodik olarak coin yatırılır. Otomatik çalışır.

Otomatik
🧾

İşlem Geçmişi Yayını

Shop history publisher

Tüm ekonomi işlemleri tek satırlık log olarak özel bir Discord kanalına webhook ile akar.

Otomatik
🖼️

Mağaza & Silah Görselleri

Shop & weapon images

Mağazadaki ürünler özel görsellerle sunulur; kill feed'deki silahlar resmi wiki görselleriyle eşleştirilir.

Otomatik

🏧 Banka & ATM Bank Exchange

🏧

ATM Kanalı Menüsü

Persistent bank channel

Özel ATM kanalına banner + butonlu menü basılır. Butonlar bot yeniden başlasa da çalışmaya devam eder.

Otomatik
💰 Para Yatır (Coin → Oyun Parası)
💳 Bakiye Sorgula (DM)
💵

Para Yatır Butonu

Coin → cash deposit

ATM menüsündeki buton modal açar; girilen coin düşülür, oyun içi nakit karakterin ayağına basılır.

Kullanıcı
[Para Yatır] → miktar gir → onayla
Karakterin oyunda olmalı, aksi halde coin iade edilir.
🔎

Banka Bakiyesi

In-game bank balances

Bir oyuncunun oyun içi banka bakiyesini (cash + gold) gösterir.

Admin
!bankbal @Oyuncu

Banka Bakiyesi Ekle

Add in-game bank balance

Oyuncunun oyun içi banka hesabına cash veya gold ekler.

Admin
!bankadd @Oyuncu cash 100000
!bankadd @Oyuncu gold 50
🎯

Banka Bakiyesi Ayarla

Set in-game bank balance

Oyuncunun oyun içi banka bakiyesini doğrudan belirli bir değere ayarlar.

Admin
!bankset @Oyuncu cash 250000
!bankset @Oyuncu gold 100
⚖️

Kur Ayarla

Set coin→cash rate

Coin → cash dönüşüm kurunu çalışma anında değiştirir (kalıcı olması için config.json'a yazılmalı).

Admin
!setrate coin2cash 1000

🪪 Kayıt & Karakter Registration

🔗

Kayıt Ol

Link Discord → SCUM character

Discord hesabını SCUM karakterine bağlar. Tek kullanımlık token DM'ine gönderilir.

Kullanıcı
!register
# DM'e gelen: !registerme123456
Token'ı oyunda Local sohbete yaz.
🔓

Bağlantıyı Kaldır

Unlink character

Discord hesabın ile SCUM karakterin arasındaki bağlantıyı kaldırır.

Kullanıcı
!unlink
📡

Sohbet İzleyici

Chat watcher

SCUM sohbet loglarını izler; kayıt tokenlarını ve !discord isteklerini algılar.

Otomatik
🆕

Yeni Spawn Tespiti

Fresh spawn detection

Yeni karakterleri otomatik algılar ve belirlenen koordinata ışınlar, Discord'a bildirir.

Otomatik
📚

Oyuncu Kaydı

Player registry

Sunucuya giren oyuncular kalıcı olarak kaydedilir; isim/SteamID eşleştirmesi tüm sistemlerde kullanılır.

Otomatik

🗳️ Oylama Sistemi Voting

🔗

Oy Linki

Personal vote link

Kişisel sunucu oy linkini DM olarak gönderir. 2 saatte bir oy verilebilir.

Kullanıcı
!vote
🌦️

Saat / Hava Oylaması

Time & weather votes

Sunucu içinde saat ve hava durumu oylaması başlatır (RCON vote). Discord veya oyun içi sohbetten çalışır.

VIP1+
!voteday    → gündüz
!votenight  → gece
!voterain   → yağmur
!votesun    → güneşli
🏆

Haftalık Oy Ödülleri

Weekly vote rewards

Haftanın en çok oy veren 3 oyuncusuna coin, mağaza indirimi ve VIP paket indirimi verilir. Canlı sıralamayı herkes görebilir.

Kullanıcı
!voterewards
Admin
!voterewards distribute

💎 VIP Sistemi VIP System

💎

VIP Durumum

My VIP status

VIP seviyeni ve alınmamış hediye claim butonlarını DM'ine (yeniden) gönderir.

Kullanıcı
!vip
🥇

VIP Ata

Set VIP tier

Bir üyeye VIP seviyesi atar: vip1 Silver, vip2 Gold, vip3 Platinum.

Admin
!set @Oyuncu vip1
!set @Oyuncu vip2
!set @Oyuncu vip3
🚫

VIP Kaldır

Remove VIP

Bir üyenin VIP durumunu kaldırır.

Admin
!unsetvip @Oyuncu
📋

VIP Listesi

List VIP members

Tüm VIP üyeleri seviyeleriyle listeler.

Admin
!vips
🎁

Hediye Ver

Personal reward claim

Bir üyeye eşya veya araç hediye claim'i tanımlar; claim butonu DM'ine gider, oyuncu oyundayken teslim edilir.

Admin (Owner)
!gift @Oyuncu item Silah 1
!gift @Oyuncu vehicle Quad 1

🎯 Görevler Quests

📜

Özel Görevler

Custom quests

Trader'a satış görevlerini (örn. "10 Tornavida sat") takip eder; tamamlanınca ödül claim butonu DM'e düşer.

Otomatik
🎖️

Ödül Talep Et

Claim quest reward

Görev ödülünü kod ile talep eder (veya DM'deki butonu kullan). Ödül yalnızca oyuncu oyundayken basılır.

Kullanıcı
!claim <kod>

⚔️ Savaş Bölgesi (Warzone) Warzone

⚔️

Warzone Planlayıcı

Warzone scheduler

Bölgeleri rotasyonla açıp kapatan otomatik planlayıcı. Aktif bölgede loot tabloları değişir, eşya setleri basılır.

Otomatik
🚀

Warzone Başlat / Durdur

Start / stop warzone

Warzone'u manuel başlatır veya durdurur. Bölge verilmezse rastgele seçilir.

Admin
!start warzone [bolge]
!stop warzone
⏯️

Planlayıcıyı Aç/Kapat

Pause/resume scheduler

Warzone planlayıcısını duraklatır veya sürdürür.

Admin
!warzone on
!warzone off
🚕

Warzone Taksi

Warzone taxi

Oyuncu oyun içi sohbette !taxi yazınca aktif warzone içinde rastgele bir noktaya ışınlanır.

Oyun İçi
!taxi   (Global/Local sohbet)
🎒

Warzone Paketi

Warzone pack

Yalnızca aktif warzone sırasında coin ile satın alınabilen butonlu paket; içerik alıcının konumuna basılır. Kişi başı cooldown var.

Kullanıcı
[Warzone Paketi Satın Al] butonu
💀

Warzone Kill Ödülü

Warzone kill rewards

Aktif warzone içinde kill alan oyuncuya otomatik coin yatırılır. Ölen kişi coin kaybetmez.

Otomatik
🎲

Eşya Spawner

Warzone item spawner

Warzone aktifken belirlenen noktalara kademeli (tier) eşya setleri otomatik basılır.

Otomatik

🛡️ Kural Uygulayıcılar Rule Enforcers

🧨

Tuzak Kuralı

Trap rule enforcer

Bayrak alanı dışına kurulan tuzakları tespit eder; kuranı üzerine ışınlar, tetiklenmezse tuzağı doğrudan yok eder.

Otomatik Admin
!ruleenforcer on
!ruleenforcer off
🏰

PVE Baskın Koruyucusu

PVE raid enforcer

PvPvE bölge kuralını uygular: PVE oyuncusu, PVP oyuncusunun bayrak alanında lockpick yapamaz / tuzak tetikleyemez. İhlal eden hapishaneye ışınlanır.

Otomatik

🔁 Sunucu Yönetimi & Araçlar Server Ops & Tools

🔄

Planlı Yeniden Başlatma

Scheduled restart

Geri sayımlı oyun içi duyurularla sunucuyu planlı şekilde kapatır/yeniden başlatır.

Otomatik
server_reset.py
🗺️

Harita Önizlemeleri

Zone map previews

PVE bölgelerini ve warzone alanlarını harita üzerinde görselleştiren yardımcı araçlar.

Admin
draw_pve_zones_preview.py
draw_warzone_preview.py

👁️ İzleme & Gözetleme Monitoring

🔓

Lockpick İzleyici

Lockpick watcher

Tüm kilit açma denemelerini (başarı/başarısız, hedef, kilit tipi) loglar ve Discord'a bildirir.

Otomatik
🧰

Sandık İzleyici

Chest watcher

Sandık gömme/çıkarma olaylarını takip eder; başkasının sandığını çıkaran şüpheli olarak işaretlenir (ESP hile denetimi).

Otomatik
☠️

Kill / Death Beslemesi

Kill & death feed

Oyun loglarındaki kill, ölüm ve admin komutlarını Discord kanallarına bildirir.

Otomatik
🚷

Ban Kontrolü

Steam ban history checker

Steam Web API üzerinden VAC / oyun / topluluk / ticaret ban geçmişini sorgular ve daha önce bildirilenleri atlar.

Otomatik
🗺️

Harita / Heatmap

Player position heatmap

Oyuncu koordinatlarını harita görseline çizer: herkese bulanık ısı noktaları, adminlere kesin işaretçiler.

Otomatik
🔔

Webhook Bildirimleri

Discord notifications

Spawn, ışınlanma, kayıt, satın alma, kill/death ve admin komutlarını ilgili Discord kanallarına bildirir.

Otomatik
🔥

24 Saat Aktivite Heatmap

Daily activity heatmap

Gün içinde oyuncuların nerelerde takıldığını biriktirir; gün sonunda kümülatif aktivite haritası yayınlar.

Otomatik

🚗 Araç Takibi Vehicle Tracker

🛣️

Araç Yolu

Vehicle path (date range)

Araç binme/inme ve sürülen rotayı haritada renkli çizgilerle gösterir. Kapsam seçici (oyuncu/ekip) ve tarih aralığı sorar.

Admin
!vehiclepath [hedef]
!vehiclepathall
📊

Detaylı Araç Yolu

Vehicle path (verbose)

Aynı akış, ancak her sürüş için ayrıntılı özet üretir.

Admin
!vehiclepathdetailed
!vehiclepathdetay
🚙

Araçları Listele

List owned vehicles

Bir ekip veya oyuncunun sahip olduğu araçları ve son koordinatlarını listeler.

Admin
!listvehicles squad
!listvehicles player

🛠️ Admin Komutları Admin Commands

Aşağıda tüm yönetim komutları özetlenmiştir. Detaylar ilgili bölümlerde.

KomutAçıklamaÖrnek
!addbalanceDiscord coin ekler!addbalance @Oyuncu 5000
!setbalanceDiscord coin bakiyesini ayarlar!setbalance @Oyuncu 10000
!coinhistoryCoin geçmişi/bakiyesi dökümü!coinhistory @Oyuncu 10
!bankbalOyun içi banka bakiyesi!bankbal @Oyuncu
!bankaddOyun içi bankaya ekle!bankadd @Oyuncu gold 50
!banksetOyun içi bankayı ayarla!bankset @Oyuncu cash 250000
!setrateCoin→cash kurunu ayarla!setrate coin2cash 1000
!resetdailyGünlük paket beklemesini sıfırla!resetdaily @Oyuncu
!reloadshopMağazayı JSON'dan yenile!reloadshop
!start warzoneWarzone başlat!start warzone c1city
!stop warzoneWarzone durdur!stop warzone
!warzone on|offPlanlayıcıyı aç/kapat!warzone off
!ruleenforcer on|offTuzak kuralını aç/kapat!ruleenforcer on
!adminsSunucu adminlerini listele!admins
!set @user vipNVIP seviyesi ata!set @Oyuncu vip2
!unsetvipVIP kaldır!unsetvip @Oyuncu
!vipsVIP üyeleri listele!vips
!giftHediye claim tanımla!gift @Oyuncu item Silah 1
!clearKanalı temizle, yardım göster!clear

🖱️ Butonlar & Menüler Buttons & Menus

Hızlı Eylemler

Quick action buttons

Özel kanala basılan kalıcı butonlar: kayıt, başlangıç paketi, oy ve günlük paket.

Kullanıcı
[Kayıt] [Başlangıç Paketi] [Oy Ver] [Günlük Paket]
📅

Günlük Paket

Daily pack claim

Her gün alınabilen paket; butonla talep edilir, kişi başı cooldown uygulanır.

Kullanıcı
[Günlük Paketi Al] butonu
🎒

Warzone Paketi Butonu

Warzone pack button

Warzone aktifken görünen satın alma butonu (coin ile).

Kullanıcı

🖼️ Örnek Çıktılar Example Outputs

Botun Discord'a attığı gerçek görüntülerden örnekler.

Oyuncu heatmap (herkese açık)
🗺️ Oyuncu Heatmap — herkese açık, bulanık ısı noktaları (gizlilik korumalı)
Admin heatmap
🛰️ Admin Heatmap — kesin konumlar + oyuncu isimleri
24 saatlik aktivite heatmap
🔥 24 Saat Aktivite Heatmap — günlük oyuncu yoğunluğu (mavi → kırmızı)
Araç yolu takibi
🚗 Araç Yolu Takibi — renkli rotalar, sürücü isimleri ve araç lejantı
Warzone kanalı örneği
⚔️ Warzone Kanalı — başlangıç duyurusu, warzone paketi ve bitiş özeti
PVE bölgeleri
🛡️ PVE Bölgeleri — raid koruma alanları harita üzerinde
ATM kanalı banner
🏧 ATM Kanalı Banner — banka menüsü üst görseli

⚙️ Kurulum & Gereksinimler Setup

Başka bir SCUM sunucusuna kurmak için gerekenler.

GereksinimDetay
Python3.10+ (bağımlılıklar için pip install -r requirements.txt)
SCUM SunucusuRCON erişimi (host, port, şifre)
Discord BotuBot token + MESSAGE CONTENT INTENT + davet linki
Log ErişimiSCUM.log ve gameplay_*.log okuma yolu
Banka (opsiyonel)Oyun içi banka işlemleri için SCUM.db erişimi
Harita (opsiyonel)Harita görseli + kalibrasyon noktaları (heatmap/araç yolu)
Steam API (opsiyonel)Ban geçmişi kontrolü için API anahtarı