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フォルダ内にある

デバッグ方法

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

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）以降： プロジェクトフォルダ（内のlibフォルダなど適当な場所）にComputerCraftのjarを置き、そのjarをビルドパスに追加する
     • 「開発環境への導入方法」でComputerCraft APIのソースコードをビルドパスに追加している場合、デバッグ時にjarとクラスが被ったためどちらかが無効になったというエラーが表示される。気になるならソースコードの方のAPIは除いてしまって構わない
2. 「MinecraftForge導入手順#デバッグ」を参考にmodding環境上でデバッグを開始する

関連リンク

• ComputerCraft 公式
• ComputerCraft Download
• ComputerCraft Forums: Peripherals and Turtle Upgrades
• ComputerCraft Wiki: Turtle Upgrade IDs

クラス構成

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)

チュートリアル

項目	バージョン別チュートリアル
周辺機器・CCAPI全般
周辺機器の追加	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)
リソースのマウント	1.65～1.79 (MC 1.7.x～1.8.x)
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)

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