Le guide du serveur Palworld

En bref

Palworld est proposé sur deux fiches distinctes du catalogue — Palworld (crossplateforme) et Palworld PC — chacune avec sa propre page d’achat. Le dashboard permet de voir les joueurs connectés, de les expulser ou bannir et de gérer les annonces. La gamme se choisit selon votre nombre de joueurs : de 5 (La Ficelle) à 32 (La Tourte d’Or).

Choisir la bonne fiche à l’achat

Palworld occupe deux fiches séparées du catalogue — pas un sélecteur d’édition sur une seule page :

• baguetoast.com/games/palworld — édition crossplateforme (PC + consoles).
• baguetoast.com/games/palworld-pc — édition PC.

Ce sont deux produits séparés du catalogue, avec chacun sa propre gamme et son propre abonnement : choisissez la bonne fiche avant l’achat.

1. Ouvrez la fiche correspondant à votre édition, puis choisissez votre gamme.
2. Cliquez sur « Choisir {gamme} », puis choisissez votre moyen de paiement : « Carte bancaire » ou « b@guetcoin » (voir essai gratuit et moyens de paiement).
3. Après le paiement, le déploiement est automatique (~60 secondes). Le détail pas à pas est dans Créer son premier serveur.

Astuce

En mode carte, si vous y êtes éligible, le dialogue affiche « Les 3 premiers jours sont offerts — aucun débit avant la fin de l’essai. » Profitez-en pour tester votre configuration.

Rejoindre votre serveur

Votre adresse de connexion est la pilule copiable hôte:port affichée dans le bandeau du serveur (visible sur tous les onglets), dans la barre de la console et dans Paramètres → « Réseau & ressources ». Copiez-la telle quelle : c’est toujours elle qui a raison. Le port est géré par la plateforme, vous ne pouvez pas le choisir. Tous les détails : Comment rejoindre votre serveur ?

Mot de passe admin et API Palworld

Le mot de passe administrateur reste nécessaire pour les commandes exécutées directement en jeu. Le dashboard propose en plus des outils dédiés dans les onglets Joueurs et Annonces.

1. Ouvrez votre serveur → onglet « Paramètres » → carte « Variables de démarrage ».
2. Renseignez ADMIN_PASSWORD (champ masqué) : c’est le mot de passe qui vous donne les droits d’administration en jeu.
3. Laissez l’interrupteur « Redémarrer le serveur après enregistrement » activé (c’est le défaut), puis cliquez « Enregistrer ».

La variable « Server Query Port » (QUERY_PORT) figure aussi dans cette carte : c’est le port TCP dédié à l’API REST officielle de Palworld (voir la section suivante). Il est géré par la plateforme, vous ne pouvez pas le modifier. Bon à savoir : RCON est déprécié par Pocketpair depuis Palworld 1.0 et désactivé sur nos serveurs — l’API REST le remplace, et la console du panel reste votre fenêtre sur les logs.

Attention

Par défaut, les variables n’acceptent que les caractères A-Z a-z 0-9 . _ -, sans espaces. Un mot de passe avec espaces ou caractères exotiques sera refusé avec le message « contient des caractères non autorisés ».

Le fonctionnement complet des variables est décrit dans Variables de démarrage et server.properties.

Automatiser son serveur : l’API REST Palworld

Envie d’écrire vos propres scripts (annonces d’événements, sauvegardes, suivi des joueurs) ? Chaque serveur Palworld expose l’API REST officielle du jeu — la même que le dashboard utilise pour les onglets Joueurs et Annonces. Rien à activer : elle est déjà en place.

API du jeu ≠ clés API BaguetToast

Cette API est celle du serveur Palworld lui-même (fournie par Pocketpair), pas celle de la plateforme. Les clés API BaguetToast de votre compte servent uniquement à nos intégrations (comme le bot Discord) et ne sont pas destinées à l’automatisation de votre serveur de jeu : pour vos scripts, c’est bien l’API REST Palworld décrite ici qu’il faut utiliser.

• URL de base : http://<hôte>:<port>/v1/api — l’hôte est celui de votre pilule d’adresse (par ex. node1.baguetoast.com, sans le port du jeu), et le port est la variable « Server Query Port » visible dans Paramètres → « Variables de démarrage ».
• Authentification : HTTP Basic, utilisateur admin, mot de passe = votre ADMIN_PASSWORD (défini comme expliqué ci-dessus).

Exemples prêts à l’emploi — remplacez l’hôte, le port et le mot de passe par les vôtres :

Shell

palworld-api.sh

