diff --git a/docs/core-projects/Metamod-R/00-supported-games.md b/docs/core-projects/Metamod-R/00-supported-games.md new file mode 100644 index 0000000..21fd078 --- /dev/null +++ b/docs/core-projects/Metamod-R/00-supported-games.md @@ -0,0 +1,126 @@ +--- +id: metamod-r-supported-games +title: Supported games +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/supported-games +--- + +# Supported games + +Enthusiasts from the community looked at the famous versions of _Metamod_, + +* [metamod (Original)](https://sourceforge.net/projects/metamod/files/Metamod%20Sourcecode/1.20/) ("games.h"), +* [metamod-p](https://github.com/jkivilin/metamod-p/blob/master/metamod/games.h), +* [metamod-p-cmake](https://github.com/SamVanheer/Metamod-P-CMake/blob/master/metamod/games.h) (just Fork, optimized for c-make build) +* [metamod-am\metamod-hl1](https://github.com/alliedmodders/metamod-hl1/blob/master/metamod/games.h) from [alliedmodders](https://github.com/alliedmodders/). +made clear and actual list of mods,checked (**`briefly*`**) performance and added support "out-of-the-box" of these games in **[Metamod-r](https://github.com/rehlds/metamod-r)**. + +## Supported games +:heavy_check_mark: - Supported :x: - Unsupported :interrobang: - Partially supported, but still have probolems :star: - Tested by community + +| Game \ Mod | ![](https://i.imgur.com/t23p9tU.png) | ![](https://i.imgur.com/AzhAYR4.png) | Note +| ------------- | ------| ------|------| +| [Action Half-Life](http://www.moddb.com/mods/action-half-life/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [Adrenaline Gamer](https://github.com/martinwebrant/agmod) | :heavy_check_mark: | :heavy_check_mark: | +| [Azure Sheep](http://www.moddb.com/mods/azure-sheep/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Base Defense](http://www.moddb.com/mods/b-def/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [Brain Bread](http://www.moddb.com/mods/brainbread/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Brutal Half-Life](http://www.moddb.com/mods/brutal-half-life/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Bumper Cars](http://www.moddb.com/mods/bumper-cars/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [BuzzyBots](http://www.moddb.com/mods/buzzybots/downloads) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Chicken Fortress 3](http://www.moddb.com/mods/chicken-fortress-3/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Counter-Strike 1.0](http://www.moddb.com/mods/counter-strike/downloads/counter-strike-10-for-steam) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Counter-Strike 1.5](http://www.moddb.com/mods/counter-strike/downloads/counter-strike-15-for-steam) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Counter-Strike 1.6](http://store.steampowered.com/app/10/CounterStrike/) :star: | :heavy_check_mark: | :heavy_check_mark: | +| [Counter-Strike:Condition Zero](http://store.steampowered.com/app/80/CounterStrike_Condition_Zero/) | :heavy_check_mark: | :heavy_check_mark: +| [Counter-Strike:Condition Zero Deleted Scenes](http://store.steampowered.com/app/80/CounterStrike_Condition_Zero/) | :heavy_check_mark: | :heavy_check_mark: | Single-user mod based on multiplayer. +| [Day of Defeat](http://store.steampowered.com/app/30/Day_of_Defeat/) | :heavy_check_mark: | :heavy_check_mark: +| [Deathmatch Classic](http://store.steampowered.com/app/40/Deathmatch_Classic/) | :heavy_check_mark: | :heavy_check_mark: +| [Desert Crisis](http://www.moddb.com/mods/desert-crisis/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Digital Paintball](http://www.moddb.com/mods/digital-paintball/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Earth's Special Forces](http://www.moddb.com/mods/earths-special-forces/downloads/) :star: | :heavy_check_mark: | :heavy_check_mark: | +| [Existence](http://www.moddb.com/mods/existence/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Firearms](http://www.moddb.com/mods/firearms/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Frontline Force](http://www.moddb.com/mods/front-line-force/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Gangsta Wars](http://www.moddb.com/mods/gangsta-wars/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Gangwars](http://www.moddb.com/mods/gangwars/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Global Warfare](http://www.moddb.com/mods/global-warfare/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Goldeneye](http://www.moddb.com/mods/goldeneye-mod/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Gunman Chronicles](http://www.moddb.com/games/gunman-chronicles/downloads/gunman-chronicles-steam-version/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [HL-Rally](http://www.moddb.com/mods/hl-rally/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [Half-Life](http://store.steampowered.com/app/70/HalfLife/) :star: | :heavy_check_mark: | :heavy_check_mark: | Alternative client [Bugfixed and improved HL release](https://github.com/LevShisterov/BugfixedHL) :star: . +| [Half-Life 1.5: Weapon Edition](http://www.moddb.com/mods/half-life-weapon-edition/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Half-Life: Blue Shift](http://store.steampowered.com/app/130/HalfLife_Blue_Shift/) | :heavy_check_mark: | :heavy_check_mark: | Single-user mod based on multiplayer. +| [Half-Life: Decay](http://www.moddb.com/mods/half-life-decay/downloads/) :star:| :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Headcrab Frenzy](http://www.moddb.com/mods/headcrab-frenzy/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [Holy Wars](http://www.moddb.com/mods/holy-wars/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Hostile Intent](http://www.moddb.com/mods/hostile-intent/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [International Online Soccer](http://www.moddb.com/mods/international-online-soccer/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Judgement](http://www.moddb.com/mods/judgement/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Kanonball](http://www.moddb.com/mods/kanonball/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Master Sword](http://www.moddb.com/mods/master-sword/downloads/) [Continued](http://www.moddb.com/mods/master-sword-continued-111/downloads) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Monkeystrike](http://www.moddb.com/mods/monkeystrike/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Morbid Inclination](http://www.moddb.com/mods/morbid-inclination/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Move In!](http://www.moddb.com/mods/move-in/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Natural Selection](https://unknownworlds.com/ns/) :star:| :heavy_check_mark: | :heavy_check_mark: | Also `Beta`-version. +| [Open-Source Jailbreak](http://www.moddb.com/mods/open-source-jailbreak/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [openAG](https://github.com/YaLTeR/OpenAG) | :heavy_check_mark: | :heavy_check_mark: | Alternative open-source client for `Adrenaline Gamer` mod. +| [Operations 1942](http://www.moddb.com/mods/operations-1942/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Opposing Force](http://store.steampowered.com/app/50/HalfLife_Opposing_Force/) | :heavy_check_mark: | :heavy_check_mark: +| [Out Break](http://www.moddb.com/mods/outbreak-half-life/downloads/) | :heavy_check_mark: | :x: | There are no executable files for Linux. +| [Outlawsmod](http://www.moddb.com/mods/outlaws/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Over Ground](http://www.moddb.com/mods/over-ground/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Oz Deathmatch](http://ozdeathmatch.com/) | :heavy_check_mark: | :heavy_check_mark: +| [Paintball](http://www.bloodvayne.com/hlpb/downloads.htm) | :heavy_check_mark: | :heavy_check_mark: +| [Pirates, Vikings and Knights](http://www.moddb.com/mods/pirates-vikings-and-knights/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Point of No Return](http://www.moddb.com/mods/point-of-no-return/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Project Timeless](http://www.moddb.com/mods/project-timeless/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Public Enemy](http://www.moddb.com/mods/public-enemy/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Resident Evil : Cold Blood](http://www.moddb.com/mods/resident-evil-cold-blood/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Ricochet](http://store.steampowered.com/app/60/Ricochet/) :star:| :heavy_check_mark: | :heavy_check_mark: +| [Rival Species](http://www.rivalspecies.com/files.php) | :heavy_check_mark: | :heavy_check_mark: +| [Rocket Crowbar](http://hldm.org/files/mods/287-rocket-crowbar.html) | :heavy_check_mark: | :heavy_check_mark: +| [Rocket Crowbar 2](http://www.moddb.com/mods/rocket-crowbar-2/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Science & Industry](http://www.moddb.com/mods/science-and-industry/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Scientist Hunt](http://www.moddb.com/mods/scientist-hunt/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Snow-War](http://www.moddb.com/mods/snow-war/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [StargateTC](http://www.moddb.com/mods/stargatetc/downloads/) :star:| :heavy_check_mark: | :heavy_check_mark: | All versions: `1.x` и `2.x`. +| [Sven Coop](http://store.steampowered.com/app/225840/Sven_Coop/) :star: | :interrobang: | :interrobang: | **Warning!** `legacy` versions and old `steam 5.x` users have the problems [#1](https://github.com/theAsmodai/metamod-r/issues/17#issuecomment-362253473), [#2](https://github.com/theAsmodai/metamod-r/issues/29). _**Problem resolved**_ at `steam` version [#3](https://github.com/theAsmodai/metamod-r/issues/45) by developers since [Build 3082297](https://forums.svencoop.com/showthread.php/45308-Sven-Co-op-Update-Released-Build-3082297). +| [Swarm](http://www.moddb.com/mods/swarm/downloads) | :heavy_check_mark: | :heavy_check_mark: | +| [Team Fortress Classic](http://store.steampowered.com/app/20/Team_Fortress_Classic/) | :heavy_check_mark: | :heavy_check_mark: +| [The Battle Grounds](http://www.moddb.com/mods/battle-grounds/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [The Ship](http://www.moddb.com/mods/the-ship) | :heavy_check_mark: | :heavy_check_mark: | +| [The Specialists](http://www.moddb.com/mods/the-specialists/downloads/) :star: | :heavy_check_mark: | :heavy_check_mark: | +| [The Trenches](http://www.moddb.com/mods/the-trenches-half-life/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [The Wastes](http://www.moddb.com/mods/the-wastes/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Tour of Duty](http://www.moddb.com/mods/tour-of-duty/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Train Hunters](http://www.moddb.com/games/half-life/addons?filter=t&kw=Train+Hunters&category=&licence=&timeframe=) | :heavy_check_mark: | :heavy_check_mark: +| [Underworld Bloodline](http://www.moddb.com/mods/underworld-bloodline/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [VampireSlayer](http://www.moddb.com/mods/vampire-slayer/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Wanted!](http://www.moddb.com/mods/wanted-the-western-mod-steam/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Wizard Wars](http://www.moddb.com/mods/wizard-wars/downloads/) | :heavy_check_mark: | :heavy_check_mark: | Also`Beta`-version. +| [WormsHL](http://www.moddb.com/mods/wormshl/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Zombie Panic](http://www.moddb.com/mods/zombie-panic/downloads/) | :heavy_check_mark: | :heavy_check_mark: + +* _mods, exept `Counter-Strike 1.6`, `Half-Life 1` and the others marked :star: - tested only for successful launch in the [ReHLDS](https://github.com/dreamstalker/ReHLDS) + [Metamod-r](https://github.com/theAsmodai/metamod-r) environment. There were no Intensive checks. The compatibility chart is "advance". Nowadays there is a more deep testing and we try to identify all the problems with mods._ + + +*** + +## Known Issues + +### SvenCoop + +#### "Precache limit - 512" +![image](https://user-images.githubusercontent.com/34998786/37242681-89c5da6a-24a8-11e8-8ef2-97188b70a6f3.png) + +The game has a modified limit for preloading objects in the engine and client. Since metamod-r requires rehlds, the server-side limit is changed to the standard 512 objects. As a consequence, the mod doesn't run on cards that go beyond the limit (co-op mode on single-player maps). But at the same time, the standard network cards, such as `crossfire` work fine. (_It is not a bug of [metamod-r #29](https://github.com/theAsmodai/metamod-r/issues/29) or [rehlds #591](https://github.com/dreamstalker/rehlds/issues/591), but affects it_). + +##### How to fix: +* Try to update `steam`-version to [Build 3082297](https://forums.svencoop.com/showthread.php/45308-Sven-Co-op-Update-Released-Build-3082297) of svencoop. + +> Restored API/ABI compatibility with vanilla GoldSrc/Metamod-P. The custom Sven Co-op Metamod-P build is no longer necessary (and in fact won't work anymore). + +##### Workarounds: +* Try to use ![](https://i.imgur.com/AzhAYR4.png) [metamod_unprecacher](https://github.com/In-line/metamod_unprecacher) or something similar to block unused resources. `not tested` +* Try to build a custom rehlds-assembly with an increased limit that is used in svencoop. `not tested` diff --git a/docs/core-projects/Metamod-R/01-installing.md b/docs/core-projects/Metamod-R/01-installing.md new file mode 100644 index 0000000..6a231a5 --- /dev/null +++ b/docs/core-projects/Metamod-R/01-installing.md @@ -0,0 +1,57 @@ +--- +id: metamod-r-install +title: Installation +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/install +--- + +# Installing + +Check out [list of supported games](/docs/metamod-r/supported-games) and make sure that there is your game in the list. _Don't be upset if it's not. After installation you can check the performance of **Metamod-r** with your `unsupported` mod after fine tuning by this [article](/docs/metamod-r/settings). There is a possibility that the game will start._ + +# Compatibility + +**Metamod-r is incompatible with original `HLDS`. It's necessary to have installed [ReHLDS](https://github.com/rehlds/ReHLDS) (`API 3.1+`). There is no guarantee that the product will work in a different environment.** + +| HLDS| [ReHLDS](https://github.com/rehlds/ReHLDS)| OS +|---------| -------| -------| +| :x: | `API 3.1+` | ![](https://i.imgur.com/AzhAYR4.png) ![](https://i.imgur.com/t23p9tU.png) | + +# Installing on the game server +* Download the latest version of _**Metamod-r**_ [![Download](https://camo.githubusercontent.com/2b15ec2fc402e02b66fde9eab7e896406caeddac/687474703a2f2f7265686c64732e6f72672f76657273696f6e2f6d6574616d6f642d2d722e737667)](http://teamcity.rehlds.org/guestAuth/downloadArtifacts.html?buildTypeId=Metamod_Publish&buildId=lastSuccessful) into any convenient place. +* Unzip the folder _**addons**_ into your mod folder from the downloaded zip archive.![](https://i.imgur.com/ptx3MZx.png) +_In case of any problem with determining the name of the directory, please refer to the summary table, which is represented by **[here](/docs/metamod-r/troubbleshouting)**._ +* Find the `liblist.gam` file in the mod folder, make a backup copy of it (if you want) and open the file with any convenient text editor. +* Find in the `liblist.gam` file strings containing `gamedll` and `gamedll_linux`. _For example, `Half-Life 1` 1 would look like this:_ +``` +gamedll "dlls\hl.dll" +gamedll_linux "dlls/hl.so" +``` +_as for `Counter-Strike 1.6`:_ + +``` +gamedll "dlls\mp.dll" +gamedll_linux "dlls/cs.so" +``` +* In the desired line replace the contents of the path to metamod-r: + +_For Windows versions of your server:_ +``` +gamedll "addons\metamod\metamod.dll" +``` +_For Linux-versions of your server:_ +``` +gamedll_linux "addons/metamod/metamod_i386.so" +``` +* Save the changes to `liblist.gam` file. +* Installation **Metamod-r** is completed. + +# Check + +After a successful installation of **Metamod-r** you can check the performance by running the game server. + +**Metamod-r** works: +![](https://i.imgur.com/VScngBr.png) +If it doesn't, +![](https://i.imgur.com/HPKRiBF.png) +contact [the Troubleshooting guide](/docs/metamod-r/troubbleshouting). diff --git a/docs/core-projects/Metamod-R/02-settings.md b/docs/core-projects/Metamod-R/02-settings.md new file mode 100644 index 0000000..6e04f43 --- /dev/null +++ b/docs/core-projects/Metamod-R/02-settings.md @@ -0,0 +1,109 @@ +--- +id: metamod-r-settings +title: Settings +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/settings +--- + +# Settings + +## Connection of the plugins in plugins.ini +As example we will use a mythical plugin `metaPlugin`. Installation of other plugins is similar. + +* Create the `plugins.ini` file in the `addons\metamod`folder (in case of absence of this file) +* Create a folder for the new plugin in the `addons` folder._For example, **meta Plugin** folder._ +* * Put your plugin `metaPlugin.dll` (or `meta Plugin.so`) to the created folder `addons\metamod\metaplugins`. +* Open the `plugins.ini` file from the `metamod` folder with any text editor. +* * To connect the plugin `metaPlugin.dll`(or `meta Plugin.so`) write the following lines to the `plugins file.ini`: + +_For Windows versions of your server:_ +``` +win32 addons\metaPlugin\metaPlugin.dll +``` +_For Linux versions of your server:_ +``` +linux addons/metaPlugin/metaPlugin.so +``` +* Save your file `plugins.ini` and launch the server. +* The installation is **completed**. + +_You can check plugin performance via `meta list` command in the server console ._ +![](https://i.imgur.com/1fVXBzc.png) + +in case of negative result, +![](https://i.imgur.com/nGXAokG.png) +apply to [Troubbleshouting](https://github.com/theAsmodai/metamod-r/wiki/Troubbleshouting). + +# List of console commands +Write command with `meta` word. _For example, `meta version`_. + +``` + version - information of metamod version + list - list of uploaded plugins + game - information about gamedll (list of registered msg, id and size) + cmds - list of console commands, added from third-party plugins + cvars - cvar list, added from third-party plugins + refresh - reloading of metamod-r + config - configuration from config.ini + load - find and upload plugin on specified path + unload - upload the plugin + reload - reload the plugin + info - information about the plugin + pause - pause the plugin + unpause - resume the operation of all installed plugins + retry - retry download of a failed plugins + clear - upload failed plugins from the memory + force_unload - forced unloading of plugin + require - turn off the server if the specified plugin doesn't work +``` + +### debuglevel + +| **var** | debuglevel +| :----- | -----: +| **type** | int +| **contains** | from 0 to 42 +| **default** | 0 +| **overridden** | `+localinfo mm_debug <число>` +| **example** | `debuglevel 0` +| **description** | Sets the initial debugging level for metamod (same as cvar "meta_debug"). Where `` is an integer, 0 and up. Default is normally 0. If hlds is run with "-dev", default is 3. + +### gamedll +| **var** | gamedll +| :----- | -----: +| **type** | string +| **contains** | `` +| **default** | null +| **overridden** | `+localinfo mm_gamedll <путь>` +| **example** | `gamedll dlls/hl.dll`, `gamedll ../podbot/podbot.dll`, `gamedll /home/bots/dlls/mybot.dll` +| **description** | Overrides the auto-detected gamedll, in particular for bots. Where `` is an absolute path, or a path relative to the gamedir. Default is empty, with gamedll being auto-recognized based on the gamedir. + +### exec_cfg +| **var** | exec_cfg +| :----- | -----: +| **Тип** | string +| **type** | `` +| **default** | `addons/metamod/exec.cfg` +| **overridden** | `+localinfo mm_execcfg <файл>` +| **example** | `exec_cfg configs/debugging.cfg`, `exec_cfg ../clan/match.cfg` +| **description** | Overrides the default filename containing hlds commands to run just after loading Metamod. Where `` is a path relative to the gamedir. Note! This CANNOT be an absolute path, as hlds will not "exec" absolute pathnames. + +### clientmeta +| **var** | clientmeta +| :----- | -----: +| **type** | bool +| **contains** | `` +| **default** | `yes` +| **overridden** | `+localinfo mm_clientmeta ` +| **example** | `clientmeta yes`, `clientmeta no` +| **description** | Setting to disable or enable Metamod's client commands ('meta list' and 'meta version'). Extra setting for "Metamod+All-Mod-Support Patch". + +### dynalign_list +| **var** | clientmeta +| :----- | -----: +| **type** | bool +| **contains** | `` +| **default** | `no` +| **overridden** | +| **example** | `dynalign_list yes`, `dynalign_list no` +| **description** | Setting to disable or enable plugins list dynamic alignment into output. **NOTE**: This option affect's on incorrect parse from HLSW on Tab `Metamod Plugins`. diff --git a/docs/core-projects/Metamod-R/03-troubleshuting.md b/docs/core-projects/Metamod-R/03-troubleshuting.md new file mode 100644 index 0000000..4723afa --- /dev/null +++ b/docs/core-projects/Metamod-R/03-troubleshuting.md @@ -0,0 +1,247 @@ +--- +id: metamod-r-troubbleshouting +title: Troubbleshouting +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/troubbleshouting +--- + +# Troubbleshouting + +## How to report about the problem correctly: + +If you want to make an offer, register a mistake, your fail or you need "live" help and assistance-you can always apply [here](https://github.com/theAsmodai/metamod-r/issues). Just press the green `New issue` button and fill out the form. + +Developers will be grateful if the description of the problem be as much detail as possible: +* The version of your operating system; + The version (build number) HLDS server (either [ReHLDS](https://github.com/dreamstalker/ReHLDS)); +* The version of your game (or mod); +* Metamod-r version (build number or build date) ; + - You can optionally specify a list of modules (by typing `meta list` in the server console). +* Attach the logs; +* Apply crashdumps; + +This will help for a more thorough analysis and possibly correction of your problems in the future. + +*** + + +## Получение дампов падения HLDS\reHLDS + +![](https://i.imgur.com/vqDiJ67.png) [Main source (rus)](https://aghl.ru/forum/viewtopic.php?f=10&t=1441). +![](https://i.imgur.com/vqDiJ67.png) [Mirror (rus)](https://dev-cs.ru/threads/1532/). + + **Не стоит просто так выкладывать дампы в интернете, так как зачастую в них содержится полная информация о сервере, включая rcon и прочее. Для передачи можно архивировать их с паролем, что полезно ещё тем, что жмутся они весьма хорошо.** + +### ![](https://i.imgur.com/t23p9tU.png) Windows + +#### С использованием WER (Windows Error Reporting): +* Разрешить WER (отчеты об ошибках): + - До Vista: + - Запустить drwtsn32.exe и выбрать "Full" напротив Crash Dump File. Тут же можно увидеть (или настроить) куда будут складываться дампы. + - На Vista и выше: + - Редактирование реестра, удобный способ от [s1lent](https://github.com/s1lentq): +> +> #### Развернутый и быстрый способ настроить реестр на получение дампов для новичков. +> +> * Настройки: +> - **NAME_APP** - `hlds.exe` +> - имя приложения, которому нужно будет создавать дампы в случае аварийного завершения. +> - **REG_LINK** - `HKLM\Software\Microsoft\Windows\Windows Error Reporting` +> - путь до раздела Windows Error Reporting (Эту настройку скорее всего менять не нужно, думаю во всех Windows пути одинаковые) +> - **DumpType** - `2` +> - `0` - Обычный дамп +> - `1` - Минимальный дамп +> - `2` - Полный дамп +> - DumpCount - `15` +> - количество создаваемых дампов, если в папке количество дампов будет больше указанного значения, то будет удаляться старый дамп для создания нового дампа. +> - **DumpFolder** - `C:\CrashDumps` +> - путь до папки, куда будут складываться дампы. +> - (во избежании всяких проблем не используйте пробелы или кириллицу в путях) +> * Установка: +> - Скачать архив и разархивировать. +> - Запустить add_RegistryDumps.bat +> +> - После записи в реестр вы должны убедиться что у вас включена служба Отчеты об ошибках Windows. +> - Дальше нажать горячую клавишу Windows + R (Windows кнопка находится между ctrl и alt) или можно вызвать cmd.exe или Пуск - Выполнить, сразу после этого нужно ввести gpedit.msc, далее см. скриншот. +> +> `Конфигурация компьютера -> Административные шаблоны -> Компоненты Windows -> Отчеты об ошибок Windows` +> +> ![](https://i.imgur.com/PLQ8mf3.jpg) +> +> * ![](https://i.imgur.com/vqDiJ67.png) [add_RegistryDumps.zip](http://aghl.ru/forum/download/file.php?id=3071) \ ![](https://i.imgur.com/Uy97ydR.png) mirror for ["add_RegistryDumps.zip"](https://github.com/EpicMorgGames/LegacyMods/raw/master/AGHL.ru/add_RegistryDumps.zip) +> * ![](https://i.imgur.com/vqDiJ67.png) [remove_RegistryDumps.zip](http://aghl.ru/forum/download/file.php?id=3536) \ ![](https://i.imgur.com/Uy97ydR.png) mirror for ["remove_RegistryDumps.zip"](https://github.com/EpicMorgGames/LegacyMods/raw/master/AGHL.ru/remove_RegistryDumps.zip) +> + +#### С использованием утилиты userdumps +* Инструкция от _unKn0wn_: + +> +> Способ получения дампов посредством утилиты от MicroSoft: ![](https://i.imgur.com/vqDiJ67.png) [UserModeProcessDumper](http://www.microsoft.com/en-us/download/details.aspx?id=4060) \ ![](https://i.imgur.com/Uy97ydR.png) mirror for ["UserModeProcessDumper8_1_2929_5.zip"](https://github.com/EpicMorgGames/LegacyMods/raw/master/AGHL.ru/UserModeProcessDumper8_1_2929_5.zip). +> +> Спасибо [Lev](https://github.com/LevShisterov) за настройки. +> +> ##### 1. Инсталяция +> Архив который вы скачали разархивируем (по умолчанию C:\kktools\userdump8.1). +> - Запустите файл setup.exe из каталога: +> - Если вы используете 32-битную ОС Windows XP/2003, то C:\kktools\userdump8.1\x86. +> - Если вы используете 64-битную ОС Windows XP/2003, то C:\kktools\userdump8.1\x64. +> - В окне Мастера установки нажмите на кнопку Далее. +> - (Только для 32-битных ОС) В окне Terminate Mode выберите Disable "Dump on Process Termination" feature и нажмите на кнопку Далее. +> +> ![](https://i.imgur.com/NgjxfPa.png) +> +> - Нажмите на кнопку Готово и дождитесь завершения установки. +> В окне User Mode Process Dump Setup нажмите на кнопку ДА (Если по каким-то причинам вы не знаете как зайти в меню с настройками userdump -вы их всегда сможете найти в Панель управления - Process Dumper). +> +> ##### 2. Добавление приложения +> В открывшемся окне Свойства: User Mode Process Dumper Setup жмём New и добавляем имя нужной нам программы на пример: hlds.exe (расширение -обязательно!) и жмём ОК +> +> ![](https://i.imgur.com/36m9qL1.jpg) +> +> ##### 3. Настройки +> В окне Свойства: User Mode Process Dumper Setup находим созданное только-что правило приложения, выделяем его и жмём кнопку Rules +> В открывшемся окне Process Monitoring Ruless for hlds.exe +> 1. Выберем Use custom rules. +> 2. Если требуется меняем папку для хранения созданных дампов. +> 3. В Exeption Codes выделяем (нажатием ЛКМ) следующие коды: "Access Violation, Overflow, Illegal Instruction, Stack oveflow." +> 4. Выставляем параметр Save Mode в режим Cyclic saving (5 times). +> Должно получится примерно так: +> +> ![](https://i.imgur.com/sio3Aac.jpg) +> +> PS: Рекомендую использовать совместно с Dr Watson с типом дампов "Краткий", т.к. доктор умеет вести логи в текстовом формате, которые дадут возможность отбирать нужные дампы. А userdump будет делать полные дампы. +> + +### ![](https://i.imgur.com/AzhAYR4.png) Linux + +Сервер надо запускать с ключем **-debug**. + +Если в системе установлен gdb, то автоматически в файле `debug.log` будет записываться внятная информация об ошибке. Так что рекомендуется его поставить (команда зависит от используемой системы, на Debian\Ubuntu - это `apt install gdb`). Хотя для создания дампов это не требуется, это фактически обязательно надо сделать при наличии возможности, так как в `debug.log` при этом будет записано место падения, что позволит сразу что-то сказать об ошибке. Получение этой же информации на другой системе из дамп-файла потребует наличия всех бинарников от сервера. + +По умолчанию дамп-файл называется `core`, записывается в рабочей папке, и, соответственно, будет перезаписываться. Во избежание, можно добавлять к имени идентификатор процесса: + +`echo 1 > /proc/sys/kernel/core_uses_pid` + +или складывать дампы в `/tmp`: + +`echo /tmp/%e-%t-%p-%c.dmp > /proc/sys/kernel/core_pattern` Больше информации ![](https://i.imgur.com/vqDiJ67.png)[тут](http://man7.org/linux/man-pages/man5/core.5.html). + +Запуск без `sudo` (под root, иначе общие настройки системы должны быть выставлены на unlimited): + +`ulimit -c unlimited && ./hlds_run -debug ...` + +Запуск с `sudo` (под пользователем hlds): + +`ulimit -Hc unlimited && sudo -u hlds sh -c "ulimit -Sc unlimited && ./hlds_run -debug ..."` + +Проверка запуска из под sudo: + +`ulimit -Hc unlimited && sudo -u hlds sh -c "ulimit -Sc unlimited && whoami && ulimit -Sc && ./hlds_run -debug ..."` + +выводит имя пользователя под которым произойдет запуск и лимит на создание дампов, после чего запускает сервер. + +Для тестирования настроек создания дампов можете использовать специально разработанный модуль: ![](https://i.imgur.com/vqDiJ67.png) [FixItAll](http://aghl.ru/forum/viewtopic.php?f=19&t=1680&p=19549) \ ![](https://i.imgur.com/Uy97ydR.png) [FixItAll mirror](https://github.com/EpicMorgGames/LegacyMods/raw/master/AGHL.ru/fixitall_mm.0.0.zip) or ![](https://i.imgur.com/Uy97ydR.png) [Crash.sma*](https://github.com/EpicMorgGames/LegacyMods/blob/master/AGHL.ru/Crash.sma). + +* crash.sma - https://github.com/theAsmodai/metamod-r/issues/42#issuecomment-416456526 + +*** + +### Summary table: + +`Folder` - the directory of your mod or game. In columns ![](https://i.imgur.com/t23p9tU.png) and ![](https://i.imgur.com/AzhAYR4.png) the names of the executable files from the folder 'dlls`, which is located in the directory`your mod or game'. + +:x: - platform version does not exist + +| Game \ Mod | Folder | ![](https://i.imgur.com/t23p9tU.png) | ![](https://i.imgur.com/AzhAYR4.png) +| ------------- | ------| ------|------| +| [Action Half-Life](http://www.moddb.com/mods/action-half-life/downloads/) | action | ahl.dll | ahl.so +| [Adrenaline Gamer](https://github.com/martinwebrant/agmod) | ag | ag.dll | ag.so +| [openAG](https://github.com/YaLTeR/OpenAG) | ag | ag.dll | ag.so +| [Azure Sheep](http://www.moddb.com/mods/azure-sheep/downloads/) | asheep | hl.dll | :x: +| [Base Defense](http://www.moddb.com/mods/b-def/downloads/) | bdef | server.dll | server.so +| [The Battle Grounds](http://www.moddb.com/mods/battle-grounds/downloads/) | bg | bg.dll | bg.so +| [Brutal Half-Life](http://www.moddb.com/mods/brutal-half-life/downloads/) | bhl | bhl.dll | :x: +| [Brain Bread](http://www.moddb.com/mods/brainbread/downloads/) | brainbread | bb.dll | :x: +| [Half-Life: Blue Shift](http://store.steampowered.com/app/130/HalfLife_Blue_Shift/) | bshift | hl.dll | bshift.so +| [Bumper Cars](http://www.moddb.com/mods/bumper-cars/downloads/) | bumpercars | hl.dll | :x: +| [BuzzyBots](http://www.moddb.com/mods/buzzybots/downloads) | buzzybots | bb.dll | :x: +| [Chicken Fortress 3](http://www.moddb.com/mods/chicken-fortress-3/downloads/) | ckf3 | mp.dll | :x: +| [Counter-Strike 1.0](http://www.moddb.com/mods/counter-strike/downloads/counter-strike-10-for-steam) | cs10 | mp.dll | :x: +| [Counter-Strike 1.5](http://www.moddb.com/mods/counter-strike/downloads/counter-strike-15-for-steam) | csv15 | mp.dll | :x: +| [Counter-Strike 1.6](http://store.steampowered.com/app/10/CounterStrike/) | cstrike | mp.dll | cs.so +| [Counter-Strike:Condition Zero](http://store.steampowered.com/app/80/CounterStrike_Condition_Zero/) | czero | mp.dll | cs.so +| [Counter-Strike:Condition Zero Deleted Scenes](http://store.steampowered.com/app/80/CounterStrike_Condition_Zero/) | czeror | cz.dll | cz.so +| [Desert Crisis](http://www.moddb.com/mods/desert-crisis/downloads/) | dcrisis | dc.dll | dc.so +| [Half-Life: Decay](http://www.moddb.com/mods/half-life-decay/downloads/) | decay | decay.dll | :x: +| [Deathmatch Classic](http://store.steampowered.com/app/40/Deathmatch_Classic/) | dmc | dmc.dll | dmc.so +| [Day of Defeat](http://store.steampowered.com/app/30/Day_of_Defeat/) | dod | dod.dll | dod.so +| [Digital Paintball](http://www.moddb.com/mods/digital-paintball/downloads/) | dpb | pb.dll | pb.i386.so +| [Earth's Special Forces (Old)](http://www.moddb.com/mods/earths-special-forces/downloads/) | esf | hl.dll | hl.so (лежит не в `dlls` каталоге, а в `linuxdll`) +| [Earth's Special Forces](http://www.moddb.com/mods/earths-special-forces/downloads/) | esf | hl.dll | hl.so +| [Existence](http://www.moddb.com/mods/existence/downloads/) | existence | existence.dll | :x: +| [Firearms](http://www.moddb.com/mods/firearms/downloads/) | firearms | firearms.dll | :x: +| [Frontline Force](http://www.moddb.com/mods/front-line-force/downloads/) | frontline | frontline.dll | front.so +| [Gangsta Wars](http://www.moddb.com/mods/gangsta-wars/downloads/) | gangstawars | gwars27.dll | :x: +| [Gangwars](http://www.moddb.com/mods/gangwars/downloads/) | gangwars | mp.dll | :x: +| [Opposing Force](http://store.steampowered.com/app/50/HalfLife_Opposing_Force/) | gearbox | opfor.dll | opfor.so +| [Global Warfare](http://www.moddb.com/mods/global-warfare/downloads/) | globalwarfare | mp.dll | gw.so +| [Goldeneye](http://www.moddb.com/mods/goldeneye-mod/downloads/) | goldeneye | mp.dll | :x: +| [Headcrab Frenzy](http://www.moddb.com/mods/headcrab-frenzy/downloads/) | hcfrenzy | hcfrenzy.dll | hcfrenzy.so +| [Half-Life 1.5: Weapon Edition](http://www.moddb.com/mods/half-life-weapon-edition/downloads/) | hl15we | hl.dll | hl.so +| [HL-Rally](http://www.moddb.com/mods/hl-rally/downloads/) | hlrally | hlrally.dll | hlr.so +| [Holy Wars](http://www.moddb.com/mods/holy-wars/downloads/) | holywars | holywars.dll | hl.so +| [Hostile Intent](http://www.moddb.com/mods/hostile-intent/downloads/) | hostileintent | hl.dll | hl.so +| [International Online Soccer](http://www.moddb.com/mods/international-online-soccer/downloads/) | ios | ios.dll | ios.so +| [Judgement](http://www.moddb.com/mods/judgement/downloads/) | judgedm | mp.dll | judge.so +| [Kanonball](http://www.moddb.com/mods/kanonball/downloads/) | kanonball | kanonball.dll | hl.so +| [Monkeystrike](http://www.moddb.com/mods/monkeystrike/downloads/) | monkeystrike | monkey.dll | ms.so +| [Morbid Inclination](http://www.moddb.com/mods/morbid-inclination/downloads/) | MorbidPR | morbid.dll | morbid.so +| [Move In!](http://www.moddb.com/mods/move-in/downloads/) | movein | hl.dll | hl.so +| [Master Sword](http://www.moddb.com/mods/master-sword/downloads/) [Continued](http://www.moddb.com/mods/master-sword-continued-111/downloads) | msc | ms.dll | :x: +| [Natural Selection](https://unknownworlds.com/ns/) | ns | ns.dll | ns.so +| [Natural Selection Beta](https://unknownworlds.com/ns/) | nsp | ns.dll | ns.so +| [Over Ground](http://www.moddb.com/mods/over-ground/downloads/) | og | og.dll | og.so +| [Outlawsmod](http://www.moddb.com/mods/outlaws/downloads/) | ol | hl.dll | ol.so +| [Operations 1942](http://www.moddb.com/mods/operations-1942/downloads/) | ops1942 | spirit.dll | spirit.so +| [Open-Source Jailbreak](http://www.moddb.com/mods/open-source-jailbreak/downloads/) | osjb | jail.dll | osjb.so +| [Out Break](http://www.moddb.com/mods/outbreak-half-life/downloads/) | outbreak | hl.dll | :x: +| [Oz Deathmatch](http://ozdeathmatch.com/) | oz | mp.dll | mp.so +| [Paintball](http://www.bloodvayne.com/hlpb/downloads.htm) | paintball | mp.dll | pb.so +| [Public Enemy](http://www.moddb.com/mods/public-enemy/downloads/) | penemy | pe.dll | pe.so +| [Point of No Return](http://www.moddb.com/mods/point-of-no-return/downloads/) | ponreturn | mp.dll | ponr.so +| [Pirates, Vikings and Knights](http://www.moddb.com/mods/pirates-vikings-and-knights/downloads/) | pvk | hl.dll | hl.so +| [Rocket Crowbar 2](http://www.moddb.com/mods/rocket-crowbar-2/downloads/) | rc2 | rc2.dll | rc2.so +| [Resident Evil : Cold Blood](http://www.moddb.com/mods/resident-evil-cold-blood/downloads/) | recbb2 | recb.dll | recb.so +| [Gunman Chronicles](http://www.moddb.com/games/gunman-chronicles/downloads/gunman-chronicles-steam-version/) | rewolf | gunman.dll | :x: +| [Ricochet](http://store.steampowered.com/app/60/Ricochet/) | ricochet | mp.dll | ricochet.so +| [Rocket Crowbar](http://hldm.org/files/mods/287-rocket-crowbar.html) | rockcrowbar | rc.dll | rc.so +| [Rival Species](http://www.rivalspecies.com/files.php) | rspecies | hl.dll | hl.so +| [Scientist Hunt](http://www.moddb.com/mods/scientist-hunt/downloads/) | scihunt | shunt.dll | shunt.so +| [The Ship](http://www.moddb.com/mods/the-ship) | ship | ship.dll | ship.so +| [Science & Industry](http://www.moddb.com/mods/science-and-industry/downloads/) | si | si.dll | si.so +| [Snow-War](http://www.moddb.com/mods/snow-war/downloads/) | snow | snow.dll | snow.so +| [StargateTC (Old, 1.x)](http://www.moddb.com/mods/stargatetc/downloads/) | stargatetc | hl.dll | hl.so +| [StargateTC (Updated, 2.x)](http://www.moddb.com/mods/stargatetc/downloads/) | stargatetc | hl.dll | stc.so +| [StargateTC (Updated, 2.x)](http://www.moddb.com/mods/stargatetc/downloads/) | stargatetc | hl.dll | stc_i386_opt.so +| [Sven Coop (Old)](http://store.steampowered.com/app/225840/Sven_Coop/) | svencoop | hl.dll | hl.so +| [Sven Coop (Steam)](http://store.steampowered.com/app/225840/Sven_Coop/) | svencoop | server.dll | server.so +| [Swarm](http://www.moddb.com/mods/swarm/downloads) | swarm | swarm.dll | swarm.so +| [Team Fortress Classic](http://store.steampowered.com/app/20/Team_Fortress_Classic/) | tfc | tfc.dll | tfc.so +| [The Wastes](http://www.moddb.com/mods/the-wastes/downloads/) | thewastes | thewastes.dll | thewastes.so +| [Project Timeless](http://www.moddb.com/mods/project-timeless/downloads/) | timeless | timeless.dll | pt.so +| [Tour of Duty](http://www.moddb.com/mods/tour-of-duty/downloads/) | tod | hl.dll | hl.so +| [Train Hunters](http://www.moddb.com/games/half-life/addons?filter=t&kw=Train+Hunters&category=&licence=&timeframe=) | trainhunters | th.dll | th.so +| [The Specialists](http://www.moddb.com/mods/the-specialists/downloads/) | ts | mp.dll | ts.so +| [The Trenches](http://www.moddb.com/mods/the-trenches-half-life/downloads/) | tt | tt.dll | tt.so +| [Underworld Bloodline](http://www.moddb.com/mods/underworld-bloodline/downloads/) | underworld | uw.dll | uw.so +| [Half-Life](http://store.steampowered.com/app/70/HalfLife/) | valve | hl.dll | hl.so +| [VampireSlayer](http://www.moddb.com/mods/vampire-slayer/downloads/) | vs | mp.dll | vs.so +| [Wanted!](http://www.moddb.com/mods/wanted-the-western-mod-steam/downloads/) | wantedhl | wanted.dll | hl.so +| [Wizard Wars (Steam)](http://www.moddb.com/mods/wizard-wars/downloads/) | wizardwars | wizardwars.dll | wizardwars.so +| [Wizard Wars Beta (Steam)](http://www.moddb.com/mods/wizard-wars/downloads/) | wizardwars_beta | wizardwars.dll | wizardwars.so +| [Wizard Wars (Old)](http://www.moddb.com/mods/wizard-wars/downloads/) | wizwars | mp.so | hl.dll +| [WormsHL](http://www.moddb.com/mods/wormshl/downloads/) | wormshl | wormshl.dll | wormshl.so +| [Zombie Panic](http://www.moddb.com/mods/zombie-panic/downloads/) | zp | mp.dll | hl.so + +*** +Any assistance and contribution to the project is welcome. The more tests and feedback, the stronger the development of Metamod-r and other related products. Goodluck! diff --git a/docs/core-projects/Metamod-R/04-compilling.md b/docs/core-projects/Metamod-R/04-compilling.md new file mode 100644 index 0000000..ae53316 --- /dev/null +++ b/docs/core-projects/Metamod-R/04-compilling.md @@ -0,0 +1,76 @@ +--- +id: metamod-r-compilling +title: Compilling +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/compilling +--- + +# Compilling + +## Build instructions +### Checking requirements +There are several software requirements for building Metamod-r: + +#### Windows +
+Visual Studio 2015 (C++14 standard) and later
+
+ +#### Linux +
+git >= 1.8.5
+cmake >= 3.10
+GCC >= 4.9.2 (Optional)
+ICC >= 15.0.1 20141023 (Optional)
+LLVM (Clang) >= 6.0 (Optional)
+
+ +### Building + +#### Windows +Use `Visual Studio` to build, open `msvc/metamod.sln` and just select from the solution configurations list `Release` or `Debug` + +#### Linux + +* Optional options using `build.sh --compiler=[gcc] --jobs=[N] -D[option]=[ON or OFF]` (without square brackets) + +
+-c=|--compiler=[icc|gcc|clang]  - Select preferred C/C++ compiler to build
+-j=|--jobs=[N]                  - Specifies the number of jobs (commands) to run simultaneously (For faster building)
+
+Definitions (-D)
+DEBUG                           - Enables debugging mode
+USE_STATIC_LIBSTDC              - Enables static linking library libstdc++
+
+ +* ICC
./build.sh --compiler=intel
+* LLVM (Clang)
./build.sh --compiler=clang
+* GCC
./build.sh --compiler=gcc
+ +##### Checking build environment (Debian / Ubuntu) + +
+Click to expand + +
    +
  • +Installing required packages +
    +sudo dpkg --add-architecture i386
    +sudo apt-get update
    +sudo apt-get install -y gcc-multilib g++-multilib
    +sudo apt-get install -y build-essential
    +sudo apt-get install -y libc6-dev libc6-dev-i386
    +
    +
  • + +
  • +Select the preferred C/C++ Compiler installation +
    +1) sudo apt-get install -y gcc g++
    +2) sudo apt-get install -y clang
    +
    +
  • +
