Skip to content
This repository has been archived by the owner on Apr 26, 2024. It is now read-only.
/ node-modern-rcon Public archive

A modern RCON client implementation written in ES2015

License

Notifications You must be signed in to change notification settings

levrik/node-modern-rcon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

node-modern-rcon npm package

A modern RCON client implementation written in ES2015

NOTE: This has only been tested with Minecraft. So be aware of possible bugs with other server implementations. Feel free to submit a PR if you have any problems.

Installation

npm install modern-rcon --save

API

new Rcon(host, port = 25575, password, timeout = 5000)

Creates a new Rcon object.

rcon.connect() -> Promise

Connects with the credentials provided in the constructor.

rcon.send(data) -> Promise<string>

Executes the provided command on the open connection and returns the response.

rcon.disconnect() -> Promise

Disconnects gracefully.

Example

const Rcon = require('modern-rcon');

const rcon = new Rcon('localhost', 'some password');

rcon.connect().then(() => {
  return rcon.send('help'); // That's a command for Minecraft
}).then(res => {
  console.log(res);
}).then(() => {
  return rcon.disconnect();
});

Contribute

  1. Install the dependencies with npm install
  2. Setup a Minecraft Server for the tests by using npm run setup-minecraft
    Important: This script will automatically accept the Minecraft EULA

To run the tests you need to start the Minecraft Server with npm run start-minecraft in another Terminal.

License

MIT

About

A modern RCON client implementation written in ES2015

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published