Files
MHR-Overlay/README.md
2023-06-10 17:48:58 +03:00

179 lines
7.2 KiB
Markdown

<p align="center">
<h2 align="center"><b>"MHR Overlay" Mod for Monster Hunter: Rise<b/></h2>
<p align="center">Exposes in-game data about monsters, creatures, players and damage. Draws a highly customizable UI.</p>
</p>
<p align="center">
<a href="https://github.com/greencomfytea/mhr-overlay/graphs/contributors">
<img alt="GitHub Contributors" src="https://img.shields.io/github/contributors/greencomfytea/MHR-Overlay" />
</a>
<a href="https://github.com/greencomfytea/mhr-overlay/issues">
<img alt="Issues" src="https://img.shields.io/github/issues/greencomfytea/MHR-Overlay" />
</a>
<a href="https://github.com/greencomfytea/mhr-overlay/pulls">
<img alt="GitHub Pull Requests" src="https://img.shields.io/github/issues-pr/greencomfytea/MHR-Overlay" />
</a>
</p>
<p align="center">
<a href="">
<img src="https://img.shields.io/github/repo-size/greencomfytea/MHR-Overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/search/greencomfytea/MHR-Overlay/goto" />
</a>
<a href="">
<img src="https://img.shields.io/github/sponsors/greencomfytea" />
</a>
<a href="">
<img src="https://img.shields.io/github/issues/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/issues-closed/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/issues-pr/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/issues-pr-closed/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/license/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/followers/greencomfytea?style=social" />
</a>
<a href="">
<img src="https://img.shields.io/github/forks/greencomfytea/mhr-overlay?style=social" />
</a>
<a href="">
<img src="https://img.shields.io/github/stars/greencomfytea/mhr-overlay?style=social" />
</a>
<a href="">
<img src="https://img.shields.io/github/watchers/greencomfytea/mhr-overlay?style=social" />
</a>
<a href="">
<img src="https://img.shields.io/twitch/status/greencomfytea?style=social" />
</a>
<a href="">
<img src="https://img.shields.io/twitter/follow/GreenComfyTea?style=social" />
</a>
<a href="">
<img src="https://img.shields.io/github/v/release/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/website?down_color=red&down_message=down&up_color=green&up_message=up&url=https://www.nexusmods.com/monsterhunterrise/mods/50" />
</a>
<a href="">
<img src="https://img.shields.io/github/commit-activity/w/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/commit-activity/m/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/commit-activity/y/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/commit-activity/t/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/commits-since/greencomfytea/mhr-overlay/latest" />
</a>
<a href="">
<img src="https://img.shields.io/github/last-commit/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/github/release-date/greencomfytea/mhr-overlay" />
</a>
<a href="">
<img src="https://img.shields.io/maintenance/yes/2023" />
</a>
</p>
**This mod is solely intended to empower players with means of self-improvement. Please don't use the information provided by this tool to make hurtful comments and actions toward other players.**
![50-1659789731-551420562](https://user-images.githubusercontent.com/30152047/183250401-9f2898dd-feb4-4903-802c-c9d398261f11.png)
# Links
* **[Nexus Mods](https://www.nexusmods.com/monsterhunterrise/mods/50)**
* **[Wiki](https://github.com/GreenComfyTea/MHR-Overlay/wiki)**
* **[FAQ](https://github.com/GreenComfyTea/MHR-Overlay/wiki/FAQ)**
* **[Requirements and Installation](https://github.com/GreenComfyTea/MHR-Overlay/wiki/Requirements-and-Installation)**
* **[Features](https://github.com/GreenComfyTea/MHR-Overlay/wiki/Features)**
* **[Troubleshooting](https://github.com/GreenComfyTea/MHR-Overlay/wiki/Troubleshooting)**
# Requirements
1. [REFramework](https://www.nexusmods.com/monsterhunterrise/mods/26) (v1.503 or above);
2. [REFramework Direct2D](https://www.nexusmods.com/monsterhunterrise/mods/134) (v0.4.0 or above) - Needed for Unicode Support.
# How to install:
1. Install [REFramework](https://www.nexusmods.com/monsterhunterrise/mods/26);
2. Install [REFramework Direct2D](https://www.nexusmods.com/monsterhunterrise/mods/134);
>**:pushpin: Windows:** Works normally.
>**:pushpin: Linux:** Latest Experimental Proton seems to have it working normally as well (https://github.com/cursey/reframework-d2d/issues/5).
>**:pushpin: Steam Deck:** I've seen people getting it working but I don't have the exact instructions. You will have to figure it out yourself and/or search the nexus pages for information ([REFramework](https://www.nexusmods.com/monsterhunterrise/mods/26?tab=description), [REFramework Direct2D](https://www.nexusmods.com/monsterhunterrise/mods/134), [MHR Overlay](https://www.nexusmods.com/monsterhunterrise/mods/50)).
3. Download the mod:
* Official release can be downloaded from [Nexus Mods](https://www.nexusmods.com/monsterhunterrise/mods/50);
* Nightly builds are available in [this repo](https://github.com/GreenComfyTea/MHR-Overlay) and can contain broken functionality, debugging info on screen, bugs and might require the latest [nightly build](https://github.com/praydog/REFramework-nightly/releases) of [REFramework](https://www.nexusmods.com/monsterhunterrise/mods/26). Use with caution!
4. Extract the mod from the archive and place it in MonsterHunterRise folder. Refer to [FAQ](https://github.com/GreenComfyTea/MHR-Overlay/wiki/FAQ) to verify how the file hierarchy should look like if everything is done correctly.
# Credits
**GreenComfyTea** - creator of the mod and it's main contributor.
**cursecat** - creator of [REFramework](https://www.nexusmods.com/monsterhunterrise/mods/26), [REFramework Direct2D](https://www.nexusmods.com/monsterhunterrise/mods/134) plugin and [Monster Has HP Bar](https://www.nexusmods.com/monsterhunterrise/mods/43) mod, which provided an example on how to retrieve monster HP data.
**praydog2** - creator of [REFramework](https://www.nexusmods.com/monsterhunterrise/mods/26). Contributed huge improvements to the performance of the mod.
**coavins** - creator of [coavins damage meter](https://www.nexusmods.com/monsterhunterrise/mods/68) mod.
**neatnet** - Korean translation.
**s9000008, mcc1** - Traditional Chinese translation.
**etnAtker**, **sukiqwq** - Simplified Chinese translation.
**AKILAND0214** - Japanese translation.
***
# 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>