Download and launch Minecraft in offline mode (all assets, libraries, etc)
A Node.js library for downloading, installing, and launching Minecraft in offline mode with support for custom authentication servers and mod loaders.
npm install axocore
const axocore = require('axocore');
const path = require('path');
(async () => {
await axocore.launch({
version: '1.20.1',
username: 'Player',
javaPath: 'java',
destDir: path.resolve(__dirname, '.minecraft'),
gameDir: path.resolve(__dirname, '.minecraft')
});
})();
const axocore = require('axocore');
const path = require('path');
(async () => {
await axocore.launch({
version: '1.20.1',
username: 'your_username',
password: 'your_password',
authServer: 'https://your-auth-server.com/api/yggdrasil/authserver',
javaPath: 'java',
destDir: path.resolve(__dirname, '.minecraft'),
gameDir: path.resolve(__dirname, '.minecraft'),
javaArgs: ['-Xmx2G', '-Xms1G']
});
})();
const axocore = require('axocore');
const path = require('path');
(async () => {
await axocore.launch({
modLoader: 'fabric',
fabricVersion: 'fabric-loader-0.16.14-1.20.1',
version: '1.20.1',
username: 'Player',
javaPath: 'java',
destDir: path.resolve(__dirname, '.minecraft'),
gameDir: path.resolve(__dirname, '.minecraft')
});
})();
You can now track download progress and live game logs by passing callbacks directly to launch and downloadAll:
onDownloadProgress: Called with info about each file downloaded. For assets, the callback includes:
fileBytesDownloaded: Bytes downloaded for the current filefileTotalBytes: Total bytes for the current filecumulativeBytes: Total bytes downloaded so far (all assets)totalBytes: Total bytes to download (all assets)onGameLog: Called with each log line from the running game.const axocore = require('axocore');
const path = require('path');
(async () => {
await axocore.launch({
version: '1.20.1',
username: 'Player',
javaPath: 'java',
destDir: path.resolve(__dirname, '.minecraft'),
gameDir: path.resolve(__dirname, '.minecraft'),
onDownloadProgress: (info) => {
console.log(info);
},
onGameLog: (line) => {
console.log('[GameLog]', line);
}
});
})();
axocore.launch(options)Main function to download and launch Minecraft.
options (Object) - Launch configuration
version (string) - Minecraft version (e.g., '1.20.1')username (string) - Player username (default: 'Player')javaPath (string) - Path to Java executabledestDir (string) - Directory to download Minecraft filesgameDir (string) - Game directory for saves, mods, etc.password (string, optional) - Password for Yggdrasil authenticationauthServer (string, optional) - Custom authentication server URLmodLoader (string, optional) - Mod loader type ('vanilla' or 'fabric', default: 'vanilla')fabricVersion (string, optional) - Fabric version (required if modLoader is 'fabric')javaArgs (Array, optional) - Additional JVM argumentsReturns a child process object for the launched Minecraft instance.
axocore.downloadAll(options)Downloads all required Minecraft files without launching.
options (Object)
version (string) - Minecraft versiondestDir (string) - Destination directoryObject containing paths to downloaded files:
clientJar - Path to Minecraft client JARlibraries - Array of library JAR pathsassetsDir - Path to assets directoryassetIndexPath - Path to asset index fileaxocore.authenticate(options)Authenticate with a Yggdrasil server.
options (Object)
username (string) - Usernamepassword (string) - PasswordauthServer (string, optional) - Authentication server URLAuthentication response containing access token and profile information.
axocore creates a standard Minecraft directory structure:
.minecraft/
├── assets/
│ ├── indexes/
│ └── objects/
├── libraries/
├── versions/
│ └── [version]/
│ ├── [version].jar
│ └── [version].json
├── saves/
├── mods/
├── resourcepacks/
├── logs/
├── crash-reports/
├── options.txt
├── servers.dat
└── launcher_profiles.json
const path = require('path');
const axocore = require('./index');
(async () => {
// Launch Fabric Minecraft with explicit values
console.log('Launching Minecraft...');
await axocore.launch({
modLoader: 'fabric',
fabricVersion: 'fabric-loader-0.16.14-1.20.1',
version: '1.20.1',
javaPath: 'java',
username: 'candiedapple',
password: 'alpo123',
authServer: 'https://nested.candiedapple.me/api/yggdrasil/authserver',
destDir: path.resolve(__dirname, '.minecraft'),
gameDir: path.resolve(__dirname, '.minecraft'),
javaArgs: [
`-javaagent:${path.join(path.resolve(__dirname, '.minecraft'), 'authlib-injector.jar')}=https://nested.candiedapple.me/api/yggdrasil`
],
onDownloadProgress: (info) => {
console.log('[Download]', info);
},
onGameLog: (line) => {
console.log('[GameLog]', line);
}
});
})();
const axocore = require('axocore');
const path = require('path');
(async () => {
console.log('Downloading Minecraft files...');
const result = await axocore.downloadAll({
version: '1.20.1',
destDir: path.resolve(__dirname, '.minecraft')
});
console.log('Download complete!');
console.log('Client JAR:', result.clientJar);
console.log('Libraries:', result.libraries.length, 'files');
console.log('Assets directory:', result.assetsDir);
})();
When no password is provided, axocore generates an offline UUID and launches Minecraft in offline mode. This is useful for testing and development.
axocore supports custom Yggdrasil authentication servers, which are compatible with the Minecraft authentication protocol. This allows integration with custom authentication systems.
For custom authentication servers, you may need to use authlib-injector. Add it to your Java arguments:
javaArgs: [
'-javaagent:path/to/authlib-injector.jar=https://your-auth-server.com/api/yggdrasil'
]
axocore has built-in support for Fabric mod loader. When using Fabric:
modLoader: 'fabric'fabricVersion (e.g., 'fabric-loader-0.16.14-1.20.1')mods/ directory within your game directoryAfter launching with Fabric, you can add mods by placing .jar files in the mods/ directory:
.minecraft/
└── mods/
├── fabric-api.jar
├── jei.jar
└── your-mod.jar
javaPath is correctMinecraft logs are saved to logs/latest.log in the game directory. Check this file for detailed error information.
If Minecraft crashes, crash reports are saved to the crash-reports/ directory with timestamps.
Default Minecraft directories by platform:
%APPDATA%\.minecraft~/Library/Application Support/minecraft~/.minecraftMIT License - see LICENSE file for details.
FAQs
Download and launch Minecraft in offline mode (all assets, libraries, etc)
The npm package axocore receives a total of 11 weekly downloads. As such, axocore popularity was classified as not popular.
We found that axocore demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Following last week’s supply chain attack, Nx published findings on the GitHub Actions exploit and moved npm publishing to Trusted Publishers.
Security News
AGENTS.md is a fast-growing open format giving AI coding agents a shared, predictable way to understand project setup, style, and workflows.
Security News
/Research
Malicious npm package impersonates Nodemailer and drains wallets by hijacking crypto transactions across multiple blockchains.