From 04713222c92564a729e2ac5fcda9efce4f23ebb4 Mon Sep 17 00:00:00 2001
From: Geoff Bourne <itzgeoff@gmail.com>
Date: Sat, 5 Apr 2025 08:53:06 -0500
Subject: [PATCH] docs: add a note about downloading fabric-api (#3401)

---
 docs/types-and-platforms/server-types/fabric.md | 12 +++++++++++-
 examples/fabric/compose.yml                     |  4 ++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/docs/types-and-platforms/server-types/fabric.md b/docs/types-and-platforms/server-types/fabric.md
index 431c3159..71881b22 100644
--- a/docs/types-and-platforms/server-types/fabric.md
+++ b/docs/types-and-platforms/server-types/fabric.md
@@ -41,7 +41,17 @@ A specific loader or launcher version other than the latest can be requested usi
       FABRIC_LOADER_VERSION: 0.13.1
     ```
 
-!!! note
+!!! note "Fabric API"
+
+    As [mentioned on the Fabric download page](https://fabricmc.net/use/installer/), most mods will require the Fabric API mod to be installed. That can be easily done by utilizing [the Modrinth downloads feature](../../mods-and-plugins/modrinth.md), such as adding this to the `environment` of a compose file service:
+    
+    ```yaml
+          TYPE: FABRIC
+          MODRINTH_PROJECTS: |
+            fabric-api
+    ```
+
+!!! note "Alternate launcher"
 
     If you wish to use an alternative launcher you can:  
 
diff --git a/examples/fabric/compose.yml b/examples/fabric/compose.yml
index 05dc0877..df27a406 100644
--- a/examples/fabric/compose.yml
+++ b/examples/fabric/compose.yml
@@ -7,6 +7,10 @@ services:
 #      VERSION: 1.21.4
 #      FABRIC_INSTALLER_VERSION: 1.0.1
 #      FABRIC_LOADER_VERSION: 0.16.10
+      # Since Fabric server type only includes the loader, most times
+      # the fabric-api is required for other mods to function
+      MODRINTH_PROJECTS: |
+        fabric-api
     ports:
       - "25565:25565"
     volumes: