> For the complete documentation index, see [llms.txt](/llms.txt)

# 装備エンチャント

装備にランダムな追加効果を付与します。抽選されるスロット数と効果の種類・重みを設定できます。




**このデモについて**

デモは匿名アカウントで自動的にログインします。このアカウントはショールームのすべてのデモで共有されるため、あるデモで手に入れたアイテムや通貨が別のデモにも反映されます。読み込みには少し時間がかかります。画面が小さい場合は新しいタブで開いてお試しください。

## 概要

装備を入手すると、その装備 1 つごとにランダムな追加効果（エンチャント）が 1〜3 個抽選されます。効果は `attack`、`defense`、`hp`、`speed`、`critical`、`luck` の 6 種類から重み付きで選ばれ、装備の行に `attack +12 / hp +50` のように表示されます。コインを支払って効果を引き直したり、効果を 1 つ追加したりできます。

## 試し方

1. **Get coins** の **Deposit** を押して、**Your coins** の **Free balance** に無償コインを 100 枚入れます。
1. **Take equipment** で装備名の横にある **Take** を押します。装備が **Your equipment and its bonuses** に追加され、初めて読み込まれた時点で 1〜3 個の効果が抽選されて表示されます（1 個が最も出やすく、3 個はまれです）。
1. 装備の行の **Reroll** を押すと、10 コインを支払って同じ個数の効果を引き直します。
1. **Add bonus** を押すと、30 コインを支払って効果を 1 つ追加します。効果がすでに上限の 3 個に達している場合は失敗し、コインは減りません。
1. 所持枠が足りなくなったら、**Equipment bag** の **Expand** で枠を 2 つ増やせます（最大 10）。

**How enchanting works** に、効果の個数とそれぞれの費用のルールが表示されています。同じ装備名でも 1 つずつ別の個体として扱われ、効果も個体ごとに抽選されます。

## 使用している GS2 のサービス

- [GS2-Enchant](/ja/microservices/enchant/): GS2-Enchant のレアリティパラメーターモデル `standard` が、効果の最大数（3）、効果数ごとの抽選の重み、6 種類の効果と値を定義します。効果は装備の個体（アイテムセットの `propertyId`）ごとに保持され、引き直しは `Gs2Enchant:ReDrawRarityParameterStatusByUserId`、追加は `Gs2Enchant:AddRarityParameterStatusByUserId` で行います。
- [GS2-Exchange](/ja/microservices/exchange/): GS2-Exchange の交換レートが、**Reroll** と **Add bonus** をコインの消費とエンチャントの操作を 1 つにまとめたトランザクションとして定義し、サーバー側でアトミックに実行します。装備の入手、所持枠の拡張、無償コインの入金も交換レートで行います。
- [GS2-Inventory](/ja/microservices/inventory/): GS2-Inventory が、プレイヤーが入手した装備と所持枠（初期 4、最大 10）を保持します。
- [GS2-Money2](/ja/microservices/money2/): GS2-Money2 のウォレットがコインを保持し、**Reroll** で 10 枚、**Add bonus** で 30 枚が引き出されます。

## GS2 Studio で使う

GS2 Studio のシンプルモードで **機能を追加** を開き、**装備エンチャント** の **追加** を押すと、この機能を自分のプロジェクトに取り込めます。パッケージを直接指定する場合は **GitHub から追加** を選び、次のパッケージを指定します。

```text
https://github.com/gs2io/gs2-studio-package/tree/main/micro-economy-equipment-enchant/packages/micro-economy-equipment-enchant
```

- オーナー: `gs2io`
- リポジトリ: `gs2-studio-package`
- サブディレクトリ: `micro-economy-equipment-enchant/packages/micro-economy-equipment-enchant`

## ソースコード

- デモのプロジェクト: <https://github.com/gs2io/gs2-studio-package/tree/main/micro-economy-equipment-enchant/live-demo>
- 機能パッケージ: <https://github.com/gs2io/gs2-studio-package/tree/main/micro-economy-equipment-enchant>



