Repository of the Minecraft Timeline project, listing every update to the game in one timeline for each edition.

This began as a simple static image posted on Reddit that gained a lot of traction (even appearing briefly in some videos [1] [2]); enough to motivate me to create this simple, interactable timeline easily available to all.

You are welcome to contribute by fixing bugs, but mainly, by adding missing versions of the game to the timeline :)

Version data

All timeline data is stored in TypeScript files. The root of this data is an array of Edition objects at src/lib/editions/index.ts.

Each Edition represents a Minecraft edition, containing some metadata and all timeline entries of that edition. Its fields are:

• id: The ID of the edition. Used to tell them apart and find files in directories. Should be short and unique, like "java". Required.
• name: The display name of the edition. Required.
• firstMessage: The first entry in the timeline, like "Minecraft is born". Required.
• versions: An array of Version objects, representing all released versions or events in the history of the edition. Required.
• upcomings: An array of NaiveVersion objects, representing upcoming versions or events that don't have a definite date yet. Required.

Version and NaiveVersion are very similar objects, with the only difference being that Version requires a definite date field, while NaiveVersion has an optional possibleDate field instead. Their fields are:

• type: Either "major", "minor", "drop" or "event". Stores the kind of timeline entry that this object represents (major updates, minor updates, game drops, or important events in the history of the game). Required.
• date: The date of the version, in the format yyyy-MM-dd[T[hh][:mm][:ss]]. Required in Version.
• possibleDate: A possible date of the version, in no particular format. Optional.
• title: The big display title of the version (e.g. "Update Aquatic"). Optional.
• subtitle: The smaller subtitle of the version (e.g. "1.13"). Optional.
• description: The short description of the version (e.g. "Ocean Overhaul & Phantoms"). Optional.
• longDescription: A very long description of the version. Optional, but use very sparingly (pretty much just for big events).
• funFact: A light hearted medium description of the version, meant for not widely known "fun facts" or "did you know?" lines. Optional.
• icon: Path to an image icon of the version, relative to images/versions. Optional.
• learnMore: URL for more information of the version. You can also use the syntax @NAME as a shorthand to minecraft.wiki/w/NAME. Optional.
• mainFeatures: A list of Feature objects, which only contain a text field (others may be added in the future). Contains the most important features of an update.
• minorFeatures: The same as mainFeatures but for less important yet noteworthy features.

We currently have two editions: java and bedrock, located at src/lib/editions/java/ and src/lib/editions/bedrock/, respectively. Their data is split into multiple files for easier mantainance. Each edition directory contains:

• major.ts: All major versions of that edition.
• minor.ts: All minor versions of that edition.
• drops.ts: All game drops of that edition.
• events.ts: All important events of that edition.
• upcomings.ts: All upcoming versions or events of that edition.
• index.ts: The main file exporting the final Edition object, importing data from the previous files.

Building

This project is written in Svelte, using Typescript and Vite. To build it, you need to have Node.js installed. After cloning the repository, run the following commands:

npm install
npm run dev

This will start a development server at localhost:5173. To build the project, run npm run build.

Icons

Content updates (major updates and a few minor ones) have icons, located in public/versions/<edition>/version_<version>.png.

All timeline icons must have 64px of height and at most 128px of width. They should all follow the same art style, following these guidelines:

• Include as few elements as needed to properly represent the update, but no fewer.
• Blocks should always be 3D.
• Pixel art must have a constant, integer pixel size.
• Structures should have its own custom pixel art.
• Mobs should only be depicted as a head, unless more is needed.
• All items in a same icon must have the same pixel size.
• There must be a drop shadow of 2px vertical offset and 50% opacity.

Thank you

Thanks to everyone who shared, enjoyed and contributed to this small project. Over the years, I have received many kind messages of people thanking me for creating Minecraft Timeline, and if it wasn't for your support, I wouldn't be still mantaining this. So, thank you, and let's enjoy many Minecraft updates to come!

- Henrique

---

"Minecraft" is a trademark of Mojang Studios.
This project is not affiliated with Mojang, or Microsoft.