#!/usr/bin/env bash
# ── Configuration ─────────────────────────────────────────────
# HOTE : l'hôte de votre pilule d'adresse (sans le port du jeu)
# PORT : Paramètres → Variables de démarrage → « Server Query Port »
HOTE="node1.baguetoast.com"
PORT="25580"
BASE="http://${HOTE}:${PORT}/v1/api"
AUTH="admin:VOTRE_ADMIN_PASSWORD"   # HTTP Basic

# Infos du serveur (nom, version, uptime…)
curl -s -u "$AUTH" "$BASE/info"

# Joueurs connectés
curl -s -u "$AUTH" "$BASE/players"

# Annonce in-game pour tous les joueurs connectés
curl -s -u "$AUTH" -X POST "$BASE/announce" \
     -H "Content-Type: application/json" \
     -d '{"message": "Éclosion x2 dans 10 minutes !"}'

# Sauvegarde du monde
curl -s -u "$AUTH" -X POST "$BASE/save"

Python

palworld_api.py

"""Automatiser un serveur Palworld BaguetToast via l'API REST officielle."""
import requests

# ── Configuration ─────────────────────────────────────────────
# hôte : celui de votre pilule d'adresse (sans le port du jeu)
# port : Paramètres → Variables de démarrage → « Server Query Port »
BASE = "http://node1.baguetoast.com:25580/v1/api"
AUTH = ("admin", "VOTRE_ADMIN_PASSWORD")  # HTTP Basic


def annonce(message: str) -> None:
    """Diffuse un message in-game à tous les joueurs connectés."""
    r = requests.post(f"{BASE}/announce", auth=AUTH,
                      json={"message": message}, timeout=10)
    r.raise_for_status()


def sauvegarde() -> None:
    """Force une sauvegarde du monde."""
    requests.post(f"{BASE}/save", auth=AUTH, timeout=30).raise_for_status()


def joueurs() -> list[dict]:
    """Retourne la liste des joueurs connectés."""
    r = requests.get(f"{BASE}/players", auth=AUTH, timeout=10)
    r.raise_for_status()
    return r.json()["players"]


if __name__ == "__main__":
    annonce("Éclosion x2 dans 10 minutes !")
    sauvegarde()
    print(f"{len(joueurs())} joueur(s) en ligne")

JavaScript

palworld-api.mjs

// Node.js 18+ : fetch est natif, aucune dépendance à installer.

// ── Configuration ─────────────────────────────────────────────
// hôte : celui de votre pilule d'adresse (sans le port du jeu)
// port : Paramètres → Variables de démarrage → « Server Query Port »
const BASE = "http://node1.baguetoast.com:25580/v1/api";
const AUTH =
  "Basic " + Buffer.from("admin:VOTRE_ADMIN_PASSWORD").toString("base64");

// Annonce in-game pour tous les joueurs connectés
await fetch(`${BASE}/announce`, {
  method: "POST",
  headers: { Authorization: AUTH, "Content-Type": "application/json" },
  body: JSON.stringify({ message: "Éclosion x2 dans 10 minutes !" }),
});

// Sauvegarde du monde
await fetch(`${BASE}/save`, { method: "POST", headers: { Authorization: AUTH } });

// Joueurs connectés
const res = await fetch(`${BASE}/players`, { headers: { Authorization: AUTH } });
const { players } = await res.json();
console.log(`${players.length} joueur(s) en ligne`);

TypeScript

palworld-api.ts

// Node.js 18+ ou Bun — fetch natif, aucune dépendance.

// ── Configuration ─────────────────────────────────────────────
// hôte : celui de votre pilule d'adresse (sans le port du jeu)
// port : Paramètres → Variables de démarrage → « Server Query Port »
const BASE = "http://node1.baguetoast.com:25580/v1/api";
const AUTH =
  "Basic " + Buffer.from("admin:VOTRE_ADMIN_PASSWORD").toString("base64");

interface Player {
  name: string;
  accountName: string;
  playerId: string;
  level: number;
}

async function api<T = unknown>(path: string, init: RequestInit = {}): Promise<T> {
  const res = await fetch(`${BASE}${path}`, {
    ...init,
    headers: { Authorization: AUTH, "Content-Type": "application/json", ...init.headers },
  });
  if (!res.ok) throw new Error(`API Palworld : HTTP ${res.status}`);
  // Les POST répondent 200 avec un corps vide : on ne parse que s'il y a du JSON
  const text = await res.text();
  return (text ? JSON.parse(text) : {}) as T;
}

