1.1) Installation
1.2) Wie muss die config Datei strukturiert sein ?

2.1) Spezielle-Optionen in der config Datei
2.2) WAV, MP3 und SPEECH korrekt in der config Datei
2.3) Ein neues Wort / Sound hinzufgen
2.4) Benutzerdefinierte Rechte pro Wort/Sound

3) CVAR's und ihre Beschreibung

4.1) WAV ist nicht gleich WAV, hier ist das korrekte Format
4.2) Mehr Sounds hinzugefgt als funktionieren/angezeigt werden ?
4.3) Plugin funktioniert nicht oder Probleme mit Sounds ?
4.4) Server crashed ?

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 1.1)

- Tue die Configurationsdatei "snd-list.cfg" in den "addons/amxmodx/configs" Ordner
- Tue die "sank_sounds.amxx" Datei in den AmxModX Plugins Ordner

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 1.2)

- Dateinamen drfen keine leerzeichen enthalten

- Datei muss wie folgt aussehen:
	SND_MAX;		20			// maximale Anzahl von Sounds die ein Spieler pro map benutzten kann
	SND_MAX_DUR		180.0			// maximale Lnge von Sounds in Sekunden die ein Spieler pro map abspielen kann
	SND_WARN;		17			// wieviele Sounds ein Spieler pro map benutzten kann bis er eine Warnung bekommt
	SND_JOIN;		misc/hi.wav		// Sounds die abgespielt werden wenn jemand das Spiel betritt
	SND_EXIT;		misc/comeagain.wav	// Sounds die abgespielt werden wenn jemand das Spiel verlsst
	SND_DELAY;		0.0			// Zeit die zwischen 2 Sounds abgewartet werden muss
	SND_MODE;		15			// Definiert wer Sounds abspielen und hren kann (Lebende und Tote)
	EXACT_MATCH;		1			// Definiert ob das Wort im Chat genau dem in der config Datei entsprechen muss oder nicht
	ADMINS_ONLY;		0			// Definiert ob nur Admins Sounds abspielen knnen
	DISPLAY_KEYWORDS;	1			// Setzte dies auf 0 wenn du nicht willst das Wrter von Sounds im Chat angezeigt werden sollen

	# Word/Wav combinations:
	crap;			misc/awwcrap.Wav;misc/awwcrap2.wav
	woohoo;			misc/woohoo.wav
	@ha ha;			misc/haha.wav
	doh;			misc/doh.wav;misc/doh2.wav;@misc/doh3.wav
	mp3;			sound/mymp3.mp3;music/mymp3s/number2.mp3;mainfolder.mp3
	target;			"target destroyed"
	
	mapname TESTMAP
	testmap;		misc/doh.wav
	mapname TESTMAP2
	testmap2;		misc/haha.wav;sound/mymp3.mp3
	testmap3;		misc/hi.wav
	
	package 1
	haha2;			misc/haha.wav
	doh3;			misc/doh3.wav
	package 2
	hi;			misc/hi.wav
	
	modspecific
	<keyword>;		<location>/<name>.wav

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 2.1)

SND_MODE:
Whle die Optionen aus und addiere sie zusammen
1 = Tote knnen Sounds abspielen
2 = Lebende knnen Sounds abspielen
4 = Tote knnen Sounds hren
8 = Lebende knnen Sounds hren
16 = Lebende und Tote sind isoliert
32 = Tote hren Sounds von Lebenden ( auch wenn isoliert )
64 = Lebende hren Sounds von Toten ( auch wenn isoliert )

zB: 1 + 4 = 5, bedeutet das nur Tote Sounds abspielen und hren knnen

Die drei Optionen 16 + 32 + 64 zusammen, ist das gleiche als ob man keine dieser Optionen setzt

Zustzliche Configs:

mapname:
	- tippe mapname <leerzeichen> der echte Map Name (ohne .bsp) (eg: mapnameonly de_dust)
	- alles unter dieser Zeile wird nur bei dieser Map geprecached aber auf jeder benutzt

