ResGen

Wersja z 00:49, 17 maj 2011

Opis

ResGen to program do tworzenia plików .res, które są wykorzystywane w HLDS.

Pliki .res zawierają listę zasobów potrzebnych do prawidłowego odpalenia mapki przez serwer jak i klienta. Jest to w rzeczywistości plik tekstowy, można go edytować notepadem albo stworzyć od zera innym edytorem tekstu. Jednak po co się męczyć - do tworzenia plików .res stosujemy program resgen, który za nas odwali kawał roboty.

Linki

• http://www.jtpage.net/resgen.htm - tutaj są źródła aczkolwiek dla potrzeb nowego gcc-4.3 trzeba zmienic troche makefile, zmienić CFLAGS oraz LDFLAGS
• z CFLAGs usuwamy -m486
• do LDFLAGS dodajemy -lstdc++ aby dodac standardowe biblioteki c++

#full optimization
CFLAGS=$(BASE_CFLAGS) -w -s  -O2 \
        -ffast-math -funroll-loops \
        -fexpensive-optimizations -malign-loops=2 \
        -malign-jumps=2 -malign-functions=2

LDFLAGS=-lstdc++

do tego trzeba zmienic vstring.h - zastapnic VString::InstrRev na InstrRev

// int VString::InstrRev(char *search, int start);
int InstrRev(char *search, int start);

Tworzymy jeszcze katalog obj/ Po tych zmianach makefile powinen nie zgłaszać błędów.

Komendy

Podstawowa komenda i słownik angielskiego podają nam informacje jak używać aplikacji (z konsoli)

resgen --help

(tłumaczenie)

RESGen version 2.0 BETA 2, Copyright (C) 2000-2003 Jeroen Bogers
RESGen comes with ABSOLUTELY NO WARRANTY; for details
use the command line switch '-w'.  This is free software,
and you are welcome to redistribute it under certain
conditions; see the 'gpl.txt' file for details.

Parametry:
-h           wyświetla help (po angielsku)
-c           wyświetla listę autorów
-w           pokazuje rozszerzony ekran z prawami autorskimi
-v           uruchamia tzw. silent mode czyli bardzo mało wyników na ekranie się będzie pojawiać
-s           nie wyświetla linii statusu
-i           nie wyświetla aktualnego folderu podczas poszukiwania plików z mapami
-j           nie wyświetla listy znalezionych zasobów podczas przetwarzania mapy
-d [folder]  przetwarzaj cały folder (z mapami)
-r [folder]  tak jak -d, ale schodzi do podkatalogów (np przy generowaniu plików .res dla wszystkich map wszystkich modów)
-f [nazwa]   przetwarzaj mapę o nazwie 'nazwa'
[map]        tak samo jak -f
-x [nazwa]   nie przetwarzaj mapy o nazwie 'nazwa', użyteczne przy parametrach -d i -r
-o           nadpisz istniejące pliki .res
-a [rfafile] dodaj zawartość pliku .rfa o pliku .res (przy dodawaniu np dźwięków multikill)
-l           nie przetwarzaj nazw plików na małe litery (teoretycznie ważne na linuksie szczególnie przy użyciu sv_dowloadurl, ale aktualnie naprawione)
-e [modpath] sprawdź ścieżkę 'modpath' w poszukiwaniu zasobów
-p           nie szukaj zasobów w plikach .pak (z czasów cs 1.5)
-t           ignoruj linki symboliczne podczas szukania zasobów (linux only)

Przykład:
   resgen -f boot_camp -d . -r ../mappack -e hlds_l/cstrike

Przed uruchomieniem pliku resgen z mapami najlepiej jeśli zrobicie sobie gdzieś kopie plików .res (np w podkatalogu maps/bak)

Najlepiej program resgen umieścić w katalogu cstrike i uruchamiamy z konsoli.

resgen -t -d maps -o -e

Wtedy przemieli wszystkie mapki i stworzy dla każdej plik .res, Uwaga ten proces może być czasochłonny!

Dlatego lepiej dla jednej mapy wpisać:

resgen -t -f nazwa_mapy -o -e

Dla naszej mapki de_biochem komenda wiec będzie wyglądać tak:

resgen -t -f maps/de_biochem -o -e

Wtedy pojawi się na ekranie cos w rodzaju poniższego tekstu:

Added "maps/de_biochem.bsp" to map list


Creating .res file for maps/de_biochem.bsp [1/1]:
halflife.wad
decals.wad
gfx/env/dashdesert256_up.tga
gfx/env/dashdesert256_dn.tga
gfx/env/dashdesert256_lf.tga
gfx/env/dashdesert256_rt.tga
gfx/env/dashdesert256_ft.tga
gfx/env/dashdesert256_bk.tga
models/tnt.mdl
maps/de_biochem.txt