// Annonce in-game pour tous les joueurs connectés
await api("/announce", {
  method: "POST",
  body: JSON.stringify({ message: "Éclosion x2 dans 10 minutes !" }),
});

// Sauvegarde du monde
await api("/save", { method: "POST" });

// Joueurs connectés
const { players } = await api<{ players: Player[] }>("/players");
console.log(`${players.length} joueur(s) en ligne`);

Go

palworld-api.go

// Automatiser un serveur Palworld BaguetToast via l'API REST officielle.
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "log"
  "net/http"
  "time"
)

// ── Configuration ─────────────────────────────────────────────
// hôte : celui de votre pilule d'adresse (sans le port du jeu)
// port : Paramètres → Variables de démarrage → « Server Query Port »
const (
  baseURL  = "http://node1.baguetoast.com:25580/v1/api"
  password = "VOTRE_ADMIN_PASSWORD" // HTTP Basic, utilisateur « admin »
)

var client = &http.Client{Timeout: 10 * time.Second}

// call exécute une requête authentifiée vers l'API REST du serveur.
func call(method, path string, payload any) (*http.Response, error) {
  body := &bytes.Buffer{}
  if payload != nil {
    if err := json.NewEncoder(body).Encode(payload); err != nil {
      return nil, err
    }
  }
  req, err := http.NewRequest(method, baseURL+path, body)
  if err != nil {
    return nil, err
  }
  req.SetBasicAuth("admin", password)
  req.Header.Set("Content-Type", "application/json")
  return client.Do(req)
}

func main() {
  // Annonce in-game pour tous les joueurs connectés
  if _, err := call(http.MethodPost, "/announce",
    map[string]string{"message": "Éclosion x2 dans 10 minutes !"}); err != nil {
    log.Fatal(err)
  }

  // Sauvegarde du monde
  if _, err := call(http.MethodPost, "/save", nil); err != nil {
    log.Fatal(err)
  }

  // Joueurs connectés
  resp, err := call(http.MethodGet, "/players", nil)
  if err != nil {
    log.Fatal(err)
  }
  defer resp.Body.Close()

  var out struct {
    Players []struct {
      Name  string `json:"name"`
      Level int    `json:"level"`
    } `json:"players"`
  }
  if err := json.NewDecoder(resp.Body).Decode(&out); err != nil {
    log.Fatal(err)
  }
  fmt.Printf("%d joueur(s) en ligne\n", len(out.Players))
}

Référence des endpoints

Chaque endpoint est détaillé dans la documentation officielle Palworld :

Méthode	Endpoint	Rôle	Doc officielle
GET	/v1/api/info	Nom, version et description du serveur	info
GET	/v1/api/players	Joueurs connectés (nom, niveau, ping…)	players
GET	/v1/api/settings	Configuration du monde — lecture seule	settings
GET	/v1/api/metrics	Métriques temps réel (FPS, joueurs, uptime)	metrics
POST	/v1/api/announce	Annonce in-game à tous les joueurs	announce
POST	/v1/api/save	Sauvegarde du monde	save
POST	/v1/api/kick	Expulser un joueur	kick
POST	/v1/api/ban	Bannir un joueur	ban
POST	/v1/api/unban	Débannir un joueur	unban
POST	/v1/api/shutdown	Arrêt du serveur — à éviter, voir l’encart ci-dessous	shutdown
POST	/v1/api/stop	Arrêt forcé immédiat — à éviter, voir l’encart ci-dessous	stop

Trois limites à connaître

1. GET /settings est en lecture seule — c’est une limite du jeu, pas de la plateforme. Pour modifier la configuration du monde, passez par l’onglet Configuration ou éditez PalWorldSettings.ini via SFTP ; un redémarrage reste nécessaire pour appliquer les changements.
2. N’appelez pas POST /shutdown ni POST /stop : ils arrêtent le serveur mais rien ne le relance derrière — le redémarrage propre (annonces, sauvegarde, arrêt, relance) est orchestré par la plateforme. Tout se règle dans l’onglet Planification décrit plus bas : redémarrages quotidiens et hebdomadaires, et même des événements planifiés qui changent un réglage sur un créneau avec redémarrage automatique aux deux bornes — plus besoin de script pour ça ; le vôtre peut se concentrer sur l’habillage (annonces, sauvegardes).
3. L’API du jeu est servie en HTTP simple (pas de HTTPS) : le mot de passe transite en clair. Choisissez un ADMIN_PASSWORD dédié, que vous n’utilisez nulle part ailleurs.

