Help Hosting Mods and Custom Maps (Using the Game Server as the File Server)

[Tifosi 92]

Hi there!

I've had difficulty hosting matches on custom maps for a few years now (switched webhosts a while ago) and am looking for a solution, primarily for LAN games but also for games over the internet if possible. After 3 hours of trial-and-error research last weekend I don't feel I'm any closer to success and would like some help.

I am able to host LAN games running the Bot Warfare mod on the game server without any problems (it's unclear to me if the mod is successfully downloading to client machines given I cannot get custom maps to do so). However, when I switch to any custom maps (e.g. Shipment), client machines are kicked from the lobby after a short delay with an "invalid file" error.

I would like to host mods and usermaps on the machine functioning as the game server, primarily for LAN parties but preferably over the internet as well. The FastDL guide is, quite bluntly, missing a LOT of information on how to do this even though it appears to be possible since there is a screengrab of what looks to be an XAMPP-generated Apache server page with a local network IP address (I'm happy to write/contribute a detailed guide for the page if someone can help me learn how to get it working). I have tried, without success, to set up my game server as an Apache server that also hosts mods or usermaps.

The following are questions I have about this process:

File Storage Questions

1. Is it possible to simply install identical "mods" and "usermaps" directories on the client machines to avoid the use of FastDL entirely? (have already tried this without success, so I assume not, but saw it mentioned as possibly viable in another thread)

2. What is the proper location for the "usermaps" directory on the file (also game) server? Should it live in the same directory as "mods", inside the "mods" directory, or inside the directory for the loaded mod? (another thread inconclusively suggests all of these are viable options)

3. Should client machines delete all "mods" and "usermaps" directories from "storage/iw5/" prior to joining the server, or do the server settings override any client-side "mods" and "usermaps" directories? Is it possible that "mods" and "usermaps" installed client-side can cause issues with FastDL? Will having these directories present in "storage/iw5/" AND in the "gameserver" folder create issues?

Simultaneously Using the Game Server as a File Server

4. Is it possible to use XAMPP to host mods AND usermaps on the game server for client machines in LAN play using Apache? Does this also work for online play?

5. I have tried setting sv_wwwBaseURL in the server config file to point to a directory labeled "iw5" containing two sub-directories: "mods" and "usermaps", with all the game files I want downloaded by clients. When XAMPP is running an Apache server on the machine, I can access this folder using the server machine by typing "[server IP address]/iw5/" into its web browser, but cannot access it from any other machines. This seems like an XAMPP configuration problem and possibly the root of the issue—any suggestions? The XAMPP documentation is ridiculously dense for someone with little web coding experience.

6. How should "fsgame" in the server config file be set (simply "mods/bots")? When leaving it empty, Bot Warfare loaded and ran fine on my game server as well as for clients using base-game maps. Given I can neither get any usermaps to download to clients, nor use a client to access the files on my game server, it appears that Bot Warfare need not be downloaded to clients to run properly—perhaps someone can confirm this?

There are probably other questions about which I've forgotten but this seems a good place to get a working model for further testing/diagnosis in order. Once I've got my game/file server working I'm happy to compile the process into a more detailed guide for the website, if that contribution would be helpful, as I've found the documentation present there underdeveloped and don't want others to have the same issues.

Thanks in advance for any answers, and would love to get this solved so I can go back to having 18-player bloodbaths on Bog or Shipment with my friends.

[Tifosi 92]

OK, after doing some research, I've at last solved the problem for LAN games.

The answers I found for my own above questions are:

1. Inconclusive. I tried to simply join a private match using mods using the "friends" feature but got stuck on a "Connecting..." dialog which would not resolve.

2. The proper location for usermaps on the gameserver is in "storage/iw5/usermaps". As far as I can tell, it need not live anywhere else.

3. Client-side files have no effect on what the host machine is doing at all it seems.

4. Yes, this is possible.

5. "http://[server IP address]/iw5/" is correct. If XAMPP is working through a particular port (I used port 80), then "http://[server IP address]:80/iw5/" is correct. This folder should contain a "mods" folder separate from "usermaps".

6. seta_fsgame should be set to "mods/bots" if you're running bots.

Now, as to what my issue was, so that others can solve the problem:

• XAMPP requires being run as an administrator. If you're not paying attention and launching it from the taskbar, you may not have launched it as an admin. My version of XAMPP (downloaded December 2024) displays a warning message about lack of admin privileges in the console dialog box when opened, but on my PC, this was half cut-off by other status messages so I'd initially missed it. Make sure you are running XAMPP as an administrator.

• Once you are running XAMPP as an administrator, you must download and install the Apache service. If there's a big red "X" in XAMPP near "Apache", you don't have Apache installed or it's not functional. This download took mere seconds from a button on the main screen of XAMPP and it was installed immediately.

• You must allow the newly installed Apache service through your firewall on the network you are running. To do this, go to Windows Firewall settings and look for services labeled Apache. Make sure all incoming and outgoing connections through Apache are allowed through the firewall. For me, editing the settings for Public networks was easier than for Private. Importantly, your network must match the classification of the networks for which traffic is allowed—I could not get my home network to work when configured in Windows Settings -> Wi-Fi as a Private network, so had to switch it to Public. If you have done this correctly, you will be able to navigate to "http://[server ip address]:80/iw5/" in a browser on your client machine and see the hosted files.

• To host your mod, navigate to the XAMPP folder on your C drive and look for a folder titled "htdocs" (it may be inside a folder labeled Apache, I can't remember). Your "iw5" directory (containing a "mods" folder and a "usermaps" folder) should live inside this htdocs folder. The files for your mod in your gameserver folder MUST MATCH EXACTLY the ones hosted in this htdocs folder or you will get the same exact "invalid file" error that you would if clients could not connect to the Apache server. This was misleading and sent me down a 10 minute rabbit hole of figuring out WTF happened when I updated the z_svr_bots.iwd file inside the gameserver mods folder without doing the same to the one hosted in htdocs. To diagnose this, check that you can still access the htdocs files on a client machine—if you can still see them on a client but you are getting an "invalid file" error, then the files in htdocs probably do not match those stored elsewhere on the game server.

So in conclusion:

• Yep, it's possible to host your mods and usermaps on the same machine that's functioning as your game server. You can probably also play on this machine simultaneously if it's powerful enough. I don't think this will work for anything other than LAN games unless you can have a URL direct clients to this folder (I'd be wary of doing this anyway).

• The gameserver folder for iw5 just needs a "mods" folder, and for Bot Warfare, the "mods/bots" folder needs to simply contain a copy of z_svr_bots.iwd with all the waypoints for any custom maps you wish to use. This z_svr_bots.iwd must be identical to the one located in XAMPP's htdocs folder.

• Usermaps on your game server only need to exist in the AppData "storage/iw5" on your game server and inside XAMPP's htdocs folder (again, these must be identical or you will get errors).

Hopefully this will help out anyone who has a similar problem in the future. My Mac wants to autocorrect "htdocs" to "hotdogs" and I'm done with that for now, lol. Happy to finally have this working again for LAN games and will have to keep an eye out for solutions to online games with friends.