Development guide for ActionArms, a Minecraft mod adding realistic firearms mechanics. Built with Architectury (Fabric/Forge), component-based architecture, glTF rendering, and multiplayer synchronization.
ActionArmsは、Minecraftに現実的な銃器メカニクスを追加する高度なModです。Architecturyプラットフォームを使用してFabricとForgeの両方のModローダーをサポートしています。
```bash
./gradlew build
./gradlew :fabric:build
./gradlew :forge:build
./gradlew :fabric:runClient
./gradlew :fabric:runServer
./gradlew :forge:runClient
./gradlew :forge:runServer
./gradlew clean build
```
```
common/ # FabricとForge間の共有コード
fabric/ # Fabric固有の実装
forge/ # Forge固有の実装
docs/ # プロジェクト文書と仕様
```
銃のメカニクスにNBTベースのコンポーネントシステムを使用:
**主要インターフェース:**
**コンポーネントタイプ:**
**コアクラス:**
**メカニカルコンポーネント:**
**glTFシステム:**
**HUDシステム:**
**パケットシステム:**
```
docs/agent/
├── files-index.json # 全体概要とカテゴリ分類
├── crud-guide.md # 知識の泉操作指示書
├── common/ # 詳細情報(カテゴリ別)
│ ├── root.json # メインクラス・設定管理
│ ├── client.json # クライアント・キーバインド
│ ├── item.json # 銃アイテム・コンポーネント
│ ├── network.json # ネットワーク通信
│ ├── gltf.json # glTFレンダリングシステム
│ └── entity.json # エンティティシステム
└── [ガイドライン文書]
```
**1. 実装調査の開始**
```bash
Read docs/agent/files-index.json
Read docs/agent/common/gltf.json # レンダリング調査時
Read docs/agent/common/item.json # アイテムシステム調査時
Read docs/agent/common/network.json # 通信システム調査時
```
**2. 調査効率の向上**
1. **システム全体把握調査**: files-index.json → importance:high特定 → アーキテクチャ図作成
2. **機能連携調査**: dependencies追跡 → データフロー分析 → シーケンス図作成
3. **パフォーマンス調査**: recent_major_changes確認 → 最適化手法理解 → 技術詳細文書化
4. **コンポーネントシステム調査**: コンポーネント構造把握 → 実装パターン抽出 → サンプル集作成
5. **バグ調査・デバッグ**: 問題箇所特定 → 関連システム確認 → 最近の変更確認 → 解決策文書化
詳細: `docs/agent/implementation-investigation-patterns.md`
```java
// 良い例: 明示的なnull安全性
public Optional<BulletComponent> findBullet(@Nullable ItemStack stack) {
if (stack == null) return Optional.empty();
// 実装...
}
// Nullableフィールドの例
@Nullable
private PlayerEntity cachedPlayer;
```
1. 類似機能の調査(知識の泉活用)
2. 依存関係の特定(dependencies確認)
3. 実装パターンの参照(サンプル集活用)
4. 実装完了後の知識の泉更新
1. 問題箇所の特定(knowledge spring検索)
2. 関連システムの確認(dependencies追跡)
3. 最近の変更確認(recent_major_changes)
4. 修正完了後の情報更新
```bash
Read docs/agent/crud-guide.md # 操作方法確認
```
このコードベースで作業する際は、以下に特に注意してください:
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/actionarms-minecraft-mod-development/raw