Merge remote-tracking branch 'myfork/flopinguin-fix-nation-relation-exploit' into flopinguin-fix-nation-relation-exploit

Author: FloPinguin

.github/workflows/pr-description.yml

@@ -73,7 +73,7 @@ jobs:
               // Get the pull request data
               const milestone = context.payload.pull_request.milestone;
               if (!milestone) {
-                core.setFailed('❌ Pull request must have a milestone assigned before merging.');
+                core.setFailed('❌ Reviewer must assign a Milestone to this Pull request before merging.');
                 return;
               }
               console.log(`✅ Milestone found: ${milestone.title}`);

API.md

@@ -1,4 +1,6 @@
-## API Usage
+# API Usage
+
+## Games
 
 ### List Game Metadata
 
@@ -40,8 +42,7 @@ curl "https://api.openfront.io/public/games?start=2025-10-25T00:00:00Z&end=2025-
     "type": "Singleplayer",
     "mode": "Free For All",
     "difficulty": "Medium"
-  },
-  ...
+  }
 ]
 ```
 
@@ -75,7 +76,7 @@ curl "https://api.openfront.io/public/game/ABSgwin6?turns=false"
 
 **Note:** Public player IDs are stripped from game records for privacy.
 
----
+## Players
 
 ### Get Player Info
 
@@ -108,3 +109,100 @@ GET https://api.openfront.io/public/player/:playerId/sessions
 ```bash
 curl "https://api.openfront.io/public/player/HabCsQYR/sessions"
 ```
+
+## Clans
+
+### Clan Leaderboard
+
+Shows the top 100 clans by `weighted wins`.
+
+**Endpoint:**
+
+```
+GET https://api.openfront.io/public/clans/leaderboard
+```
+
+Weighted wins have a half-life of 30 days to favor recent wins.
+
+Weighted wins are calculated using the following formula:
+
+```
+FUNCTION calculateScore(session: ClanSession, decay: NUMBER = 1) → NUMBER
+    // 1. Calculate average team size
+    avgTeamSize ← session.totalPlayerCount ÷ session.numTeams
+
+    // 2. Determine how much the clan contributed to their team
+    //    (clan players divided by average players per team)
+    clanMemberRatio ← session.clanPlayerCount ÷ avgTeamSize
+
+    // 3. Apply decay factor (e.g., for older sessions)
+    weightedValue ← clanMemberRatio × decay
+
+    // 4. Calculate match difficulty based on number of teams
+    //    More teams → harder to win → higher reward for victory
+    //    Uses square root to avoid extreme scaling
+    difficulty ← MAX(1, √(session.numTeams - 1))
+
+    // 5. Return final score:
+    //    - Win:  reward is multiplied by difficulty
+    //    - Loss: penalty is divided by difficulty (less punishment in harder matches)
+    IF session.hasWon THEN
+        RETURN weightedValue × difficulty
+    ELSE
+        RETURN weightedValue ÷ difficulty
+    END IF
+END FUNCTION
+```
+
+### Clan stats
+
+Displays comprehensive clan performance statistics for a specified clan over a chosen time range. If no time range is provided, it shows lifetime stats (starting from early November 2025).
+
+Key metrics include:
+
+- Total games, wins, losses, and win rate
+- Win/loss ratio and weighted win/loss ratio\* broken down by:
+  - Team type (e.g., 2 teams, 3 teams, duos, trios, etc)
+  - Number of teams in the game (2 teams, 5 teams, 20 teams, etc)
+
+**Note:** No decay is used, so weighted wins will be different from in the leaderboard.
+
+**Endpoint**
+
+```
+GET https://openfront.io/public/clan/:clanTag
+```
+
+**Query Parameters:**
+
+- `start` (optional): ISO 8601 timestamp
+- `end` (optonal): ISO 8601 timestamp
+
+**Example**
+
+```bash
+curl https://api.openfront.io/public/clan/UN?start=2025-11-15T00:00:00Z &
+end=2025-11-18T23:59:59Z
+```
+
+### Clan Sessions
+
+A clan session is created any time a player with that clan tag is in a public team game. If no start or end query parameter is provided, lifetime sessions (starting early November 2025) are shown.
+
+**Endpoint**
+
+```
+GET https://api.openfront.io/public/clan/:clanTag/sessions
+```
+
+**Query Parameters:**
+
+- `start` (optional): ISO 8601 timestamp
+- `end` (optonal): ISO 8601 timestamp
+
+**Example**
+
+```bash
+curl https://api.openfront.io/public/clan/UN/sessions?start=2025-11-15T00:00:00Z &
+end=2025-11-18T23:59:59Z
+```

CREDITS.md

@@ -25,4 +25,6 @@ Licensed under [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/)
 
 ## Icons
 
-Icons from [The Noun Project](https://thenounproject.com/)
+### [The Noun Project](https://thenounproject.com/)
+
+Stats icon by [Meko](https://thenounproject.com/mekoda/) – https://thenounproject.com/icon/stats-4942475/

map-generator/assets/maps/africa/info.json

@@ -87,7 +87,7 @@
     },
     {
       "coordinates": [1094, 1093],
-      "name": "Democratic Republic of the Congo",
+      "name": "DR Congo",
       "strength": 2,
       "flag": "cd"
     },

map-generator/assets/maps/europe/info.json

@@ -153,7 +153,7 @@
     },
     {
       "coordinates": [517, 1483],
-      "name": "People's Democratic Republic of Algeria",
+      "name": "Algeria",
       "strength": 1,
       "flag": "dz"
     },

map-generator/assets/maps/fourislands/image.png

@@ -0,0 +1,29 @@
+{
+  "name": "Four Islands",
+  "nations": [
+    {
+      "coordinates": [403, 1296],
+      "flag": "",
+      "name": "Korinthal",
+      "strength": 2
+    },
+    {
+      "coordinates": [1152, 1251],
+      "flag": "",
+      "name": "Lunareth",
+      "strength": 2
+    },
+    {
+      "coordinates": [1328, 322],
+      "flag": "",
+      "name": "Sylvoria",
+      "strength": 2
+    },
+    {
+      "coordinates": [114, 121],
+      "flag": "",
+      "name": "Myrkwind",
+      "strength": 2
+    }
+  ]
+}

map-generator/assets/maps/fourislands/info.json

@@ -69,7 +69,7 @@
     },
     {
       "coordinates": [1609, 1837],
-      "name": "People's Republic of Algeria'",
+      "name": "Algeria'",
       "strength": 2,
       "flag": "dz"
     },

map-generator/assets/maps/gatewaytotheatlantic/info.json

@@ -51,7 +51,7 @@
     },
     {
       "coordinates": [1409, 372],
-      "name": "Palestinian Territory",
+      "name": "Palestine",
       "strength": 1,
       "flag": "ps"
     },

map-generator/assets/maps/mena/info.json

@@ -69,7 +69,7 @@
     },
     {
       "coordinates": [143, 37],
-      "name": "Lao People's Democratic Republic",
+      "name": "Lao PDR",
       "strength": 1,
       "flag": "la"
     },
@@ -99,7 +99,7 @@
     },
     {
       "coordinates": [834, 215],
-      "name": "Federated States of Micronesia",
+      "name": "Micronesia",
       "strength": 1,
       "flag": "fm"
     },