🚀 Astroneer - Takaro Integration

Connect your Astroneer dedicated server to Takaro using native RCON. No mods required!

â„šī¸ About Takaro
Takaro is a comprehensive game server management platform that provides powerful admin tools, moderation systems, player analytics, and automation features for game servers.
âš ī¸ IMPORTANT
Takaro is currently invite-only. To get access:
  1. Go to Takaro.io and complete the interest survey
  2. Join the Takaro Discord server
  3. Request an invite from the team
🚀 v1.22.0 - STABLE!
Added kick <name> support. You can now kick players by name instead of GUID.

đŸ“Ĩ Download

🌟 Download Latest Version (v1.22.0) 🌟

Released: March 1, 2026 | View All Releases

🆕 What's New in v1.22.0

Feature: kick <name> command alias

Astroneer RCON only supports KickPlayerGuid. Typing kick Crash would send an invalid command, causing a 15-second timeout and RCON reconnect. The bridge now intercepts kick <name>, looks up the player's GUID automatically, and sends the correct KickPlayerGuid command.

Example: kick Crash now works correctly.

📜 Previous Updates

v1.21.0 - Fix JSON commands showing as one line

The v1.19.0 plain-text fix caused JSON responses (ListPlayers, ListGames, ServerStatistics) to be returned as raw compact strings. The bridge now re-parses and pretty-prints any JSON response automatically.

v1.20.0 - Fix SaveGame/NewGame returning error

Astroneer does not send a response after SaveGame or NewGame. The bridge was waiting 15 seconds then returning an error. These commands now resolve immediately.

📜 Previous Updates

v1.19.0 - Fix RCON parse errors on plain-text responses

Commands like kick, ban, and unban return plain text from Astroneer. The bridge was trying to JSON-parse those responses, causing errors that triggered RCON reconnects and ghost clients firing duplicate events. Fixed by passing notJson=true to sendRaw for all direct commands.

v1.18.0 - Fix ghost RCON clients causing duplicate events

Every RCON error was creating a new client without disconnecting the old one. Multiple clients polling simultaneously doubled every player event. Fixed by calling removeAllListeners() and disconnect() on the old client before creating a new one.

v1.17.0 - Fix events blocked after game crash

Bug Fix: Events blocked after game crash

When a player's game crashed instead of cleanly disconnecting, the bridge was silently blocking their next connect event. This is now fixed — all connect and disconnect events fire correctly regardless of how a player leaves.

📜 Previous Updates

v1.16.0 - Remove initial player scan

Removed the initial player scan on RCON connect that was causing duplicate connected events every time the bridge restarted.

v1.13.0 - listEntities fix & newplayer dedup

Fixed listEntities error from Takaro. Removed redundant newplayer handler that was duplicating connect events.

v1.12.0 - Log rotation & deployment cleanup

Added log rotation (20-day retention), cleaned up server deployment scripts.

v1.11.9 - Code optimization & reliability

Player data validation, error tracking with metrics, max reconnect attempts, improved logging throughout.

v1.11.8 - Stable Release (superseded)

Added debug logging and confirmed all features working. Superseded by v1.11.9's reliability improvements.

v1.11.7 - Event Processing Fix

Fixed Event Processing Hang

Bridge now responds immediately to getPlayerLocation requests, allowing events to be created in the database.

Critical Fix - Event Processing No Longer Hangs

The Problem: Events were being sent correctly, but Takaro's request for getPlayerLocation was being queued instead of answered immediately. This caused event processing to hang indefinitely, preventing events from being created in the database.

The Fix:

Result: Full real-time player event support is now working!

📜 Previous Updates

v1.11.5 - Event Format Fix

Restored Working Event Format

Events now use type: 'gameEvent' as expected by Takaro instead of incorrect type: 'request' format.

Critical Fix - Event Format Restored

The Problem: Events were being sent with the wrong format (type: 'request') instead of the correct type: 'gameEvent' format. This caused Takaro to ignore all events, breaking Discord notifications and event-triggered hooks.

The Fix:

Combined with v1.11.4: Shutdown commands work reliably AND events trigger properly!

📜 Previous Updates

v1.11.4 - Shutdown Command Fix

Fixed Shutdown Breaking Bridge

Server shutdown commands no longer break the bridge. Shutdown executes asynchronously and RCON auto-reconnects.

v1.11.0-v1.11.3 - Click to expand

