鎌倉トランスポート (Kamakura Transport)

Fabric 1.20.1 向けの経済・交通システム拡張モジュールです。 ※本モジュールに含まれるすべてのアイテムには、サバイバルモードでのクラフトレシピが用意されていません。クリエイティブモードまたはチェストショップを通じて入手してください。

🛠️ 【ベータ版に関するお知らせと既知のバグ】 本モジュールは現在ベータテスト版のため、いくつかの不具合が存在します。ご理解とご協力をお願い申し上げます。

現在の既知のバグ：

1. LANプレイ（局域網聯機）時： ホスト（房主）のプレイヤーは、銀行の送金（転送）機能を使用することができません。
2. マルチプレイ / サーバー環境時： ホスト以外のプレイヤーが「Suica」の実名認証を行う際、画面のボタンがクリックできなくなる場合があります。

📬 バグ報告・フィードバックの募集 もし不具合を発見された場合や、モジュールへの改善案・ご意見がございましたら、どうぞお気軽に下記のメールアドレスまでご連絡ください。 ✉️ E-mail: Matsuhirasuzuka@gmail.com

【お願い】 不具合をご報告いただく際、もし可能であれば動画やスクリーンショットを添付していただけますと幸いです。また、テキストでの状況説明もできるだけ詳しく記載していただけると非常に助かります。（※画像や動画がない場合でも問題ございません。ご連絡をいただいた後、私の方でも自らテストを行って確認いたします。） 皆様からの温かいフィードバックを心よりお待ちしております。

---

🏗️ マシンの設置方法と注意点

• 7-Eleven ATM (外観2種)
• MUFG ATM / SMBC ATM (各1種)
• Suica券売・チャージ機 / 乗車券自動券売機 (各1種)

🔴 【特殊な設置手順】 ブロックの高さ判定の仕様により、すべてのマシンは地面から2マスの高さに設置する必要があります。 正しい設置手順： 地面に任意の通常ブロックを設置 ➡️ そのブロックの上にマシンを設置 ➡️ 最後に、最初に設置した地面の通常ブロックを破壊する。

---

💳 Suica（西瓜カード）＆ 乗車券システム

🟢 Suica（西瓜カード）利用ガイド

• 購入とデポジット： 券売機での Suica の販売価格は 1000円 です（500円の預り金が含まれるため、初期の利用可能残高は 500円 となります）。
• 実名認証： 購入後、必ず Suica機で実名認証を行い、自身の UID と紐付けてください。認証されたカードは購入者本人しか使用できません。他のプレイヤーに渡しても改札は通過できません。
• 解約機能： 解約を選択するとカードは無効化され、残高はすべて現金としてプレイヤーに返還されます。

🎫 乗車券（切ップ）と改札機

• 改札の通過： 認証済みの Suica または購入した乗車券で改札機を通過できます。
• ステータス確認： インベントリで乗車券にカーソルを合わせると現在の状態を確認できます。
• 回収メカニズム： 入場後にステータスが「入場済」に変わります。目的地で改札を出場する際、乗車券は自動的に回収されます。「入場済」の乗車券で再度入場することはできません。

---

🏦 ATM＆銀行口座システム

• 残高とカードの解約： すべての ATM の口座残高はクライアント側に保存されます。「キャッシュカードの解約」を行ってもカードが無効になるだけで、銀行口座および残高自体には一切影響しません。
• 取引明細の確認： 取引（引き出し、預け入れ）履歴が記録されます。サーバー負荷軽減のため、保存されるのは最新の 15 件の記録のみとなります。

---

📦 独自チェストショップシステム

バニラとは独立した専用のショップブロックを使用します（自動お釣り機能付き）。

👤 オーナー（ショップの管理）

1. ショップの設定： アイテムを　オフハンド（副手）　に持ち、ブロックを Shift + 左クリック することで、価格設定および「販売」または「買取」モードの切り替えが可能です。
2. 在庫の補充： 素手（空手）　の状態で Shift + 右クリック すると管理画面が開きます。補充したいアイテムを直接投入してください。他のプレイヤーはこの画面を開けません。
3. 売上金の自動振り込み： 決済方法に関わらず、売上金はオーナーの銀行口座に直接振り込まれます（事前に ATM でキャッシュカードを登録しておくことを強く推奨します。未登録の場合でも売上金は保持され、次回登録時に一括で口座に振り込まれます）。
4. 買取上限の設定： 「買取」モードで上限数を指定した場合、顧客が売却したアイテムはショップの在庫に入り、代金はオーナーの銀行口座から自動的に引き落とされます。

