<p align="center">
	<h2 align="center"><b>"Better Matchmaking" Mod for Monster Hunter: World</b></h2>
	<p align="center">Mod that disables Steam Region Lock, increases Max Search Result Count, provides Improved Search Filters and some custom filters. </p>
</p>

<p align="center">
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/graphs/contributors">
		<img alt="Contributors" src="https://custom-icon-badges.demolab.com/github/contributors/GreenComfyTea/MHW-Better-Matchmaking?logo=person-add" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/issues">
		<img alt="Issues" src="https://custom-icon-badges.demolab.com/github/issues/GreenComfyTea/MHW-Better-Matchmaking?logo=issue-opened" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/issues">
		<img alt="Issues Closed" src="https://custom-icon-badges.demolab.com/github/issues-closed/GreenComfyTea/MHW-Better-Matchmaking?logo=issue-closed" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/pulls">
		<img alt="Pull Requests" src="https://custom-icon-badges.demolab.com/github/issues-pr/GreenComfyTea/MHW-Better-Matchmaking?logo=git-pull-request" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/pulls">
		<img alt="Pull Requests Closed" src="https://custom-icon-badges.demolab.com/github/issues-pr-closed/GreenComfyTea/MHW-Better-Matchmaking?logo=git-pull-request-closed" />
	</a>
	<br>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/blob/main/LICENSE">
		<img alt="License" src="https://custom-icon-badges.demolab.com/github/license/GreenComfyTea/MHW-Better-Matchmaking?logo=law" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/releases">
		<img alt="Release Version" src="https://custom-icon-badges.demolab.com/github/v/release/GreenComfyTea/MHW-Better-Matchmaking?logo=tag" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/releases">
		<img alt="Release Date" src="https://custom-icon-badges.demolab.com/github/release-date/GreenComfyTea/MHW-Better-Matchmaking?logo=clock" />
	</a>
	<a href="">
		<img alt="Platform" src="https://custom-icon-badges.demolab.com/badge/platform-win-blue?logo=device-desktop" />
	</a>
	<a href="">
		<img alt="Maintenance" src="https://custom-icon-badges.demolab.com/maintenance/yes/2024?logo=tools" />
	</a>
	<br>
	<a href="https://www.nexusmods.com/monsterhunterworld/mods/1982">
		<img alt="Stracker's Loader Dependency" src="https://custom-icon-badges.demolab.com/badge/dependency-Stracker%27s Loader%20v3.0.1+-brightgreen?logo=package-dependencies" />
	</a>
	<a href="https://dotnet.microsoft.com/en-us/download/dotnet/8.0">
		<img alt=".NET Dependency" src="https://custom-icon-badges.demolab.com/badge/dependency-.NET%20v8.0-brightgreen?logo=package-dependencies" />
	</a>
	<a href="https://github.com/Fexty12573/SharpPluginLoader">
		<img alt="SharpPluginLoader Dependency" src="https://custom-icon-badges.demolab.com/badge/dependency-SharpPluginLoader%20v0.0.7.1-brightgreen?logo=package-dependencies" />
	</a>
	<br>
	<br>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking-Nightly/releases">
		<img alt="Build" src="https://custom-icon-badges.demolab.com/github/actions/workflow/status/GreenComfyTea/MHW-Better-Matchmaking/build-and-create-release.yml?logo=mark-github" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/commits/main">
		<img alt="Commits" src="https://custom-icon-badges.demolab.com/github/commit-activity/t/GreenComfyTea/MHW-Better-Matchmaking?logo=git-commit" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/commits/main">
		<img alt="Last Commit" src="https://custom-icon-badges.demolab.com/github/last-commit/GreenComfyTea/MHW-Better-Matchmaking?logo=git-commit" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/commits/main">
		<img alt="Commits Since" src="https://custom-icon-badges.demolab.com/github/commits-since/GreenComfyTea/MHW-Better-Matchmaking/latest?logo=git-commit" />
	</a>
	<br>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/graphs/commit-activity">
		<img alt="Commit Activity (Year)" src="https://custom-icon-badges.demolab.com/github/commit-activity/y/GreenComfyTea/MHW-Better-Matchmaking?logo=pulse" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/graphs/commit-activity">
		<img alt="Commit Activity (Month)" src="https://custom-icon-badges.demolab.com/github/commit-activity/m/GreenComfyTea/MHW-Better-Matchmaking?logo=pulse" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/graphs/commit-activity">
		<img alt="Commit Activity (Week)" src="https://custom-icon-badges.demolab.com/github/commit-activity/w/GreenComfyTea/MHW-Better-Matchmaking?logo=pulse" />
	</a>
	<br>
	<br>
	<a href="">
		<img alt="Repo Size" src="https://custom-icon-badges.demolab.com/github/repo-size/GreenComfyTea/MHW-Better-Matchmaking?logo=database" />
	</a>
	<a href="">
		<img alt="Line Count" src="https://sloc.xyz/github/GreenComfyTea/MHW-Better-Matchmaking" />
	</a>
	<a href="">
		<img alt="Goto Counter" src="https://custom-icon-badges.demolab.com/github/search/GreenComfyTea/MHW-Better-Matchmaking/goto?logo=git-compare" />
	</a>
	<br>
	<a href="https://github.com/sponsors/GreenComfyTea">
		<img alt="Sponsors" src="https://custom-icon-badges.demolab.com/github/sponsors/GreenComfyTea?logo=heart" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/watchers">
		<img alt="Watchers" src="https://custom-icon-badges.demolab.com/github/watchers/GreenComfyTea/MHW-Better-Matchmaking?logo=eye" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/forks">
		<img alt="Forks" src="https://custom-icon-badges.demolab.com/github/forks/GreenComfyTea/MHW-Better-Matchmaking?logo=repo-forked" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/stargazers">
		<img alt="Stars" src="https://custom-icon-badges.demolab.com/github/stars/GreenComfyTea/MHW-Better-Matchmaking?logo=star" />
	</a>
	<a href="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/graphs/traffic">
		<img alt="Hits" src="https://custom-icon-badges.demolab.com/endpoint?url=https://hits.dwyl.com/GreenComfyTea/MHW-Better-Matchmaking.json?color=blue&logo=eye" />
	</a>
	<br>
	<br>
	<a href="https://nexusmods.com/monsterhunterworld/mods/7263">
		<img alt="Website" src="https://custom-icon-badges.demolab.com/website?down_color=red&down_message=down&up_color=brightgreen&up_message=up&logo=link&url=https://nexusmods.com/monsterhunterworld/mods/7263" />
	</a>
	<a href="https://github.com/GreenComfyTea?tab=followers">
		<img alt="Followers" src="https://custom-icon-badges.demolab.com/github/followers/GreenComfyTea?logo=people" />
	</a>
	<a href="https://twitter.com/GreenComfyTea">
		<img alt="Twitter" src="https://img.shields.io/twitter/follow/GreenComfyTea?logo=twitter" />
	</a>
	<a href="https://mhwtwitch.tv/GreenComfyTea">
		<img alt="Twitch" src="https://img.shields.io/twitch/status/GreenComfyTea?logo=twitch" />
	</a>
	<br>
	<a href="https://github.com/GreenComfyTea">
		<img alt="Author" src="https://custom-icon-badges.demolab.com/badge/author-GreenComfyTea-green?logo=person" />
	</a>
  <a href="https://github.com/Fexty12573">
		<img alt="Author" src="https://custom-icon-badges.demolab.com/badge/author-Fexty12573-green?logo=person" />
	</a>
	<a href="https://github.com/topics/open-source">
		<img alt="Open Source" src="https://img.shields.io/badge/open%20source-%20yes-brightgreen?logo=openvpn" />
	</a>
	<a href="https://fexty12573.github.io/SharpPluginLoader/">
		<img alt="Written in" src="https://custom-icon-badges.demolab.com/badge/written%20in-c%23-178600?logo=terminal" />
	</a>
