diff --git a/CHANGELOG.md b/CHANGELOG.md
index b27dfb9..6832787 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,6 +15,7 @@
 * Myth of Empires - Added support.
 * Fix: BeamMP maxplayers that was displaying player count (By @dgibbs64 #551)
 * Fix: BeamMP filter servers by address, not host (By @Rephot #558)
+* Palworld - Replace old and broken protocol with the new one (#560)
 
 ## 5.0.0-beta.2
 * Fixed support for projects using `require`.
diff --git a/GAMES_LIST.md b/GAMES_LIST.md
index 5ce2199..e5c4ea6 100644
--- a/GAMES_LIST.md
+++ b/GAMES_LIST.md
@@ -210,7 +210,7 @@
 | openarena            | OpenArena                                        |                                                 |
 | openttd              | OpenTTD                                          |                                                 |
 | painkiller           | Painkiller                                       |                                                 |
-| palworld             | Palworld                                         | [EOS Protocol](#epic)                           |
+| palworld             | Palworld                                         | [Notes](#palworld)                              |
 | pce                  | Primal Carnage: Extinction                       | [Valve Protocol](#valve)                        |
 | pixark               | PixARK                                           | [Valve Protocol](#valve)                        |
 | postal2              | Postal 2                                         |                                                 |
@@ -459,3 +459,8 @@ option: `requestRules: true`. Beware that this may increase query time.
 
 ### <a name="epic"></a>Epic Online Services (EOS) Protocol
 EOS does not provide players data.
+
+### <a name="valve"></a>Palworld
+Palworld support can be unstable, the devs mention the api is currently experimental.  
+To query palworld servers, the `RESTAPIEnabled` must be `True` in the configuration file, and you need to pass
+the `username` (currently always `admin`) and `password` (settings parameter) for it.
diff --git a/lib/games.js b/lib/games.js
index cc1d853..aa05a77 100644
--- a/lib/games.js
+++ b/lib/games.js
@@ -2093,7 +2093,8 @@ export const games = {
     release_year: 2024,
     options: {
       port: 8212,
-      protocol: 'palworld'
+      protocol: 'palworld',
+      doc_notes: 'palworld'
     }
   },
   pvak2: {
diff --git a/tools/generate_games_list.js b/tools/generate_games_list.js
index d0c6146..7ec0e0d 100644
--- a/tools/generate_games_list.js
+++ b/tools/generate_games_list.js
@@ -34,7 +34,7 @@ for (const id in sortedGames) {
   if (game.options.protocol === 'valve' || game.options.protocol === 'dayz') {
     notes.push('[Valve Protocol](#valve)')
   }
-  if (game.options.protocol === 'epic' || game.options.protocol === 'asa' || game.options.protocol === 'palworld' || game.options.protocol === 'theisleevrima') {
+  if (game.options.protocol === 'epic' || game.options.protocol === 'asa' || game.options.protocol === 'theisleevrima') {
     notes.push('[EOS Protocol](#epic)')
   }
   if (notes.length) {