ActionArms Minecraft Mod Development

ActionArmsは、Minecraftに現実的な銃器メカニクスを追加する高度なModです。Architecturyプラットフォームを使用してFabricとForgeの両方のModローダーをサポートしています。

プロジェクト概要

**Mod ID**: `actionarms`

**Minecraftバージョン**: 1.20.1

**マルチローダー**: Fabric + Forge (Architectury経由)

**主要言語**: Java 17

**ドキュメント言語**: 日本語

開発コマンド

ビルドと実行

```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/ # プロジェクト文書と仕様

```

コア設計パターン

1. コンポーネントベースアイテムシステム

銃のメカニクスにNBTベースのコンポーネントシステムを使用:

**主要インターフェース:**

`IItemComponent` - NBTシリアライゼーション機能を持つ基底コンポーネント

`ExecuteFunction<T>` - コンポーネント変更用の関数型インターフェース

`ComponentResult` - コンポーネント状態追跡用Enum (NO_CHANGE/MODIFIED)

**コンポーネントタイプ:**

`BulletComponent` - 弾丸プロパティとデータ

`LeverActionGunComponent` - レバーアクションライフルメカニクス

`MagazineComponent` - マガジン/チューブローディングシステム

`UniqueComponent` - アイテム一意性追跡

2. 銃メカニクスシステム

**コアクラス:**

`LeverActionGunItem` - メインレバーアクションライフル実装

`BulletItem` - 物理プロパティを持つ弾薬アイテム

`GunController` - プレイヤー銃操作管理

`AimManager` - トグル/ホールドモード対応照準システム

**メカニカルコンポーネント:**

`FireTrigger` - 射撃メカニクスとタイミング

`CyclingLever` - レバー操作(下降/上昇サイクル)

`Chamber` - 弾倉管理

`Cartridge` - 薬莢/カートリッジ状態追跡

3. クライアントサイドレンダリング

**glTFシステム:**

jglTFライブラリを使用したカスタム3Dモデルレンダリング

`GltfRenderer` - MinecraftのモデルシステムをバイパスしたOpenGL直接レンダリング

`ItemAnimationManager` - UUID基盤のアニメーション同期

持っているアイテムとアイテムレンダラー統合用のMixin

**HUDシステム:**

`AAHudRenderer` - 弾薬状態表示

2つの表示モード: 縦(右下)と横(中央上)

リアルタイムの薬室とマガジン可視化

4. 入力管理

`ClientKeyInputManager` - カスタムキーバインディングシステム

`AAKeys` - キーバインディング定義

バニラの右クリックを専用の照準/発射キーに置換

fabric/forgeディレクトリにプラットフォーム固有実装

5. オーディオシステム

4つのサウンドタイプ: FIRE, DRY_FIRE, RELOAD, CYCLE

タイプごとに4-8のサウンドバリエーション

`LeverActionPlaySoundContext` - 集中サウンド管理

6. ネットワーキング

**パケットシステム:**

`KeyInputPacket` - キー押下同期

`AimPacket` - 照準状態同期

`RecoilPacket` - リコイル効果同期

`HudStatePacket` - HUD更新同期

7. エンティティシステム

`BulletEntity` - 重力と空気抵抗を持つ物理ベース投射物

ハイブリッド当たり判定: レイキャスト + ProjectileUtil

サイズ応答型ヒットボックスでヘッドショット検出

Mixin経由のプレイヤー能力システム

知識の泉（Knowledge Spring）- 効率的な実装調査システム

システム構成

```

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. 調査効率の向上**

**71%の時間短縮**: 従来255分 → 75分

**依存関係追跡**: `dependencies`フィールドで関連システム特定

**実装状況把握**: `importance`/`key_features`/`note`で詳細確認

**最新変更確認**: `recent_major_changes`で履歴把握

実装調査の5つのパターン

1. **システム全体把握調査**: files-index.json → importance:high特定 → アーキテクチャ図作成

2. **機能連携調査**: dependencies追跡 → データフロー分析 → シーケンス図作成

3. **パフォーマンス調査**: recent_major_changes確認 → 最適化手法理解 → 技術詳細文書化

4. **コンポーネントシステム調査**: コンポーネント構造把握 → 実装パターン抽出 → サンプル集作成

5. **バグ調査・デバッグ**: 問題箇所特定 → 関連システム確認 → 最近の変更確認 → 解決策文書化

詳細: `docs/agent/implementation-investigation-patterns.md`

コーディング標準

言語とドキュメント

**主要言語**: すべてのコミュニケーション、ドキュメント、コードコメントに日本語を使用

**コードコメント**: インラインコメントとJavaDocドキュメントに日本語を使用

Null安全性

**Nullアノテーション**: `@org.jetbrains.annotations.Nullable`を使用してnullable型を明示的にマーク

**Non-nullデフォルト**: `@Nullable`で明示的にマークされない限り、すべてのパラメータ、戻り値、クラスフィールドはnon-nullと見なす

**Optionalの使用**: メソッドの戻り値がnullableな場合は、nullを返すよりも`Optional<T>`を返すことを優先

例

```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

1. 知識の泉の更新

Read docs/agent/crud-guide.md # 操作方法確認

該当するcommon/*.jsonファイルを更新

2. 関連ドキュメントの更新

アーキテクチャ図、実装サンプル等の更新

```

重要な注意点

このコードベースで作業する際は、以下に特に注意してください:

コンポーネント状態管理と不変性

マルチプレイヤー互換性のためのクライアント・サーバー同期

データ永続化のためのNBTシリアライゼーション

fabric/forgeディレクトリのプラットフォーム固有実装

適切なnull安全性アノテーションとOptional使用

プロジェクトの大まかな情報を得たいときは知識の泉`docs/agent`ディレクトリを活用

実装調査時は`docs/agent/implementation-investigation-patterns.md`の5つのパターンを活用

ドキュメント作成時は`docs/agent/documentation-creation-guide.md`のガイドラインに従う

主要な依存関係

**jglTF**: 3Dモデル読み込みとレンダリング(`de.javagl:jgltf-*`)

**Architectury**: マルチプラットフォームMod開発

**Cloth Config**: 設定GUIシステム

**ModMenu**: Fabric設定統合

ActionArms Minecraft Mod Development

ActionArms Minecraft Mod Development

プロジェクト概要

開発コマンド

ビルドと実行

全プラットフォームビルド

特定プラットフォームビルド

開発環境実行

クリーンビルド

アーキテクチャ構造

マルチプラットフォーム構成

コア設計パターン

1. コンポーネントベースアイテムシステム

2. 銃メカニクスシステム

3. クライアントサイドレンダリング

4. 入力管理

5. オーディオシステム

6. ネットワーキング

7. エンティティシステム

知識の泉（Knowledge Spring）- 効率的な実装調査システム

システム構成

活用方法

全体把握

特定システム調査

実装調査の5つのパターン

コーディング標準

言語とドキュメント

Null安全性

例

追加ルール

開発ワークフロー

新機能開発時

バグ修正時

ドキュメント更新プロセス

1. 知識の泉の更新

該当するcommon/*.jsonファイルを更新

2. 関連ドキュメントの更新

アーキテクチャ図、実装サンプル等の更新

重要な注意点

主要な依存関係

Reviews (0)