Done creating res file(s)! 1 file(s) were generated.

W efekcie powinien powstać plik maps/de_biochem.res o poniższej zawartości

// de_biochem.res - created with RESGen v2.0 BETA 2.
// RESGen is made by Jeroen "ShadowLord" Bogers.
// For more info go to http://resgen.hltools.com
// or E-mail me at resgen@hltools.com.

// .res entries (10):
halflife.wad
decals.wad
gfx/env/dashdesert256_up.tga
gfx/env/dashdesert256_dn.tga
gfx/env/dashdesert256_lf.tga
gfx/env/dashdesert256_rt.tga
gfx/env/dashdesert256_ft.tga
gfx/env/dashdesert256_bk.tga
models/tnt.mdl
maps/de_biochem.txt

Jeśli mamy dźwięki w katalogu sound/misc/ multikill, hedshot i chcemy aby były ściągane przez graczy na przykład:

sound/misc/headshot.wav
sound/misc/holyshit.wav

oraz widok mapy z góry:

overviews/de_biochem.txt
overviews/de_biochem.bmp

to możemy do tego pliku je dodać ręcznie, uzyskując w efekcie końcowym taki plik:

// de_biochem.res - created with RESGen v2.0 BETA 2.
// RESGen is made by Jeroen "ShadowLord" Bogers.
// For more info go to http://resgen.hltools.com
// or E-mail me at resgen@hltools.com.

// .res entries (10):
halflife.wad
decals.wad
gfx/env/dashdesert256_up.tga
gfx/env/dashdesert256_dn.tga
gfx/env/dashdesert256_lf.tga
gfx/env/dashdesert256_rt.tga
gfx/env/dashdesert256_ft.tga
gfx/env/dashdesert256_bk.tga
models/tnt.mdl
maps/de_biochem.txt

sound/misc/headshot.wav
sound/misc/holyshit.wav

overviews/de_biochem.txt
overviews/de_biochem.bmp

Uwaga, nie należy dodawać za dużo dźwięków, bo może się nie załadować mapka - serwer się wyłoży, szczególnie jest to zauważalne przy mapach typu de_aztec, de_oimec i innych, gdzie jest dużo ekstra modeli, tekstur, efektów itp, i wtedy limit 512 obiektów jest przekraczany i serwer się wykłada. Wtedy trzeba ręcznie usunąć nadmiarową ilość wpisów z pliku .res i spróbować załadować mapkę jeszce raz.

NIE NALEŻY dodawać plików .wav typu multikill i headshot, jeśli używamy pluginów do AMX Mod czy AMX Mod X, które robią to za nas, np sank sounds, czy psycho sounds i temu podobne.

Dodawanie masowe plików

Masowe dodawanie plików .wav do zassania. Czyli mamy własne dźwięki i chcemy dodać do wszelkich map na jakich gramy aby na pewno były ściągalne.

Dodajemy listę plików do pliku lista.rfa na przykład

sound/misc/dominating.wav
sound/misc/firstblood.wav
sound/misc/headshot.wav
sound/misc/holyshit.wav
sound/misc/holyshit_q3.wav
sound/misc/humiliation.wav

Odpalamy resgen z dodatkowym parametrem -a lista.rfa, aby stworzyć pliki .res oraz aby zawierały naszą listę dodatkowych zasobów:

resgen -t -d maps -o -e -a lista.rfa

Od tego momentu wszelkie pliki .res powinny mieć dodatkowo nasze dźwięki (i inne rzeczy) dodane, i powinnny się ściągać z serwera, jeśli klient na to pozwala.

Problemy

Resgen nie dodaje overview Wiem, że poprzednie wersje resgen'a mialy błąd i w ogóle nie dodawały plików overview, wtedy trzeba dorwać nowsza wersje resgen'a, albo obejść problem - można overview dodać ręczne, nie mówiąc o tym ze najpierw trzeba dostać/zrobić pliki overview, ale i tak z tego trybu pewnie korzysta maks 5% graczy i to tylko wtedy gdy widok mapki nie jest zablokowany.

Skrypt multiRes (win)

Przy 20 mapach utworzenie ręcznie plików resource troszkę czasu zajmuje, ale jest to osiągalne, ale w przypadku 100, 200 lub ~1700 map jest to awykonalne. Poniżej prezentuje dwa proste skrypty do utworzenia plików resource (res), także plików konfiguracji mapconfig, dla wszystkich posiadanych map, włączenie z overviews. Pliki należy zapisać/utworzyć w wraz z programem ResGen.exe w katalogu cstrike. Działanie jest proste: 1.cmd tworzy listę map z katalogu /maps zapisuje je odpowiednio przetworzone w pliku 2.cmd res.cmd tworzy pliki resource (.res), AMXModX mapconfig dla pluginów (.ini) oraz AMXModX mapconfig dla cvarów (.cfg), sprawdza czy istnieją podglądy mapy w katalogu overviews

