Skip to content

Commit 4de3e34

Browse files
committed
Add Wine installation script
1 parent a448a1e commit 4de3e34

File tree

2 files changed

+14
-2
lines changed

2 files changed

+14
-2
lines changed

docs/01-mapping-tools/02-installation.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,19 @@ In order to run, you need to have installed **.NET Desktop Runtime 5** with the
3131

3232
### Wine (Linux) {#wine}
3333

34-
You can successfully run Mapping Tools on different operating systems with Wine. Most features will work correctly except memory reading and Geometry Dashboard. I recommend disabling Editor Reader in the Preferences, so Mapping Tools will not attempt memory reading every time it does something.
34+
You can successfully run Mapping Tools on different operating systems with Wine. Most features will work correctly, but memory reading and Geometry Dashboard need some extra consideration.
35+
In order to get memory reading to work, you need to install Mapping Tools into the osu! Wine prefix and run it with the same Wine binary. You also need to open osu! before opening Mapping Tools. If you can not get it to work, I recommend disabling Editor Reader in the Preferences, so Mapping Tools will not attempt memory reading every time it does something.
36+
37+
#### Install script (Recommended)
38+
39+
Use [this install script](https://gist.github.com/night-mareLuna/52c21dabd35d7cd359f9c52b471f0a8f) to automatically install Mapping Tools into your osu! Wine prefix. It will install any dependencies and memory reading should work too. This has been tested with [osu-winello](https://github.com/NelloKudo/osu-winello).
40+
41+
1. Download `install-mappingtools.sh` from the [GitHub gist](https://gist.github.com/night-mareLuna/52c21dabd35d7cd359f9c52b471f0a8f).
42+
2. Start your osu! client.
43+
3. Run: `chmod +x ./install-mappingtools.sh`
44+
4. Run: `./install-mappingtools.sh --install`
45+
46+
#### Manual install
3547

3648
1. Install [WineHQ](https://www.winehq.org/). Follow the installation instructions for your operating system.
3749
2. If you are using an Arch Linux distro, then you need to install GDI+ using Winetricks.

src/pages/faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ These are features that depend on reading the memory of the osu! client. Memory
3131
- Not using the latest version of osu!: Switch off of private servers and update osu! to the latest version.
3232
- osu! updated and changed memory offsets again: Please notify me so the issue can be fixed.
3333
- Using Mapping Tools on Windows 7 or earlier: Make sure you have .NET framework 4.5.1 or later installed.
34-
- Using Mapping Tools on an OS which is not Windows: No solutions for this unfortunately.
34+
- Using Mapping Tools on an OS which is not Windows: Refer to the [Wine instructions](../../docs/mapping-tools/installation#wine).
3535

3636
## How to mute sliderends without copying hitsounds?
3737

0 commit comments

Comments
 (0)