TON Miner — Telegramミニアプリ向けアイドルマイニング
概要
TON Minerは、Telegram Mini App向けのアイドルマイニングゲームを目指したフロントエンド実装です。ReactとViteで構成され、TypeScriptで型管理が行われています。主な遊びは「自動で資源を掘る」「装備(GPU/ASIC/Farm)を購入・強化する」「エネルギーの回復を管理する」「オフラインでも一定時間分の報酬を受け取れる」といった放置ゲームの定番機能で、ゲーム内通貨や報酬の計算・永続化、TON Connectを利用したウォレット連携(トークン送受信やユーザー認証の基盤)に対応する点が特徴です。Telegramミニアプリのサンプル/プロトタイプとして、ゲームロジックとウォレット統合の実装参考になります。(約300字)
リポジトリの統計情報
- スター数: 1
- フォーク数: 0
- ウォッチャー数: 1
- コミット数: 6
- ファイル数: 12
- メインの言語: TypeScript
主な特徴
- 自動(Idle)マイニング:連続で収益が発生する放置システム
- 装備強化とショップ:GPU、ASIC、Farmなどのアップグレード要素
- エネルギー管理とオフライン報酬:エネルギー回復と最大8時間分のオフライン収益
- TON Connect統合:Telegram向けウォレット連携をサポート
技術的なポイント
リポジトリはフロントエンド中心で、React+Viteで高速にビルドされる構成が採用されています。TypeScriptを用いることでゲームロジックやウォレット連携部分に静的型付けを導入し、バグを抑制しています。READMEにあるTON Connectの統合は、Telegramミニアプリとしてユーザーのウォレットと接続して認証やトランザクションが行える設計を示唆しており、実務でのブロックチェーンウォレット連携の基礎を学べます。
放置ゲーム特有の技術課題(オフライン報酬計算、エネルギー回復、プレイヤー進行の永続化)は、一般に「最終アクティブ時刻」を保存し、復帰時に経過時間を計算して報酬を付与する方式で実装されます。本リポジトリもREADMEの記述から同様のアプローチを取っていることが想定され、オフライン上限(8時間)やエネルギー回復のレート、装備毎の生産性係数といった定数を用いた算出ロジックが中心です。
また、UIは軽量なHTML/Reactコンポーネントで構築されているため、Telegramのミニアプリ環境(WebViewベース)に適合しやすい点が利点です。状態管理は小規模プロジェクトらしくContextやuseState/useEffectで完結する設計になっている可能性が高く、保存はlocalStorageやIndexedDBを利用して端末にデータを保持するパターンが想定されます。ESLint設定(eslint.config.js)やTypeScript導入によりコード品質が保たれ、Viteを用いた高速な開発体験とビルド出力が得られます。TON Connect対応のため、外部APIやSDKとの非同期処理とエラーハンドリングも実装上の重要点です。(約880字)
プロジェクトの構成
主要なファイルとディレクトリ:
- .gitignore: file — ビルド成果物や環境依存ファイル除外
- README.md: file — プロジェクト概要と特徴、起動方法など
- eslint.config.js: file — コード整形・静的解析の設定
- index.html: file — アプリのエントリHTML(Vite経由で読み込む)
- package-lock.json: file — npm依存解決のロックファイル
…他 7 ファイル
(備考)ファイル数は12で、メイン言語がTypeScriptとなっているため、srcディレクトリやpackage.json、tsconfigなどTypeScript/Vite向けの設定ファイルや実装ファイル群が含まれている想定です。小規模なミニアプリとして、フロントエンドロジックとTON Connect連携に焦点が当たっています。
まとめ
Telegramミニアプリ向けの軽量なアイドルマイニングの参考実装で、ウォレット統合と放置ゲームの基本を学べます。(約50字)
リポジトリ情報:
- 名前: tma-miner
- 説明: 説明なし
- スター数: 1
- 言語: TypeScript
- URL: https://github.com/dopaton/tma-miner
- オーナー: dopaton
- アバター: https://avatars.githubusercontent.com/u/261529161?v=4
READMEの抜粋:
TON Miner - Telegram Mini App
A Telegram Mini App idle mining game built with React, Vite, TypeScript, and TON Connect.
Features
- 🎮 Auto Idle Mining: Continuous mining without tapping
- ⚙️ Equipment Upgrades: GPU, ASIC, and Farm levels
- ⚡ Energy Management: Energy regeneration system
- 💤 Offline Earnings: Earn while you’re away (up to 8 hours)
- 🛍️ Shop: Purchase and upgrade mining equipment
- 💼 Wallet: TON Connect integration
- 👥 Referral System: Earn …