zawartość pliku 1.cmd

@echo off > newfile & setLocal enableDELAYedexpansion 

dir maps\*.bsp /B >> 2.cmd
for /f "tokens=* delims= " %%a in ('echo 2.cmd') do ( 
for /f "tokens=* delims= " %%t in (%%a) do ( 
set S=%%t 

set S=!S:.bsp =! 
>> newfile echo @call res.cmd !S! 
) 
copy newfile "%%a" > nul 
) 
del newfile 

zawartość pliku res.cmd

@echo off > newfile & setLocal enableDELAYedexpansion 

IF NOT EXIST maps\%1.bsp (
ECHO [ BLAD ] NIE MA TAKIEJ MAPY LUB UZYJ NAZWY MAPY BEZ ROZSZERZENIA 
GOTO end
)

@echo RESOURCE DLA MAPY [ %1.bsp ] >> _lista
@resgen.exe -v -o -f maps\%1.bsp >> _lista

cd maps
for /f "tokens=* delims= " %%a in ('echo %1.res') do ( 
for /f "tokens=* delims= " %%t in (%%a) do ( 
set S=%%t 

REM nie ma sensu by w pliku resource sprawdzało standardowe pliki tekstur w hl i cs16

set S=!S:models/player=//-! 
set S=!S:ajawad.wad=//-! 
set S=!S:cached.wad=//-! 
set S=!S:chateau.wad=//-!
set S=!S:cs_747.wad=//-!
set S=!S:cs_assault.wad=//-!
set S=!S:cs_bdog.wad=//-!
set S=!S:cs_cbble.wad=//-!
set S=!S:cs_dust.wad=//-!
set S=!S:cs_havana.WAD=//-!
set S=!S:cs_office.wad=//-!
set S=!S:cstraining.wad=//-!
set S=!S:cstrike.wad=//-!
set S=!S:de_airstrip.wad=//-!
set S=!S:de_aztec.wad=//-!
set S=!S:de_piranesi.wad=//-!
set S=!S:de_storm.wad=//-!
set S=!S:de_vertigo.wad=//-!
set S=!S:decals.wad=//-!
set S=!S:iga_static.wad=//-!
set S=!S:itsitaly.wad=//-!
set S=!S:n0th1ng.wad=//-!
set S=!S:prodigy.wad=//-!
set S=!S:torntextures.wad=//-!
set S=!S:tswad.wad=//-!
set S=!S:gfx.wad=//-!
set S=!S:halflife.wad=//-!
set S=!S:liquids.wad=//-!
set S=!S:spraypaint.wad=//-!
set S=!S:xeno.wad=//-!
>> newfile echo !S! 
) 
copy newfile "%%a" > nul 

) 

rem dodawanie widoków
IF EXIST ..\overviews\%1.bmp ECHO overviews/%1.bmp >> %1.res
IF EXIST ..\overviews\%1.tga ECHO overviews/%1.tga >> %1.res
IF EXIST ..\overviews\%1.txt ECHO overviews/%1.txt >> %1.res

rem sprawdzanie poprawności oryginalnych plików np smoke
ECHO sprites/gas_puff_01.spr >> %1.res
ECHO sprites/smokepuff.spr >> %1.res
del newfile 
cd ..
del newfile 

rem mapconfig pluginy on off
IF NOT EXIST addons\nul md addons\amxmodx\configs\maps\
echo MAPCONFIG [%1.BSP]
cd addons\amxmodx\configs\maps\
echo ;; MAPCONFIG PLUGINS INI [%1.BSP] >> plugins-%1.ini
echo ;; http://wiki.alliedmods.net/Configuring_AMX_Mod_X#Map_Specific_Plugins >> plugins-%1.ini

rem mapconfig cvar
echo ;; MAPCONFIG CVAR CFG [%1.BSP] >> %1.cfg
echo ;; http://wiki.alliedmods.net/Configuring_AMX_Mod_X#Map_Config_Files >> %1.cfg
echo amx_restrict on shield >> %1.cfg
echo amx_pausecfg stop M_Antirusher_2.6.amxx >> %1.cfg
cd ..
cd ..
cd ..
cd ..

:end 

kolejność uruchamiana: 1.cmd po zakończeniu 2.cmd

dla pojedynczej mapy można użyć polecenia res.cmd <nazwamapy>