mapnameonly:
	- tippe mapnameonly <leerzeichen> der echte Map Name (ohne .bsp) (eg: mapnameonly de_dust)
	- alles unter dieser Zeile wird nur bei dieser Map benutzt

package:
	- tippe package <leerzeichen> Nummer (eg: package 2)
	- alles unter dieser Zeile wird nur einmal geladen und beim Map wechsel zum nchsten "package" gesprungen
	- wenn nur ein package existiert wird dieser bei jedem Map wechsel benutzt

modspecific:
	- alles unter dieser Zeile muss inhalf-life.gcf oder <deinmod>.gcf (zB: counter-strike.gcf) sein
	- wenn du andere Dateien hinzufgst (zB: wenn du CS hast und sounds aus TFC hinzufgst) kann/wird dies den Server crashen, da diese Sounds als existent eingestufft werden

INFO:
mapname		= precachen von sounds auf bestimmten maps, ABER man kann auf allen maps benutzten
mapnameonly	= precachen von sounds auf bestimmten maps, ABER nur auf dieser map kann man sie benutzen

INFO2:
Neu OPTIONEN anfangen fr dazu das die folgenden Sounds NUR an diese OPTION gebunden sind.

zB:
mapname de_dust
haha;		misc/haha.wav
mapname cs_italy
hi;		misc/hi.wav

"misc/hi.wav" ist an die OPTION "mapname cs_italy" gebunden.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 2.2)

Unterschiedliche Sound Typen brauchen unterschiedliche Einstellungen:

WAV Dateien:
	- basis Verzeichnis ist "mod-verzeichnis/sound/"
	- fge den EXAKTEN PFAD zur wav, beginnend mit basis Verzeichnis
	- wenn dein Sound in "cstrike/sound/misc/haha.wav" liegt, dann muss du zur config folgendes hinzufgen "misc/haha.wav"
MP3 Dateien:
	- basis Verzeichnis ist "mod-verzeichnis/"
	- fge den EXAKTEN PFAD zur mp3
	- wenn dein Sound in "cstrike/sound/misc/good.mp3" liegt, dann muss du zur config folgendes hinzufgen "sound/misc/good.mp3"
SPEECH Dateien:
	- basis Verzeichnis ist "mod-verzeichnis/sound/vox/"
	- diesee Dateien sind in dem steam Packet
	- speech Sounds mssen in Anfhrungsstriche getan werden (zB: target; "target destroyed")
	du darfst nicht verschiedene Speech Typen in eine speech tun oder die speech wird icht abgespielt
	speech ohne Verzeichnis wird aus  "vox/.." benutzt
	zuerst definiere den Speech Typ (NUR EINMAL zB hgrunt/) und dann fge die Wrter mir leerzeichen zwischen jedem speech ein
	zB "hgrunt/yessir barney/stop1" wird nicht funktionieren denn es sind 2 verschiedene Speeches
	ABER "hgrunt/yessir no" wird funktionieren
	finde alle verfgbaren Speech Sounds hier:
		"http://www.adminmod.org/help/online/Admin_Mod_Reference/Half_Life_Sounds.htm"

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 2.3)

- Wenn du ein neues Wort hinzufgen willst, tue dies unter "# Word/Wav combinations:" als eine NEUE Zeile.
- Das einfge eines " @ " vor einem Wort, fhrt dazu das nur Admins dieses benutzten knnen.
- Nach einem Wort und zwischen Sounds muss ein " ; " sein.
- Sounds die an ein Wort gebunden werden, mssen in der gleichen Zeile stehen !!!
- Das einfge eines " @ " vor einem Sound fhrt dazu das nur Admins dieses benutzten knnen. Also wenn
  ein Wort ffentlich ist und es hat 2 Sounds, eines ffentlich und eines mit einem " @ ", fhrt dies
  dazu, dass wenn Spieler dieses Wort benutzten nur ein Sound abgespielt werden kann, ABER wenn ein
  ADMIN dieses Wort benutzt is es mglich das der zweite Sound abgespielt wird.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 2.4)

