提供: Minecraft Modding Wiki
この編集を取り消せます。
下記の差分を確認して、本当に取り消していいか検証してください。よろしければ変更を保存して取り消しを完了してください。
| 最新版 | 編集中の文章 | ||
| 3行目: | 3行目: | ||
== UpgradeNBTDataの利用 == | == UpgradeNBTDataの利用 == | ||
| − | + | Turtleより提供されるTurtle Upgrade用のNBTTagCompound（UpgradeNBTData）の利用方法について解説します。 | |
*UpgradeNBTDataの取得 | *UpgradeNBTDataの取得 | ||
| 15行目: | 15行目: | ||
NBTTagCompound nbt = turtle.getUpgradeNBTData(side); | NBTTagCompound nbt = turtle.getUpgradeNBTData(side); | ||
</source> | </source> | ||
| − | + | 引数でUpgradeNBTDataを取得したいTurtle Upgradeの装着方向を指定します。<br> | |
| − | + | 各Turtleは左のTurtle Upgrade用のUpgradeNBTDataと右のTurtle Upgrade用のUpgradeNBTDataを持っていて、それぞれのUpgradeNBTDataは独立しています。 | |
| − | + | 周辺機器タイプのTurtleで周辺機器実装クラスでもUpgradeNBTDataを利用したい場合は、以下のように周辺機器側でITurtleAccessとTurtleSideのインスタンスを保存しておきます。 | |
<source lang = "java"> | <source lang = "java"> | ||
public class TurtleSample implements ITurtleUpgrade { | public class TurtleSample implements ITurtleUpgrade { | ||
| 35行目: | 35行目: | ||
public SamplePeripheral(ITurtleAccess turtle, TurtleSide side) { | public SamplePeripheral(ITurtleAccess turtle, TurtleSide side) { | ||
// コンストラクタで渡されたITurtleAccessとTurtleSideのインスタンスを保存 | // コンストラクタで渡されたITurtleAccessとTurtleSideのインスタンスを保存 | ||
| − | // | + | // turtleAccess.getUpgradeNBTData(turtleSide) のようにしてUpgradeNBTDataを取得 |
turtleAccess = turtle; | turtleAccess = turtle; | ||
turtleSide = side; | turtleSide = side; | ||
| 43行目: | 43行目: | ||
=== UpgradeNBTDataの利用 === | === UpgradeNBTDataの利用 === | ||
| − | ITurtleAccess.getUpgradeNBTData() | + | ITurtleAccess.getUpgradeNBTData()で取得したNBTTagCompoundは（TileEntityやItemStackのNBTTagCompoundと同じように）データの保存や取得が可能です。<br> |
| − | + | 詳しくはForgeチュートリアルのNBTに関するページを参照してください。 | |
Minecraftの構造上、（シングル・マルチを問わず）UpgradeNBTDataにも「サーバ側」と「クライアント側」が存在します。<br> | Minecraftの構造上、（シングル・マルチを問わず）UpgradeNBTDataにも「サーバ側」と「クライアント側」が存在します。<br> | ||
| − | + | 基本的にはサーバ側のUpgradeNBTDataを利用することになりますが、UpgradeNBTDataのデータを元にTurtle Upgradeの外観を変えたりなどする場合はクライアント側のUpgradeNBTDataを利用する必要があります。<br> | |
| − | + | サーバ側のUpgradeNBTDataの状態をクライアント側のUpgradeNBTDataへ反映させる（同期させる）には後述するITurtleAccess.updateUpgradeNBTData()を呼び出します。 | |
サーバ側のUpgradeNBTDataに保存したデータはゲームを終了しても消去されず、ゲーム再開後に再び取得することができます。<br> | サーバ側のUpgradeNBTDataに保存したデータはゲームを終了しても消去されず、ゲーム再開後に再び取得することができます。<br> | ||
ただし、以下の場合は保存したデータが消去されます。 | ただし、以下の場合は保存したデータが消去されます。 | ||
| − | *Turtle | + | *Turtle Upgradeを取り外す（取り外されたTurtle Upgradeの方のUpgradeNBTDataのみ消去されます） |
| − | *別のTurtle | + | *別のTurtle Upgradeと交換する（交換されたTurtle Upgradeの方のUpgradeNBTDataのみ消去されます） |
*Turtleを破壊する（両方のUpgradeNBTDataが消去されます。ラベルを付けたTurtleでも消去されます） | *Turtleを破壊する（両方のUpgradeNBTDataが消去されます。ラベルを付けたTurtleでも消去されます） | ||
| 65行目: | 65行目: | ||
サーバ側からの呼び出しのみ有効で、クライアント側で呼び出してもクライアント側のUpgradeNBTDataがサーバ側に反映されるということはありません。 | サーバ側からの呼び出しのみ有効で、クライアント側で呼び出してもクライアント側のUpgradeNBTDataがサーバ側に反映されるということはありません。 | ||
| − | + | UpgradeNBTDataはTurtleがワールドへロードされた時などにも同期されますが、このメソッドを呼び出すと即座に同期されます。 | |