</p>

<p align="center">
	<a>
		<img align="center" src="https://github.com/GreenComfyTea/MHW-Better-Matchmaking/assets/30152047/c192bcb6-c7f2-4207-a348-d784ee73bdfd" />
	</a>
</p>

# Links
* **[Nexus Mods](https://nexusmods.com/monsterhunterworld/mods/7263)**
* **[Nightly Builds](https://github.com/GreenComfyTea/MHW-Better-Matchmaking-Nightly/releases)**

# Features
1. Steam Region Lock Fix;
2. Increased Max Search Result Count (from 20 to 32);
3. Custom Session Player Count Filter;
4. Improved In-Game Search Filters (overrides one of the existing option and allows to search by several options at the same time).

# Requirements
1. **[Stracker's Loader v3.0.1+](https://www.nexusmods.com/monsterhunterworld/mods/1982)**;
2. **[.NET 8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)**;
3. **[SharpPluginLoader v0.0.7.1](https://github.com/Fexty12573/SharpPluginLoader)** (Other versions are not guaranteed to work).

# How to Install
1. Install **[Stracker's Loader](https://www.nexusmods.com/monsterhunterworld/mods/1982)**;
2. Install **[.NET 8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)** (Get the **.NET Desktop Runtime 8.0.x 64-bit**);
3. Install **[SharpPluginLoader](https://github.com/Fexty12573/SharpPluginLoader)**;
4. Download the mod:
    * Official release can be downloaded from **[Nexus Mods](https://nexusmods.com/monsterhunterworld/mods/7263)**;
    * Nightly builds are available in **[this repo](https://github.com/GreenComfyTea/MHW-Better-Matchmaking)** and can contain broken functionality, debugging info on screen, bugs and might require latest unreleased version of **[SharpPluginLoader](https://github.com/Fexty12573/SharpPluginLoader)**. Use with caution!
5. Extract the mod from the archive and place it in the game root folder: **/Monster Hunter World/**.

# How to Use
1. Open `SharpPluginLoader`﻿ menu by pressing `F9` key  (can be changed in `loader-config.json`);
2. Press `Better Matchmaking` button;
3. Configure according to your needs.

# For Translators
The mod has support for localizations. If you wish to translate the mod, follow these steps:
1. Verify that the localization doesn't exist (**[Link](https://github.com/GreenComfyTea/MHW-Better-Matchmaking/tree/main/BetterMatchmaking/data/localizations)**);
2. Go to `Monster Hunter World\nativePC\plugins\CSharp\BetterMatchmaking\data\localizations\` folder. There should be `en-us.json` file. If not, launch the game once, the file will be regenerated;
3. Copy-paste the file and give it a new name. Any format is supported but I expect it to be `ISO language code` for uniformity reasons;
4. Open the file with any text editor and translate the strings;
5. Make an issue/pull request, or dm me on **[Twitter](https://twitter.com/GreenComfyTea)**, to submit your localization. I will check it and include it in the next release.

> [!IMPORTANT]
> Each localization must provide unicode glyph ranges to load. You can take the ranges **[here](https://github.com/Fexty12573/SharpPluginLoader/blob/master/SharpPluginLoader.Core/Rendering/GlyphRangeFactory.cs)** and **[here](https://jrgraphix.net/r/Unicode/)**.

> [!IMPORTANT]
> Put the font you want to use in `\Monster Hunter World\nativePC\plugins\CSharp\BetterMatchmaking\data\fonts\` folder. The font must be `static`. Only `.OTF` and `.TTF` fonts are supported.

> [!IMPORTANT]
> **SharpPluginLoader doesn't support font hot-reload. So adding/changing a font will require game restart.** This applies to both localization file changes (font name, glyph ranges) and config changes (font size, oversample).

### Example:
```JSON
"FontInfo": {
	"Name": "NotoSans-Bold.ttf",
	"GlyphRanges": [
		"0x0020", "0x00FF",
		"0x0370", "0x03FF",
		"0x0400", "0x052F",
		"0x2DE0", "0x2DFF",
		"0xA640", "0xA69F"
	]
},
```

# Credits
**[GreenComfyTea](https://github.com/GreenComfyTea)** - Creator of the mod and it's main contributor;  
**[Fexty12573](https://github.com/Fexty12573)** - Creator of **[SharpPluginLoader](https://github.com/Fexty12573/SharpPluginLoader)**. Implemented an interface for Steam Matchmaking API. Provided invaluable help on figuring out how matchmaking works;  
**[elappale](https://github.com/elappale)** - Japanese translator;  
**[Alpha-Cyg](https://github.com/Alpha-Cyg)** - Traditional Chinese translator;  
**[Narugakuruga](https://github.com/Narugakuruga)** - Simplified and Traditional Chinese translator;  
**[BlacklightsC](https://github.com/BlacklightsC)** - Korean translator.  
 
***
# Support

You can support me by donating! I would appreciate it! But anyway, thank you for using this mod!

 <a href="https://streamelements.com/GreenComfyTea/tip">
  <img alt="Qries" src="https://panels.twitch.tv/panel-48897356-image-c6155d48-b689-4240-875c-f3141355cb56">
</a>
<a href="https://ko-fi.com/GreenComfyTea">
  <img alt="Qries" src="https://panels.twitch.tv/panel-48897356-image-c2fcf835-87e4-408e-81e8-790789c7acbc">
</a>

