Change items skin (texture)

This will work with the latest head as of writing this (I don't know if the previous versions did something different with the skins, but you could try anycase)

The first thing you want to do is have some naming convention for your files.

If you are to make a shape called ITEM.DTS you need some textures like BASE.ITEM.PNG and other (for the different textures you want to use with this shape). The BASE.ITEM.PNG file is the one you use as diffuse map in 3d studio when creating the item shape.

So if you have say 2 more textures for the same shape you would call 'em TEX1.ITEM.PNG and TEX2.ITEM.PNG

Now, in the shape's datablock you could add an extra variable called: skin like this:

datablock ItemData(MyItem1)
{
  ... 

  shapeFile = "~/data/shapes/items/item.dts"; // <-- our model

  ...

  // Dynamic properties defined by the scripts
  skin = "TEX1"; // <-- look here

  // another Item DataBlock might use skin = "TEX2";
  ...
};

Now to actually make the engine use TEX1.ITEM.PNG as the texture (skin) and not BASE.ITEM.PNG we need to add a few more lines of code in item.cs (we will also come back to this datablock)

In item.cs I made the follwing change:

function ItemData::create(%data)
{
   // The mission editor invokes this method when it wants to create
   // ...
   %obj = new Item() {
      dataBlock = %data;
      static = true;
      rotate = true;
   };

   [b]%obj.setSkinName(%data.skin); // <-- add this to change the skin when the editor adds the item[/b]

   return %obj;
}

and add a new class-function (you can do this in item.cs too)

function MMItem::onAdd(%data, %obj)
{
   %obj.setSkinName(%data.skin);
}

and lastly go back to the item's DataBlock and add

className = "MMItem";

like this

datablock ItemData(MyItem1)
{
  ... 

  shapeFile = "~/data/shapes/items/item.dts"; // <-- our model
  className = "MMItem"; // <-- look here

  ...

  // Dynamic properties defined by the scripts
  skin = "TEX1"; // <-- look here

  // another Item DataBlock might use skin = "TEX2";
  ...
};

And that should do it :)