+ +
diff --git a/docs/core-projects/Metamod-R/05-credits.md b/docs/core-projects/Metamod-R/05-credits.md new file mode 100644 index 0000000..b6515ee --- /dev/null +++ b/docs/core-projects/Metamod-R/05-credits.md @@ -0,0 +1,49 @@ +--- +id: metamod-r-credits +title: Credits +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/credits +--- + +# Credits + +**Metamod-r** is based on the original version of [Metamod](http://metamod.org/) written by _Will Day_ for Half-Life 1 with some improvements from [Jussi Kivilinna](https://github.com/jkivilin) ([Metamod-p](https://github.com/jkivilin/metamod-p)). This product contains a large number of performance optimizations and more pure code. The core was written using JIT compiler. + +**Metamod-r is incompatible with original `HLDS`. It's necessary to have installed [ReHLDS](https://github.com/rehlds/ReHLDS) (`API 3.1+`). There is no guarantee that the product will work in a different environment.** + +Distributed under [![GitHub license](https://img.shields.io/github/license/rehlds/metamod-r.svg?style=flat-square)](https://github.com/rehlds/metamod-r/blob/master/LICENSE). + +## ![](https://i.imgur.com/pej4HBX.png) Links and contacts +* ![](https://i.imgur.com/vqDiJ67.png) Will Day, `willday@metamod.org` — original [Metamod](http://www.metamod.org/), +* ![](https://i.imgur.com/Uy97ydR.png) [Jussi Kivilinna](https://github.com/jkivilin) — [Metamod-p](https://github.com/jkivilin/metamod-p), +* ![](https://i.imgur.com/Uy97ydR.png) [AlliedModders](https://github.com/alliedmodders) — [Metamod-am](https://github.com/alliedmodders/metamod-hl1), +* ![](https://i.imgur.com/Uy97ydR.png) [theAsmodai](https://github.com/rehlds/), ![](https://i.imgur.com/vqDiJ67.png) + [ReHLDS Team](http://www.dedicated-server.ru/vbb/) — [Metamod-r](https://github.com/rehlds/metamod-r). + + +### ![](https://i.imgur.com/i6iU6vZ.png) Documentation + +* Russian translaion - ![](https://i.imgur.com/Uy97ydR.png) [STAM](https://github.com/stamepicmorg),![](https://i.imgur.com/Uy97ydR.png) [AurZum](https://github.com/Aleks-Z). +* English translation - ![](https://i.imgur.com/Uy97ydR.png) [AEnimka](https://github.com/AEnimka). +* Icons - ![](https://i.imgur.com/vqDiJ67.png) [Freepik](https://www.flaticon.com/authors/freepik), ![](https://i.imgur.com/vqDiJ67.png) [Dave Gandy](https://www.flaticon.com/authors/dave-gandy). + + +**Metamod-r** is based on the original version of [Metamod](http://metamod.org/) written by _Will Day_ for Half-Life 1 with some improvements from [Jussi Kivilinna](https://github.com/jkivilin) ([Metamod-p](https://github.com/jkivilin/metamod-p)). This product contains a large number of performance optimizations and more pure code. The core was written using JIT compiler. + +**Metamod-r is incompatible with original `HLDS`. It's necessary to have installed [ReHLDS](https://github.com/rehlds/ReHLDS) (`API 3.1+`). There is no guarantee that the product will work in a different environment.** + +Distributed under [![GitHub license](https://img.shields.io/github/license/rehlds/metamod-r.svg?style=flat-square)](https://github.com/rehlds/metamod-r/blob/master/LICENSE). + +## ![](https://i.imgur.com/pej4HBX.png) Links and contacts +* ![](https://i.imgur.com/vqDiJ67.png) Will Day, `willday@metamod.org` — original [Metamod](http://www.metamod.org/), +* ![](https://i.imgur.com/Uy97ydR.png) [Jussi Kivilinna](https://github.com/jkivilin) — [Metamod-p](https://github.com/jkivilin/metamod-p), +* ![](https://i.imgur.com/Uy97ydR.png) [AlliedModders](https://github.com/alliedmodders) — [Metamod-am](https://github.com/alliedmodders/metamod-hl1), +* ![](https://i.imgur.com/Uy97ydR.png) [theAsmodai](https://github.com/rehlds/), ![](https://i.imgur.com/vqDiJ67.png) + [ReHLDS Team](http://www.dedicated-server.ru/vbb/) — [Metamod-r](https://github.com/rehlds/metamod-r). + + +### ![](https://i.imgur.com/i6iU6vZ.png) Documentation + +* Russian translaion - ![](https://i.imgur.com/Uy97ydR.png) [STAM](https://github.com/stamepicmorg),![](https://i.imgur.com/Uy97ydR.png) [AurZum](https://github.com/Aleks-Z). +* English translation - ![](https://i.imgur.com/Uy97ydR.png) [AEnimka](https://github.com/AEnimka). +* Icons - ![](https://i.imgur.com/vqDiJ67.png) [Freepik](https://www.flaticon.com/authors/freepik), ![](https://i.imgur.com/vqDiJ67.png) [Dave Gandy](https://www.flaticon.com/authors/dave-gandy). diff --git a/docs/core-projects/Metamod-R/index.md b/docs/core-projects/Metamod-R/index.md index c5693ca..df271c1 100644 --- a/docs/core-projects/Metamod-R/index.md +++ b/docs/core-projects/Metamod-R/index.md @@ -7,7 +7,7 @@ slug: /metamod-r # What is Metamod-r? -Metamod-r is an improved version of the original Metamod, a plugin/DLL manager that functions as an intermediary layer between the Half-Life Engine and a Half-Life game mod. This setup allows the dynamic loading and unloading of mod-like DLL plugins, making it possible to add custom functionality to the Half-Life server or any game mod running on the engine. +Metamod-r is an improved version of the original [Metamod](http://metamod.org/) written by _Will Day_ for Half-Life 1 with some additions from [Jussi Kivilinna](https://github.com/jkivilin) ([Metamod-p](https://github.com/jkivilin/metamod-p)), a plugin/DLL manager that functions as an intermediary layer between the Half-Life Engine and a Half-Life game mod. This setup allows the dynamic loading and unloading of mod-like DLL plugins, making it possible to add custom functionality to the Half-Life server or any game mod running on the engine. Based on the original Metamod developed by Will Day, Metamod-r incorporates significant improvements, including code optimizations and enhanced performance, while maintaining full compatibility with all plugins designed for Metamod. Key enhancements in Metamod-r include optimizations from Metamod-p, an earlier modified version by Jussi Kivilinna, along with further refinements. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/00-supported-games.md b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/00-supported-games.md new file mode 100644 index 0000000..6f56790 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/00-supported-games.md @@ -0,0 +1,129 @@ +--- +id: metamod-r-supported-games +title: Поддерживаемые игры +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/supported-games +--- + +# Поддерживаемые игры + +Энтузиасты из сообщества прошлись по известным версиям _Metamod_, +* [metamod (Оригинальный)](https://sourceforge.net/projects/metamod/files/Metamod%20Sourcecode/1.20/) ("games.h"), +* [metamod-p](https://github.com/jkivilin/metamod-p/blob/master/metamod/games.h), +* [metamod-p-cmake](https://github.com/SamVanheer/Metamod-P-CMake/blob/master/metamod/games.h) (просто форк, оптимизированный под c-make сборку), +* [metamod-am\metamod-hl1](https://github.com/alliedmodders/metamod-hl1/blob/master/metamod/games.h) от [alliedmodders](https://github.com/alliedmodders/). + составив очищенный и актуальный список модов, проверив (**`поверхностно*`**) на работоспособность и добавили поддержку "из-коробки" этих игр в **[Metamod-r](https://github.com/theAsmodai/metamod-r)**. + +# Поддерживаемые игры: +:heavy_check_mark: - Поддерживается :x: - Не поддерживается :interrobang: - Частично поддерживается, есть проблемы :star: - Проверено сообществом + +| Игра \ Мод | ![](https://i.imgur.com/t23p9tU.png) | ![](https://i.imgur.com/AzhAYR4.png) | Заметка +| ------------- | ------| ------|------| +| [Action Half-Life](http://www.moddb.com/mods/action-half-life/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [Adrenaline Gamer](https://github.com/martinwebrant/agmod) | :heavy_check_mark: | :heavy_check_mark: | +| [Azure Sheep](http://www.moddb.com/mods/azure-sheep/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Base Defense](http://www.moddb.com/mods/b-def/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [Brain Bread](http://www.moddb.com/mods/brainbread/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Brutal Half-Life](http://www.moddb.com/mods/brutal-half-life/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Bumper Cars](http://www.moddb.com/mods/bumper-cars/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [BuzzyBots](http://www.moddb.com/mods/buzzybots/downloads) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Chicken Fortress 3](http://www.moddb.com/mods/chicken-fortress-3/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Counter-Strike 1.0](http://www.moddb.com/mods/counter-strike/downloads/counter-strike-10-for-steam) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Counter-Strike 1.5](http://www.moddb.com/mods/counter-strike/downloads/counter-strike-15-for-steam) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Counter-Strike 1.6](http://store.steampowered.com/app/10/CounterStrike/) :star: | :heavy_check_mark: | :heavy_check_mark: | +| [Counter-Strike:Condition Zero](http://store.steampowered.com/app/80/CounterStrike_Condition_Zero/) | :heavy_check_mark: | :heavy_check_mark: +| [Counter-Strike:Condition Zero Deleted Scenes](http://store.steampowered.com/app/80/CounterStrike_Condition_Zero/) | :heavy_check_mark: | :heavy_check_mark: | Однопользовательский мод, сделанный на основе мультиплеера. +| [Day of Defeat](http://store.steampowered.com/app/30/Day_of_Defeat/) | :heavy_check_mark: | :heavy_check_mark: +| [Deathmatch Classic](http://store.steampowered.com/app/40/Deathmatch_Classic/) | :heavy_check_mark: | :heavy_check_mark: +| [Desert Crisis](http://www.moddb.com/mods/desert-crisis/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Digital Paintball](http://www.moddb.com/mods/digital-paintball/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Earth's Special Forces](http://www.moddb.com/mods/earths-special-forces/downloads/) :star: | :heavy_check_mark: | :heavy_check_mark: | +| [Existence](http://www.moddb.com/mods/existence/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Firearms](http://www.moddb.com/mods/firearms/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Frontline Force](http://www.moddb.com/mods/front-line-force/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Gangsta Wars](http://www.moddb.com/mods/gangsta-wars/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Gangwars](http://www.moddb.com/mods/gangwars/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Global Warfare](http://www.moddb.com/mods/global-warfare/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Goldeneye](http://www.moddb.com/mods/goldeneye-mod/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Gunman Chronicles](http://www.moddb.com/games/gunman-chronicles/downloads/gunman-chronicles-steam-version/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [HL-Rally](http://www.moddb.com/mods/hl-rally/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [Half-Life](http://store.steampowered.com/app/70/HalfLife/) :star: | :heavy_check_mark: | :heavy_check_mark: | Также альтернативный клиент [Bugfixed and improved HL release](https://github.com/LevShisterov/BugfixedHL) :star: . +| [Half-Life 1.5: Weapon Edition](http://www.moddb.com/mods/half-life-weapon-edition/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Half-Life: Blue Shift](http://store.steampowered.com/app/130/HalfLife_Blue_Shift/) | :heavy_check_mark: | :heavy_check_mark: | Однопользовательский мод, сделанный на основе мультиплеера. +| [Half-Life: Decay](http://www.moddb.com/mods/half-life-decay/downloads/) :star:| :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Headcrab Frenzy](http://www.moddb.com/mods/headcrab-frenzy/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [Holy Wars](http://www.moddb.com/mods/holy-wars/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Hostile Intent](http://www.moddb.com/mods/hostile-intent/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [International Online Soccer](http://www.moddb.com/mods/international-online-soccer/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Judgement](http://www.moddb.com/mods/judgement/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Kanonball](http://www.moddb.com/mods/kanonball/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Master Sword](http://www.moddb.com/mods/master-sword/downloads/) [Continued](http://www.moddb.com/mods/master-sword-continued-111/downloads) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Monkeystrike](http://www.moddb.com/mods/monkeystrike/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Morbid Inclination](http://www.moddb.com/mods/morbid-inclination/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Move In!](http://www.moddb.com/mods/move-in/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Natural Selection](https://unknownworlds.com/ns/) :star:| :heavy_check_mark: | :heavy_check_mark: | Также `Beta`-версия. +| [Open-Source Jailbreak](http://www.moddb.com/mods/open-source-jailbreak/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [openAG](https://github.com/YaLTeR/OpenAG) | :heavy_check_mark: | :heavy_check_mark: | Также альтернативный open-source клиент для мода `Adrenaline Gamer`. +| [Operations 1942](http://www.moddb.com/mods/operations-1942/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Opposing Force](http://store.steampowered.com/app/50/HalfLife_Opposing_Force/) | :heavy_check_mark: | :heavy_check_mark: +| [Out Break](http://www.moddb.com/mods/outbreak-half-life/downloads/) | :heavy_check_mark: | :x: | Нету исполняемых файлов для Linux. +| [Outlawsmod](http://www.moddb.com/mods/outlaws/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Over Ground](http://www.moddb.com/mods/over-ground/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Oz Deathmatch](http://ozdeathmatch.com/) | :heavy_check_mark: | :heavy_check_mark: +| [Paintball](http://www.bloodvayne.com/hlpb/downloads.htm) | :heavy_check_mark: | :heavy_check_mark: +| [Pirates, Vikings and Knights](http://www.moddb.com/mods/pirates-vikings-and-knights/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Point of No Return](http://www.moddb.com/mods/point-of-no-return/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Project Timeless](http://www.moddb.com/mods/project-timeless/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Public Enemy](http://www.moddb.com/mods/public-enemy/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Resident Evil : Cold Blood](http://www.moddb.com/mods/resident-evil-cold-blood/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Ricochet](http://store.steampowered.com/app/60/Ricochet/) :star:| :heavy_check_mark: | :heavy_check_mark: +| [Rival Species](http://www.rivalspecies.com/files.php) | :heavy_check_mark: | :heavy_check_mark: +| [Rocket Crowbar](http://hldm.org/files/mods/287-rocket-crowbar.html) | :heavy_check_mark: | :heavy_check_mark: +| [Rocket Crowbar 2](http://www.moddb.com/mods/rocket-crowbar-2/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Science & Industry](http://www.moddb.com/mods/science-and-industry/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Scientist Hunt](http://www.moddb.com/mods/scientist-hunt/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Snow-War](http://www.moddb.com/mods/snow-war/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [StargateTC](http://www.moddb.com/mods/stargatetc/downloads/) :star:| :heavy_check_mark: | :heavy_check_mark: | Все версии: `1.x` и `2.x`. +| [Sven Coop](http://store.steampowered.com/app/225840/Sven_Coop/) :star: | :interrobang: | :interrobang: | **Внимание!** Пользователи испытывают проблемы со старыми `legacy` `steam 5.x` версиями [#1](https://github.com/theAsmodai/metamod-r/issues/17#issuecomment-362253473), [#2](https://github.com/theAsmodai/metamod-r/issues/29). _**Проблема РЕШЕНА**_ в `steam` версии [#3](https://github.com/theAsmodai/metamod-r/issues/45) разработчиками мода начиная с [билда 3082297](https://forums.svencoop.com/showthread.php/45308-Sven-Co-op-Update-Released-Build-3082297). +| [Swarm](http://www.moddb.com/mods/swarm/downloads) | :heavy_check_mark: | :heavy_check_mark: | +| [Team Fortress Classic](http://store.steampowered.com/app/20/Team_Fortress_Classic/) | :heavy_check_mark: | :heavy_check_mark: +| [The Battle Grounds](http://www.moddb.com/mods/battle-grounds/downloads/) | :heavy_check_mark: | :heavy_check_mark: | +| [The Ship](http://www.moddb.com/mods/the-ship) | :heavy_check_mark: | :heavy_check_mark: | +| [The Specialists](http://www.moddb.com/mods/the-specialists/downloads/) :star: | :heavy_check_mark: | :heavy_check_mark: | +| [The Trenches](http://www.moddb.com/mods/the-trenches-half-life/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [The Wastes](http://www.moddb.com/mods/the-wastes/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Tour of Duty](http://www.moddb.com/mods/tour-of-duty/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Train Hunters](http://www.moddb.com/games/half-life/addons?filter=t&kw=Train+Hunters&category=&licence=&timeframe=) | :heavy_check_mark: | :heavy_check_mark: +| [Underworld Bloodline](http://www.moddb.com/mods/underworld-bloodline/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [VampireSlayer](http://www.moddb.com/mods/vampire-slayer/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Wanted!](http://www.moddb.com/mods/wanted-the-western-mod-steam/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Wizard Wars](http://www.moddb.com/mods/wizard-wars/downloads/) | :heavy_check_mark: | :heavy_check_mark: | Также `Beta`-версия. +| [WormsHL](http://www.moddb.com/mods/wormshl/downloads/) | :heavy_check_mark: | :heavy_check_mark: +| [Zombie Panic](http://www.moddb.com/mods/zombie-panic/downloads/) | :heavy_check_mark: | :heavy_check_mark: + +* _Моды, не считая `Counter-Strike 1.6`, `Half-Life 1` и остальных, помеченных :star: - проверялись только на успешный запуск в среде [ReHLDS](https://github.com/dreamstalker/ReHLDS) + [Metamod-r](https://github.com/theAsmodai/metamod-r). Интенсивных проверок произведено не было. Таблица совместимости является "авансовой". В данный момент идет более тщательное тестирование и выявление проблем с модами._ + + +*** + +## Известные проблемы + +### SvenCoop + +#### "Лимит 512" +![image](https://user-images.githubusercontent.com/34998786/37242681-89c5da6a-24a8-11e8-8ef2-97188b70a6f3.png) + +Игра имеет модифицированный лимит на предзагрузку объектов в движке и клиенте. Поскольку metamod-r требует наличие rehlds, то на стороне сервера лимит меняется на стандартный - 512 объектов. Как следствие, мод не запускается на картах, которые выходят за рамки лимита (карты одиночной игры, для совместного прохождения). Но при этом, стандартные сетевые карты, типа `crossfire` работают нормально. (_Прямым багом [metamod-r #29](https://github.com/theAsmodai/metamod-r/issues/29) или [rehlds #591](https://github.com/dreamstalker/rehlds/issues/591) это не является, но косвенно затрагивает данные продукты_). + +##### Решение: +* можно попробовать обновиться до новейшей `steam`-версии [билд 3082297](https://forums.svencoop.com/showthread.php/45308-Sven-Co-op-Update-Released-Build-3082297) of svencoop. + +Цитата из списка изменений: +> Restored API/ABI compatibility with vanilla GoldSrc/Metamod-P. The custom Sven Co-op Metamod-P build is no longer necessary (and in fact won't work anymore). + +Вольный перевод: +> Восстановлена совместимость API/ABI с ванильными(оригинальными) версиями GoldSrc/Metamod-P. Модифицированная версия Metamod-P больше не требуется (по факту, больше не будет работать). + +##### Обходные решения: +* можно попробовать использовать ![](https://i.imgur.com/AzhAYR4.png) [metamod_unprecacher](https://github.com/In-line/metamod_unprecacher) для выгрузки ненужных ресурсов (чтобы вписаться в ограничения). `не проверялось` +* можно попробовать собрать пользовательскую сборку rehlds с увеличенным лимитом, который используется в svencoop. `не проверялось` diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/01-installing.md b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/01-installing.md new file mode 100644 index 0000000..5279f13 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/01-installing.md @@ -0,0 +1,60 @@ +--- +id: metamod-r-install +title: Установка +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/install +--- + +# Установка + +Ознакомьтесь со [списком поддерживаемых игр](/ru/docs/metamod-r/supported-games) и убедитесь, что игра в нем присутствует. _Если же нет, то не расстраивайтесь. После установки, вы можете проверить работоспособность **Metamod-r** с вашим `неподдерживаемым` модом после тонкой настройки, обратившись к этой [статье](/ru/docs/metamod-r/settings). Есть вероятность, что игра запустится._ + +# Совместимость + +**Metamod-r несовместим с оригинальным `HLDS`. Необходимо иметь заранее установленный [ReHLDS](https://github.com/rehlds/ReHLDS) (`API 3.1+`). Нет гарантий, что metamod-r запустится с оригинальной версией HLDS.** + +| HLDS| [ReHLDS](https://github.com/rehlds/ReHLDS)| OS +|---------| -------| -------| +| :x: | `API 3.1+` | ![](https://i.imgur.com/AzhAYR4.png) ![](https://i.imgur.com/t23p9tU.png) | + +# Установка на игровой сервер + +* Скачайте последнюю версию _**Metamod-r**_ [![Download](https://camo.githubusercontent.com/2b15ec2fc402e02b66fde9eab7e896406caeddac/687474703a2f2f7265686c64732e6f72672f76657273696f6e2f6d6574616d6f642d2d722e737667)](http://teamcity.rehlds.org/guestAuth/downloadArtifacts.html?buildTypeId=Metamod_Publish&buildId=lastSuccessful) в любое удобное место. +* Разархивируйте из скачанного zip-архива папку _**addons**_ в папку вашего мода. ![](https://i.imgur.com/QYpJ6vI.png) + + _Если у вас возникла проблема, с определением имени каталога, обратитесь к сводной таблице, которая представлена **[здесь](/ru/docs/metamod-r/troubbleshouting)**._ + +* В папке мода найдите файл `liblist.gam`, сделайте его резервную копию (если хотите) и откройте файл любым удобным текстовым редактором. +* Найдите в файле `liblist.gam` строчки, содержащие `gamedll` и `gamedll_linux`. _Например, у `Half-Life 1` они будет выглядеть так:_ + +``` +gamedll "dlls\hl.dll" +gamedll_linux "dlls/hl.so" +``` +_а у `Counter-Strike 1.6` - так:_ + +``` +gamedll "dlls\mp.dll" +gamedll_linux "dlls/cs.so" +``` + +* Замените в нужной строке содержание пути до metamod-r на следующее: + + _Для Windows-версии вашего сервера:_ +``` +gamedll "addons\metamod\metamod.dll" +``` + _Для Linux-версии вашего сервера:_ +``` +gamedll_linux "addons/metamod/metamod_i386.so" +``` +* Сохраните изменения в `liblist.gam` файле. +* Установка **Metamod-r** завершена. + +# Проверка +После успешной установки **Metamod-r**, можете проверить работоспособность, просто запустив игровой сервер. О том, что **Metamod-r** работает, свидетельствует сообщение в консоли при запуске сервера: +![](https://i.imgur.com/VScngBr.png) + +Если такого не наблюдается, +![](https://i.imgur.com/HPKRiBF.png) +обратитесь к [руководству по устранению неполадок](/ru/docs/metamod-r/troubbleshouting). \ No newline at end of file diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/02-settings.md b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/02-settings.md new file mode 100644 index 0000000..afa4149 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/02-settings.md @@ -0,0 +1,113 @@ +--- +id: metamod-r-settings +title: Настройки +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/settings +--- + +# Настройки + + +## Подключение плагинов в plugins.ini +В качестве примера будет использован мифический плагин `metaPlugin`. Установка других плагинов идет по аналогии с этой инструкцией. + +* В папке `addons\metamod` создайте файл `plugins.ini`, если его там нету. +* В папке `addons` создайте папку для нового плагина. _Например, папку **metaPlugin**._ +* Поместите свой плагин `metaPlugin.dll` (или `metaPlugin.so`) в созданную папку по пути `addons\metamod\metaPlugin`. +* Откройте из папки `metamod` файл `plugins.ini` любым удобным для вас текстовым редактором. +* Для подключения плагина `metaPlugin.dll` (или `metaPlugin.so`) пропишите следующие строки в файл `plugins.ini`: + + _Для Windows-версии вашего сервера:_ +``` +win32 addons\metaPlugin\metaPlugin.dll +``` + _Для Linux-версии вашего сервера:_ +``` +linux addons/metaPlugin/metaPlugin.so +``` +* Сохраните ваш файл `plugins.ini` и запустите сервер. +* Установка плагина **завершена**. + +_Вы можете проверить, что плагин работает, набрав в консоли сервера `meta list`._ +![](https://i.imgur.com/1fVXBzc.png) + +Если такого не наблюдается, +![](https://i.imgur.com/nGXAokG.png) +обратитесь к [руководству по устранению неполадок](https://github.com/theAsmodai/metamod-r/wiki/Устранение-проблем). + +# Список консольных команд +Команда пишется в связке с приставкой `meta`. _Например, `meta version`_. + +``` + version - отобразить информацию о версии metamod + list - отобразить список загруженных плагинов + game - отобразить информацию о gamedll (список зарегистрированных msg, их id и размер) + cmds - список консольных команд, добавленных сторонними плагинами + cvars - список cvar, добавленных сторонними плагинами + refresh - перезагрузить metamod-r + config - конфигурация из config.ini + load - найти и загрузить плагин по указанному пути + unload - выгрузить указанный плагин + reload - перезагрузить указанный плагин + info - отобразить подробную информацию об указанном плагине + pause - приостановить работу плагина + unpause - возобновить работу всех остановленных плагинлв + retry - повторить попытку неудачной загрузки плагина + clear - выгрузить из памяти неудачно загруженный плагин + force_unload - принудительная выгрузка плагина + require - выключить сервер, если указанный плагин не запущен +``` + +# Тонкая настройка через config.ini +Файл `config.ini` находится рядом с `metamod.dll`. В нем можно произвести более тонкую настройку, если вам это необходимо. _Например, выключить рассылку информации об установленных плагинов в клиенты, либо форсированно подключить `неподдерживаемый` мод или игру._ + +### debuglevel + +| **Переменная** | debuglevel +| :----- | -----: +| **Тип** | число +| **Принимает** | от 0 до 42 +| **По умолчанию** | 0 +| **Переопределяется** | `+localinfo mm_debug <число>` +| **Пример использования** | `debuglevel 0` +| **Подробное описание** | Устанавливает начальный уровень отладки для `metamod` (так же, как cvar `meta_debug`). По умолчанию обычно `0`. Если `hlds` запущен с `-dev` параметром, то значение будет `3`. + +### gamedll +| **Переменная** | gamedll +| :----- | -----: +| **Тип** | строка +| **Принимает** | `<путь>` +| **По умолчанию** | пусто +| **Переопределяется** | `+localinfo mm_gamedll <путь>` +| **Пример использования** | `gamedll dlls/hl.dll`, `gamedll ../podbot/podbot.dll`, `gamedll /home/bots/dlls/mybot.dll` +| **Подробное описание** | `<путь>` - либо абсолютный путь, либо относительный папки мода, к исполняемому файлу игры (например, `hl.dll`) в тех случаях, когда `Metamod-r` не может распознать запускаемую игру или мод. По умолчанию - значение пустое. + +### exec_cfg +| **Переменная** | exec_cfg +| :----- | -----: +| **Тип** | строка +| **Принимает** | `<файл>` +| **По умолчанию** | `addons/metamod/exec.cfg` +| **Переопределяется** | `+localinfo mm_execcfg <файл>` +| **Пример использования** | `exec_cfg configs/debugging.cfg`, `exec_cfg ../clan/match.cfg` +| **Подробное описание** | Где` <файл> `- это путь относительно папки с игрой. **Внимание:** Это НЕ МОЖЕТ быть абсолютным путем, поскольку `hlds` не будет «исполнять» абсолютные пути. Переопределяет имя файла по умолчанию, содержащее команды `hlds`, которые запускаются сразу после загрузки `Metamod-r`. + +### clientmeta +| **Переменная** | clientmeta +| :----- | -----: +| **Тип** | флаг +| **Принимает** | `` +| **По умолчанию** | `yes` +| **Переопределяется** | `+localinfo mm_clientmeta ` +| **Пример использования** | `clientmeta yes`, `clientmeta no` +| **Подробное описание** | Настройка для отключения или включения клиентских команд Metamod (`meta list` и `meta version`). Дополнительная настройка для исправления патча `Metamod+All-Mod-Support`. + +### dynalign_list +| **Переменная** | clientmeta +| :----- | -----: +| **Тип** | флаг +| **Принимает** | `` +| **По умолчанию** | `no` +| **Переопределяется** | +| **Пример использования** | `dynalign_list yes`, `dynalign_list no` +| **Подробное описание** | Настройка для отключения или включения динамического выравнивания списка плагинов на вывод. **Внимание**: Этот параметр влияет на неправильный синтаксический анализ из `HLSW` во вкладке `Metamod Plugins`. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/03-troubleshuting.md b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/03-troubleshuting.md new file mode 100644 index 0000000..32cb941 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/03-troubleshuting.md @@ -0,0 +1,245 @@ +--- +id: metamod-r-troubbleshouting +title: Устранение проблем +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/troubbleshouting +--- + +# Устранение проблем + +## Как правильно подать заявку с проблемой: +Если вы хотите внести предложение, зарегистрировать ошибку, у вас ничего не получилось, либо вам нужна "живая" помощь и содействие - вы всегда можете подать заявку [здесь](https://github.com/theAsmodai/metamod-r/issues). Достаточно нажать зеленую кнопку `New issue` и заполнить форму. + +Разработчики будут благодарны, если при описании проблемы - вы максимально подробно все распишете: +* Версию вашей операционной системы; +* Версию (номер сборки) HLDS-сервера (либо [ReHLDS](https://github.com/dreamstalker/ReHLDS)); +* Версию вашей игры (или мода); +* Версию (номер или дату сборки) Metamod-r; + - Можете дополнительно указать список модулей (набрав `meta list` в консоли сервера). +* Приложите логи; +* Приложите crashdump'ы; + +Это поможет для более тщательного анализа и, возможно, исправления ваших проблем в будущем. + +*** + +## Получение дампов падения HLDS\reHLDS + +![](https://i.imgur.com/vqDiJ67.png) [Источник](https://aghl.ru/forum/viewtopic.php?f=10&t=1441). +![](https://i.imgur.com/vqDiJ67.png) [Зеркало](https://dev-cs.ru/threads/1532/). + + **Не стоит просто так выкладывать дампы в интернете, так как зачастую в них содержится полная информация о сервере, включая rcon и прочее. Для передачи можно архивировать их с паролем, что полезно ещё тем, что жмутся они весьма хорошо.** + +### ![](https://i.imgur.com/t23p9tU.png) Windows + +#### С использованием WER (Windows Error Reporting): +* Разрешить WER (отчеты об ошибках): + - До Vista: + - Запустить drwtsn32.exe и выбрать "Full" напротив Crash Dump File. Тут же можно увидеть (или настроить) куда будут складываться дампы. + - На Vista и выше: + - Редактирование реестра, удобный способ от [s1lent](https://github.com/s1lentq): +> +> #### Развернутый и быстрый способ настроить реестр на получение дампов для новичков. +> +> * Настройки: +> - **NAME_APP** - `hlds.exe` +> - имя приложения, которому нужно будет создавать дампы в случае аварийного завершения. +> - **REG_LINK** - `HKLM\Software\Microsoft\Windows\Windows Error Reporting` +> - путь до раздела Windows Error Reporting (Эту настройку скорее всего менять не нужно, думаю во всех Windows пути одинаковые) +> - **DumpType** - `2` +> - `0` - Обычный дамп +> - `1` - Минимальный дамп +> - `2` - Полный дамп +> - DumpCount - `15` +> - количество создаваемых дампов, если в папке количество дампов будет больше указанного значения, то будет удаляться старый дамп для создания нового дампа. +> - **DumpFolder** - `C:\CrashDumps` +> - путь до папки, куда будут складываться дампы. +> - (во избежании всяких проблем не используйте пробелы или кириллицу в путях) +> * Установка: +> - Скачать архив и разархивировать. +> - Запустить add_RegistryDumps.bat +> +> - После записи в реестр вы должны убедиться что у вас включена служба Отчеты об ошибках Windows. +> - Дальше нажать горячую клавишу Windows + R (Windows кнопка находится между ctrl и alt) или можно вызвать cmd.exe или Пуск - Выполнить, сразу после этого нужно ввести gpedit.msc, далее см. скриншот. +> +> `Конфигурация компьютера -> Административные шаблоны -> Компоненты Windows -> Отчеты об ошибок Windows` +> +> ![](https://i.imgur.com/PLQ8mf3.jpg) +> + +> * ![](https://i.imgur.com/vqDiJ67.png) [add_RegistryDumps.zip](http://aghl.ru/forum/download/file.php?id=3071) \ ![](https://i.imgur.com/Uy97ydR.png) Зеркало ["add_RegistryDumps.zip"](https://github.com/EpicMorgGames/LegacyMods/raw/master/AGHL.ru/add_RegistryDumps.zip) +> * ![](https://i.imgur.com/vqDiJ67.png) [remove_RegistryDumps.zip](http://aghl.ru/forum/download/file.php?id=3536) \ ![](https://i.imgur.com/Uy97ydR.png) Зеркало ["remove_RegistryDumps.zip"](https://github.com/EpicMorgGames/LegacyMods/raw/master/AGHL.ru/remove_RegistryDumps.zip) +> + +#### С использованием утилиты userdumps +* Инструкция от _unKn0wn_: + +> +> Способ получения дампов посредством утилиты от MicroSoft: ![](https://i.imgur.com/vqDiJ67.png) [UserModeProcessDumper](http://www.microsoft.com/en-us/download/details.aspx?id=4060) \ ![](https://i.imgur.com/Uy97ydR.png) Зеркало ["UserModeProcessDumper8_1_2929_5.zip"](https://github.com/EpicMorgGames/LegacyMods/raw/master/AGHL.ru/UserModeProcessDumper8_1_2929_5.zip). +> +> Спасибо [Lev](https://github.com/LevShisterov) за настройки. +> +> ##### 1. Инсталяция +> Архив который вы скачали разархивируем (по умолчанию C:\kktools\userdump8.1). +> - Запустите файл setup.exe из каталога: +> - Если вы используете 32-битную ОС Windows XP/2003, то C:\kktools\userdump8.1\x86. +> - Если вы используете 64-битную ОС Windows XP/2003, то C:\kktools\userdump8.1\x64. +> - В окне Мастера установки нажмите на кнопку Далее. +> - (Только для 32-битных ОС) В окне Terminate Mode выберите Disable "Dump on Process Termination" feature и нажмите на кнопку Далее. +> +> ![](https://i.imgur.com/NgjxfPa.png) +> +> - Нажмите на кнопку Готово и дождитесь завершения установки. +> В окне User Mode Process Dump Setup нажмите на кнопку ДА (Если по каким-то причинам вы не знаете как зайти в меню с настройками userdump -вы их всегда сможете найти в Панель управления - Process Dumper). +> +> ##### 2. Добавление приложения +> В открывшемся окне Свойства: User Mode Process Dumper Setup жмём New и добавляем имя нужной нам программы на пример: hlds.exe (расширение -обязательно!) и жмём ОК +> +> ![](https://i.imgur.com/36m9qL1.jpg) +> +> ##### 3. Настройки +> В окне Свойства: User Mode Process Dumper Setup находим созданное только-что правило приложения, выделяем его и жмём кнопку Rules +> В открывшемся окне Process Monitoring Ruless for hlds.exe +> 1. Выберем Use custom rules. +> 2. Если требуется меняем папку для хранения созданных дампов. +> 3. В Exeption Codes выделяем (нажатием ЛКМ) следующие коды: "Access Violation, Overflow, Illegal Instruction, Stack oveflow." +> 4. Выставляем параметр Save Mode в режим Cyclic saving (5 times). +> Должно получится примерно так: +> +> ![](https://i.imgur.com/sio3Aac.jpg) +> +> PS: Рекомендую использовать совместно с Dr Watson с типом дампов "Краткий", т.к. доктор умеет вести логи в текстовом формате, которые дадут возможность отбирать нужные дампы. А userdump будет делать полные дампы. +> + +### ![](https://i.imgur.com/AzhAYR4.png) Linux + +Сервер надо запускать с ключем **-debug**. + +Если в системе установлен gdb, то автоматически в файле `debug.log` будет записываться внятная информация об ошибке. Так что рекомендуется его поставить (команда зависит от используемой системы, на Debian\Ubuntu - это `apt install gdb`). Хотя для создания дампов это не требуется, это фактически обязательно надо сделать при наличии возможности, так как в `debug.log` при этом будет записано место падения, что позволит сразу что-то сказать об ошибке. Получение этой же информации на другой системе из дамп-файла потребует наличия всех бинарников от сервера. + +По умолчанию дамп-файл называется `core`, записывается в рабочей папке, и, соответственно, будет перезаписываться. Во избежание, можно добавлять к имени идентификатор процесса: + +`echo 1 > /proc/sys/kernel/core_uses_pid` + +или складывать дампы в `/tmp`: + +`echo /tmp/%e-%t-%p-%c.dmp > /proc/sys/kernel/core_pattern` Больше информации ![](https://i.imgur.com/vqDiJ67.png)[тут](http://man7.org/linux/man-pages/man5/core.5.html). + +Запуск без `sudo` (под root, иначе общие настройки системы должны быть выставлены на unlimited): + +`ulimit -c unlimited && ./hlds_run -debug ...` + +Запуск с `sudo` (под пользователем hlds): + +`ulimit -Hc unlimited && sudo -u hlds sh -c "ulimit -Sc unlimited && ./hlds_run -debug ..."` + +Проверка запуска из под sudo: + +`ulimit -Hc unlimited && sudo -u hlds sh -c "ulimit -Sc unlimited && whoami && ulimit -Sc && ./hlds_run -debug ..."` + +выводит имя пользователя под которым произойдет запуск и лимит на создание дампов, после чего запускает сервер. + +Для тестирования настроек создания дампов можете использовать специально разработанный модуль: ![](https://i.imgur.com/vqDiJ67.png) [FixItAll](http://aghl.ru/forum/viewtopic.php?f=19&t=1680&p=19549) \ ![](https://i.imgur.com/Uy97ydR.png) [FixItAll зеркало](https://github.com/EpicMorgGames/LegacyMods/raw/master/AGHL.ru/fixitall_mm.0.0.zip) или ![](https://i.imgur.com/Uy97ydR.png) [Crash.sma*](https://github.com/EpicMorgGames/LegacyMods/blob/master/AGHL.ru/Crash.sma). + +* crash.sma - https://github.com/theAsmodai/metamod-r/issues/42#issuecomment-416456526 + +*** + +## Сводная таблица: +`Папка` - каталог вашего мода или игры. В колонках ![](https://i.imgur.com/t23p9tU.png) и ![](https://i.imgur.com/AzhAYR4.png) представлены названия исполняемых файлов из папки `dlls`, которая находится в каталоге `вашего мода или игры`. + +:x: - версии под платформу не существует + +| Игра \ Мод | Папка | ![](https://i.imgur.com/t23p9tU.png) | ![](https://i.imgur.com/AzhAYR4.png) +| ------------- | ------| ------|------| +| [Action Half-Life](http://www.moddb.com/mods/action-half-life/downloads/) | action | ahl.dll | ahl.so +| [Adrenaline Gamer](https://github.com/martinwebrant/agmod) | ag | ag.dll | ag.so +| [openAG](https://github.com/YaLTeR/OpenAG) | ag | ag.dll | ag.so +| [Azure Sheep](http://www.moddb.com/mods/azure-sheep/downloads/) | asheep | hl.dll | :x: +| [Base Defense](http://www.moddb.com/mods/b-def/downloads/) | bdef | server.dll | server.so +| [The Battle Grounds](http://www.moddb.com/mods/battle-grounds/downloads/) | bg | bg.dll | bg.so +| [Brutal Half-Life](http://www.moddb.com/mods/brutal-half-life/downloads/) | bhl | bhl.dll | :x: +| [Brain Bread](http://www.moddb.com/mods/brainbread/downloads/) | brainbread | bb.dll | :x: +| [Half-Life: Blue Shift](http://store.steampowered.com/app/130/HalfLife_Blue_Shift/) | bshift | hl.dll | bshift.so +| [Bumper Cars](http://www.moddb.com/mods/bumper-cars/downloads/) | bumpercars | hl.dll | :x: +| [BuzzyBots](http://www.moddb.com/mods/buzzybots/downloads) | buzzybots | bb.dll | :x: +| [Chicken Fortress 3](http://www.moddb.com/mods/chicken-fortress-3/downloads/) | ckf3 | mp.dll | :x: +| [Counter-Strike 1.0](http://www.moddb.com/mods/counter-strike/downloads/counter-strike-10-for-steam) | cs10 | mp.dll | :x: +| [Counter-Strike 1.5](http://www.moddb.com/mods/counter-strike/downloads/counter-strike-15-for-steam) | csv15 | mp.dll | :x: +| [Counter-Strike 1.6](http://store.steampowered.com/app/10/CounterStrike/) | cstrike | mp.dll | cs.so +| [Counter-Strike:Condition Zero](http://store.steampowered.com/app/80/CounterStrike_Condition_Zero/) | czero | mp.dll | cs.so +| [Counter-Strike:Condition Zero Deleted Scenes](http://store.steampowered.com/app/80/CounterStrike_Condition_Zero/) | czeror | cz.dll | cz.so +| [Desert Crisis](http://www.moddb.com/mods/desert-crisis/downloads/) | dcrisis | dc.dll | dc.so +| [Half-Life: Decay](http://www.moddb.com/mods/half-life-decay/downloads/) | decay | decay.dll | :x: +| [Deathmatch Classic](http://store.steampowered.com/app/40/Deathmatch_Classic/) | dmc | dmc.dll | dmc.so +| [Day of Defeat](http://store.steampowered.com/app/30/Day_of_Defeat/) | dod | dod.dll | dod.so +| [Digital Paintball](http://www.moddb.com/mods/digital-paintball/downloads/) | dpb | pb.dll | pb.i386.so +| [Earth's Special Forces (Old)](http://www.moddb.com/mods/earths-special-forces/downloads/) | esf | hl.dll | hl.so (лежит не в `dlls` каталоге, а в `linuxdll`) +| [Earth's Special Forces](http://www.moddb.com/mods/earths-special-forces/downloads/) | esf | hl.dll | hl.so +| [Existence](http://www.moddb.com/mods/existence/downloads/) | existence | existence.dll | :x: +| [Firearms](http://www.moddb.com/mods/firearms/downloads/) | firearms | firearms.dll | :x: +| [Frontline Force](http://www.moddb.com/mods/front-line-force/downloads/) | frontline | frontline.dll | front.so +| [Gangsta Wars](http://www.moddb.com/mods/gangsta-wars/downloads/) | gangstawars | gwars27.dll | :x: +| [Gangwars](http://www.moddb.com/mods/gangwars/downloads/) | gangwars | mp.dll | :x: +| [Opposing Force](http://store.steampowered.com/app/50/HalfLife_Opposing_Force/) | gearbox | opfor.dll | opfor.so +| [Global Warfare](http://www.moddb.com/mods/global-warfare/downloads/) | globalwarfare | mp.dll | gw.so +| [Goldeneye](http://www.moddb.com/mods/goldeneye-mod/downloads/) | goldeneye | mp.dll | :x: +| [Headcrab Frenzy](http://www.moddb.com/mods/headcrab-frenzy/downloads/) | hcfrenzy | hcfrenzy.dll | hcfrenzy.so +| [Half-Life 1.5: Weapon Edition](http://www.moddb.com/mods/half-life-weapon-edition/downloads/) | hl15we | hl.dll | hl.so +| [HL-Rally](http://www.moddb.com/mods/hl-rally/downloads/) | hlrally | hlrally.dll | hlr.so +| [Holy Wars](http://www.moddb.com/mods/holy-wars/downloads/) | holywars | holywars.dll | hl.so +| [Hostile Intent](http://www.moddb.com/mods/hostile-intent/downloads/) | hostileintent | hl.dll | hl.so +| [International Online Soccer](http://www.moddb.com/mods/international-online-soccer/downloads/) | ios | ios.dll | ios.so +| [Judgement](http://www.moddb.com/mods/judgement/downloads/) | judgedm | mp.dll | judge.so +| [Kanonball](http://www.moddb.com/mods/kanonball/downloads/) | kanonball | kanonball.dll | hl.so +| [Monkeystrike](http://www.moddb.com/mods/monkeystrike/downloads/) | monkeystrike | monkey.dll | ms.so +| [Morbid Inclination](http://www.moddb.com/mods/morbid-inclination/downloads/) | MorbidPR | morbid.dll | morbid.so +| [Move In!](http://www.moddb.com/mods/move-in/downloads/) | movein | hl.dll | hl.so +| [Master Sword](http://www.moddb.com/mods/master-sword/downloads/) [Continued](http://www.moddb.com/mods/master-sword-continued-111/downloads) | msc | ms.dll | :x: +| [Natural Selection](https://unknownworlds.com/ns/) | ns | ns.dll | ns.so +| [Natural Selection Beta](https://unknownworlds.com/ns/) | nsp | ns.dll | ns.so +| [Over Ground](http://www.moddb.com/mods/over-ground/downloads/) | og | og.dll | og.so +| [Outlawsmod](http://www.moddb.com/mods/outlaws/downloads/) | ol | hl.dll | ol.so +| [Operations 1942](http://www.moddb.com/mods/operations-1942/downloads/) | ops1942 | spirit.dll | spirit.so +| [Open-Source Jailbreak](http://www.moddb.com/mods/open-source-jailbreak/downloads/) | osjb | jail.dll | osjb.so +| [Out Break](http://www.moddb.com/mods/outbreak-half-life/downloads/) | outbreak | hl.dll | :x: +| [Oz Deathmatch](http://ozdeathmatch.com/) | oz | mp.dll | mp.so +| [Paintball](http://www.bloodvayne.com/hlpb/downloads.htm) | paintball | mp.dll | pb.so +| [Public Enemy](http://www.moddb.com/mods/public-enemy/downloads/) | penemy | pe.dll | pe.so +| [Point of No Return](http://www.moddb.com/mods/point-of-no-return/downloads/) | ponreturn | mp.dll | ponr.so +| [Pirates, Vikings and Knights](http://www.moddb.com/mods/pirates-vikings-and-knights/downloads/) | pvk | hl.dll | hl.so +| [Rocket Crowbar 2](http://www.moddb.com/mods/rocket-crowbar-2/downloads/) | rc2 | rc2.dll | rc2.so +| [Resident Evil : Cold Blood](http://www.moddb.com/mods/resident-evil-cold-blood/downloads/) | recbb2 | recb.dll | recb.so +| [Gunman Chronicles](http://www.moddb.com/games/gunman-chronicles/downloads/gunman-chronicles-steam-version/) | rewolf | gunman.dll | :x: +| [Ricochet](http://store.steampowered.com/app/60/Ricochet/) | ricochet | mp.dll | ricochet.so +| [Rocket Crowbar](http://hldm.org/files/mods/287-rocket-crowbar.html) | rockcrowbar | rc.dll | rc.so +| [Rival Species](http://www.rivalspecies.com/files.php) | rspecies | hl.dll | hl.so +| [Scientist Hunt](http://www.moddb.com/mods/scientist-hunt/downloads/) | scihunt | shunt.dll | shunt.so +| [The Ship](http://www.moddb.com/mods/the-ship) | ship | ship.dll | ship.so +| [Science & Industry](http://www.moddb.com/mods/science-and-industry/downloads/) | si | si.dll | si.so +| [Snow-War](http://www.moddb.com/mods/snow-war/downloads/) | snow | snow.dll | snow.so +| [StargateTC (Old, 1.x)](http://www.moddb.com/mods/stargatetc/downloads/) | stargatetc | hl.dll | hl.so +| [StargateTC (Updated, 2.x)](http://www.moddb.com/mods/stargatetc/downloads/) | stargatetc | hl.dll | stc.so +| [StargateTC (Updated, 2.x)](http://www.moddb.com/mods/stargatetc/downloads/) | stargatetc | hl.dll | stc_i386_opt.so +| [Sven Coop (Old)](http://store.steampowered.com/app/225840/Sven_Coop/) | svencoop | hl.dll | hl.so +| [Sven Coop (Steam)](http://store.steampowered.com/app/225840/Sven_Coop/) | svencoop | server.dll | server.so +| [Swarm](http://www.moddb.com/mods/swarm/downloads) | swarm | swarm.dll | swarm.so +| [Team Fortress Classic](http://store.steampowered.com/app/20/Team_Fortress_Classic/) | tfc | tfc.dll | tfc.so +| [The Wastes](http://www.moddb.com/mods/the-wastes/downloads/) | thewastes | thewastes.dll | thewastes.so +| [Project Timeless](http://www.moddb.com/mods/project-timeless/downloads/) | timeless | timeless.dll | pt.so +| [Tour of Duty](http://www.moddb.com/mods/tour-of-duty/downloads/) | tod | hl.dll | hl.so +| [Train Hunters](http://www.moddb.com/games/half-life/addons?filter=t&kw=Train+Hunters&category=&licence=&timeframe=) | trainhunters | th.dll | th.so +| [The Specialists](http://www.moddb.com/mods/the-specialists/downloads/) | ts | mp.dll | ts.so +| [The Trenches](http://www.moddb.com/mods/the-trenches-half-life/downloads/) | tt | tt.dll | tt.so +| [Underworld Bloodline](http://www.moddb.com/mods/underworld-bloodline/downloads/) | underworld | uw.dll | uw.so +| [Half-Life](http://store.steampowered.com/app/70/HalfLife/) | valve | hl.dll | hl.so +| [VampireSlayer](http://www.moddb.com/mods/vampire-slayer/downloads/) | vs | mp.dll | vs.so +| [Wanted!](http://www.moddb.com/mods/wanted-the-western-mod-steam/downloads/) | wantedhl | wanted.dll | hl.so +| [Wizard Wars (Steam)](http://www.moddb.com/mods/wizard-wars/downloads/) | wizardwars | wizardwars.dll | wizardwars.so +| [Wizard Wars Beta (Steam)](http://www.moddb.com/mods/wizard-wars/downloads/) | wizardwars_beta | wizardwars.dll | wizardwars.so +| [Wizard Wars (Old)](http://www.moddb.com/mods/wizard-wars/downloads/) | wizwars | mp.so | hl.dll +| [WormsHL](http://www.moddb.com/mods/wormshl/downloads/) | wormshl | wormshl.dll | wormshl.so +| [Zombie Panic](http://www.moddb.com/mods/zombie-panic/downloads/) | zp | mp.dll | hl.so + +*** +Любое содействие и вклад в проект - приветствуется. Чем больше тестов с вашей стороны и обратной связи, тем сильнее развитие Metamod-r и остальных связанных продуктов. Удачи! diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/04-compilling.md b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/04-compilling.md new file mode 100644 index 0000000..20831d1 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/04-compilling.md @@ -0,0 +1,76 @@ +--- +id: metamod-r-compilling +title: Compilling +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/compilling +--- + +# Compilling + +## Build instructions +### Checking requirements +Для сборки Metamod-r существует несколько программных требований: + +#### Windows +
+Visual Studio 2015 (C++14 standard) and later
+
+ +#### Linux +
+git >= 1.8.5
+cmake >= 3.10
+GCC >= 4.9.2 (Optional)
+ICC >= 15.0.1 20141023 (Optional)
+LLVM (Clang) >= 6.0 (Optional)
+
+ +### Building + +#### Windows +Используйте `Visual Studio` для сборки, откройте `msvc/metamod.sln` и просто выберите из списка конфигураций решения `Release` или `Debug`. + +#### Linux + +* Дополнительные параметры с использованием `build.sh --compiler=[gcc] --jobs=[N] -D[option]=[ON или OFF]` (без квадратных скобок) + +
+-c=|--compiler=[icc|gcc|clang]  - Выберите предпочтительный компилятор C/C++ для сборки
+-j=|--jobs=[N]                  - Указывает количество заданий (команд), которые нужно выполнить одновременно (для более быстрой сборки)
+
+Definitions (-D)
+DEBUG                           - Включает режим отладки
+USE_STATIC_LIBSTDC              - Включает статическую линковку библиотеки libstdc++
+
+ +* ICC
./build.sh --compiler=intel
+* LLVM (Clang)
./build.sh --compiler=clang
+* GCC
./build.sh --compiler=gcc
+ +##### Проверка среды сборки (Debian / Ubuntu) + +
+Нажмите, чтобы развернуть + +
    +
  • +Установка необходимых пакетов +
    +sudo dpkg --add-architecture i386
    +sudo apt-get update
    +sudo apt-get install -y gcc-multilib g++-multilib
    +sudo apt-get install -y build-essential
    +sudo apt-get install -y libc6-dev libc6-dev-i386
    +
    +
  • + +
  • +Выберите предпочтительную установку компилятора C/C++ +
    +1) sudo apt-get install -y gcc g++
    +2) sudo apt-get install -y clang
    +
    +
  • +
