dvander@311: This is the README file for sourcemm_update_tool. dvander@311: dvander@311: This tool will automatically correct gameinfo.txt when your server gets updated, and Valve's updater overwrites Metamod:Source's changes. This tool is experimental, and is thus a separate download for now. dvander@311: dvander@311: 1. INSTALLATION dvander@311: dvander@311: a. Extract the entire package to your mod folder. The structure should look like: dvander@311: dvander@311: /addons/metamod/bin/sourcemm_update_tool.dll dvander@311: /addons/metamod/bin/sourcemm_update_tool_i486.so dvander@311: /addons/metamod/README.txt dvander@311: /addons/sourcemm_update_tool.vdf dvander@311: /sourcemm_updater.conf dvander@311: dvander@311: b. Open /sourcemm_updater.conf with your favorite text editor. Change the dvander@311: "cstrike" folder to match your mod folder. dvander@311: dvander@311: 2. CONFIGURATION dvander@311: dvander@311: The sourcemm_updater.conf file has two configuration options. dvander@311: dvander@311: mmpath - Set this to the path Metamod:Source is located in. dvander@311: This defaults to addons/metamod/bin dvander@311: restart - Set this to how the server should be restarted when dvander@311: gameinfo.txt is patched. There are three options: dvander@311: dvander@311: quit - Execute "quit" in the console. Currently does not work. dvander@311: never - Do not restart. dvander@311: error - Generate an error message. Because of a bug in SourceDS, dvander@311: this will generate a crash dump on Windows, but the server dvander@311: will successfully quit. dvander@311: dvander@311: 3. USAGE dvander@311: dvander@311: You do not need to do anything to use the updater tool. When your server starts, dvander@311: it silently checks to see if Metamod:Source is loaded. If not, it will make sure dvander@311: gameinfo.txt is correctly set. Then, depending on how it's configured, it will dvander@311: kill the server. Most game server provides have auto-restart functionality on their dvander@311: servers; if not, you will need to manually restart the server. dvander@311: dvander@311: The update tool unloads itself immediately after the server starts, so it will not dvander@311: use any resources, and will not display when you type 'plugin_print'. dvander@311: dvander@311: 4. TROUBLESHOOTING dvander@311: dvander@311: This tool is currently experimental. There are two possible problems. For dvander@311: any issue you encounter, you should post a report here: dvander@311: dvander@311: http://bugs.alliedmods.net/index.php?project=4 dvander@311: dvander@311: a. The updater tool does not patch gameinfo.txt dvander@311: dvander@311: Verify that the tool is loading. You can do this by opening up the dvander@311: sourcemm_update_tool.vdf file and copying its file path. Then, enter dvander@311: the following command in your server console: dvander@311: dvander@311: plugin_load dvander@311: dvander@311: Example: dvander@311: dvander@311: plugin_load cstrike\addons\metamod\bin\sourcemm_update_tool dvander@311: dvander@311: If you get the following reply: dvander@311: dvander@311: Failed to load plugin "cstrike\addons\sourcemm_update_tool" dvander@311: Unable to load plugin "cstrike\addons\sourcemm_update_tool" dvander@311: dvander@311: Then the tool is working, and you should post a bug report. If instead, dvander@311: you get: dvander@311: dvander@311: Unable to load plugin "cstrike\addons\sourcemm_update_tool" dvander@311: Unable to load plugin "cstrike\addons\sourcemm_update_tool" dvander@311: dvander@311: Then the tool is not loading properly, and the path you are trying to use dvander@311: is not correct. dvander@311: dvander@311: b. The server always dies, and you can't start it at all dvander@311: dvander@311: The updater tool is either crashing or not repairing Metamod:Source dvander@311: correctly. First, try changing the 'restart' line in sourcemm_updater.conf dvander@311: to the following line: dvander@311: dvander@311: restart = never dvander@311: dvander@311: If that does not fix the problem, remove the .vdf file so the updater tool dvander@311: will not be loaded. dvander@311: dvander@311: In either case, you should post a bug report containing your mod name and dvander@311: your gameinfo.txt as an attachment. dvander@311: