@modbender/capacitor-play-games 0.3.0

package/dist/esm/web.d.ts

@@ -0,0 +1,33 @@
+import { WebPlugin } from "@capacitor/core";
+import type { IdentityVerificationSignature, PlayerInfo, PlayGamesPlugin, SignInResult, Snapshot, SnapshotMeta } from "./definitions";
+/**
+ * Web / non-native fallback: every method resolves to a safe default (signed
+ * out, empty). Gate feature usage behind `isSignedIn()`, which is `false` here.
+ */
+export declare class PlayGamesWeb extends WebPlugin implements PlayGamesPlugin {
+    initialize(): Promise<void>;
+    signIn(): Promise<SignInResult>;
+    isSignedIn(): Promise<{
+        signedIn: boolean;
+    }>;
+    getPlayer(): Promise<PlayerInfo>;
+    requestServerSideAccess(): Promise<{
+        authCode: string;
+    }>;
+    fetchIdentityVerificationSignature(): Promise<IdentityVerificationSignature>;
+    unlockAchievement(): Promise<void>;
+    incrementAchievement(): Promise<void>;
+    showAchievements(): Promise<void>;
+    submitScore(): Promise<void>;
+    showLeaderboard(): Promise<void>;
+    showAllLeaderboards(): Promise<void>;
+    loadSnapshot(): Promise<{
+        snapshot: Snapshot | null;
+    }>;
+    saveSnapshot(): Promise<void>;
+    listSnapshots(): Promise<{
+        snapshots: SnapshotMeta[];
+    }>;
+    deleteSnapshot(): Promise<void>;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/esm/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,6BAA6B,EAC7B,UAAU,EACV,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,YAAY,EACb,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,qBAAa,YAAa,SAAQ,SAAU,YAAW,eAAe;IAC9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAE9B,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC,CAEpC;IAEK,UAAU,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAEjD;IAEK,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAErC;IAEK,uBAAuB,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAE7D;IAEK,kCAAkC,IAAI,OAAO,CAAC,6BAA6B,CAAC,CASjF;IAEK,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAErC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAExC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAEpC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAE/B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAEnC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAEvC,YAAY,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE,CAAC,CAE3D;IAEK,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAEhC,aAAa,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAE5D;IAEK,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CACzC"}

package/dist/esm/web.js

@@ -0,0 +1,45 @@
+import { WebPlugin } from "@capacitor/core";
+/**
+ * Web / non-native fallback: every method resolves to a safe default (signed
+ * out, empty). Gate feature usage behind `isSignedIn()`, which is `false` here.
+ */
+export class PlayGamesWeb extends WebPlugin {
+    async initialize() { }
+    async signIn() {
+        return { signedIn: false };
+    }
+    async isSignedIn() {
+        return { signedIn: false };
+    }
+    async getPlayer() {
+        return { playerId: "", displayName: "" };
+    }
+    async requestServerSideAccess() {
+        return { authCode: "" };
+    }
+    async fetchIdentityVerificationSignature() {
+        return {
+            publicKeyUrl: "",
+            signature: "",
+            salt: "",
+            timestamp: 0,
+            playerId: "",
+            bundleId: "",
+        };
+    }
+    async unlockAchievement() { }
+    async incrementAchievement() { }
+    async showAchievements() { }
+    async submitScore() { }
+    async showLeaderboard() { }
+    async showAllLeaderboards() { }
+    async loadSnapshot() {
+        return { snapshot: null };
+    }
+    async saveSnapshot() { }
+    async listSnapshots() {
+        return { snapshots: [] };
+    }
+    async deleteSnapshot() { }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAW5C;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC,KAAK,CAAC,UAAU,KAAmB,CAAC;IAEpC,KAAK,CAAC,MAAM;QACV,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,uBAAuB;QAC3B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,kCAAkC;QACtC,OAAO;YACL,YAAY,EAAE,EAAE;YAChB,SAAS,EAAE,EAAE;YACb,IAAI,EAAE,EAAE;YACR,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB,KAAmB,CAAC;IAE3C,KAAK,CAAC,oBAAoB,KAAmB,CAAC;IAE9C,KAAK,CAAC,gBAAgB,KAAmB,CAAC;IAE1C,KAAK,CAAC,WAAW,KAAmB,CAAC;IAErC,KAAK,CAAC,eAAe,KAAmB,CAAC;IAEzC,KAAK,CAAC,mBAAmB,KAAmB,CAAC;IAE7C,KAAK,CAAC,YAAY;QAChB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,YAAY,KAAmB,CAAC;IAEtC,KAAK,CAAC,aAAa;QACjB,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,cAAc,KAAmB,CAAC;CACzC"}

package/dist/plugin.cjs.js

@@ -0,0 +1,59 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const PlayGames = core.registerPlugin("PlayGames", {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.PlayGamesWeb()),
+});
+
+/**
+ * Web / non-native fallback: every method resolves to a safe default (signed
+ * out, empty). Gate feature usage behind `isSignedIn()`, which is `false` here.
+ */
+class PlayGamesWeb extends core.WebPlugin {
+    async initialize() { }
+    async signIn() {
+        return { signedIn: false };
+    }
+    async isSignedIn() {
+        return { signedIn: false };
+    }
+    async getPlayer() {
+        return { playerId: "", displayName: "" };
+    }
+    async requestServerSideAccess() {
+        return { authCode: "" };
+    }
+    async fetchIdentityVerificationSignature() {
+        return {
+            publicKeyUrl: "",
+            signature: "",
+            salt: "",
+            timestamp: 0,
+            playerId: "",
+            bundleId: "",
+        };
+    }
+    async unlockAchievement() { }
+    async incrementAchievement() { }
+    async showAchievements() { }
+    async submitScore() { }
+    async showLeaderboard() { }
+    async showAllLeaderboards() { }
+    async loadSnapshot() {
+        return { snapshot: null };
+    }
+    async saveSnapshot() { }
+    async listSnapshots() {
+        return { snapshots: [] };
+    }
+    async deleteSnapshot() { }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    PlayGamesWeb: PlayGamesWeb
+});
+
+exports.PlayGames = PlayGames;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nconst PlayGames = registerPlugin(\"PlayGames\", {\n    web: () => import(\"./web\").then((m) => new m.PlayGamesWeb()),\n});\nexport * from \"./definitions\";\nexport { PlayGames };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\n/**\n * Web / non-native fallback: every method resolves to a safe default (signed\n * out, empty). Gate feature usage behind `isSignedIn()`, which is `false` here.\n */\nexport class PlayGamesWeb extends WebPlugin {\n    async initialize() { }\n    async signIn() {\n        return { signedIn: false };\n    }\n    async isSignedIn() {\n        return { signedIn: false };\n    }\n    async getPlayer() {\n        return { playerId: \"\", displayName: \"\" };\n    }\n    async requestServerSideAccess() {\n        return { authCode: \"\" };\n    }\n    async fetchIdentityVerificationSignature() {\n        return {\n            publicKeyUrl: \"\",\n            signature: \"\",\n            salt: \"\",\n            timestamp: 0,\n            playerId: \"\",\n            bundleId: \"\",\n        };\n    }\n    async unlockAchievement() { }\n    async incrementAchievement() { }\n    async showAchievements() { }\n    async submitScore() { }\n    async showLeaderboard() { }\n    async showAllLeaderboards() { }\n    async loadSnapshot() {\n        return { snapshot: null };\n    }\n    async saveSnapshot() { }\n    async listSnapshots() {\n        return { snapshots: [] };\n    }\n    async deleteSnapshot() { }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,SAAS,GAAGA,mBAAc,CAAC,WAAW,EAAE;AAC9C,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;AAChE,CAAC;;ACFD;AACA;AACA;AACA;AACO,MAAM,YAAY,SAASC,cAAS,CAAC;AAC5C,IAAI,MAAM,UAAU,GAAG,EAAE;AACzB,IAAI,MAAM,MAAM,GAAG;AACnB,QAAQ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;AAClC,IAAI;AACJ,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;AAClC,IAAI;AACJ,IAAI,MAAM,SAAS,GAAG;AACtB,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;AAChD,IAAI;AACJ,IAAI,MAAM,uBAAuB,GAAG;AACpC,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;AAC/B,IAAI;AACJ,IAAI,MAAM,kCAAkC,GAAG;AAC/C,QAAQ,OAAO;AACf,YAAY,YAAY,EAAE,EAAE;AAC5B,YAAY,SAAS,EAAE,EAAE;AACzB,YAAY,IAAI,EAAE,EAAE;AACpB,YAAY,SAAS,EAAE,CAAC;AACxB,YAAY,QAAQ,EAAE,EAAE;AACxB,YAAY,QAAQ,EAAE,EAAE;AACxB,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,iBAAiB,GAAG,EAAE;AAChC,IAAI,MAAM,oBAAoB,GAAG,EAAE;AACnC,IAAI,MAAM,gBAAgB,GAAG,EAAE;AAC/B,IAAI,MAAM,WAAW,GAAG,EAAE;AAC1B,IAAI,MAAM,eAAe,GAAG,EAAE;AAC9B,IAAI,MAAM,mBAAmB,GAAG,EAAE;AAClC,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE;AACjC,IAAI;AACJ,IAAI,MAAM,YAAY,GAAG,EAAE;AAC3B,IAAI,MAAM,aAAa,GAAG;AAC1B,QAAQ,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;AAChC,IAAI;AACJ,IAAI,MAAM,cAAc,GAAG,EAAE;AAC7B;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,62 @@
+var capacitorPlayGames = (function (exports, core) {
+    'use strict';
+
+    const PlayGames = core.registerPlugin("PlayGames", {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.PlayGamesWeb()),
+    });
+
+    /**
+     * Web / non-native fallback: every method resolves to a safe default (signed
+     * out, empty). Gate feature usage behind `isSignedIn()`, which is `false` here.
+     */
+    class PlayGamesWeb extends core.WebPlugin {
+        async initialize() { }
+        async signIn() {
+            return { signedIn: false };
+        }
+        async isSignedIn() {
+            return { signedIn: false };
+        }
+        async getPlayer() {
+            return { playerId: "", displayName: "" };
+        }
+        async requestServerSideAccess() {
+            return { authCode: "" };
+        }
+        async fetchIdentityVerificationSignature() {
+            return {
+                publicKeyUrl: "",
+                signature: "",
+                salt: "",
+                timestamp: 0,
+                playerId: "",
+                bundleId: "",
+            };
+        }
+        async unlockAchievement() { }
+        async incrementAchievement() { }
+        async showAchievements() { }
+        async submitScore() { }
+        async showLeaderboard() { }
+        async showAllLeaderboards() { }
+        async loadSnapshot() {
+            return { snapshot: null };
+        }
+        async saveSnapshot() { }
+        async listSnapshots() {
+            return { snapshots: [] };
+        }
+        async deleteSnapshot() { }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        PlayGamesWeb: PlayGamesWeb
+    });
+
+    exports.PlayGames = PlayGames;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nconst PlayGames = registerPlugin(\"PlayGames\", {\n    web: () => import(\"./web\").then((m) => new m.PlayGamesWeb()),\n});\nexport * from \"./definitions\";\nexport { PlayGames };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\n/**\n * Web / non-native fallback: every method resolves to a safe default (signed\n * out, empty). Gate feature usage behind `isSignedIn()`, which is `false` here.\n */\nexport class PlayGamesWeb extends WebPlugin {\n    async initialize() { }\n    async signIn() {\n        return { signedIn: false };\n    }\n    async isSignedIn() {\n        return { signedIn: false };\n    }\n    async getPlayer() {\n        return { playerId: \"\", displayName: \"\" };\n    }\n    async requestServerSideAccess() {\n        return { authCode: \"\" };\n    }\n    async fetchIdentityVerificationSignature() {\n        return {\n            publicKeyUrl: \"\",\n            signature: \"\",\n            salt: \"\",\n            timestamp: 0,\n            playerId: \"\",\n            bundleId: \"\",\n        };\n    }\n    async unlockAchievement() { }\n    async incrementAchievement() { }\n    async showAchievements() { }\n    async submitScore() { }\n    async showLeaderboard() { }\n    async showAllLeaderboards() { }\n    async loadSnapshot() {\n        return { snapshot: null };\n    }\n    async saveSnapshot() { }\n    async listSnapshots() {\n        return { snapshots: [] };\n    }\n    async deleteSnapshot() { }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,SAAS,GAAGA,mBAAc,CAAC,WAAW,EAAE;IAC9C,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;IAChE,CAAC;;ICFD;IACA;IACA;IACA;IACO,MAAM,YAAY,SAASC,cAAS,CAAC;IAC5C,IAAI,MAAM,UAAU,GAAG,EAAE;IACzB,IAAI,MAAM,MAAM,GAAG;IACnB,QAAQ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;IAClC,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;IAClC,IAAI;IACJ,IAAI,MAAM,SAAS,GAAG;IACtB,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;IAChD,IAAI;IACJ,IAAI,MAAM,uBAAuB,GAAG;IACpC,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC/B,IAAI;IACJ,IAAI,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,OAAO;IACf,YAAY,YAAY,EAAE,EAAE;IAC5B,YAAY,SAAS,EAAE,EAAE;IACzB,YAAY,IAAI,EAAE,EAAE;IACpB,YAAY,SAAS,EAAE,CAAC;IACxB,YAAY,QAAQ,EAAE,EAAE;IACxB,YAAY,QAAQ,EAAE,EAAE;IACxB,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,iBAAiB,GAAG,EAAE;IAChC,IAAI,MAAM,oBAAoB,GAAG,EAAE;IACnC,IAAI,MAAM,gBAAgB,GAAG,EAAE;IAC/B,IAAI,MAAM,WAAW,GAAG,EAAE;IAC1B,IAAI,MAAM,eAAe,GAAG,EAAE;IAC9B,IAAI,MAAM,mBAAmB,GAAG,EAAE;IAClC,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjC,IAAI;IACJ,IAAI,MAAM,YAAY,GAAG,EAAE;IAC3B,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;IAChC,IAAI;IACJ,IAAI,MAAM,cAAc,GAAG,EAAE;IAC7B;;;;;;;;;;;"}

package/ios/Plugin/AchievementsModule.swift

@@ -0,0 +1,73 @@
+import Capacitor
+import GameKit
+import UIKit
+
+/// GameKit has no increment API (report overwrites percentComplete), so
+/// increment() loads current progress, adds the steps (percentage points),
+/// then reports the new total.
+internal class AchievementsModule: PgsModule, GKGameCenterControllerDelegate {
+    func unlock(_ call: CAPPluginCall) {
+        guard let id = call.getString("id") else {
+            call.reject("missing id"); return
+        }
+        let achievement = GKAchievement(identifier: id)
+        achievement.percentComplete = 100
+        achievement.showsCompletionBanner = true
+        GKAchievement.report([achievement]) { error in
+            if let error = error {
+                call.reject(error.localizedDescription, nil, error)
+            } else {
+                call.resolve()
+            }
+        }
+    }
+
+    func increment(_ call: CAPPluginCall) {
+        guard let id = call.getString("id") else {
+            call.reject("missing id"); return
+        }
+        let steps = call.getDouble("steps") ?? 0
+
+        GKAchievement.loadAchievements { existing, error in
+            if let error = error {
+                call.reject(error.localizedDescription, nil, error)
+                return
+            }
+            let current = existing?.first(where: { $0.identifier == id })
+            let achievement = current ?? GKAchievement(identifier: id)
+            let next = min(100, (achievement.percentComplete) + steps)
+            achievement.percentComplete = next
+            achievement.showsCompletionBanner = next >= 100
+            GKAchievement.report([achievement]) { reportError in
+                if let reportError = reportError {
+                    call.reject(reportError.localizedDescription, nil, reportError)
+                } else {
+                    call.resolve()
+                }
+            }
+        }
+    }
+
+    func show(_ call: CAPPluginCall) {
+        DispatchQueue.main.async {
+            guard let presenter = self.topViewController() else {
+                call.reject("no presenter available"); return
+            }
+            let vc: GKGameCenterViewController
+            if #available(iOS 14.0, *) {
+                vc = GKGameCenterViewController(state: .achievements)
+            } else {
+                vc = GKGameCenterViewController()
+                vc.viewState = .achievements
+            }
+            vc.gameCenterDelegate = self
+            presenter.present(vc, animated: true) { call.resolve() }
+        }
+    }
+
+    // MARK: - GKGameCenterControllerDelegate
+
+    func gameCenterViewControllerDidFinish(_ controller: GKGameCenterViewController) {
+        controller.dismiss(animated: true)
+    }
+}