Régler le monde depuis l’onglet Configuration

Au-delà des variables de démarrage, Palworld dispose d’un onglet « Configuration » dédié : un formulaire complet de PalWorldSettings.ini (plus d’une centaine d’options, organisées par catégories), avec des préréglages rapides — Défaut, Casual, Hardcore, PvP.

1. Ouvrez votre serveur → onglet « Configuration ».
2. Ajustez les réglages un par un, ou partez d’un préréglage.
3. Enregistrez : le fichier est réécrit sur le serveur. Comme pour les variables de démarrage, un redémarrage est nécessaire pour que les changements s’appliquent en jeu.

Astuce

Le nom du serveur, le mot de passe admin, le nombre de joueurs max et les réglages RCON restent verrouillés dans cet onglet : ils sont pilotés par les variables de démarrage vues ci-dessus, pour éviter toute incohérence entre les deux.

Gérer les joueurs

L’onglet Joueurs affiche en direct les joueurs connectés et la liste des joueurs bannis. Vous pouvez :

• expulser un joueur connecté ;
• bannir un joueur, avec un motif facultatif ;
• débannir un joueur depuis la liste des bannis.

Ces actions nécessitent un serveur en ligne et une API Palworld accessible. Si le dashboard indique qu’un redémarrage est requis, redémarrez le serveur depuis l’onglet Console, puis revenez dans Joueurs. Pour les autres commandes d’administration, utilisez le mot de passe ADMIN_PASSWORD en jeu.

Envoyer et programmer des annonces

L’onglet Annonces permet d’envoyer un message immédiatement aux joueurs connectés ou de créer des annonces récurrentes.

1. Pour une annonce immédiate, saisissez un message de 200 caractères maximum puis cliquez sur Envoyer.
2. Pour une annonce automatique, saisissez le message, choisissez un intervalle entre 5 minutes et 24 heures, puis ajoutez-la.
3. Activez, désactivez ou supprimez ensuite chaque annonce depuis la liste.

Les annonces automatiques restent configurables même si l’API live est momentanément indisponible. Une annonce immédiate nécessite en revanche que le serveur et son API Palworld soient joignables.

Pour le reste : utilisez la console pour les logs, les métriques et alertes pour les ressources, et l’onglet Partage pour inviter des co-gérants.

Redémarrages automatiques (planification)

Un serveur Palworld gagne à être redémarré régulièrement : après plusieurs jours d’affilée, il consomme de plus en plus de mémoire et finit par ramer. L’onglet Planification — visible uniquement sur les serveurs Palworld — s’occupe de ces redémarrages à votre place. Ouvrez votre serveur → onglet « Planification ».

Tout est en heure de Paris

Les horaires affichés et réglés dans cet onglet sont exprimés en heure de Paris (changement d’heure été/hiver compris). Un redémarrage réglé sur 08:00 se déclenche bien à 8 h.

Les deux redémarrages quotidiens obligatoires. Deux redémarrages automatiques sont imposés chaque jour, par défaut à 08:00 et 22:00. Ils ne peuvent être ni supprimés ni désactivés — c’est le minimum pour garder le serveur en forme — mais vous restez libre d’en changer l’heure pour tomber sur vos creux de fréquentation. Besoin d’un passage de plus ? Ajoutez un troisième redémarrage optionnel (3 au maximum au total) ; celui-là, vous pouvez le retirer quand vous voulez.

Les redémarrages hebdomadaires. Besoin d’un redémarrage qui n’a lieu qu’un jour précis de la semaine ? Ajoutez jusqu’à 4 redémarrages hebdomadaires (jour + heure), en plus des quotidiens. Ils suivent le même déroulé (annonces, sauvegarde, relance automatique) et se suppriment librement.

Les événements planifiés. Le même onglet permet de créer jusqu’à 3 événements : un créneau hebdomadaire (début/fin, y compris à cheval sur minuit) pendant lequel un ou plusieurs réglages de PalWorldSettings.ini prennent une valeur spéciale, puis reviennent automatiquement à la normale — avec un redémarrage propre à chaque borne pour appliquer le changement. Exemple : « Éclosion instantanée » le vendredi de 20h00 à 21h00, avec PalEggDefaultHatchingTime à 0 pendant l’événement et 5 le reste du temps. Chaque événement accepte de 1 à 5 réglages, choisis parmi les options non verrouillées de l’onglet Configuration.

