Skip to content

An RCON manager for game servers, with a persistent Node.js backend and a React + xterm.js frontend. Supports multiple server profiles, live player lists, chat, and more. Focused on Ark: SA right now

License

Notifications You must be signed in to change notification settings

malkamius/node_rcon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Installation Notes

After running npm install, you do not need to run a separate build step. The install process will:

  • Automatically build the project (backend and frontend)
  • Register the backend service as a Windows scheduled task (runs as SYSTEM)
  • Register the instance installation socket service (admin socket server) as a Windows scheduled task

Both services are set up and started automatically. No manual build or service registration is required after install.

Node.js RCON Manager

Screenshot

A RCON manager for game servers, with a persistent Node.js backend and a React + xterm.js frontend. Supports multiple server profiles, live player lists, chat, and more. Right now we are focusing on ARK Survival Ascended


Features

  • Persistent RCON Connections: Manages multiple game servers, auto-reconnects on disconnect.
  • Web UI: React frontend with xterm.js terminals, resizable layout, and tabbed server sessions.
  • Live Player List: See current players (for ARK SE/SA) with live updates.
  • Chat Integration: View in-game chat in real time.
  • Server Management: Add/edit/remove servers.
  • Local Server Settings: Edit basic settings(Game/GameUserSettings) of the dedicated server if running on the same box

Getting Started

1. Install Git (if you don't have it)

Download and install Git from git-scm.com for your platform.

2. Install Node.js (if you don't have it)

Download and install Node.js (includes npm) from nodejs.org for your platform.

3. Clone the Repository

git clone https://github.com/malkamius/node_rcon.git
cd node_rcon

4. Install Dependencies

npm install

4.5 (Windows Only)

Start a PowerShell as administrator and execute:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

SteamCMD Installation

To install SteamCMD, use the provided Node.js script:

node install-steamcmd.js <install-directory>

This will download and extract SteamCMD to the specified directory. The old PowerShell script is now deprecated. if you are unable to run npm

5. Build the Project

Build both backend and frontend:

npm run build

Or build separately:

npm run build:backend
npm run build:frontend

6. Run the Backend

npm start

The backend will start the web server and manage RCON connections.

5. Open the Frontend

Visit http://localhost:3000 (or your configured host/port) in your browser.


Usage

  • Tabs: Each server has its own tab with a terminal and status bar.
  • Toolbar: Use the toolbar to manage servers
  • Server Management: Add/edit/remove servers in the modal dialog (changes are live).
  • Player List: If enabled, see a live-updating list of players.
  • Chat: In-game chat messages appear in the terminal.
  • Reconnect: If the frontend loses connection to the backend, a modal will appear and auto-retry every 5 seconds.

Development

  • Backend: TypeScript, Express, rcon-client
  • Frontend: React, TypeScript, xterm.js, Material-UI
  • Build: Uses Webpack for frontend bundling

Debugging

VS Code debug configuration is available for backend (Node.js) with --inspect-brk for breakpoints and inspection.


License

MIT License. See LICENSE for details.


Credits


Screenshot

Screenshot Screenshot

About

An RCON manager for game servers, with a persistent Node.js backend and a React + xterm.js frontend. Supports multiple server profiles, live player lists, chat, and more. Focused on Ark: SA right now

Topics

Resources

License

Stars

Watchers

Forks