package/ios/Plugin/LeaderboardsModule.swift

@@ -0,0 +1,75 @@
+import Capacitor
+import GameKit
+import UIKit
+
+/// GameKit leaderboards: score submission + the native leaderboard overlay.
+internal class LeaderboardsModule: PgsModule, GKGameCenterControllerDelegate {
+    func submit(_ call: CAPPluginCall) {
+        guard let leaderboardID = call.getString("leaderboardId") else {
+            call.reject("missing leaderboardId"); return
+        }
+        let scoreDouble = call.getDouble("score") ?? 0
+        let score = Int(scoreDouble)
+
+        GKLeaderboard.submitScore(
+            score,
+            context: 0,
+            player: GKLocalPlayer.local,
+            leaderboardIDs: [leaderboardID]
+        ) { error in
+            if let error = error {
+                call.reject(error.localizedDescription, nil, error)
+            } else {
+                call.resolve()
+            }
+        }
+    }
+
+    func show(_ call: CAPPluginCall) {
+        guard let leaderboardID = call.getString("leaderboardId") else {
+            call.reject("missing leaderboardId"); return
+        }
+        DispatchQueue.main.async {
+            guard let presenter = self.topViewController() else {
+                call.reject("no presenter available"); return
+            }
+            let vc: GKGameCenterViewController
+            if #available(iOS 14.0, *) {
+                vc = GKGameCenterViewController(
+                    leaderboardID: leaderboardID,
+                    playerScope: .global,
+                    timeScope: .allTime
+                )
+            } else {
+                vc = GKGameCenterViewController()
+                vc.viewState = .leaderboards
+                vc.leaderboardIdentifier = leaderboardID
+            }
+            vc.gameCenterDelegate = self
+            presenter.present(vc, animated: true) { call.resolve() }
+        }
+    }
+
+    func showAll(_ call: CAPPluginCall) {
+        DispatchQueue.main.async {
+            guard let presenter = self.topViewController() else {
+                call.reject("no presenter available"); return
+            }
+            let vc: GKGameCenterViewController
+            if #available(iOS 14.0, *) {
+                vc = GKGameCenterViewController(state: .leaderboards)
+            } else {
+                vc = GKGameCenterViewController()
+                vc.viewState = .leaderboards
+            }
+            vc.gameCenterDelegate = self
+            presenter.present(vc, animated: true) { call.resolve() }
+        }
+    }
+
+    // MARK: - GKGameCenterControllerDelegate
+
+    func gameCenterViewControllerDidFinish(_ controller: GKGameCenterViewController) {
+        controller.dismiss(animated: true)
+    }
+}

