Palworld-Takaro Bridge v1.5.1

Connect your Palworld dedicated server to Takaro for Discord integration, player management, and server control.

What's New in v1.5.1:
Previous Release - v1.5.0:
Download Latest Release View Previous Versions

What You Get

Prerequisites

Setup: Bridge

1. Enable Palworld REST API

Edit PalWorldSettings.ini in your Palworld server:

RESTAPIEnabled=True
RESTAPIPort=8212
AdminPassword=YourSecurePassword

2. Get Takaro Tokens

  1. Log into takaro.io
  2. Go to your game server settings
  3. Copy your Identity Token and Registration Token

3. Install Bridge

git clone https://github.com/mad-001/Palworld-Bridge.git
cd Palworld-Bridge
npm install
npm run build

4. Configure Bridge

Create TakaroConfig.txt in the bridge directory:

# Takaro Connection
IDENTITY_TOKEN=YourIdentityToken
REGISTRATION_TOKEN=YourRegistrationToken

# Palworld Server Settings
PALWORLD_HOST=127.0.0.1
PALWORLD_PORT=8212
PALWORLD_USERNAME=admin
PALWORLD_PASSWORD=YourAdminPassword

5. Start Bridge

npm start
# Or with PM2:
pm2 start dist/index.js --name palworld-bridge
That's it! Your bridge should now connect to Takaro. Check the logs to confirm connection.

Setup: Chat Integration (Optional)

Enables game chat to forward to Discord and Discord messages to relay back to the game.

Prerequisites

Important: Palworld 0.4.1.5+ requires the Palworld-specific experimental UE4SS from Okaetsu's fork. The standard UE4SS will NOT work due to engine changes.

1. Install UE4SS

  1. Download UE4SS-Palworld.zip from experimental-palworld release
  2. Extract entire ue4ss folder to PalServer\Pal\Binaries\Win64\
  3. If Windows blocks files: Right-click → Properties → Unblock → Apply

2. Install TakaroChat Mod

Copy TakaroChat folder from bridge repository to:

PalServer\Pal\Binaries\Win64\ue4ss\Mods\TakaroChat\

Final structure:

PalServer\Pal\Binaries\Win64\
└── ue4ss\
    ├── UE4SS.dll
    ├── UE4SS-settings.ini
    └── Mods\
        └── TakaroChat\
            ├── enabled.txt
            └── Scripts\
                ├── main.lua
                └── config.lua

3. Configure TakaroChat

Edit TakaroChat/Scripts/config.lua:

-- Bridge Connection
config.BridgeURL = "http://localhost:3001/chat"  -- Bridge endpoint (default 3001)
config.EnableBridge = true

-- Chat Categories (Palworld chat types)
-- 1 = Say (local), 2 = Guild, 3 = Global
config.SendCategories = {1, 2, 3}  -- Which categories to send

4. Restart Palworld Server

Stop and start your server. UE4SS and TakaroChat will load automatically.

Chat working? Test by sending a message in-game. It should appear in your Discord channel via Takaro.

Available Commands

Use these in the Takaro web console (not in-game):

Troubleshooting

Bridge Issues

Bridge won't connect to Takaro:
Can't connect to Palworld server:

Chat Integration Issues

UE4SS not loading:
Chat not appearing in Discord:

Command Issues

Commands not working:

Links