rcon-ping
v1.0.1
Published
A Node.js client for checking if a Minecraft server's RCON is live and exists with the given hostname, port, and password.
Downloads
37
Readme
RconPing
A Node.js client for checking if a Minecraft server's RCON is live and exists with the given hostname, port, and password. Developed by Mehran1022
Features
- Connect to a Minecraft server using RCON
- Authenticate with the server
- Handle errors and timeouts gracefully
- Modular and maintainable code structure
Installation
Install with npm / yarn / pnpm:
npm install rcon-ping
yarn add rcon-ping
pnpm add rcon-ping
Usage
Here’s an example of how to use the RconPing class:
const RconPing = require('rcon-ping');
const hostname = '0.0.0.0'; // Should be enable-rcon=true in server.properties
const port = 25575; // rcon.port in server.properties
const password = 'yourpassword'; // rcon.password in server.properties
async function main() {
const client = new RconPing(hostname, port, password)
try {
const result = await client.connect()
console.log(result)
} catch (error) {
console.log(error.message)
}
}
main()
Methods
RconPing
constructor(hostname, port, password)
Creates a new instance of the RconPing class.
hostname
(string): The hostname of the Minecraft server.port
(number): The port of the Minecraft server.password
(string): The RCON password for the Minecraft server.
connect()
Connects to the Minecraft server and authenticates using the provided hostname, port, and password.
Returns a promise that resolves with a success message or rejects with an error message.
Error Handling
The connect method provides detailed error messages for various scenarios, such as incorrect passwords, connection timeouts, and invalid responses from the server.
Contributing
Contributions are welcome! Please open an issue or submit a pull request with your changes.