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:
- CRITICAL FIX: Chat Event Handling - Fixed "Internal error handling game event" errors from Takaro when processing chat messages
- Player Cache Validation - Chat events now properly validate player is in cache before sending to Takaro
- Prevented Invalid Data - Removed fallback code that sent player names as gameId instead of Steam IDs
- Auto Cache Refresh - Triggers immediate player list refresh when cache miss occurs during chat events
Previous Release - v1.5.0:
- PlayerState Handling - Fixed intermittent invalid PlayerState causing location timeouts and teleport failures
- Player Name Consistency - Bridge now auto-corrects inconsistent names using authoritative UE4SS responses
- Teleport System -
!visit command now works reliably for all players
- Auto Log Cleanup - Bridge keeps only 10 most recent log files to prevent disk bloat
Download Latest Release
View Previous Versions
What You Get
- Bridge Service - Connects Palworld REST API to Takaro platform
- Player Tracking - Real-time location tracking and connect/disconnect events
- Console Commands - Kick, ban, announce, shutdown from Takaro web console
- Teleport System - Player-to-player and coordinate-based teleportation via queue system
- Location Lookup - Get live player coordinates (X/Y/Z) by name or Steam ID
- Chat Integration - Optional UE4SS mod for game chat to Discord (bi-directional)
Prerequisites
- Palworld dedicated server
- Node.js 18 or higher
- Takaro account - Get access at takaro.io or their Discord
Setup: Bridge
1. Enable Palworld REST API
Edit PalWorldSettings.ini in your Palworld server:
RESTAPIEnabled=True
RESTAPIPort=8212
AdminPassword=YourSecurePassword
2. Get Takaro Tokens
- Log into takaro.io
- Go to your game server settings
- 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
- Download
UE4SS-Palworld.zip from experimental-palworld release
- Extract entire
ue4ss folder to PalServer\Pal\Binaries\Win64\
- 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):
help - List all commands
players - Show online players
serverinfo - Server details
metrics - Server metrics
settings - Server settings
announce <message> - Send announcement
save - Save world
shutdown [seconds] [message] - Shutdown with countdown
stop - Stop immediately
kick <player_name> - Kick player
ban <player_name> - Ban player
unban <steam_id> - Unban player
teleportplayer <source> <target> - Teleport player to another player
teleportplayer <source> <x> <y> <z> - Teleport player to coordinates
location <player_name_or_gameid> - Get live player coordinates
Troubleshooting
Bridge Issues
Bridge won't connect to Takaro:
- Check IDENTITY_TOKEN and REGISTRATION_TOKEN are correct
- Check bridge logs for errors:
tail -f palworld-bridge.log or pm2 logs palworld-bridge
- Verify internet connectivity
Can't connect to Palworld server:
- Verify REST API is enabled in PalWorldSettings.ini
- Check AdminPassword matches between config and server
- Ensure port 8212 is accessible
- Confirm server is running
Chat Integration Issues
UE4SS not loading:
- Ensure
dwmapi.dll is in Win64\ directory
- Unblock DLL: Right-click → Properties → Unblock → Apply
- Verify UE4SS version 3.0.0 or higher
- Check
UE4SS.log for errors
Chat not appearing in Discord:
- Check bridge logs for incoming chat messages from mod
- Verify
config.BridgeURL uses correct port (default: http://localhost:3001/chat)
- Ensure Takaro has chat forwarding configured
- Confirm TakaroChat mod is enabled: check
enabled.txt exists
Command Issues
Commands not working:
- Ensure bridge is connected (check logs)
- Type commands in Takaro web console, NOT in-game chat
- Verify command syntax with
help command
Links