Marble Skin Selector

[Jeff]

Note: credits to Matan for the MainMenuGui.gui source code.

This code basically allows the marble to be re-skinned so that it can change colors. This will not change the marble shape as it does not use dts files, rather it uses image files. In order to add new skins, navigate to:

marble/data/shapes/balls/

and add new files with:

<your file base>.marble.png

---

Installation:

Go to marble/client/init.cs

find function initClient() and look where other files are being loaded.

add this:

  // load our script
  exec("./ui/MarbleSelectDlg.gui");

Go to marble/client/ui/

add in the attached file

Go to marble/server/scripts/game.cs

find function GameConnection::onClientEnterGame(%this)

add this right before the last closing brace (}):

// This is where the marble selection happens
if (isFile($Pref::MarbleSelection))
{
%marbleSkin = convertToFileBase($Pref::MarbleSelection);
%this.player.setSkinName(%marbleSkin);
}

---

To use:

I added a console command to use this. In the level select screen BEFORE you press play, open the console (press the ~ key) and type in the following:

openMarbleSelect();


If you want this attached to a button, make a button in a .gui file and change the command field to this:

command = "openMarbleSelect();";

That is it! If your marble gliches out and you can't see your new texture, this may help you solve it (this is found in the source code)

// If the skin does not show up, go into:
// marble/server/scripts/marble.cs
// find:
//   Datablock MarbleData(DefaultMarble)
// find:
//   emap = true;
// change to:
//   emap = false;
// then, close marble blast and reload it.

This code is under the MIT license:

// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to
// deal in the Software without restriction, including without limitation the
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
// sell copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
// IN THE SOFTWARE.

Also, once a skin is selected, it will even be saved!

Enjoy!!

~Jeff

Attachments:

[Gary]

Great . Jeff..

[๖ۣۜAddict™]

Whoa, very cool!

[Riblet]

Very well done! I'm glad we are able to add in new skins without messing around with dts's.

Maybe you could add in a switch to change the emap value? If it's possible it might make it easier so you don't have to go into the cs files if your skin doesn't have an emap. Maybe there could just be a check that disables it if there is no emap file.

[Jeff]

Thanks very much guys, be sure to make use of it!

Riblet: I will take that into consideration.

[Beack]

Great contribution, clever way to change your marble skin

one small question: It's possible if I add another .DTS files and create a variety of skins for it, just editing the code lines for more models (after make MBG able to handle more than one DTS for marbles)

[Jeff]

Beack: it would require some changes, such as looping through the .dts files. Look at my old marble selection for references, as that one changes the dts files.

[LegoCreator768]

Doesn't work for me

[Jeff]

Make sure you followed the tutorial exactly...

[LegoCreator768]

My marble is the same default marble for some reason the marble skin didn't change.

[Jeff]

did you add this in game.cs

// This is where the marble selection happens
if (isFile($Pref::MarbleSelection))
{
%marbleSkin = convertToFileBase($Pref::MarbleSelection);
%this.player.setSkinName(%marbleSkin);
}

[LegoCreator768]

yeah it's in

Checked the consle, and there was a syntax error.

It says:

marble/server/game.cs Line: 628 - Syntax error
>>> Advanced Script Error Report. Line 1255
>>> Some error context, with ## on sides of error halt:
%marbleSkin = convertToFileBase($Perf::MarbleSelection);
%this.player.setSkinName(%arbleSkin);
} ##
>>>Error report complete.

EDIT:

Fixed the error, but skin still not showing up. still base.marble.
It runs off of base.marble. that's why. I renamed base.marble to blue.marble and guess what I got...
White! White means "Missing Texture".

[Jeff]

you misspelled it
%this.player.setSkinName(%arbleSkin);

its %marble.

My code:

%this.player.setSkinName(%marbleSkin);

[LegoCreator768]

once again, thanks!

EDIT: I'll use the DTS marble selector instead. I'm having too many problems with this one.

[ENlGMA]

I'm a noob to coding (it's no surprise) but how do I make a button? I just need the file name and I'll be fine.