Fge vor einem Wort/Sound @<ACCESS_LEVELS>@ ein
Ersetze <ACCESS_LEVELS> mit den Rechten die du mchtest

zB:
@abc@hallo;   misc/hallo.wav; @ab@misc/hi.wav

Das Wort "hallo" kann von jedem mit den Rechten "a", "b" oder "c"
Nur Spieler mit den Rechten "a" oder "b" knnen "misc/hi.wav" abspielen
ABER alle knnen "misc/hallo.wav" abspielen

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 3)

CVARS:

"mp_sank_sounds_download" 0 oder 1 :

Dies aktiviert oder deaktiviert das "Interne Dowload System"
Mit anderen Worten, Snak Sounds kmmert sich darum das die Spieler alle Sounds runterladen.

"mp_sank_sounds_freezetime" <Zeit in Sekunden> :

Dies definiert wie lange es dauert bis der erste betretten/verlassen Sound abgespielt wird (verhindert massig Sounds beim Map wechsel)

"mp_sank_sounds_obey_duration" <Modus> :

Dies definiert wer Soundlngen beachten muss bevor wieder ein sound abgespielt werden kann.
0 = niemand
1 = public
2 = admins
4 = RCON

zB: 1 + 2 = 3, bedeutet, dass normale Spieler und normale Admins die Soundlngen beachten mssen
7, bedeutet, dass zustzlich RCON admins die Soundlngen beachten mssen

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 4.1)

Die WAVs die du erstellst mssen dieses Format haben:
- PCM
- mono
- maximal 22 KHz
- 8 oder 16 bit

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 4.2)

Wenn du ein Problem mit Sounds hast, berprfe deine Server Console und deine amxmodX Logs.
Die Logs sind hier zu finden "<mod-Verzeichnis>/addons/amxmodx/logs/L<Monat><Tag>.log".
ffne sie (mit notepad).
Eine Log die von Sank Sounds erstellt wurde sieht so aus:
"L <Monat>/<Tag>/<Jahr> - <Zeit>: [sank_sounds.amxx] Sank Sound Plugin >> XXXXX"

XXXXX ist die Nachricht die wichtig ist.
Sie sagt mir was falsch ist.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 4.3)

Wenn du viele Sounds hinzugefgt hast und nicht alle abgespielt werden, ist es mglich,
dass du mehr hinzugefgt hast als Sank Sounds standardmssig untersttzt ( standard = 80 ).
Du musst die .sma ffnen und nach folgenden Zeilen suchen und deren Werte verndern:

#define MAX_KEYWORDS	80	// Maximale Anzahl an Wrtern
#define MAX_RANDOM	15	// Maximale Anzahl an Sounds pro Wort
#define TOK_LENGTH	60	// Maximale Wrterlnge bzw Soundwortlnge

ABER Achtung:
( MAX_RANDOM + 1 ) * TOK_LENGTH muss kleiner sein als 2048

zB Standard:
( 15 + 1 ) * 60 = 960

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 4.4)

a)

Wenn du einen Fehler wie diesen bekommst:
"Host_Error: PF_precache_sound_I : Sound fgrunt/medic.wav failed to precache because
the item count is over the 512 limit."
Musst du die Anzahl der Sound verringern
Dies ist ein Half-Life Bug, es gibt KEINE Mglichkeit das zu fixen

b)

SERVER CRASH:
Dies kann nur passieren wenn das "Interne Dowload System" an ist (oder diese Sounds von anderen plugin heruntergeladen werden)
Du hast 2 Mglichkeiten:

1) Deaktiviere das "Interne Dowload System" indem du die CVAR "mp_sank_sounds_download" auf 0 setzt
In der Server Console "mp_sank_sounds_download 0"
Oder um dies auf dauer zu deaktivieren, fge diese Zeile zur amxmodx.cfg:
"mp_sank_sounds_download 0"

2) Verkleinere deine Sound Liste

WICHTIG:
Das benutzten von anderen download plugins fr diese Sounds wird NICHT helfen. Dies ist ein HL bug und es ist NICHT mglich ihn zu korrigieren.