[Tool] MXSkinNamer v3.1.0- Bulk Skin/JM Renamer, Scram'er, and Saf'er

Post about creating and skinning models here
LKR47
Posts: 893
Joined: Fri Jan 18, 2013 4:26 am
Team: LCQ Studios
Location: McHenry, Illinois
Contact:

[Tool] MXSkinNamer v3.1.0- Bulk Skin/JM Renamer, Scram'er, and Saf'er

Post by LKR47 »

Image

Description

Everyone that makes any kind of skins for any kind of model knows that the process can be very laborious and tedious. You have to take the time to name every map or every jm and I know almost every single one of you have to go look up the dyno name on the internet so your skins show up under the right bike in game. Then you have to fire up a command prompt to scram and saf your files.

What if I told you that I have created a tool to do everything for you?

Introducing mxskinnamer.... (yeah I know the name sucks)

Mxskinnamer allows you to choose a folder that contains your skins, jms, or both at the same time and then select the dyno you want to be renamed in bulk and be named perfectly every time! You don't even have to worry about whether or not you got the right dyno name. The tool is even able to find your norm and spec maps and name them accordingly. An intuitive listbox for both the maps and jms allow you to select which files you want to include and which ones you don't. You can choose to rename maps and jm files or do each one accordingly.

Once you have your files renamed, you're going to want to protect them by sramming them. The scrammer find all the files that you renamed and runs jlv's scram binary so you get those awesome encrypted files. Following the same theme, you can choose to do this for all of your files, just the maps, or just the jm files.

The last step in the skinning process is packaging your files into a single saf file. The saf'er runs a version (updated to work with Python 3.x) of jlv's saf script to get all your files, just the maps, or just the jm files packaged into a single saf file that you can distribute anywhere for people to download.

I had a blast creating this as a way to help me learn to program in another language, Python. Since this was a learning project, there will probably be a few bugs. If anything breaks for you, feel free to let me know and I'll patch it. Otherwise, feel free to modify this to your needs, make pull requests, fork the repo, etc.

Caution!
  • The scram tool will not work on MacOS since there are no Mac binaries
  • I am unable to test the scram tool on my Linux machines since they are not running a gui. I will be testing in a VM soon, but I thought I should make you aware. I have a feeling you will have to run this command on the scram tool to make it executable.

    Code: Select all

    chmod +x plugins/mxscram
Tutorials for how to use are below.

If this helped you save some time with packaging your skins, maybe consider buying me a beer.
Paypal

Link to tool:
https://github.com/hodge47/mxskinnamer/releases/tag/v3.0.0
GitHub Repo:
https://github.com/hodge47/mxskinnamer

A big thank you to jlv for letting me redistribute his tools

Changelog:
v3.1.0 - 07/16/2022
  • Adds support for first-person rider jm's
v3.0.1 - 05/19/2022
  • Fixes a bug where all skin names were forced to lower case
  • Fixes a bug where saf files could not be created in some instances
v3.0.0 - 02/14/2021
  • Adds all files scram
  • Adds map files scram
  • Adds jm files scram
  • Adds all files saf
  • Adds map files saf
  • Adds jm files saf
  • Adds better console logging (a little more verbose)
  • Various bug fixes and improvements
v2.1.0 - 07/07/2020
  • Adds multi-selection removal to skins and JM listboxes
  • Adds 250 two-stroke dynos to complete the dyno lineup
  • Removes a couple of unnecessary print statements
v2.0 - 06/23/2020
  • Adds overhauled UI
  • Adds file copying for a non-destructive workflow
  • Adds item deletions in listboxes (does not delete files, just availability)
  • Adds JM renaming support
  • Adds options to rename only skins, only JMs, or both at the same time
  • Adds support for rider body, helmet, and wheel maps and/or jm renaming
  • Adds a 125cc and 50cc to dyno list
  • Fixes file rename errors using 'os.rename()' on Windows operating systems
  • Fixes partial maps names getting added to final file name by prompting the user about a text split
Video Tutorial:

Installation:


Usage:


Scram and Saf:


Text Tutorial (will be updated for 3.0.0 soon):

How to Use

**You will need Python installed on your machine to use this*

Prep
You will need at least one diffuse map (You can use as many diffuse maps as you want). This is the map that your graphics are on. This map can be named whatever you want it to be but it cannot have 'N[n]orm' or 'S[s]pec' in it. Optionally you can also use normal and specular maps. These need to have 'N[n]orm' and 'S[s]pec' in the name, respectively.

