MODEL NEDEN .TXT, NASIL CALISIYOR?
Yazar: MikeField

Bu dosya, Dans Menusu gizli surumunde modelin neden .txt olarak
durdugunu ve bunun nasil calistigini anlatir. Ayni yontemi kendi
modellerinize de uygulayabilirsiniz.

------------------------------------------------------------
1) NEDEN GIZLIYORUZ?
------------------------------------------------------------
Sunucunuza giren her oyuncu, sunucudaki modelleri kendi bilgisayarina
indirir. Bu dosyalar cstrike_downloads/models (ya da cstrike/models)
klasorune iner. Modeli begenen biri bu klasore girip dosyayi alir ve
kendi sunucusuna koyar.

Gizli surumde dans modeli models klasorune hic inmez. overviews
klasorune, jail_ixbir_v2.txt adinda bir metin dosyasi gibi iner.
Model arayan biri models klasorune bakar, orada bir sey bulamaz.

------------------------------------------------------------
2) OYUN DOSYAYI NASIL HALA MODEL OLARAK ACIYOR?
------------------------------------------------------------
Oyun bir dosyanin model olup olmadigina uzantisina bakarak karar
vermez. Dosyanin ilk 4 baytina bakar:

   IDST   model (.mdl)
   IDSP   sprite (.spr)
   RIFF   ses (.wav)

jail_ixbir_v2.txt dosyasini bir hex duzenleyiciyle acarsaniz ilk 4
baytin IDST oldugunu gorursunuz. Yani bu dosya adi .txt olan bir
.mdl'dir. Eklenti bu yolu model olarak yukledigi icin oyun da onu
model gibi acar.

------------------------------------------------------------
3) OYUNCUYA NASIL INIYOR?
------------------------------------------------------------
Eklenti harita acilirken su satirla dosyayi yukler:

   precache_model("overviews/jail_ixbir_v2.txt")

Sunucu, yuklenen her dosyayi oyuncuya gonderilecekler listesine
ekler. Oyuncu baglanirken bu listedeki dosyalar ayni yol ve ayni adla
indirilir:

   - FastDL (sv_downloadurl) varsa oradan, yoksa oyun sunucusundan
   - Oyuncunun bilgisayarina: cstrike_downloads/overviews/jail_ixbir_v2.txt

Oyun bazi uzantilari (exe, dll, cfg, bat gibi) indirmeyi reddeder.
.txt izin verilen uzantilardandir, bu yuzden sorunsuz iner.

------------------------------------------------------------
4) NEDEN OVERVIEWS KLASORU?
------------------------------------------------------------
overviews klasorunde normalde haritalarin radar ayar dosyalari durur
(de_dust2.txt gibi). Icinde .txt gormek kimseye garip gelmez, model
arayan kimse buraya bakmaz.

DIKKAT: Var olan bir haritanin adini kullanmayin. Ornegin modeli
overviews/de_dust2.txt yaparsaniz de_dust2'nin radar dosyasiyla
cakisir; oyuncuda zaten de_dust2.txt varsa dosyayi indirmez ve oyun
hata verir. Hicbir haritanin kullanmadigi bir ad secin
(jail_ixbir_v2 gibi).

------------------------------------------------------------
5) EKLENTIDE NE DEGISIYOR?
------------------------------------------------------------
Sadece dosyanin yolu. dans_menusu.sma'nin basinda tek bir satir var:

   #define DANS_MODELI "overviews/jail_ixbir_v2.txt"

Yukleme (precache_model) ve modeli bir varliga takma (SetModel) bu
satirdaki yolu kullanir. Normal surumde ayni satir
"models/mikefield/MikeField_Dans_01.mdl" der, baska hicbir fark yoktur.

------------------------------------------------------------
6) KENDI MODELINIZI GIZLEMEK (ADIM ADIM)
------------------------------------------------------------
1. Model dosyanizin adini degistirin:
      benim_modelim.mdl  ->  jail_benim_v1.txt
2. Sunucuda cstrike/overviews/ klasorune koyun.
3. FastDL kullaniyorsaniz FastDL'de de overviews/ altina koyun.
4. Eklentinizde modelin gectigi her yeri yeni yolla degistirin:
      precache_model("overviews/jail_benim_v1.txt")
      engfunc(EngFunc_SetModel, varlik, "overviews/jail_benim_v1.txt")
   Yolu tek bir #define ile yazarsaniz ileride tek yerden
   degistirirsiniz.
5. Eklentiyi derleyin, sunucuyu yeniden baslatin.
6. Kontrol: oyuna girin, cstrike_downloads/overviews/ klasorunde
   dosyanin indigini ve boyutunun sizinkiyle ayni oldugunu gorun.

------------------------------------------------------------
7) MODELI GUNCELLERKEN
------------------------------------------------------------
Oyuncunun bilgisayarinda ayni adli bir dosya varsa oyun onu yeniden
indirmez. Modelin icini degistirip ayni adla koyarsaniz eski dosyayi
indirmis oyuncular eski modelle oynar, sekanslar tutmaz, hatta oyun
hata verebilir.

Bu yuzden modeli her guncellediginizde adini da degistirin:
jail_benim_v1.txt -> jail_benim_v2.txt. Eklentideki yolu da ayni
sekilde guncelleyin.

------------------------------------------------------------
8) FASTDL'DE DIKKAT
------------------------------------------------------------
Bazi web sunuculari .txt dosyalarini metin sanip satir sonlarini
degistirebilir ya da karakter kodlamasini cevirebilir. Bu, modeli
bozar. Kontrol icin dosyayi tarayicidan indirin ve boyutunu
sunucudakiyle karsilastirin. Boyut ayni olmali.

------------------------------------------------------------
9) BU BIR KILIT DEGIL
------------------------------------------------------------
Bu yontem modeli saklar, kilitlemez. Dosyalarin ilk baytlarina bakan
biri modeli yine bulabilir. Eklentinin kaynak kodu acik oldugu icin
sunucu sahipleri de yolu gorebilir. Amac, siradan bir oyuncunun
modeli indirme klasorunden alip kolayca baska yere koymasini
zorlastirmaktir.
