ComputerCraft API

この記事は執筆中です。加筆してくださる人を募集しています。

この記事は"Minecraft Forge Universal 10.13.0.x～"及び"ComputerCraft 1.65～"を前提MODとしています。

ComputerCraftのComputerから利用可能な周辺機器やTurtleに装着可能なTurtle Upgradeなどを追加することができる。

概要

ComputerCraft APIを利用して以下のようなブロックやアイテムを追加できる

• ComputerやTurtleから利用可能な周辺機器ブロック
• Turtleへ装着可能なツールや周辺機器（Turtle Upgrade）
• Disk Driveなどからアクセス可能なメディアアイテム
• ComputerやTurtleに対して16チャンネルのレッドストーン入出力が可能なブロック

開発環境への導入方法

ComputerCraftの前提MODであるMinecraftForgeがMOD開発環境に導入されている必要がある。
これらの導入方法はMOD開発環境を作る、MinecraftForge導入手順のページを参照。

1. ModdingするバージョンのComputerCraftをダウンロード
   • http://www.computercraft.info/download/
2. ダウンロードしたjarを解凍
   • 拡張子をzipに変更して解凍する
3. ソースコードを移動
   • 解凍したjar内のapi\srcファルダ内にあるdan200フォルダを、(プロジェクトフォルダ)\src\api\javaフォルダ内に移動する
     • 移動後は(プロジェクトフォルダ)\src\api\java\dan200となる
     • Eclipseで利用する場合、導入後にパッケージ・エクスプローラーで「src/api/java」フォルダを右クリック→「ビルド・パス」→「ソース・フォルダとして使用」でソースフォルダに設定にする
   • APIのドキュメント（英語）は解凍したjar内のapi\doc\index.html

デバッグ方法

• プレイ環境上で行う場合 （最終段階でのテストプレイ向き）

1. 「MinecraftForge導入手順#リリース」を参考にmodのjarを生成する
2. プレイ環境のゲームフォルダ内のmodsフォルダに自作modのjarとComputerCraftのjarを置く
3. 通常のプレイと同じようにMinecraftを起動する

• Modding環境上で行う場合 （開発段階でのトライアル・アンド・エラー向き）

1. Modding環境のデバッグ時にComputerCraftが正しくロードされるようにする
   • 1.76（Minecraft 1.8）まで： Modding環境のゲームフォルダ内のmodsフォルダにCodeChickenCore dev版とComputerCraftのjarを置く
     • 通常のデバッグはこれでも問題ないが、配布前に一度はCodeChickenCoreのないプレイ環境上でのテストプレイを推奨（CodeChickenCore導入環境でのみ発生しないクラッシュなどが存在する可能性もあるため）
   • 1.78（Minecraft 1.8.9）以降：
     1. プロジェクトフォルダ内にlibフォルダを作成し、そのフォルダにComputerCraftのjarを置く
     2. build.gradle に以下の記述を追加する

        dependencies { compile fileTree(dir: 'lib', include: '*.jar') }

     3. libフォルダに置いたComputerCraftのjarを開発環境のビルドパスに追加する
     4. 「開発環境への導入方法」で追加した「src/api/java」をビルドパスから除去する
2. 「MinecraftForge導入手順#デバッグ」を参考にmodding環境上でデバッグを開始する

関連リンク

• ComputerCraft 公式
• ComputerCraft Download
• ComputerCraft Forums: Peripherals and Turtle Upgrades
• ComputerCraft Wiki: Turtle Upgrade IDs - 1.75（MC 1.7.10）まで。1.76（MC 1.8）以降はUpgrade IDがResourceLocationになったため基本的に被らなくなった。

クラス構成

API構成クラスの簡単な解説。詳細はAPI付属のJavadoc（英語）を参照。

• ComputerCraft 1.76 (Minecraft 1.8) ※MC1.7からMC1.8への変更点を含む
• ComputerCraft 1.74 (Minecraft 1.7.10)

以下、過去のバージョン（折り畳まれています。展開ボタン→）

• ComputerCraft 1.73 (Minecraft 1.7.10)
• ComputerCraft 1.65 (Minecraft 1.7.10)

チュートリアル

項目	バージョン別チュートリアル
周辺機器
周辺機器の追加	1.76～1.79 (MC 1.8.x) 1.65～1.75 (MC 1.7.x)
周辺機器メソッドの追加	1.65～1.79 (MC 1.7.x～1.8.x)
周辺機器イベントの発生	1.65～1.75 (MC 1.7.x) △ MC1.8～でも参考可
TurtleUpgrade
ツールタイプTurtleの追加	1.76～1.79 (MC 1.8.x) 1.65～1.75 (MC 1.7.x)
周辺機器タイプTurtleの追加	1.76～1.79 (MC 1.8.x) 1.65～1.75 (MC 1.7.x)
UpgradeNBTDataの利用	1.65～1.79 (MC 1.7.x～1.8.x)
その他 CCAPI 全般
リソースのマウント	1.65～1.79 (MC 1.7.x～1.8.x)
ILuaObjectの利用	1.75～1.79 (MC 1.7.x～1.8.x)

この記事は執筆中です。加筆してくださる人を募集しています。