You can also choose to rename JM files. For a bike these should include "fork_lower.jm", "fork_upper.jm", "frame.jm", and "swingarm.jm". For a rider this would need "rider_body.jm", for a helmet, "rider_head.jm". Lastly, for wheels the JMs you would need are "front_wheel.jm" and "rear_wheel.jm".

You can either rename skins and JMs separately on their own or all together at once.

Install Python
  1. Go to (https://www.python.org/downloads/) and download the latest release of Python
  2. Follow the installer instructions for your operating system
Running the Script

Double-Click
  1. Extract the script somewhere on your computer
  2. Double-click the script
Terminal/Command Line
  1. Extract the script somewhere to your computer
  2. Open a terminal or command line
  3. `cd` in the directory that contains the script
  4. Run this command `python main.py`
Usage
  1. Click the browse button and navigate to the directory that contains your skins (diffuse textures, normal map, and specular map) and/or JM files
  2. Type the model name you're saving for in the 'Model Name' text box. This is what your JM name is after the dyno
  3. Select the dyno that you're saving for in the 'Dyno' list. This contains bikes, rider body, helmet, and wheels
  4. Rename buttons
    • Click the 'Rename All' button to rename skins and JM files
    • Click the 'Rename Maps' button to only rename skins and maps
    • Click the 'Rename JMs' button to only rename JM files
  5. Navigate to the directory where your skins were saved
    • *Note: Skins/maps and JM files are now copied and then renamed to avoid a destructive workflow. Your files will be saved in your skins/jm directory under 'RenamedFiles/Model Name/Maps' or 'RenamedFiles/Model Name/JM
  6. (Optional) Scram and saf your bike maps
  7. Move to your game install directory or personal folder
Last edited by LKR47 on Sat Jul 16, 2022 7:37 pm, edited 9 times in total.
Image
Haberfield24
Crushed Dissenter
Posts: 352
Joined: Mon Feb 10, 2014 7:43 pm

Re: [Tool] MXSkinNamer

Post by Haberfield24 »

Been waiting for something like this for a while! Thanks! Shame you didn't release this a few weeks back, would of saved me some serious hours :lol:
Atom6246
Posts: 3991
Joined: Fri Jul 13, 2012 1:28 am
Contact:

Re: [Tool] MXSkinNamer

Post by Atom6246 »

Haberfield24 wrote:Shame you didn't release this a few weeks back, would of saved me some serious hours :lol:
rt

This looks really dope though! Thanks!
Mr. Wiggles
Posts: 1038
Joined: Sun Feb 08, 2015 6:41 pm
Team: GSR/137 Kid
Location: Bottom Feeder at LCQ Studios
Contact:

Re: [Tool] MXSkinNamer

Post by Mr. Wiggles »

cash money
Bottom feeder at LCQ Studios
Internet Nice Guy!
DariusP8
Posts: 363
Joined: Thu Feb 16, 2017 5:25 am
Team: Team Nami
Location: Oregon

Re: [Tool] MXSkinNamer

Post by DariusP8 »

This is very cool! Thanks for releasing it!
Image
LKR47
Posts: 893
Joined: Fri Jan 18, 2013 4:26 am
Team: LCQ Studios
Location: McHenry, Illinois
Contact:

Re: [Tool] MXSkinNamer

Post by LKR47 »

Atom6246 wrote:
Haberfield24 wrote:Shame you didn't release this a few weeks back, would of saved me some serious hours :lol:
rt
Yeah, sorry boys. Been out of the sim world for almost a year now so I wasn't thinking about it until it just hit me the other day haha.

Hopefully, you guys can make good use of it in the future. I plan on doing the JM renaming next week and possibly add rider and helmet categories to make it a little more feature complete.
Image
LKR47
Posts: 893
Joined: Fri Jan 18, 2013 4:26 am
Team: LCQ Studios
Location: McHenry, Illinois
Contact:

Re: [Tool] MXSkinNamer v2.0 - JM Renaming!

Post by LKR47 »

Image

First post updated with new links, revised instructions, video tutorials, and changelog.

I added a lot in the last week. Some of the bigger things are an overhauled UI, jm renaming, non-destructive workflow, diffuse map name splitting. I also added support for rider skin/jm renaming, helmet skin/jm renaming, and wheel skin/jm renaming. (These may be a little weird so let me know if it messes up). I also threw the 125/50 dynos in, but somehow I forgot the 250 2 strokes lol. :lol:

Changelog:
v2.0 - 06/23/2020
  • Adds overhauled UI
  • Adds file copying for a non-destructive workflow
  • Adds item deletions in listboxes (does not delete files, just availability)
  • Adds JM renaming support
  • Adds options to rename only skins, only JMs, or both at the same time
  • Adds support for rider body, helmet, and wheel maps and/or jm renaming
  • Adds a 125cc and 50cc to dyno list
  • Fixes file rename errors using 'os.rename()' on Windows operating systems
  • Fixes partial maps names getting added to final file name by prompting the user about a text split
Image
Andy_Hack
Posts: 2441
Joined: Mon Nov 01, 2010 11:47 am
Team: SplitFire
Location: Germany/Bavaria
Contact:

Re: [Tool] MXSkinNamer v2.0 - JM Renaming!

Post by Andy_Hack »

This is going to help lots of people! Thank you!
*fancy signature*
d4u5d6u7 wrote:good staff, nice skins, like
Mr. Wiggles
Posts: 1038
Joined: Sun Feb 08, 2015 6:41 pm
Team: GSR/137 Kid
Location: Bottom Feeder at LCQ Studios
Contact:

Re: [Tool] MXSkinNamer v2.0 - JM Renaming!

Post by Mr. Wiggles »

Andy_Hack wrote:This is going to help lots of people! Thank you!
Come back to discord :evil: :evil: :evil:
Bottom feeder at LCQ Studios
Internet Nice Guy!
LKR47
Posts: 893
Joined: Fri Jan 18, 2013 4:26 am
Team: LCQ Studios
Location: McHenry, Illinois
Contact:

Re: [Tool] MXSkinNamer v2.1.0 - Bulk Skin/JM Renamer

Post by LKR47 »

Image

I released a minor version today. In this version I added multi-selection to the skins and JM listboxes so if you have more than one thing to remove you can save clicks by removing in bulk. It works like you'd expect; Left-ctrl+LMB Click or Left-Shift+LMB Click and dragging.

I also finally got around to adding the 250 two-strokes to complete the dyno lineup.

Changelog:
v2.1.0 - 07/07/2020
  • Adds multi-selection removal to skins and JM listboxes
  • Adds 250 two-stroke dynos to complete the dyno lineup
  • Removes a couple of unnecessary print statements
Image
LKR47
Posts: 893
Joined: Fri Jan 18, 2013 4:26 am
Team: LCQ Studios
Location: McHenry, Illinois
Contact:

Re: [Tool] MXSkinNamer v2.1.0 - Bulk Skin/JM Renamer

Post by LKR47 »

Image

I spent the day adding scram and saf functionality to make this tool more complete. Scramming and Saffing files play a huge role in the skinning/modeling process so it was important for me to get that stuff in there. Let me know how it works for you! And as always, let me know if run into any bugs.

*Linux users*:
I am unable to test the scram tool on my Linux machines since they are not running a gui. I will be testing in a VM soon, but I thought I should make you aware. I have a feeling you will have to run this command on the scram tool to make it executable.

Code: Select all

chmod +x plugins/mxscram
Changelog:
v3.0.0 - 02/14/2021
  • Adds all files scram
  • Adds map files scram
  • Adds jm files scram
  • Adds all files saf
  • Adds map files saf
  • Adds jm files saf
  • Adds better console logging (a little more verbose)
  • Various bug fixes and improvements
Updated tutorials will be posted soon.
Image
LKR47
Posts: 893
Joined: Fri Jan 18, 2013 4:26 am
Team: LCQ Studios
Location: McHenry, Illinois
Contact:

Re: [Tool] MXSkinNamer v3.0.0- Bulk Skin/JM Renamer, Scram'er, and Saf'er

Post by LKR47 »

Forgot one thing, you will need Python 3.6+ to run the script now. I will make note of that when I update the tut.
Image
LKR47
Posts: 893
Joined: Fri Jan 18, 2013 4:26 am
Team: LCQ Studios
Location: McHenry, Illinois
Contact:

Re: [Tool] MXSkinNamer v3.0.0- Bulk Skin/JM Renamer, Scram'er, and Saf'er

Post by LKR47 »

First post updated with scram and saf video tutorial
Image
James Webb
Posts: 835
Joined: Wed Jan 02, 2013 1:26 am
Team: Evergood

Re: [Tool] MXSkinNamer v3.0.0- Bulk Skin/JM Renamer, Scram'er, and Saf'er

Post by James Webb »

this is amazing, would have saved so much time making team packs.
Carter
Posts: 28
Joined: Tue Feb 02, 2021 2:40 am

Re: [Tool] MXSkinNamer v3.0.0- Bulk Skin/JM Renamer, Scram'er, and Saf'er

Post by Carter »

This is actually so sick
Image
Post Reply