JSPM

  • Created
  • Published
  • Downloads 414
  • Score
    100M100P100Q90417F
  • License MIT

Create your Electron Minecraft Launcher easily!

Package Exports

  • eml-lib
  • eml-lib/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (eml-lib) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Electron Minecraft Launcher Lib (EML Lib)

Electron Minecraft Launcher Lib (EML Lib) is a Node.js library. It permits to authenticate, download Java and Minecraft and launch Minecraft.


Features

  • Authentication: Authenticate users with Microsoft, Azuriom or Crack.
  • Minecraft: Automatically download and launch Minecraft (Vanilla and Forge [^1]; Fabric, NeoForge, Quilt and MCP are coming soon), and remove unwanted files (such as unwanted mods).
  • Java: Automatically download and install Java.
  • Bootstraps [^1]: Auto-update your launcher.
  • Maintenance [^1]: Block the launcher during maintenance.
  • Server status: Displaying server information (from Minecraft 1.4 to the latest Minecraft version)
  • News [^1]: Displaying news.
  • Background [^1]: Displaying a background image.

Installation

Software requirements

  • Node.js 15.14.0 or higher: see Node.js;
  • Electron 15.0.0 or higher: please install it with npm i electron if you use Microsoft Authentication.

To get all the capacities of this Node.js library, you must set up your EML AdminTool website! Without it, you can only use Minecraft Vanilla, and many features will be disabled (such as News, Bootstrap, etc.).

If you don't want to use EML AdminTool, you should rather use the Minecraft Launcher Core library.

EML Lib installation

You need Node.js and Electron.

# Using npm
npm i eml-lib

eml-lib package includes TypeScript typings, so you don't need to install @types/eml-lib.

Quick start

Quick start using the EML AdminTool:

const EMLLib = require('eml-lib')

const launcher = new EMLLib.Launcher({
  url: 'https://admintool.electron-minecraft-launcher.com',
  serverId: 'eml',
  account: new EMLLib.CrackAuth().auth('GoldFrite')
})

launcher.launch()

Please refer to the wiki for more information.

Platform compatibility

OS (platform) Supported? Minimum version supported
Windows (win32) Yes Windows 7 (Windows NT 6.1)
macOS (Darwin) Yes Mac OS X Lion (10.7)
Linux, including Chrome OS Yes Variable
Others Not officially -

[!WARNING] No support will be provided for older versions of Windows, macOS and Linux, or for other operating systems.

Tests

The library have been tested on:

Minecraft version OS Loader Result
1.21.1 Windows 11 (26120.1252) Vanilla OK
Forge (52.0.3) OK
1.19.4 Windows 11 (26120.1252) Vanilla OK
Forge (45.3.0) OK
1.18.2 Windows 11 (26120.961) Forge (40.2.0) OK
1.17.1 Windows 11 (26120.1252) Vanilla OK
Forge (37.1.1) OK
1.16.5 Windows 11 (26120.1252) Vanilla Warn: Multiplayer not available.
Forge (36.2.34)
1.14.4 Windows 11 (26120.961) Forge (28.2.26) OK
1.12.2 Windows 11 (26120.1252) Vanilla OK
Forge (14.23.5.2859) Non-breaking error: Minecraft is unable to read forge.jar from libraries.
1.7.10 Windows 11 (26120.1252) Vanilla OK
Forge (10.13.4.1614) Non-breaking error: SSL certificate error.
1.4.7 Windows 11 (26120.1252) Vanilla Non-breaking error: Minecraft tries to fetch non-existing HTTP data.
1.0.0 Windows 11 (26120.1252) Vanilla OK

[!WARNING] Forge is currently not working on Minecraft 1.5.2 and below.

Contributing

Development

Download the code and run the commands:

cd EML-Lib-v2
npm i

Tests

You can submit your tests by creating an issue.

Please indicate the following information in your issue:

  • The Minecraft version;
  • The operating system the test was performed on (including the version);
  • The loader used (Vanilla, Forge, Fabric, etc., including the loader version);
  • The result of the test (OK if the test was successful, KO if the test failed, or a detailed explanation if the test was not conclusive and if it breaks the game).

Important information

  • This is not an official library from Mojang Studios, Microsoft, Electron or Node.js. Minecraft is a trademark of Mojang Studios.
  • This Node.js library is under the MIT license; to get more information, please read the file LICENSE. It is legally obligatory to respect this license.
  • If you need some help, you can join this Discord.

[^1]: Requires EML AdminTool.