zuburi-game-platform 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +22 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -96,6 +96,28 @@ account.lifetimeSpent
96
96
 
97
97
  ポイント履歴取得、`points.add()`、`points.set()` はありません。
98
98
 
99
+ ### Score multiplier rewards
100
+
101
+ Point Reward Rule は管理画面で次の2方式を選べます。
102
+
103
+ - `fixed`: Event 1回につき固定ポイントを加算
104
+ - `value_multiplier`: Event の `value × 倍率` を端数切り捨てして加算
105
+
106
+ たとえば倍率を `0.1` にして、ゲーム終了時にスコア `1234` を送ると `123pt` 加算されます。
107
+
108
+ ```ts
109
+ const result = await platform.events.emit({
110
+ type: PLATFORM_EVENTS.GAME_FINISHED,
111
+ value: 1234,
112
+ })
113
+
114
+ console.log(result.points.delta) // 123(倍率0.1の場合)
115
+ ```
116
+
117
+ 倍率はフロント側で掛けず、Backend が管理画面の設定を参照して計算します。倍率ルールで `value` がない、または負数の場合は Event を拒否します。
118
+
119
+ ブラウザから送る `value` 自体は改変可能です。改変耐性が必要なスコアはゲーム固有RPCで検証して trusted event を使ってください。
120
+
99
121
  ## Achievements
100
122
 
101
123
  ```ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "zuburi-game-platform",
3
- "version": "0.2.1",
3
+ "version": "0.2.2",
4
4
  "description": "Framework-independent TypeScript SDK for KZTK Game Platform",
5
5
  "type": "module",
6
6
  "sideEffects": false,