Critical Bug Fix - Shutdown Command No Longer Breaks Bridge

The Problem: In v1.11.2-v1.11.3, server shutdown commands would wait for RCON response, but the server would disconnect before responding. This caused errors that broke all subsequent bridge operations including player events.

The Fix:

  • Shutdown commands now respond immediately to Takaro
  • Server shutdown executes asynchronously without blocking
  • RCON auto-reconnects when server comes back online
  • Player connect/disconnect events work reliably again

Recommendation: If you're on v1.11.2 or v1.11.3, update immediately to restore full functionality.

📜 Previous Updates

v1.11.0-v1.11.3 - Click to expand

v1.11.0 - Player Events Fixed

Player connect/disconnect events now work instantly via WebSocket! Critical bugs fixed for real-time event delivery.

🔧 Technical Details (v1.11.0)

Critical Bug Fixes - Events Now Work Instantly!

The Problem: Events were being sent but silently dropped by Takaro due to two critical bugs:

Bug Fix #1 - Null Values in Optional Fields:

The bridge was sending null for optional fields like epicOnlineServicesId and ip. Takaro's strict validation rejects null values - optional fields must be completely omitted instead.

Bug Fix #2 - getPlayerLocation Hanging:

During event processing, Takaro requests player location. The bridge was queuing this request without responding, causing event processing to hang indefinitely.

The Result:

  1. ✅ Events delivered via WebSocket gameEvent messages (no module needed!)
  2. ✅ Instant event delivery (< 1 second latency)
  3. ✅ 100% reliability - events always created
  4. ✅ Hooks and Discord notifications work immediately
  5. ✅ Simpler architecture - just the bridge, no Takaro module required

⚡ Quick Start

  1. 1Install Node.js
    Easy way: Open PowerShell as Administrator and run:
    winget install OpenJS.NodeJS.LTS
    Or download: Direct Download (Windows x64)
    After installing, restart your computer
  2. 2Download & Extract
    Extract the zip file anywhere on your PC
  3. 3Enable RCON on Astroneer
    Open \astroneer\Astro\Saved\Config\WindowsServer\AstroServerSettings.ini in Notepad
    ADD these two lines (they won't be there by default):
    ConsolePort=8778
    ConsolePassword=your-password-here
    📝 Use any port number you want - just remember it for Step 4!
    Save and restart your Astroneer server
  4. 4Configure Bridge
    Open TakaroConfig.txt in Notepad and edit these settings:
    IDENTITY_TOKEN=your-server-name
    REGISTRATION_TOKEN=get-from-takaro-dashboard
    HTTP_PORT=3535
    RCON_HOST=127.0.0.1
    RCON_PORT=8778
    RCON_PASSWORD=same-password-as-step-3
    âš ī¸ RCON_PORT must match ConsolePort from Step 3!
    💡 If bridge is on same PC as Astroneer, keep RCON_HOST as 127.0.0.1
  5. 5Start the Bridge
    Double-click start.bat
    You should see: ✓ Connected to Takaro WebSocket & ✓ Connected to Astroneer RCON

✨ Features

🔌 RCON Integration

Uses Astroneer's native RCON protocol - no game modifications needed!

đŸ‘Ĩ Player Events

Real-time player join/leave notifications forwarded to Takaro

âš™ī¸ Remote Commands

Execute server commands through Takaro (kick, player list, etc.)

đŸ–Ĩī¸ Interactive Console

NEW! Direct RCON console for manual server administration and testing

📊 Monitoring

Built-in health endpoint with connection status and metrics

🔧 Configuration

The bridge uses a simple TakaroConfig.txt file for configuration. Get your tokens from the Takaro Dashboard.

đŸ–Ĩī¸ RCON Console (NEW!)

The bridge now includes an interactive RCON console for direct server administration!

To use: Double-click rcon-console.bat to open an interactive terminal.

Example commands: (Note: Commands are typed WITHOUT the "DS" prefix - it's added automatically)

RCON> help                    # Show all available commands
RCON> ListPlayers             # List all players
RCON> ServerStatistics        # Get detailed server stats
RCON> SaveGame MyBackup       # Save the game
RCON> exit                    # Close console

The console connects directly to your Astroneer server via RCON, allowing you to:

❓ Troubleshooting

🔗 Resources


Made with â¤ī¸ for the Astroneer community
Š 2025 | GitHub