Skip to content

Requirements and Installation

Jump to bottom
RQuack edited this page Jul 16, 2026 · 2 revisions

📦 Requirements & Installation

Requirements
Minecraft 26.2
Mod loader Fabric
Required dependency Fabric API
Java 25 or newer

Fabric API is mandatory — Fairy Tales uses it for networking, rendering, events, and data attachments, and the game won't launch without it.
Minecraft 1.21.1
Mod loader NeoForge
Required dependency None
Java 21

Installing (Client)

  1. Install the Fabric loader for Minecraft 26.2 — get it from fabricmc.net and run the installer, then select the Fabric profile in your launcher.
  2. Make sure you have Java 25+. Modern launchers can install the right Java for you; otherwise grab a JDK 25 build (e.g. from Adoptium).
  3. Download the two mods:
  4. Drop both .jar files into your mods/ folder:
    • Windows: %appdata%\.minecraft\mods
    • macOS: ~/Library/Application Support/minecraft/mods
    • Linux: ~/.minecraft/mods
  5. Launch the Fabric profile and make your wish. 🌠

⚠️ Use the plain fairytales-x.x.x.jar — not any -sources.jar, which is for developers and won't run as a mod.

Installing (Server)

  1. Set up a Fabric server for Minecraft 26.2 (Fabric provides a server launcher on their download page).
  2. Place both Fairy Tales and Fabric API in the server's mods/ folder.
  3. Every connecting player must also have both mods installed on their client.
  4. Start the server. The server's config/fairytales.json is generated on first run and its settings apply to everyone — see Configuration.

Want a hassle-free modded server? See the note at the bottom of the project's main page. 🧚

Modpacks

Fairy Tales may be included, unmodified, in modpacks distributed on platforms like CurseForge and Modrinth — no need to ask first. Just keep Fabric API in the pack as a dependency, and retain the license notice. (Full terms are in the mod's LICENSE.)

Troubleshooting

The game crashes on launch / "requires Fabric API". You're missing Fabric API — add its .jar to your mods/ folder.

The game won't start and mentions Java. Fairy Tales needs Java 25+. Update the Java your launcher uses for this profile.

The mod doesn't appear in the Mods list. Check that you're launching the Fabric profile for 26.2 (not vanilla or another version), and that the jar is directly in mods/ (not a subfolder or a -sources.jar).

Nothing works in multiplayer. Every player — and the server — needs both mods installed. A vanilla client can't join a server running Fairy Tales.

Installed and ready? Head to Getting Started.

Clone this wiki locally