package/ios/Plugin/Pgs.swift

@@ -0,0 +1,40 @@
+import Capacitor
+import Foundation
+import GameKit
+import UIKit
+
+/// Shared base for per-feature modules. Inherits `NSObject` so subclasses can
+/// adopt @objc protocols (e.g. `GKGameCenterControllerDelegate`).
+internal class PgsModule: NSObject {
+    unowned let plugin: PlayGamesPlugin
+    init(_ plugin: PlayGamesPlugin) {
+        self.plugin = plugin
+        super.init()
+    }
+
+    /// Top-most presented view controller. Callers must be on the main queue.
+    func topViewController() -> UIViewController? {
+        guard let scene = UIApplication.shared.connectedScenes
+            .compactMap({ $0 as? UIWindowScene })
+            .first(where: { $0.activationState == .foregroundActive })
+            ?? UIApplication.shared.connectedScenes
+                .compactMap({ $0 as? UIWindowScene }).first,
+            let rootVC = scene.windows.first(where: { $0.isKeyWindow })?.rootViewController
+                ?? scene.windows.first?.rootViewController
+        else { return nil }
+
+        var top = rootVC
+        while let presented = top.presentedViewController { top = presented }
+        return top
+    }
+}
+
+/// Serialise a GameKit player as the JS-side `PlayerInfo`. Uses the stable
+/// cross-device `gamePlayerID` (not the per-team `teamPlayerID`).
+internal func playerInfo(from player: GKLocalPlayer) -> [String: Any] {
+    let info: [String: Any] = [
+        "playerId": player.gamePlayerID,
+        "displayName": player.displayName,
+    ]
+    return info
+}

