NeoTF Linux Server

======= =NeoTF= ======= A server-side mod for TFC. Contents ================================ 1 - Installing NeoTF on a Dedicated server. 1.1 - Installing the .dll / .so on a clean STEAM server. 1.2 - Installing the .dll / .so on a WON server. 2 - Installing NeoTF on a LAN server ( i.e. Listenserver ). 2.1 - Installing the .dll / .so on a STEAM listenserver. 2.2 - Installing the .dll / .so on an old WON listenserver. 3 - Getting NeoTF to work with other MODs 3.1 - Getting NeoTF to work with FoxBot. 3.2 - Getting NeoTF to work with Metamod. 3.3 - Getting NeoTF to work with non-Metamod libraries. 4 - Miscellaneous 4.1 - Installing Glyphs. 4.2 - Authorization. 4.3 - Setting CVARs. 5 - STEAM Issues 5.1 - Creating a liblist.gam file. 5.2 - Liblist overwrite solution. 6 - Removing NeoTF from a server. 6.1 - Non Metamod server. 6.2 - Metamod server. 6.3 - Shared resources removal. 7 - Bugs. 8 - Credits. 9 - Contact information. NOTE: In this tutorial we are assuming that you are using Windows ( so note the direction of the slashes if you are using Linux ) and you have installed STEAM in the default directory ( i.e. C: drive ). NOTE: We also assume you have installed TFC and/or the Dedicated server applications. If not, then install these applications before proceding. NOTE: For Dedicated Servers, we assume that the application you are using is the one from the STEAM games menu and not the standalone HLDS application (in which case you should take into consideration the relative directory paths to your TFC folder). 1 - Installing NeoTF on a Dedicated server. ================================ 1.1 - Installing the .dll / .so on a clean STEAM server. ------------------------------------------------- When you installed STEAM, you had to create an account with a valid e-mail address eg, YOURNAME@EMAIL. This will create a folder in C:\Program Files\Steam\SteamApps\ where most downloaded contents (maps/sounds/models/sprites) will be stored. This folder will have the same name as you email address. It is from within this folder that most of your games and server applications will be run. In this folder you will find the dedicated server folder: C:\Program Files\Steam\SteamApps\YOURNAME@EMAIL\Dedicated Server Within this folder is a HLDS launcher app and a number of game folders, the TFC one is the one we are looking for: C:\Program Files\Steam\SteamApps\YOURNAME@EMAIL\Dedicated Server\tfc NOTE: For the standalone HLDS, the (default) TFC folder would be: C:\HLServer\tfc In this TFC folder you will find: (I). A liblist.gam file, replace the revelant Operating System gamedll entry: For a Windows server edit this file and replace the line: gamedll "dlls\tfc.dll" with: gamedll "addons\NeoTF\dlls\ntf.dll" For a Linux server edit this file and replace the line: gamedll_linux "dlls/tfc_i386.so" with: gamedll_linux "addons/NeoTF/dlls/NeoTF_i486.so" (II). A "models" folder, create a "neotf" folder inside this and extract all NeoTF custom models here. (III). A "sound" folder, create a "neotf" folder inside this and extract the llama sound files here. The sound files for the "ntf_tpoint" map also go here: breather.wav, rwind.wav and waterfall2.wav (IV). A "sprites" folder, create a "glyphs" folder inside this and extract the glyph sprite files here. (V). A "maps folder", extract the ntf_* maps here. For the loadconfig feature, create a "neotf" folder inside this and put any map config files here. (VI). A server.cfg file, put "exec ntf_cvars.cfg" in this file and extract the ntf_cvars.cfg file to this directory, so that the server config file can execute the CVAR config file. (VII). A "dlls" folder. Inside this folder is the tfc.dll file that this MOD will load. Create an "addons" folder in this TFC directory and extract the "NeoTF" folder to this directory, so it ends looking like this: C:\Program Files\Steam\SteamApps\YOURNAME@EMAIL\Dedicated Server\tfc\addons\NeoTF You should now have inside addons\NeoTF: (a). An "areas" folder, containing all the FoxBot area files. (b). A "data" folder to store messages from the messaging system. (c). A "dlls" folder, containing the ntf.dll file ( for Windows ) or NeoTF_i486.so file ( for Linux ). (d). A "docs" folder containing all the NeoTF documentation. (e). A "help" folder, containing all the ntf_help files. (f). An ntf_users.ini file for the auth system. Note: Your current WONID will not work in TF 1.6, you will need to find out what your STEAM ID is to auth yourself on your own server. To do this go on any dedicated server ( NOT a LAN server! ) and type "status" in your console and obtain your STEAM ID from the output. (g). An ntf_config.txt file to load the ntf.dll file ( for Windows ) OR an ntf_configlinux.txt file to load the NeoTF_i486.so file ( for Linux ). (h). An ntf_glyphs.txt file to load the glyphs. (i). An ntf_welcome.txt file. Once you have set up all the files you can start your DEDICATED NeoTF STEAM Server. NOTE: The TF1.6 dll loads extra sprites and models for teleporters, this may cause a crash when loading the map "warpath" if you have all features enabled. 1.2 - Installing the .dll / .so on a WON server ------------------------------------------------------ All Half-Life games now use STEAM. You cannot create WON Dedicated servers anymore. Go to the STEAM website for more information: URL: http://www.steampowered.com/ 2 - Installing NeoTF on a LAN server ( i.e. Listenserver ) ================================ 2.1 - Installing the .dll / .so on a STEAM listenserver ------------------------------------------------- NOTE: In this tutorial we are assuming that you are using Windows ( so note the direction of the slashes if you are using Linux ) and you have installed STEAM in the default directory ( i.e. C: drive ). When you installed STEAM, you had to create an account with a valid e-mail address eg, YOURNAME@EMAIL. This will create a folder in C:\Program Files\Steam\SteamApps\ where most downloaded contents (maps/sounds/models/sprites) will be stored. This folder will have the same name as you email address. It is from within this folder that most of your games and server applications will be run. In this folder you will find the TFC Client folder: C:\Program Files\Steam\SteamApps\YOURNAME@EMAIL\team fortress classic Within this folder is an HLDS Launcher app and a number of game folders, the TFC one is the one we are looking for: C:\Program Files\Steam\SteamApps\YOURNAME@EMAIL\team fortress classic\tfc In this TFC folder you will find: (I). A liblist.gam file, (you may have to create this file, see Section 4.1 ) Replace the revelant Operating System gamedll entry: For a Windows server edit this file and replace the line: gamedll "dlls\tfc.dll" with: gamedll "addons\NeoTF\dlls\ntf.dll" For a Linux server edit this file and replace the line: gamedll_linux "dlls/tfc_i386.so" with: gamedll_linux "addons/NeoTF/dlls/NeoTF_i486.so" (II). A "models" folder, create a "neotf" folder inside this and extract all NeoTF custom models here. (III). A "sound" folder, create a "neotf" folder inside this and extract the llama sound files here. The sound files for the ntf_tpoint map also go here: breather.wav, rwind.wav and waterfall2.wav (IV). A "sprites" folder, create a "glyphs" folder inside this and extract the glyph sprite files here. (V). A "maps" folder, extract the ntf_* maps here. For the loadconfig feature, create a "neotf" folder inside this and put any map config files here. (VI). A listenserver.cfg file, put exec ntf_cvars.cfg in this file and extract the ntf_cvars.cfg file to this directory, so that the server config file can execute the CVAR config file. (VII). A "dlls" folder. Inside this folder is the tfc.dll that this MOD will load. Create an addons folder in this TFC directory and extract the NeoTF folder to this directory, so it ends looking like this: C:\Program Files\Steam\SteamApps\YOURNAME@EMAIL\team fortress classic\tfc\addons\NeoTF You should now have inside addons\NeoTF: (a). An "areas" folder, containing all the FoxBot area files. (b). A "data" folder to store messages from the messaging system. (c). A "dlls" folder, containing the ntf.dll file ( for Windows ) or NeoTF_i486.so file ( for Linux ). (d). A "docs" folder containing all the NeoTF documentation. (e). A "help" folder, containing all the ntf_help files. (f). An ntf_users.ini file for the auth system. Note: To auth yourself on the listenserver use "STEAM_ID_LOOPBACK" or "VALVE_ID_LOOPBACK". Auth OTHER player via IP address, because everyone else will have the same ID ( usually it's "STEAM_ID_LAN" ). (g). An ntf_config.txt file to load the ntf.dll file ( for Windows ) OR an ntf_configlinux.txt file to load the NeoTF_i486.so file ( for Linux ). (h). An ntf_glyphs.txt file to load the glyphs. (i). An ntf_welcome.txt file. Once you have set up all the files you can start your NeoTF (STEAM) Listen (LAN) Server. NOTE: The TF1.6 dll loads extra sprites and models for teleporters, this may cause a crash when loading the map "warpath" if you have all features enabled. You may want to disable the custom models feature and the glyphs feature to get this map to load. 2.2 - Installing the .dll / .so on an old WON listenserver ------------------------------------------------- NOTE: USE the previous NeoTF version (ver 1.8.7) for an old WON LAN server. The current version does not support the old WON system. Unzip the zip (or tar) file into your old Half-Life directory. NeoTF now installs everything (with the exception of foxbot area files) under tfc/addons/NeoTF If you have a server that doesn't use metamod or any other addons, follow these directions: To get Half-Life to load the NeoTF .dll or .so file instead on the default you need to edit tfc\liblist.gam file: For a Windows server edit this file and replace the line: gamedll "dlls\tfc.dll" with: gamedll "addons\NeoTF\dlls\ntf.dll" For a Linux server edit this file and replace the line: gamedll_linux "dlls/tfc_i386.so" with: gamedll_linux "addons/NeoTF/dlls/NeoTF_i486.so" If you are installing NeoTF in addition to another TFC mod, or if your server is metamod-enabled, follow the instructions in Section 3. 3 - Getting NeoTF to work with other MODs ================================ 3.1 - Getting NeoTF to work with FoxBot ------------------------------------------------------ NOTE: You MUST install NeoTF and FoxBot WITH Metamod for the Bots to use NeoTF features. See Section 3.2 for Metamod information. For a WON listenserver: Use the FoxBot GUI installer and select the NeoTF option. With this option, the FoxBoT will automatically set up your files (liblist.gam, plugins.ini) to load the NeoTF dll. For STEAM servers: First install Metamod and FoxBot per (their) instructions. Make sure FoxBot is loaded as a plugin by Metamod. NOTE: Make SURE you are using the most current Metamod version: 1.17.x ( i.e. with STEAM support ). NOTE: Make sure you install FoxBot to the proper directory. The FoxBot folder must be placed in the root game directory which contains an HLDS launcher application. For Dedicated servers this directory path looks like: \SteamApps\YOURNAME@EMAIL\dedicated server For Lan servers (listenserver) this directory path looks like: \SteamApps\YOURNAME@EMAIL\team fortress classic Add the following entry to your server's "autoexec.cfg" file in your "tfc" folder: For Windows servers use this entry: localinfo mm_gamedll addons/NeoTF/dlls/ntf.dll For Linux servers use this entry: localinfo mm_gamedll addons/NeoTF/dlls/NeoTF_i486.so This entry will tell Metamod to load NeoTF (and not normal TFC). NOTE: Remove any NeoTF entries in plugins.ini or metamod.ini file or liblist.gam file, otherwise Metamod will end up trying to load NeoTF twice, which will cause the following Half-Life error: "Host_Error: SuckOutClassname: parse error" 3.2 - Getting NeoTF to work with metamod ---------------------------------------- Metamod (http://www.metamod.org) provides plugin capability for addons. Tools such as Adminmod (http://www.adminmod.org) use metamod. Thanks to RedFox, NeoTF is now capable of running as a metamod plugin. First install metamod/adminmod per instructions. Once complete your liblist.gam should have the following lines: gamedll dlls/metamod.dll gamedll_linux dlls/metamod_i386.so Your plugins.ini file (or metamod.ini for older MM versions) should have a list of the metamod plugins you're using. The order of these is important - make sure your server is working with your metamod plugins before you try to run NeoTF. Here's an example, yours will most likely vary from this: linux dlls/csguard_mm_i386.so linux dlls/admin_MM_i386.so or win32 dlls/admin.dll Note that all the above should have been accomplished when you installed metamod and it's associated plugins. Now to get NeoTF to work, just add the NeoTF ntf.dll or NeoTF_i486.so to your plugins.ini (or metamod.ini for older MM versions) file: Windows: win32 addons/NeoTF/dlls/ntf.dll OR Linux: linux addons/NeoTF/dlls/NeoTF_i486.so NOTE: Paths should use unix-style forward slashes ( / ) and not backward slashes ( \ ), even on windows platforms. 3.3 - Getting NeoTF to work with non-metamod libraries ------------------------------------------------------ Some addons (like HPB bot) aren't metamod plugins. If you want these to work with NeoTF, you'll need to change the following file: For Windows servers: addons\NeoTF\ntf_config.txt OR For Linux servers: addons/NeoTF/ntf_configlinux.txt These files contain a SINGLE LINE with the name of the .dll or .so file you want NeoTF to load. So if you want to use HPB bot, change the file as follows: For Windows servers, the"ntf_config.txt" file would contain this entry: HPB_bot.dll For Linux servers, the "ntf_configlinux.txt" file would contain this entry: HPB_bot_i486.so 4 - Miscellaneous ================================ 4.1 - Installing new glyphs on the server ----------------------------------------- The list of glyphs and the command to use each one is in ntf_glyphs.txt To install a new glyph, place the .spr file in the addons/NeoTF/sprites/glyphs directory and add an appropriate line in the "ntf_glyphs.txt" file. The format of the entries in "ntf_glyphs.txt" are as follows: (name) (filename) Where (name) is the name of the sprite to be displayed for the "glyph_list" command, and (filename) is the exact filename for the sprite. They MUST be separated by a at least a single space. Example entry: attention sprites/glyphs/t_atten.spr NOTE: Keep both the name and filename as short as possible. NOTE: There MUST be NO spaces in the sprite's name or filename for the sprite to be loaded correctly. Any new glyphs must be 32x32 with alpha transparency. They can be animated. Any client will automatically download the sprite files from the server upon connecting. Be aware that Half-Life has a set precache limit that is shared between sprites and models, so using a very large number of glyphs may cause unexpected crashes on map load -- if this happens, remove some from the list. We've disabled glyphs by default for this very reason - if you want to use glyphs, note that some maps (like warpath) will indeed crash. 4.2 - Authorization ----------------------------------------- Some NeoTF commands (e.g. llamacage-related) require authorization. Authorization is given by WONid. If you want certain players to have access to these commands, create a file called "ntf_users.ini" in your tfc/ directory. The file has the following format, with one entry per line: authid-or-ip:authlevel authid-or-ip = the player's authid (STEAM ID), or IP address authlevel = the player's authorization level authlevel is determined by adding together all the authorization codes for each command you want the user to have access to. Authlevels are described in the sample ntf_users.ini file included with NeoTF. Commands are described in detail in the ntf_admin_commands.txt file. 4.3 - Setting CVARs ----------------------------------------- There's a file called "ntf_cvars.cfg" included with NeoTF. It contains a list of all the CVARs that affect the behaviour of NeoTF. We suggest you put an "exec addons/NeoTF/ntf_cvars.cfg" line in your server.cfg (orlistenserver.cfg) so that this file gets loaded by your server. 5 - STEAM Issues ================================ 5.1 - Creating a liblist.gam file. ----------------------------------------- If you do not have a liblist.gam file in either the client or Dedicated server folders then you will have to make one (the default one is locked away in the gcache file). Creating the file: 1. Open up a text editor ( notepad for example ) and create a new file. 2. Put these settings: // Team Fortress Classes Game .dll Listing File // Load order is determined by file order. game "Team Fortress" url_info "www.teamfortressclassic.com (http://www.teamfortressclassic.com)" url_dl "" version "1.6" size "37000000" svonly "0" cldll "0" type "multiplayer_only" // Don't show models in browser, since you don't pick them there anyway. nomodels "1" mpentity "info_tfdetect" gamedll "addons\NeoTF\dlls\ntf.dll" gamedll_linux "dlls/NeoTF_i486.so" secure "1" // Enable VAC security modules 3. Choose "save as" 4. Change the file type to "All Files" 5. The filename will of course be "liblist.gam" 6. Choose the folder in which you will be saving the file. 7. Click "save". 5.2 - Liblist overwrite solution. ----------------------------------------- Note: This affects Dedicated servers using ANY addon MOD that runs from a modified liblist.gam file ( Metamod, Adminmod etc ). Everytime there is a STEAM update, this file is now extracted from the gcache file and overwrites the existing one in the Dedicated server directory. Your dedicated server has to be restarted AT LEAST ONCE with the extracted (default) file for it to run properly. These are the steps to need to perform after every Update: 1. Back up your modified liblist.gam file, make the file read-only. 2. Delete the existing liblist.gam file in the directory. 3. Start up a normal TFC dedicated server. 4. Shut down the server once it is loaded up and running normally. 5. You will notice a new liblist.gam file in your Dedicated server directory. This is the extracted file, replace it with your modified read-only file. 6. Restart your Dedicated server. 6 - Removing NeoTF from a server ================================ 6.1 - Non Metamod server ---------------------------------- To remove NeoTF from a Windows server, edit tfc\liblist.gam and replace the line: gamedll "addons\NeoTF\dlls\ntf.dll" with: gamedll "dlls\tfc.dll" To remove NeoTF from a Linux server, edit tfc\liblist.gam and replace the line: gamedll_linux "addons/NeoTF/dlls/NeoTF_i486.so" with: gamedll_linux dlls/tfc_i386.so After this is done, see Section 6.3 6.2 - Metamod server ---------------------------------- Simply remove the NeoTF ntf.dll or NeoTF_i486.so entry from your plugins.ini file (or metamod.ini for older MM versions) or any NeoTF localinfo entries in your autoexec.cfg file. After this is done, see Section 6.3 6.3 - Shared resources removal ---------------------------------- Note: the relative path for a STEAM Dedicated server is: C:\Program Files\Steam\SteamApps\YOURNAME@EMAIL\Dedicated Server\tfc Note: the relative path for a STEAM LAN server (listenserver) is: C:\Program Files\Steam\SteamApps\YOURNAME@EMAIL\team fortress classic\tfc Note: the relative path for a WON LAN server (listenserver) is: C:\Sierra\Half-Life\tfc (I). Delete the "neotf" folder inside the "tfc\models" folder. (II). Delete the "neotf" folder inside the "tfc\sound" folder. (III). Delete the "neotf" folder inside the "tfc\maps" folder. (IV). Delete the "glyphs" folder inside the "tfc\sprites" folder. (V). Delete the "NeoTF" folder inside the "tfc\addons" folder. (VI). Remove the line "exec ntf_cvars.cfg" from any configs you are running. (VII). Delete the ntf_cvars.cfg file. 7 - Bugs ================================ Please report any bugs with an accurate description to the Forums at http://www.planetneotf.com 8 - Credits ================================ See ntf_help.txt for credits. 9 - Contact information ================================ The NeoTF website is currently at http://www.planetneotf.com