Skip to main content

​
Overview

Essential Mod can be installed on Minecraft Java Edition using either Forge or Fabric mod loaders. This guide will walk you through the installation process for players.
For developers: If you’re looking to use Essential’s API in your mod, see the Quick start guide instead.

​
Prerequisites

Before installing Essential, make sure you have:

Minecraft Java Edition

A valid Minecraft Java Edition installation (version 1.8.9 or newer)

Mod loader

Either Forge or Fabric installed for your Minecraft version

​
Supported versions

Essential supports a wide range of Minecraft versions:
Mod LoaderMinecraft Versions
Forge1.8.9, 1.12.2, 1.16.2-1.16.5, 1.17.1-1.21.x
Fabric1.16.2-1.21.x
Essential uses a cross-version architecture, so a single mod file often supports multiple Minecraft versions.

​
Installation methods

​
Container vs Pinned versions

Essential is distributed in two formats:
  • Small file size (< 1 MB)
  • Downloads the latest Essential version on first launch
  • Automatically updates to new versions
  • Recommended for most users
  • Single file works across multiple Minecraft versions
  • Larger file size (includes specific Essential version)
  • No download required on first launch
  • Uses the specific Essential version included in the file
  • Includes both Minecraft and Essential version in filename
  • Can be updated via in-game update functionality

​
First launch

When you launch Minecraft with Essential for the first time:
1

Initial setup

If using the Container version, Essential will download on first launch (this may take a moment)
2

Accept terms of use

You’ll be prompted to accept Essential’s Terms of Use and Privacy Policy before accessing social features
3

Accept community rules

Accept the Community Rules to engage with social features like messaging and friends
4

Explore features

Essential is now ready! Access Essential features through:
  • The Essential button on the main menu
  • Essential Settings (ESC menu → Settings → Essential)
  • Screenshot Manager (default: F4 key)
  • Wardrobe (for cosmetics)
  • Social Menu (for friends and messaging)

​
File locations

After installation, Essential creates several files in your Minecraft directory:
LocationDescription
.minecraft/mods/Container or pinned Essential mod file
.minecraft/essential/Essential’s data directory
.minecraft/essential/Essential (<Loader>_<Version>).jarMain Essential mod (auto-downloaded by Container)
.minecraft/essential/loader/Loader stage files
.minecraft/essential/libraries/Essential’s library dependencies
Do not manually delete files from .minecraft/essential/ unless troubleshooting. Essential manages these files automatically.

​
Verifying installation

To verify Essential is installed correctly:
1

Check the main menu

Look for Essential buttons on the Minecraft title screen (typically in the top-right area)
2

Check mods list

In the main menu, click Mods and look for Essential in the list
3

Check settings

Press ESC in-game, then go to Settings. You should see an Essential category

​
Troubleshooting

  • Verify you’re using the correct Forge or Fabric version
  • Ensure the .jar file is in the mods folder
  • Check that you don’t have conflicting mods
  • Try restarting Minecraft
  • Check your internet connection
  • Temporarily disable firewall/antivirus
  • Delete .minecraft/essential/ and restart Minecraft to re-download
  • Try using the pinned version from Modrinth/CurseForge instead
  • Ensure you have the correct Minecraft version
  • Check for mod conflicts (try removing other mods temporarily)
  • Update your Java version (Essential requires Java 8+ for older MC versions, Java 17+ for MC 1.18+)
  • Check the crash log in .minecraft/crash-reports/
  • Make sure you’ve accepted the Terms of Use and Community Rules
  • Check that Essential Settings are configured correctly
  • Verify your internet connection for online features
  • Try resetting Essential settings to defaults

​
Getting help

If you encounter issues:

Discord support

Get help from the community and support team

Essential Wiki

Browse detailed guides and troubleshooting steps

​
Next steps

Explore features

Learn about Essential’s social features, cosmetics, and settings

Developer guide

Build mods using Essential’s powerful API

Build docs developers (and LLMs) love

Get started for freeTalk to us