package/ios/Plugin/Plugin.swift

@@ -0,0 +1,74 @@
+import Capacitor
+import Foundation
+import GameKit
+
+/// Capacitor 8 plugin wrapping Apple GameKit (sign-in, achievements,
+/// leaderboards, saved games). Thin dispatcher to four per-feature modules.
+@objc(PlayGamesPlugin)
+public class PlayGamesPlugin: CAPPlugin, CAPBridgedPlugin {
+    // CAPBridgedPlugin self-registers the plugin on iOS (Capacitor 8). `jsName`
+    // must match registerPlugin("PlayGames"); addListener/removeAllListeners
+    // come from CAPPlugin and aren't listed here.
+    public let identifier = "PlayGamesPlugin"
+    public let jsName = "PlayGames"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "initialize", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "signIn", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "isSignedIn", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getPlayer", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "fetchIdentityVerificationSignature", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "unlockAchievement", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "incrementAchievement", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "showAchievements", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "submitScore", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "showLeaderboard", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "showAllLeaderboards", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "loadSnapshot", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "saveSnapshot", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "listSnapshots", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "deleteSnapshot", returnType: CAPPluginReturnPromise),
+    ]
+
+    private lazy var signInModule = SignInModule(self)
+    private lazy var achievementsModule = AchievementsModule(self)
+    private lazy var leaderboardsModule = LeaderboardsModule(self)
+    private lazy var savedGamesModule = SavedGamesModule(self)
+
+    // The GameKit authenticateHandler is installed in initialize(), NOT load():
+    // see initialize() for the ATT-ordering reason.
+
+    /// Expose listener emission to the modules.
+    internal func emit(event: String, data: [String: Any]) {
+        notifyListeners(event, data: data)
+    }
+
+    // MARK: - JS-callable surface
+
+    @objc func initialize(_ call: CAPPluginCall) {
+        // Setting the handler can auto-present GameKit's "Welcome back" banner,
+        // which suppresses an ATT prompt shown while it's on screen, so call
+        // initialize() only after the app has requested ATT.
+        signInModule.installAuthHandlerIfNeeded()
+        call.resolve()
+    }
+
+    @objc func signIn(_ call: CAPPluginCall) { signInModule.signIn(call) }
+    @objc func isSignedIn(_ call: CAPPluginCall) { signInModule.isSignedIn(call) }
+    @objc func getPlayer(_ call: CAPPluginCall) { signInModule.getPlayer(call) }
+    @objc func fetchIdentityVerificationSignature(_ call: CAPPluginCall) {
+        signInModule.fetchIdentityVerificationSignature(call)
+    }
+
+    @objc func unlockAchievement(_ call: CAPPluginCall) { achievementsModule.unlock(call) }
+    @objc func incrementAchievement(_ call: CAPPluginCall) { achievementsModule.increment(call) }
+    @objc func showAchievements(_ call: CAPPluginCall) { achievementsModule.show(call) }
+
+    @objc func submitScore(_ call: CAPPluginCall) { leaderboardsModule.submit(call) }
+    @objc func showLeaderboard(_ call: CAPPluginCall) { leaderboardsModule.show(call) }
+    @objc func showAllLeaderboards(_ call: CAPPluginCall) { leaderboardsModule.showAll(call) }
+
+    @objc func loadSnapshot(_ call: CAPPluginCall) { savedGamesModule.load(call) }
+    @objc func saveSnapshot(_ call: CAPPluginCall) { savedGamesModule.save(call) }
+    @objc func listSnapshots(_ call: CAPPluginCall) { savedGamesModule.list(call) }
+    @objc func deleteSnapshot(_ call: CAPPluginCall) { savedGamesModule.delete(call) }
+}

