Skip to main content
Essential maintains a detailed changelog of all releases, documenting new features, bug fixes, compatibility improvements, and version support.

Changelog Location

The changelog is maintained in the Essential repository in the changelog/ directory: View Changelog on GitHub Each release has its own markdown file following the naming convention:
  • release-{version}.md - Major/minor releases
  • release-{version}.{patch}.md - Patch releases

Release Format

Each changelog entry includes:
  • Title - Brief description of the release theme
  • Summary - Overview of major changes
  • New Versions - Minecraft version support additions
  • Features - New functionality and improvements
  • UI Changes - Interface updates and redesigns
  • Bug Fixes - Issues resolved in the release
  • Compatibility - Mod compatibility improvements
  • Performance - Optimization updates

Example Changelog Entry

Here’s the structure of a typical changelog entry:
Title: Feature Name
Summary: Brief description of the release

## New Versions
- Added support for 1.21.8 Fabric

## UI
- Improved button layouts
- Added new modals

## Bug Fixes
- Fixed rendering issues
- Fixed performance problems

## Compatibility
- Improved compatibility with other mods

Recent Releases

The changelog includes all releases from version 1.0.0 onwards, with the most recent versions available at:
  • 1.3.x series - Latest feature releases
  • 1.2.x series - Stable releases
  • 1.1.x series - Earlier versions
  • 1.0.x series - Initial releases
The changelog directory contains over 120 release entries documenting Essential’s complete version history.

Versioning Scheme

Essential uses semantic versioning:
  • Major version (1.x.x) - Significant new features or breaking changes
  • Minor version (x.3.x) - New features and improvements
  • Patch version (x.x.10) - Bug fixes and small updates

Staying Updated

To keep track of Essential releases:
  1. Watch the repository - Get notifications for new releases on GitHub
  2. Check the changelog - Review the changelog directory regularly
  3. In-game updates - Essential automatically notifies you of updates
  4. Discord announcements - Join the Essential Discord for release announcements

Changelog by Category

Changelog entries are organized by category to help you find specific types of changes:

New Versions

Minecraft version support additions, including Forge and Fabric loader support for new Minecraft releases.

Features & UI

New functionality, user interface improvements, and feature enhancements.

Bug Fixes

Issue resolutions, crash fixes, and stability improvements.

Compatibility

Improvements for compatibility with other mods and mod loaders.

Performance

Optimizations and performance enhancements.

Historical Changes

For version history before the source code was made public, changelog entries may be limited. All releases since source availability have comprehensive changelog documentation.

Contributing to Changelog

The changelog is maintained by the Essential team. If you discover undocumented changes or issues:
  1. Report them in the Essential Discord
  2. Open an issue on GitHub
  3. Contact support through official channels
Before updating Essential, always check the latest changelog entry to understand what’s new and what might have changed.

Build docs developers (and LLMs) love