👥 顧客（購入と売却）

• 顧客が商品を購入・売却する際、代金の支払いや受け取り方法として　「キャッシュカード（残高）」または「現金」　を自由に選択できます。

---

👛 財布（ウォレット）システム

大量の現金を収納するための専用財布（9マス の収納スペース）です。

• 収納対象： 日本円の硬貨、紙幣、および各種キャッシュカードのみ。
• ⚠️ 【ロストのリスク】 財布はアイテムとして実在するため、取り扱いにはご注意ください。冒險中に財布を紛失した場合、中に入っていた現金や財産もすべて永久に失われます。

---

---

Kamakura Transport (English Description)

An economic and transportation expansion module developed for Fabric 1.20.1. Note: All items in this module do not have survival mode crafting recipes. Please obtain them via Creative Mode or Chest Shops.

🛠️ 【Beta Version Notice & Known Bugs】 This module is currently in Beta testing, so some bugs may occur. We appreciate your understanding and cooperation!

Current Known Bugs:

1. During LAN Play: The host player cannot use the bank's wire transfer function.
2. In Multiplayer / Dedicated Server Environments: When non-host players attempt to do real-name registration for the Suica card, the interface buttons may become unclickable.

📬 Bug Reports & Feedback If you find any bugs or have any suggestions/ideas for the module, please feel free to contact me via email! ✉️ E-mail: Matsuhirasuzuka@gmail.com

【Request】 When reporting a bug, it would be highly appreciated if you could attach a video or screenshot, along with a clear text description. (It is totally fine if you don't have photos or videos; I will test and verify the bug myself after receiving your report.) I sincerely look forward to your warm feedback!

---

🏗️ Machine Installation and Precautions

• 7-Eleven ATM (2 variants)
• MUFG ATM / SMBC ATM (1 variant each)
• Suica Vending Machine / Ticket Vending Machine (1 variant each)

🔴 【Special Installation Procedure】 Due to block height collision detection, all machines must be placed at the "second block height" from the ground! Correct Steps: Place any normal block on the ground ➡️ Place the machine on top of that block ➡️ Destroy the temporary block underneath.

---

💳 Suica & Single Ticket System

🟢 Suica Card Guide

• Purchase & Deposit: The purchase price is 1000 Yen (includes a 500 Yen deposit, meaning the initial usable balance is 500 Yen).
• Real-name Registration: After purchasing, you must register your real name at the Suica machine to bind it to your UID. Registered cards are locked to the owner only and cannot be used by other players at ticket gates.
• Cancellation & Refund: Upon cancellation, the card is closed, and the remaining balance is refunded to the player in cash.

🎫 Single Tickets & Gates

• Passing the Gates: Pass gates using a registered Suica card or a purchased single ticket.
• Status Check: Hover over the ticket in your inventory to view its current status.
• Recovery Mechanism: Tickets change to "Entered" status after passing the entrance. Upon passing the exit gate at your destination, the ticket is automatically recycled by the gate. "Entered" tickets cannot be used to enter a gate again.

---

🏦 ATM & Bank Account System

• Balance & Card Cancellation: Account balances are saved on the client-side. Closing a card only deactivates the physical card; your bank account and balance will not be affected.
• Transaction History: Logs deposits and withdrawals. To reduce server load, only the latest 15 records are stored.

---

📦 Custom Chest Shop System

Utilizes a dedicated shop block independent of vanilla chests, featuring an automatic change-giving system.

👤 Owner (Shop Management)

1. Shop Setup: Hold the target item in your off-hand and Shift + Left-click the block to set prices and toggle between "Sell" or "Buy" modes.
2. Restocking: With an empty hand, Shift + Right-click to open the interface, then drop items directly into it. Other players cannot access this menu.
3. Automated Payments: Revenue is deposited directly into the owner's bank account regardless of payment method. (Highly recommended to register a card at an ATM beforehand. If unregistered, funds are held and will be credited upon your next registration.)
4. Buy Limit Setup: In "Buy" mode with a set limit, items sold by customers go into shop stock, and the payout is deducted automatically from the owner's bank account.

👥 Customers (Buying & Selling)

• Customers can freely choose to pay or receive funds via "Bank Card Balance" or "Cash".

---

👛 Wallet System

A dedicated wallet providing 9 slots of storage space to prevent cash from cluttering inventories.

• Supported Items: Stores Japanese Yen coins, banknotes, and bank cards only.
• ⚠️ 【Loss Risk】 Wallets are physical items. If you lose your wallet during your adventure, all the money and property inside will be lost permanently!