diff --git a/app/flatpages/help.md b/app/flatpages/help.md index 042720da..d7a4f907 100644 --- a/app/flatpages/help.md +++ b/app/flatpages/help.md @@ -10,6 +10,7 @@ toc: False ## General Help * [Frequently Asked Questions](faq/) +* [Installing content](installing/) * [Content Ratings and Flags](content_flags/) * [Non-free Licenses](non_free/) * [Why WTFPL is a terrible license](wtfpl/) diff --git a/app/flatpages/help/faq.md b/app/flatpages/help/faq.md index 6092c4ce..949e9af9 100644 --- a/app/flatpages/help/faq.md +++ b/app/flatpages/help/faq.md @@ -54,6 +54,10 @@ You should read [the official Minetest Modding Book](https://rubenwardy.com/minetest_modding_book/) for a guide to making mods and games using Minetest. +### How do I install something from here? + +See [Installing content](/help/installing/). + ## How do I get help? diff --git a/app/flatpages/help/installing.md b/app/flatpages/help/installing.md new file mode 100644 index 00000000..c1b0e50a --- /dev/null +++ b/app/flatpages/help/installing.md @@ -0,0 +1,89 @@ +title: How to install mods, games, and texture packs +description: A guide to installing mods, games, and texture packs in Minetest. + +## Installing from the main menu (recommended) + +### Install + +1. Open the mainmenu +2. Go to the Content tab and click "Browse online content". + If you don't see this, then you need to update Minetest to v5. +3. Search for the package you want to install, and click "Install". +4. When installing a mod, you may be shown a dialog about dependencies here. + Make sure the base game dropdown box is correct, and then click "Install". + +
+
+
+ + Screenshot of the content tab in minetest + +
+ 1. Click Browser Online Content in the content tab. +
+
+
+
+
+ + Screenshot of the content tab in minetest + +
+ 2. Search for the package and click "Install". +
+
+
+
+ +Troubleshooting: + +* I can't find it in the ContentDB dialog (Browse online content) + * Make sure that you're on the latest version of Minetest. + * Are you using Android? Packages with content warnings are hidden by default on android, + you can show them by removing `android_default` from the `contentdb_flag_blacklist` setting. + * Does the webpage show "Non-free" warnings? Non-free content is hidden by default from all clients, + you can show them by removing `nonfree` from the `contentdb_flag_blacklist` setting. +* It says "required dependencies could not be found" + * Make sure you're using the correct "Base Game". A lot of packages only work with certain games, you can look + at "Compatible Games" on the web page to see which. + +### Enable in Select Mods + +1. Mods: Enable the content using "Select Mods" when selecting a world. +2. Games: choose a game when making a world. +3. Texture packs: Content > Select pack > Click enable. + + +
+
+
+ + Screenshot of Select Mods in Minetest + +
+ Enable mods using the Select Mods dialog. +
+
+
+
+ +## Installing using the command line + +### Git clone + +1. Install git +2. Find the package on ContentDB and copy "source" link. +3. Find the user data directory. + In 5.4.0 and above, you can click "Open user data directory" in the Credits tab. + Otherwise: + * Windows: whereever you extracted or installed Minetest to. + * Linux: usually `~/.minetest/` +4. Open or create the folder for the type of content (`mods`, `games`, or `textures`) +5. Git clone there +6. For mods, make sure to install any required dependencies. + +### Enable + +* Mods: Edit world.mt in the world's folder to contain `load_file_MODNAME = true` +* Games: Use `--game` or edit game_id in world.mt. +* Texture packs: change the `texture_path` setting to the texture pack absolute path. diff --git a/app/public/static/installing_cdb_dialog.png b/app/public/static/installing_cdb_dialog.png new file mode 100644 index 00000000..e339bcb6 Binary files /dev/null and b/app/public/static/installing_cdb_dialog.png differ diff --git a/app/public/static/installing_content_tab.png b/app/public/static/installing_content_tab.png new file mode 100644 index 00000000..64320c71 Binary files /dev/null and b/app/public/static/installing_content_tab.png differ diff --git a/app/public/static/installing_select_mods.png b/app/public/static/installing_select_mods.png new file mode 100644 index 00000000..8f1d387d Binary files /dev/null and b/app/public/static/installing_select_mods.png differ diff --git a/app/templates/packages/view.html b/app/templates/packages/view.html index 1134f889..e29715a4 100644 --- a/app/templates/packages/view.html +++ b/app/templates/packages/view.html @@ -53,18 +53,8 @@ {% endif %} - {% if package.type == package.type.MOD %} - {% set installing_url = "https://wiki.minetest.net/Installing_Mods" %} - {% elif package.type == package.type.GAME %} - {% set installing_url = "https://wiki.minetest.net/Games#Installing_games" %} - {% elif package.type == package.type.TXP %} - {% set installing_url = "https://wiki.minetest.net/Installing_Texture_Packs" %} - {% else %} - {{ 0 / 0 }} - {% endif %} -

- + {{ _("How do I install this?") }}