+ +
\ No newline at end of file diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/05-credits.md b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/05-credits.md new file mode 100644 index 0000000..469854a --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/05-credits.md @@ -0,0 +1,26 @@ +--- +id: metamod-r-credits +title: Credits +description: Metamod-r is an optimized version of the original Metamod, enhancing performance and compatibility for Half-Life 1 servers. +slug: /metamod-r/credits +--- + +# Credits + +**Metamod-r** основан на оригинальной версии [Metamod](http://metamod.org/), написанной _Will Day_ для Half-Life 1 с некоторыми улучшениями от _[Jussi Kivilinna](https://github.com/jkivilin)_ ([Metamod-p](https://github.com/jkivilin/metamod-p)). Данный продукт содержит большое количество оптимизаций производительности и более чистый код. Ядро было написано с использованием JIT-компилятора. + +**Metamod-r несовместим с оригинальным `HLDS`. Необходимо иметь заранее установленный [ReHLDS](https://github.com/rehlds/ReHLDS) (`API 3.1+`). Нет гарантий, что metamod-r запустится с оригинальной версией HLDS.** + +Распространяется под лицензией [![GitHub license](https://img.shields.io/github/license/rehlds/metamod-r.svg?style=flat-square)](https://github.com/rehlds/metamod-r/blob/master/LICENSE). + +## ![](https://i.imgur.com/pej4HBX.png) Контакты и ссылки +* ![](https://i.imgur.com/vqDiJ67.png) Will Day, `willday@metamod.org` — оригинальный [Metamod](http://www.metamod.org/), +* ![](https://i.imgur.com/Uy97ydR.png) [Jussi Kivilinna](https://github.com/jkivilin) — [Metamod-p](https://github.com/jkivilin/metamod-p), +* ![](https://i.imgur.com/Uy97ydR.png) [AlliedModders](https://github.com/alliedmodders) — [Metamod-am](https://github.com/alliedmodders/metamod-hl1), +* ![](https://i.imgur.com/Uy97ydR.png) [theAsmodai](https://github.com/rehlds/), ![](https://i.imgur.com/vqDiJ67.png) + [ReHLDS Team](http://www.dedicated-server.ru/vbb/) — [Metamod-r](https://github.com/rehlds/metamod-r). + +## ![](https://i.imgur.com/i6iU6vZ.png) Документация +* Перевод на русский - ![](https://i.imgur.com/Uy97ydR.png) [STAM](https://github.com/stamepicmorg),![](https://i.imgur.com/Uy97ydR.png) [AurZum](https://github.com/Aleks-Z). +* Перевод на английский - ![](https://i.imgur.com/Uy97ydR.png) [AEnimka](https://github.com/AEnimka). +* Использованы иконки от ![](https://i.imgur.com/vqDiJ67.png) [Freepik](https://www.flaticon.com/authors/freepik), ![](https://i.imgur.com/vqDiJ67.png) [Dave Gandy](https://www.flaticon.com/authors/dave-gandy). \ No newline at end of file diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/index.md b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/index.md index 98c8be2..b566bcc 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/index.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/core-projects/Metamod-R/index.md @@ -7,7 +7,7 @@ slug: /metamod-r # Что такое Metamod-r? -Metamod-r — это улучшенная версия оригинального Metamod, менеджера плагинов/DLL, который функционирует как промежуточный слой между движком Half-Life и игровым модом. Такой подход позволяет динамически загружать и выгружать DLL-плагины, добавляя возможность кастомизации серверов Half-Life или любых игровых модов на этом движке. +Metamod-r — это улучшенная версия оригинального [Metamod](http://metamod.org/), написанного _Will Day_ для Half-Life 1 с некоторыми улучшениями от _[Jussi Kivilinna](https://github.com/jkivilin)_ ([Metamod-p](https://github.com/jkivilin/metamod-p)), менеджера плагинов/DLL, который функционирует как промежуточный слой между движком Half-Life и игровым модом. Такой подход позволяет динамически загружать и выгружать DLL-плагины, добавляя возможность кастомизации серверов Half-Life или любых игровых модов на этом движке. Основанный на оригинальном Metamod, разработанном Уиллом Дэем, Metamod-r включает в себя значительные улучшения, такие как оптимизация кода и повышенная производительность, при полном сохранении совместимости со всеми плагинами, созданными для Metamod. Ключевые улучшения в Metamod-r включают оптимизации из Metamod-p, более ранней модифицированной версии от Юсси Кивилинны, а также дополнительные доработки. diff --git a/scripts/fetchRepositories.ts b/scripts/fetchRepositories.ts index ac05f46..6616e5f 100644 --- a/scripts/fetchRepositories.ts +++ b/scripts/fetchRepositories.ts @@ -15,17 +15,17 @@ interface Repository { const repos: { author: string; repo: string }[] = [ { author: 'rehlds', repo: 'rehlds' }, - { author: 's1lentq', repo: 'ReGameDLL_CS' }, - { author: 's1lentq', repo: 'reapi' }, - // { author: 's1lentq', repo: 'resemiclip' }, - // { author: 's1lentq', repo: 'reunion' }, - // { author: 's1lentq', repo: 'rechecker' }, - // { author: 's1lentq', repo: 'revoice' }, - // { author: 's1lentq', repo: 'refreelook' }, - // { author: 's1lentq', repo: 'localizebugfix' }, + { author: 'rehlds', repo: 'ReGameDLL_CS' }, + { author: 'rehlds', repo: 'reapi' }, + // { author: 'rehlds', repo: 'resemiclip' }, + // { author: 'rehlds', repo: 'reunion' }, + // { author: 'rehlds', repo: 'rechecker' }, + // { author: 'rehlds', repo: 'revoice' }, + // { author: 'rehlds', repo: 'refreelook' }, + // { author: 'rehlds', repo: 'localizebugfix' }, // { author: 'WPMGPRoSToTeMa', repo: 'SafeNameAndChat' }, // { author: 'rehlds', repo: 'relocalizebugfix' }, - // { author: 's1lentq', repo: 'hitboxtracker' } + // { author: 'rehlds', repo: 'hitboxtracker' } ]; async function fetchLatestRelease(author: string, repo: string): Promise<{ version: string; date: string }> {