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. Go to takaro.io.
  2. Click on Pricing.
  3. Choose the Free tier for now.
  4. Check your email and follow the steps in the email.
  5. Once you're logged in, click Create Game Server.
  6. Name the server (this becomes your Identity Token).
  7. Choose Generic as the server type.
  8. Takaro will generate a Registration Token. Copy it — you'll paste it into the config file in Step 4.

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