docs: rework README and added wiki (#1151)
This commit is contained in:
parent
28707968a7
commit
a8750a30fb
93
README.md
93
README.md
@ -11,88 +11,22 @@ So here I am with an up-to-date menu focusing on protecting the user from toxic
|
|||||||
## Table of contents
|
## Table of contents
|
||||||
|
|
||||||
* [How to build](#how-to-build)
|
* [How to build](#how-to-build)
|
||||||
* [Curl](#curl)
|
* [Make your own flavour of YimMenu](#make-your-own-flavour-of-yimmenu)
|
||||||
* [Git](#git)
|
|
||||||
* [CMake](#CMake)
|
|
||||||
* [Cloning and generating project files](#cloning-and-generating-project-files)
|
|
||||||
* [Staying Up To Date](#staying-up-to-date)
|
* [Staying Up To Date](#staying-up-to-date)
|
||||||
* [Project Structure](#project-structure)
|
* [Project Structure](#project-structure)
|
||||||
* [Features](#features)
|
* [Features](#features)
|
||||||
* [Contributing](#contributing)
|
* [Contributing](#contributing)
|
||||||
|
|
||||||
## How to build
|
## How to compile YimMenu
|
||||||
|
|
||||||
Requirements:
|
Read the [SETUP](https://github.com/YimMenu/YimMenu/wiki/Setup-your-PC-for-YimMenu-Development) guide.
|
||||||
|
|
||||||
* [Git](#git)
|
## Make your own flavour of YimMenu
|
||||||
* [CMake](#cmake)
|
|
||||||
|
|
||||||
If you have both of the above requirements you can skip to [cloning the git repo and generating the project files](#cloning-and-generating-project-files).
|
Fork YimMenu and git clone that repository instead of https://github.com/YimMenu/YimMenu.git
|
||||||
|
|
||||||
### Curl
|
Click the below link to make your own fork of YimMenu:
|
||||||
|
https://github.com/YimMenu/YimMenu/fork
|
||||||
Curl should be already installed on your computer, but if you are having issues with building the project, you will need to download and install
|
|
||||||
it.
|
|
||||||
|
|
||||||
[Download Link](https://curl.se/download.html)
|
|
||||||
|
|
||||||
### Git
|
|
||||||
|
|
||||||
If you haven't installed git on your system go and do so as it is **REQUIRED** for setting up a working build environment.
|
|
||||||
|
|
||||||
[Download Link](https://git-scm.com/download/win)
|
|
||||||
|
|
||||||
### CMake
|
|
||||||
|
|
||||||
CMake is used to generate our project files, if you haven't used it before you will need to download and install it.
|
|
||||||
|
|
||||||
[Download Link](https://cmake.org/download/)
|
|
||||||
|
|
||||||
### Cloning and generating project files
|
|
||||||
|
|
||||||
- Make sure that you have installed Git and CMake.
|
|
||||||
|
|
||||||
- Clone the repository:
|
|
||||||
```bash
|
|
||||||
git clone https://github.com/YimMenu/YimMenu.git
|
|
||||||
```
|
|
||||||
|
|
||||||
- Go into the directory you just cloned:
|
|
||||||
```bash
|
|
||||||
cd YimMenu
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Generate project files
|
|
||||||
|
|
||||||
> **Note**
|
|
||||||
> You will have cd build and cmake again if you add any files or you will get an error when building.
|
|
||||||
|
|
||||||
- Windows Only
|
|
||||||
|
|
||||||
- Visual Studio
|
|
||||||
|
|
||||||
If you only use Visual Studio and don't want to mess with command lines, Visual Studio has a CMake extension that does all the work.
|
|
||||||
|
|
||||||
Make sure it is [installed](https://learn.microsoft.com/en-us/cpp/build/cmake-projects-in-visual-studio?view=msvc-170#installation).
|
|
||||||
|
|
||||||
Then, just open Visual Studio, open a local folder, and select the `YimMenu` folder that the `git clone` command just created.
|
|
||||||
|
|
||||||
Let the CMake extension generate the needed files for building, you can follow the progress in the Output tab of Visual Studio.
|
|
||||||
|
|
||||||
Then, you can just build by using the Build menu at the top and clicking Build All.
|
|
||||||
|
|
||||||
|
|
||||||
- Other OSs / IDEs
|
|
||||||
|
|
||||||
If you use something else or prefer using the console on Windows, just follow this:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
mkdir build
|
|
||||||
cd build
|
|
||||||
cmake ..
|
|
||||||
```
|
|
||||||
|
|
||||||
Now, you will be able to open the solution, and build it.
|
|
||||||
|
|
||||||
## Staying Up To Date
|
## Staying Up To Date
|
||||||
|
|
||||||
@ -106,7 +40,7 @@ git pull
|
|||||||
|
|
||||||
CMake should be handling removed / added files automatically without any user input.
|
CMake should be handling removed / added files automatically without any user input.
|
||||||
|
|
||||||
If this is not the case for some reason you'll have to redo the steps in the [Generate project files](#generate-project-files) section above.
|
If this is not the case for some reason you'll have to redo the steps in the [Making changes to the source code section of the SETUP](https://github.com/YimMenu/YimMenu/wiki/Setup-your-PC-for-YimMenu-Development#making-changes-to-the-source-code).
|
||||||
|
|
||||||
If you are doing custom modifications to the codebase and have a fork you are on your own for staying up to date with upstream (this repository), google stuff like "merge from upstream" and learn how to use Git.
|
If you are doing custom modifications to the codebase and have a fork you are on your own for staying up to date with upstream (this repository), google stuff like "merge from upstream" and learn how to use Git.
|
||||||
|
|
||||||
@ -119,17 +53,6 @@ If you are doing custom modifications to the codebase and have a fork you are on
|
|||||||
- `services/` service files to interact and maintain stuff
|
- `services/` service files to interact and maintain stuff
|
||||||
- `util/` general utility functions to keep code as compact and as much in one place as possible
|
- `util/` general utility functions to keep code as compact and as much in one place as possible
|
||||||
|
|
||||||
## Features
|
|
||||||
|
|
||||||
Below is an incomplete list of feature that I believe are notable to this "base" or menu.
|
|
||||||
|
|
||||||
- Return Native spoofing
|
|
||||||
- Custom [settings](src/core/globals.hpp) with deep compare if changes were made, including auto saving
|
|
||||||
- Clear and well structured source code
|
|
||||||
- Includes a thread pool to queue tasks that shouldn't block the game thread, very similar to fiber pool
|
|
||||||
- Updated natives.hpp from https://nativedb.spyral.dev
|
|
||||||
- ReClass.NET structures implemented, accessible from a global called g_local_player defined in `common.hpp`
|
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
You're free to contribute to YimMenu as long as the features are useful, not overly toxic and do not contain anything money related that might get the menu targeted by Take2.
|
You're free to contribute to YimMenu as long as the features are useful, not overly toxic and do not contain anything money related that might get the menu targeted by Take2.
|
||||||
|
Reference in New Issue
Block a user