package/ios/Plugin/SavedGamesModule.swift

@@ -0,0 +1,102 @@
+import Capacitor
+import GameKit
+
+/// GameKit Saved Games: load/save/list/delete by stable name. Conflicts resolve
+/// most-recently-modified-wins. Requires Game Center auth; otherwise GKLocalPlayer
+/// fails with `GKErrorNotAuthenticated`, forwarded to the caller.
+internal class SavedGamesModule: PgsModule {
+    private var player: GKLocalPlayer { GKLocalPlayer.local }
+
+    func load(_ call: CAPPluginCall) {
+        guard let name = call.getString("name") else {
+            call.reject("missing name"); return
+        }
+        player.fetchSavedGames { saved, error in
+            if let error = error {
+                call.reject(error.localizedDescription, nil, error)
+                return
+            }
+            let matches = (saved ?? []).filter { $0.name == name }
+            guard let pick = matches.max(by: { ($0.modificationDate ?? .distantPast) < ($1.modificationDate ?? .distantPast) }) else {
+                call.resolve(["snapshot": NSNull()])
+                return
+            }
+            if matches.count > 1 {
+                self.player.resolveConflictingSavedGames(matches, with: Data()) { _, _ in }
+            }
+            pick.loadData { data, dataError in
+                if let dataError = dataError {
+                    call.reject(dataError.localizedDescription, nil, dataError)
+                    return
+                }
+                let bytes = data ?? Data()
+                let payload: [String: Any] = [
+                    "name": pick.name ?? name,
+                    // GKSavedGame has no description field; empty for API parity.
+                    "description": "",
+                    "modifiedAt": Int((pick.modificationDate ?? Date()).timeIntervalSince1970 * 1000),
+                    "data": String(data: bytes, encoding: .utf8) ?? "",
+                ]
+                call.resolve(["snapshot": payload])
+            }
+        }
+    }
+
+    func save(_ call: CAPPluginCall) {
+        guard let name = call.getString("name") else {
+            call.reject("missing name"); return
+        }
+        guard let data = call.getString("data") else {
+            call.reject("missing data"); return
+        }
+        let bytes = Data(data.utf8)
+        player.saveGameData(bytes, withName: name) { _, error in
+            if let error = error {
+                call.reject(error.localizedDescription, nil, error)
+            } else {
+                call.resolve()
+            }
+        }
+    }
+
+    func list(_ call: CAPPluginCall) {
+        player.fetchSavedGames { saved, error in
+            if let error = error {
+                call.reject(error.localizedDescription, nil, error)
+                return
+            }
+            // Collapse cross-device conflicts to one entry per name.
+            var byName: [String: GKSavedGame] = [:]
+            for s in saved ?? [] {
+                let key = s.name ?? ""
+                if key.isEmpty { continue }
+                if let existing = byName[key],
+                   (existing.modificationDate ?? .distantPast) >= (s.modificationDate ?? .distantPast) {
+                    continue
+                }
+                byName[key] = s
+            }
+            let snapshots = byName.values.map { s -> [String: Any] in
+                [
+                    "name": s.name ?? "",
+                    "description": "",
+                    "modifiedAt": Int((s.modificationDate ?? Date()).timeIntervalSince1970 * 1000),
+                ]
+            }
+            call.resolve(["snapshots": snapshots])
+        }
+    }
+
+    func delete(_ call: CAPPluginCall) {
+        guard let name = call.getString("name") else {
+            call.reject("missing name"); return
+        }
+        player.deleteSavedGames(withName: name) { error in
+            if let error = error {
+                call.reject(error.localizedDescription, nil, error)
+            } else {
+                call.resolve()
+            }
+        }
+    }
+}