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がcatchしてしまって見落としてしまう例外がいくらか存在するため）
   • 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)

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