2019-04-27 21:36:18 -04:00
|
|
|
|
2019-05-22 20:24:53 -04:00
|
|
|
##### This project is near complete.
|
|
|
|
|
[](https://travis-ci.com/Pierce01/MinecraftLauncher-core)
|
2018-10-29 18:13:58 -04:00
|
|
|
|
2019-02-10 21:21:14 -05:00
|
|
|
MCLC is a NodeJS solution for launching modded and vanilla Minecraft without having to download and format everything yourself.
|
|
|
|
|
Basically a core for your Electron or script based launchers.
|
2018-10-29 18:13:58 -04:00
|
|
|
|
2019-04-18 17:56:36 -04:00
|
|
|
### Getting support
|
|
|
|
|
Since people seem to use this, I've created a Discord server for anyone who needs to get in contact with me or get help!
|
|
|
|
|
https://discord.gg/8uYVbXP
|
|
|
|
|
|
2018-12-30 18:35:47 -05:00
|
|
|
### Installing
|
2018-12-09 18:17:20 -05:00
|
|
|
|
|
|
|
|
`npm i minecraft-launcher-core`
|
|
|
|
|
|
2019-03-10 20:18:49 -04:00
|
|
|
### Standard Example
|
|
|
|
|
```javascript
|
2019-05-22 18:28:48 -04:00
|
|
|
const { Client, Authenticator } = require('minecraft-launcher-core');
|
|
|
|
|
|
|
|
|
|
let opts = {
|
|
|
|
|
authorization: async () => { return await Authenticator.getAuth(username, password) },
|
|
|
|
|
clientPackage: null,
|
|
|
|
|
root: "./minecraft",
|
|
|
|
|
os: "windows",
|
|
|
|
|
version: {
|
|
|
|
|
number: "1.14",
|
|
|
|
|
type: "release"
|
2019-05-22 18:32:45 -04:00
|
|
|
},
|
2019-05-22 18:28:48 -04:00
|
|
|
memory: {
|
|
|
|
|
max: "6000",
|
|
|
|
|
min: "4000"
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
const launcher = new Client(opts);
|
|
|
|
|
launcher.launch();
|
|
|
|
|
|
|
|
|
|
launcher.on('debug', (e) => console.log(e));
|
|
|
|
|
launcher.on('data', (e) => console.log(e));
|
|
|
|
|
launcher.on('error', (e) => console.log(e));
|
2019-03-10 20:18:49 -04:00
|
|
|
```
|
2018-12-30 18:35:47 -05:00
|
|
|
### Usage
|
2018-10-29 18:13:58 -04:00
|
|
|
|
2019-05-22 18:28:48 -04:00
|
|
|
##### Client Options
|
|
|
|
|
|
|
|
|
|
| Parameter | Type | Description | Required |
|
|
|
|
|
|--------------------------|----------|-------------------------------------------------------------------------------------------|----------|
|
|
|
|
|
| `options.authorization` | Object | The result from `getAuth` function, allows the client to login in online or offline mode. | True |
|
|
|
|
|
| `options.clientPackage` | String | Path to the client package zip file. | False |
|
|
|
|
|
| `options.root` | String | Path where you want the launcher to work in. like `C:/Users/user/AppData/Roaming/.mc`, | True |
|
|
|
|
|
| `options.os` | String | windows, osx or linux, | True |
|
|
|
|
|
| `options.version.number` | String | Minecraft version that is going to be launched. | True |
|
|
|
|
|
| `options.version.type` | String | Any string. The actual Minecraft launcher uses `release` and `snapshot`. | True |
|
|
|
|
|
| `options.memory.max` | String | Max amount of memory being used by Minectaft. | True |
|
|
|
|
|
| `options.forge.path` | String | Path to Universal Forge Jar. | False |
|
|
|
|
|
| `options.server.host` | String | Host url to the server, don't include the port. | False |
|
|
|
|
|
| `options.server.port` | String | Port of the host url, will default to `25565` if not entered. | False |
|
|
|
|
|
| `options.proxy.host` | String | Host url to the proxy, don't include the port. | False |
|
|
|
|
|
| `options.proxy.port` | String | Port of the host proxy, will default to `8080` if not entered. | False |
|
|
|
|
|
| `options.proxy.username` | String | Username for the proxy. | False |
|
|
|
|
|
| `options.proxy.password` | String | Password for the proxy. | False |
|
|
|
|
|
| `options.timeout` | Interger | Timeout on download requests. | False |
|
2019-04-05 21:15:12 -04:00
|
|
|
##### Note
|
2019-05-10 22:10:38 -04:00
|
|
|
If you are loading up a client outside of vanilla Minecraft or Forge (Optifine and for an example), you'll need to download the needed files yourself
|
|
|
|
|
if you don't provide downloads url downloads like Forge and Fabric. Still need to provide the version jar.
|
2019-04-05 21:15:12 -04:00
|
|
|
|
2019-05-22 18:28:48 -04:00
|
|
|
#### Authenticator Functions
|
2018-12-30 18:35:47 -05:00
|
|
|
|
|
|
|
|
##### getAuth
|
|
|
|
|
|
|
|
|
|
| Parameter | Type | Description | Required |
|
|
|
|
|
|-----------|--------|--------------------------------------------------------------|----------|
|
|
|
|
|
| `email` | String | Email or username | True |
|
|
|
|
|
| `password` | String | Password for the Mojang account being used if online mode. | False |
|
|
|
|
|
|
|
|
|
|
##### validate
|
|
|
|
|
|
|
|
|
|
| Parameter | Type | Description | Required |
|
|
|
|
|
|--------------|--------|-------------------------------------------------------------------|----------|
|
|
|
|
|
| `access_token` | String | Token being checked if it can be used to login with (online mode). | True |
|
|
|
|
|
|
|
|
|
|
##### refreshAuth
|
|
|
|
|
|
|
|
|
|
| Parameter | Type | Description | Required |
|
|
|
|
|
|--------------------|--------|-------------------------------------------------------------------------------------|----------|
|
|
|
|
|
| `access_token` | String | Token being checked if it can be used to login with (online mode). | True |
|
|
|
|
|
| `client_token` | String | Token being checked if it's the same client that the access_token was created from. | True |
|
|
|
|
|
| `selected_profile` | Object | Json Object that was returned from Mojangs auth api. | True |
|
|
|
|
|
|
2019-05-22 18:28:48 -04:00
|
|
|
##### invalidate
|
|
|
|
|
|
|
|
|
|
| Parameter | Type | Description | Required |
|
|
|
|
|
|--------------|--------|-------------------------------------------------------------------|----------|
|
|
|
|
|
| `access_token` | String | Token being checked if it can be used to login with (online mode). | True |
|
|
|
|
|
| `client_token` | String | Token being checked if it's the same client that the access_token was created from. | True |
|
|
|
|
|
|
|
|
|
|
##### signOut
|
|
|
|
|
|
|
|
|
|
| Parameter | Type | Description | Required |
|
|
|
|
|
|--------------|--------|--------------------------------------|----------|
|
|
|
|
|
| `username` | String | Username used to login with | True |
|
|
|
|
|
| `password` | String | Password used to login with | True |
|
|
|
|
|
|
2019-02-08 14:02:42 -05:00
|
|
|
#### Events
|
|
|
|
|
|
2019-02-10 21:21:14 -05:00
|
|
|
| Event Name | Type | Description |
|
|
|
|
|
|-------------------|---------|---------------------------------------------------------------------------------------|
|
2019-04-26 13:03:39 -04:00
|
|
|
| `arguments` | Object | Emitted when launch arguments are set for the Minecraft Jar. |
|
2019-02-10 21:21:14 -05:00
|
|
|
| `data` | Buffer | Emitted when information is returned from the Minecraft Process |
|
|
|
|
|
| `close` | Integer | Code number that is returned by the Minecraft Process |
|
|
|
|
|
| `error` | String | Emitted when the Minecraft Process errors |
|
|
|
|
|
| `package-extract` | null | Emitted when `clientPackage` finishes being extracted |
|
|
|
|
|
| `download` | String | Emitted when a file successfully downloads |
|
|
|
|
|
| `download-status` | Object | Emitted when data is received while downloading |
|
2019-04-28 17:52:37 -04:00
|
|
|
| `debug` | String | Emitted when functions occur, made to help debug if errors occur |
|
2019-02-08 14:02:42 -05:00
|
|
|
|
2018-12-01 14:30:58 -05:00
|
|
|
|
2018-10-29 18:40:52 -04:00
|
|
|
#### What should it look like running from console?
|
|
|
|
|
|
|
|
|
|
|