Les annonces avant redémarrage. Avant chaque redémarrage, le serveur prévient les joueurs connectés par une série de messages en jeu, pour que personne ne soit pris de court. Vous composez librement cette liste : pour chaque annonce, choisissez le délai (nombre de minutes avant le redémarrage) et le texte du message. Par défaut, trois annonces sont programmées à 10, 5 et 1 minute avant l’heure, du type « ⚠️ Redémarrage du serveur dans 10 minutes ». Vous pouvez en garder de 1 à 8, et elles s’appliquent à tous les redémarrages — les deux obligatoires comme l’optionnel. Par exemple :

• 5 minutes avant → ⚠️ Redémarrage dans 5 minutes, mettez-vous à l'abri !
• 1 minute avant → 🥖 Redémarrage imminent, à tout de suite !

Le déroulé d’un redémarrage. À l’heure prévue, l’opération se déroule toujours dans le même ordre : les annonces sont diffusées en jeu aux délais choisis, puis le monde est sauvegardé, le serveur s’arrête proprement et redémarre automatiquement dans la foulée.

Prérequis : le mot de passe administrateur

La planification passe par l’API REST de Palworld pour diffuser les annonces et arrêter le serveur : un mot de passe administrateur (ADMIN_PASSWORD) doit donc être défini, sans quoi les redémarrages ne pourront pas s’exécuter. Renseignez-le comme expliqué plus haut dans « Mot de passe admin et API Palworld ».

Sauvegardes et monde

Toutes les gammes incluent des sauvegardes automatiques imposées : 3 par 24 h sur La Ficelle, 5 sur La Baguette, 7 sur La Tradition et 12 toutes les 12 h sur La Tourte d’Or. Ajoutez-y des sauvegardes manuelles avant chaque moment risqué avec le bouton « Créer un backup » de l’en-tête du serveur (désactivé pendant une installation).

Danger

Restaurer une sauvegarde remplace les données actuelles du serveur. Lisez d’abord Sauvegardes : créer, restaurer, comprendre les quotas avant toute restauration.

Quelle gamme pour combien de joueurs ?

Voici notre grille de joueurs recommandés pour Palworld :

Gamme	Prix/mois	Joueurs recommandés
🥖 La Ficelle	6,99 €	5
🍞 La Baguette	13,99 €	10
🌾 La Tradition	21,99 €	20
👑 La Tourte d’Or	27,99 €	32

Vous pouvez changer de gamme à chaud sans recréer le serveur. Pour comparer les gammes en détail : Quelle gamme choisir ?

Passer de crossplateforme à PC (ou l’inverse)

Crossplateforme et PC sont deux jeux distincts du catalogue, pas deux variantes d’un même jeu : il n’existe pas de bascule légère entre les deux qui préserverait votre monde ou votre configuration. Deux options :

• Acheter un serveur sur l’autre fiche (Palworld ou Palworld PC) : la solution la plus sûre, votre serveur actuel n’est pas touché.
• Changer de jeu sur le serveur existant (Paramètres → « Zone de danger » → « Changer le jeu ») : techniquement possible, mais c’est une opération destructrice.

Danger

Changer de jeu efface définitivement le monde, les fichiers et la configuration du serveur actuel — une case de consentement obligatoire vous le rappelle. Créez une sauvegarde avant de vous lancer, et lisez Changer de jeu, réinstaller : que garde-t-on ?

Problèmes fréquents

« L’onglet Joueurs demande un redémarrage. » Le serveur utilise encore l’ancien mode de communication Palworld. Redémarrez-le depuis l’onglet Console pour activer l’API nécessaire aux joueurs connectés, aux bannissements et aux annonces immédiates.

« Je ne vois pas d’onglet Mods ou Workshop. » C’est normal : ces onglets n’apparaissent que pour les jeux qui les supportent. La configuration Palworld reste disponible dans l’onglet Configuration et dans les variables de démarrage.

« Ma variable est refusée : caractères non autorisés. » Le message « contient des caractères non autorisés (seuls A-Z, a-z, 0-9, ., _, - sont permis…) » indique un espace ou un caractère spécial dans la valeur. Simplifiez-la, puis réessayez.

« Mon serveur est injoignable. » Vérifiez qu’il est bien « En ligne », puis re-copiez la pilule d’adresse du bandeau (une adresse notée ailleurs peut être périmée). Si cela ne suffit pas, suivez la checklist dédiée.

« J’ai enregistré mes variables mais rien n’a changé en jeu. » Si l’interrupteur « Redémarrer le serveur après enregistrement » était désactivé, les modifications ne prendront effet qu’au prochain démarrage — le toast le précise. Redémarrez le serveur pour les appliquer.