Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Vanilla installer instructions #79

Merged
merged 46 commits into from
Oct 20, 2024
Merged
Show file tree
Hide file tree
Changes from 15 commits
Commits
Show all changes
46 commits
Select commit Hold shift + click to select a range
42c18b2
Update install-instructions.md
Madis0 Apr 15, 2023
cb711a7
Update update-instructions.md
Madis0 Apr 15, 2023
e58cdb9
Update install-instructions.md
Madis0 Apr 15, 2023
8a07f68
Merge branch 'main' into new-cf
Madis0 Apr 15, 2023
f52abd2
Install
Madis0 Apr 16, 2023
4df2d7f
Update
Madis0 Apr 16, 2023
c1b6eda
Merge branch 'main' into multimc-remove
Madis0 Apr 16, 2023
fed2a2d
Merge branch 'main' into multimc-remove
Madis0 Apr 17, 2023
1457406
oops
Madis0 Apr 17, 2023
2daebea
Merge branch 'main' into multimc-remove
Madis0 Apr 17, 2023
33d79d2
Merge branch 'main' into multimc-remove
Madis0 Apr 21, 2023
5862190
Merge branch 'main' into multimc-remove
Madis0 May 3, 2023
39d2597
Merge branch 'main' into multimc-remove
Madis0 May 23, 2023
2042856
Merge branch 'main' into multimc-remove
Madis0 Jun 1, 2023
d0b6a2c
Merge branch 'main' into multimc-remove
Madis0 Aug 6, 2023
e14c3f0
Merge branch 'main' into multimc-remove
Madis0 Feb 12, 2024
daf55d6
Update install-instructions.md
Madis0 Feb 12, 2024
4b3c9a2
Rephrase
Madis0 Feb 12, 2024
82825de
More rephrasing
Madis0 Feb 12, 2024
e40c6d7
And more
Madis0 Feb 12, 2024
a2fd972
Update install-instructions.md
Madis0 Feb 12, 2024
01c8459
Update install-instructions.md
Madis0 Feb 12, 2024
16c5f16
Update update-instructions.md
Madis0 Feb 12, 2024
6b7fee6
Update update-instructions.md
Madis0 Feb 12, 2024
6127eef
Update install-instructions.md
Madis0 Feb 12, 2024
7232e1f
Update install-instructions.md
Madis0 Feb 13, 2024
cac0941
Update update-instructions.md
Madis0 Feb 13, 2024
6fcf67e
Update update-instructions.md
Madis0 Feb 13, 2024
c796362
Merge branch 'main' into multimc-remove
Madis0 Feb 19, 2024
2cd88e7
Update language-support.md
Madis0 Feb 19, 2024
a92cdb4
Update language-support.md
Madis0 Feb 19, 2024
71b9a3d
Update language-support.md
Madis0 Feb 19, 2024
37d76a8
Merge branch 'main' into multimc-remove
Madis0 Feb 19, 2024
f28fc18
Update install-instructions.md
Madis0 Feb 20, 2024
babe598
Merge branch 'main' into multimc-remove
Madis0 Apr 3, 2024
128bc4e
Merge branch 'main' into multimc-remove
Madis0 Jul 23, 2024
d8d35fd
Merge branch 'main' into multimc-remove
Madis0 Sep 14, 2024
9512ad0
Update install-instructions.md
Madis0 Sep 14, 2024
25141a5
Update install-instructions.md
Madis0 Sep 14, 2024
8bb05a5
Update update-instructions.md
Madis0 Sep 14, 2024
5f8b6de
Update update-instructions.md
Madis0 Sep 14, 2024
36d4ecd
Update install-instructions.md
Madis0 Sep 14, 2024
6464da4
Update version-support.md
Madis0 Sep 15, 2024
93967d0
Update install-instructions.md
Madis0 Sep 15, 2024
16bf0a9
Update update-instructions.md
Madis0 Sep 15, 2024
1d01a3f
Merge branch 'main' into multimc-remove
Madis0 Oct 19, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 22 additions & 23 deletions install-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,29 +92,28 @@ You need [Java 17 or higher](https://adoptium.net/) to play the game.

### [Minecraft Launcher](https://www.minecraft.net/en-us/download) (vanilla)

For macOS or Linux [you need Java](https://adoptium.net/) to run the Fabric Installer.
Madis0 marked this conversation as resolved.
Show resolved Hide resolved

1. Download and install [Fabric Loader](https://fabricmc.net/use/) **version 0.14.21**
* Older versions of the modpack - 1.12.3, 2.7.3 and 3.14.1 require the use of Fabric Loader 0.14.12 instead.
* Remember that the _installer version_ doesn't matter, what matters is the _loader version_ that appears when you run the installer.
2. Download some mods manually as needed:
* **FO 5.1.0+**: Download [Sodium](https://modrinth.com/mod/sodium/version/mc1.20-0.4.10)
* **FO 4.11.0**: Download [Sodium](https://modrinth.com/mod/sodium/version/mc1.19.4-0.4.10)
3. Open Minecraft Launcher, click `Installations`, then click 📂 on the Fabric installation
4. Go to [Files](https://www.curseforge.com/minecraft/modpacks/fabulously-optimized/files) on CurseForge
5. Click the topmost version, scroll down to "Additional files" section
6. Click `⋮` → `Download file` on the latest **MultiMC version**
* If you see less than 10 mods in the zip, you downloaded the wrong version.
7. Open the zip file, go to _Fabulously Optimized x.x.x_ > _minecraft_
8. Copy **all folders** from zip's _minecraft_ folder to your _.minecraft_ folder; if asked - replace the files
9. **FO 4.11.0+**: Copy downloaded mod JAR(s) to _mods_ folder
10. It is highly recommended to delete `options.txt` as well to get [FO default settings](changed-options.md)
* Your vanilla options like selected resource packs, language, keybinds will be reset but you can reapply them later.
* If you choose not to do this, it is recommended to at least enable bundled resource packs manually.
11. Launch the installed Fabric profile
12. If you now see "Fabulously Optimized" in the right bottom corner, you're done!

A simple installer for vanilla launcher [is coming soon](https://github.com/Fabulously-Optimized/fabulously-optimized/issues/110)!
#### Windows

1. Open the [releases page](https://github.com/Fabulously-Optimized/vanilla-installer/releases/latest) and download the file with the `.exe` extension. (Example: `Vanilla Installer-GUI v0.1.0.exe`)
2. If it asks you where to save your file, select your Downloads folder (`%USERPROFILE%\Downloads`)
3. Navigate to the Downloads folder and double-click the file you just downloaded.
* If you see a Microsoft Defender SmartScreen prompt, click `More info`, then `Run Anyway`.
4. Select the Minecraft version and directory, and click `Install`.
5. You're all done!

#### macOS

TODO
Madis0 marked this conversation as resolved.
Show resolved Hide resolved

#### Linux

1. Install Python 3.8 or higher (3.11 recommended) from your package manager using one of the following examples:
- Ubuntu: `sudo apt install python3`
- Arch Linux: `sudo pacman -S python3`
- Fedora: `sudo dnf install python3`

2. Run `pip3 install vanilla-installer[gui]`.
3. Then you can run `vanilla-installer-gui` to launch the program. If you have issues, try `python3 -m vanilla_installer gui`.

## Not supported

Expand Down
43 changes: 22 additions & 21 deletions update-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,27 +96,28 @@ If there is a new Minecraft version:

### Minecraft Launcher (vanilla)

Currently the only way to update is to "reinstall" the pack. Consider installing a different launcher for a smoother upgrade experience.

1. Download and install [Fabric Loader](https://fabricmc.net/use/) **version 0.14.21**
* Older versions of the modpack - 1.12.3, 2.7.3 and 3.14.1 require the use of Fabric Loader 0.14.12 instead.
* Remember that the _installer version_ doesn't matter, what matters is the _loader version_ that appears when you run the installer.
2. Open Minecraft Launcher, click `Installations` and then click 📂 on the Fabric installation
3. Delete all files in `mods` folder
* This is to ensure all mods will reflect the latest FO version. You can [add your custom mods back later](adding-more-mods.md).
4. Download some mods manually as needed:
* **FO 5.1.0+**: Download [Sodium](https://modrinth.com/mod/sodium/version/mc1.20-0.4.10)
* **FO 4.11.0**: Download [Sodium](https://modrinth.com/mod/sodium/version/mc1.19.4-0.4.10)
5. Go to [Files](https://www.curseforge.com/minecraft/modpacks/fabulously-optimized/files) on CurseForge
6. Click the topmost version, scroll down to "Additional files" section
7. Click `⋮` → `Download file` on the latest **MultiMC version**
* If you see less than 10 mods in the zip, you downloaded the wrong version.
8. Open the zip file, go to _Fabulously Optimized x.x.x_ > _minecraft_
9. Copy **all folders** from zip's _minecraft_ folder to your _.minecraft_ folder; if asked - replace the files
10. **FO 4.11.0+**: Copy downloaded mod JAR(s) to _mods_ folder
11. If you want [FO default settings](changed-options.md) as well, delete `options.txt` (your vanilla options will be reset)
12. Launch the installed Fabric profile
13. If you now see "Fabulously Optimized" in the right bottom corner and its version number is newer than before, you're done!
#### Windows

1. Open the [releases page](https://github.com/Fabulously-Optimized/vanilla-installer/releases/latest) and download the file with the `.exe` extension. (Example: `Vanilla Installer-GUI v0.1.0.exe`)
2. If it asks you where to save your file, select your Downloads folder (`%USERPROFILE%\Downloads`)
3. Navigate to the Downloads folder and double-click the file you just downloaded.
* If you see a Microsoft Defender SmartScreen prompt, click `More info`, then `Run Anyway`.
4. Select the Minecraft version and directory, and click `Install`.
5. You're all done!

#### macOS

TODO

#### Linux

1. Install Python 3.8 or higher (3.11 recommended) from your package manager using one of the following examples:
- Ubuntu: `sudo apt install python3`
- Arch Linux: `sudo pacman -S python3`
- Fedora: `sudo dnf install python3`

2. Run `pip3 install vanilla-installer[gui]`.
3. Then you can run `vanilla-installer-gui` to launch the program. If you have issues, try `python3 -m vanilla_installer gui`.

### GDLauncher

Expand Down