MESA: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
(36 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<center>http://puppet-master.net/wp-content/uploads/2012/11/mesa-logo-image.png</center>
{{distinguish|Black Mesa|desc1=Third-party remake of [[Half-Life]]}}
<center>https://puppet-master.net/wp-content/uploads/2015/09/mesa21-logo.png</center>


= Description =
----


MESA is mel script suite to export and import 3d models for the Valve Source Engine. This is the short name for Maya Exporter for Source Absolute.
__toc__


'''Question :''' What about the '''Absolute''' mention ?
= Description =
'''Anwser : ''' Because all the work could be done within maya. no text editor will be required for the final version of MESA.
{{mesa|4}} 2.0 is a suite of MEL Scripts to export and import 3d models for the Valve Source Engine with Autodesk Maya. This is the short name for Maya Exporter for Source Absolute.


The objective of MESA, is about to make the full asset creation process within Maya interface.
The objective of MESA, is about to make the full asset creation process within Maya interface.
It include static, physiques, dynamic and ragdoll props models, breakable models, bodygroups models.
It includes static, physics, breakable, dynamic and ragdoll models, and supported bodygroups , It become easy to use maya  to export to the source engine  the  NPCs (Monsters and Humanoid), Vehicles, Weapons and Items for your game.
But also NPCs (Monsters and Humanoid), Vehicles, Weapons and Items.


MESA is Mel script bases exporter and importer Tools. This script are the rewritten /edited Script from Valve originally designed for maya 4.5, and that is available into the source sdk
MESA is Mel scripts bases exporter and importer Tools. This scripts are the rewritten / edited Scripts from Valve, and originally designed for maya 4.5, that was also deeply rewritten by Prall .
provided by Valve Software.


MESA is compatible with all recent version of maya ( 2011/2012/2013 x86 and x64 bits )
MESA is compatible with all recent version of Maya ( 2011/2012/2013/2014  with x86 and x64 bits )




== Download the functional scripts for SMD import/Export ==
== Download MESA ==




Line 26: Line 25:
! MESA Version
! MESA Version
! Download Link
! Download Link
|-
! Compatibility
| width=15% height=100px | 05 Nov 2012
|- style=" vertical-align:top;"
| width=33%  | MESA ( Maya exporter to Source Absolute ) v1.0 beta
| width=10% height=50px | 04 Nov 2015
| width=33%  | [http://puppet-master.net/mesa/mesa_v1.0_beta.rar MESA v 1.0 beta]
| width=20%  | MESA v2.1
| width=20%  | [http://puppet-master.net/plugins/mesa-2.0/ MESA v 2.1]
| rowspan=3 width=50%  | Tested on x86 and x64 version of :
* Maya 2016
* Maya 2015
* Maya 2014
* Maya 2013
* Maya 2012
* Maya 2011
|- style=" vertical-align:top;"
| width=10% height=50px | 06 Oct 2013
| width=20%  | MESA v2.0
| width=20%  | [http://puppet-master.net/plugins/mesa-2.0/ MESA v 2.0] (396ko)
|- style=" vertical-align:top;"
| width=10% height=50px | 23 Apr 2013
| width=20%  | MESA v1.1
| width=20%  | [http://puppet-master.net/plugins/mesa-for-maya/ MESA v 1.1] (127ko)
|}
|}


Line 37: Line 52:
|-
|-
| style= "vertical-align:top;" |  
| style= "vertical-align:top;" |  
__TOC__
|  
|  
== Instructions about the multiple types of installation and their Usage==
== Features list ==


The main interest of MESA exporter, is the easy way to compile and convert the asset one few click within Maya Interface.
The main interest of MESA exporter, is the easy way to compile and convert the assets in few clicks within Maya Interface.


<big>The installation will depend on the location of MESA exporter, and the usage you want with this Scripts.</big>
{| style=" vertical-align:top; text-align:center;" class=wikitable width="100%" align="left"
 
{| style=" vertical-align:top; text-align:center;" class=wikitable width="100%" align="center"
|+  What installation , for what usage  ?
|-
|-
! How to install MESA
! Description
! Support / Usage
! Support / Usage
! Documentation
|-
|-
| width= 15% | [[MESA#Standard_Installation|Standard Installation]]
| style=" vertical-align:top; text-align:left;" | You may have a computer without source sdk and Steam installed on your computer ? And you wish to be capable to export Smd Ref, Anim, VTA, QC and VMT, without full compile process ? This is the right choice for you.
| style=" vertical-align:top; text-align:left;" |
- SMD Import
- SMD Export
- SMD Animations
- Lod
- Physic Mesh
- VTA export (blend shapes)
- Ref break
- Phys_break
- BodyGroups
- QC export
- VMT export
|-
| [[MESA#Absolute_Installation_.28full_featured_.29|Absolute Installation]]
| style=" vertical-align:top; text-align:left;" | You want to installs MESA Exporters  and incoporate the script into your Source Mod project directory.
| style=" vertical-align:top; text-align:left;" |
| style=" vertical-align:top; text-align:left;" |
- Maya Workspace
* Maya Workspace
- SMD Import
* SMD Import
- SMD Export
* SMD Export
- SMD Animations
* SMD Animations
- Lod
* LODS ( level of detail )
- Physic Mesh
* Physic / Ragdoll Model
- VTA export (blend shapes)
* VTA export
- Ref break
* Ref break
- Phys_break
* Phys_break
- BodyGroups
* BodyGroups
- QC export
* QC export
- VMT export
* VMT export
----
* VTF Export
- VTF Export
* MDL Compile
- MDL Compile
| style=" vertical-align:top; text-align:left;" |
|}
'''Install Guide :'''


|}
* [https://puppet-master.net/docs/mesa/installation-guide/ Installation Guide]
* [https://puppet-master.net/docs/mesa/installation-guide/mesa-setup/ MESA Setup]
* [https://puppet-master.net/docs/mesa/installation-guide/project-setup/ Project Setup]
* [https://puppet-master.net/docs/mesa/installation-guide/how-the-resource-must-to-be-structured/ How the resource must to be structured]


== Archive Content overview ==
* [https://puppet-master.net/docs/mesa/installation-guide/how-to-install-the-mesa-shelf-manually/ How to install the MESA shelf manually]
* [https://puppet-master.net/docs/mesa/installation-guide/verify-the-user-environment-variables/ Verify the user environment variables]
'''Export Guide :'''
* [https://puppet-master.net/docs/mesa/export-guide/ Export Guide]
* [https://puppet-master.net/docs/mesa/tutorials/installation-video/ Installation Video Tutorials]
* [https://puppet-master.net/docs/mesa/tutorials/export-video/ Export Video Tutorials]
* [https://puppet-master.net/docs/mesa/installation-guide/issues-and-common-errors/ Issues and Common Errors]
* [https://puppet-master.net/docs/mesa/source-engine/studiomdl-common-errors/ StudioMDL common errors]


Into the Mesa Archive file, you will find all the components to make the full installation
* [https://puppet-master.net/docs/mesa/dota-2-items-creation-guide-for-maya/ Dota 2 Assets Creation Guide]
* [https://puppet-master.net/docs/mesa/tutorials/maya-settings-for-source-engine/ Maya Setting for Source]
* [https://puppet-master.net/docs/mesa/source-engine/create-a-source-engine-mod/ Create Source Engine Mod]


<center>http://puppet-master.net/wp-content/uploads/2012/11/asset_content_root.png</center>
|}
 
;Maya Directory
 
<center>http://puppet-master.net/wp-content/uploads/2012/11/asset_content_maya-env.png</center>
 
: Maya/version/Maya.env ( a copy of the maya Environment variable definition). Very important.
: Maya/version/prefs/shelves/Mesa_Shelf.mel
 
;ModName_Source Directory
 
<center>http://puppet-master.net/wp-content/uploads/2012/11/asset_content_modsource.png</center>
 
'''ModName_Source/Workspace.mel''' ( it is the right path for the scripts, scenes, images etc..) so maya project will fit with your ”’ModName_Source”’ folder.
 
;ModName_Source/ :
: '''/Modelsrc/''' where the smd and ac will be exported
: '''/Materialsrc/''' where the TGA must be stored.
: '''/Scenes/''' where you must save your scenes. this is very important! The generation of the Smd and QC path will follow the structure of the scenes directory, for the '''modelsrc''' directory.
: '''/mesa/''' Where the script are stored with the project. if properly set into the '''Workspace.mel''', the Script path is not requires into the Maya.env data.
 
;Important:
'''/ModName_source/''' directory do not contains a '''gameinfo.txt''', this is also very important for the exporters to compiles and converts the assets. If a gameinfo.txt is into that folder, the compiler will output the mdl and VTF, VMT file into the models and materials folders of the ModName_Source and not into the '''Vproject''' ( the project will the asset for “ModName” sourcemod)
A Maya Scene, “'''/scenes/props/cube.mb'''“ is here to show you how the model is properly setted to be correctly exported
 
;ModName Directory
 
<center>http://puppet-master.net/wp-content/uploads/2012/11/asset_content_vproject.png</center>
 
 
The folder contains the mod with the compiled assets.
: '''/models/''' contains the mdl.
: '''/materials/''' contain the VTF and VMTs
 
;Important :
Before to compile an assets the destination folder must be created, in “'''/ModName/materials/'''” and “'''/ModName/models/'''“.
 
----
 
 
 
=== Standard Installation ===
 
{{note|This version works With and without Steam and the source sdk launcher.}}
 
1. Download MESA Importer/exporter
 
2. Extract '''maya\version\scripts\MESA\''' directory into ''' c:\User\Your-Profile\Documents\Maya\version\scripts\MESA\
 
3. Extract '''maya\version\prefs\shelves\SourceEngine_Shelf.mel''' into '''\maya\version\prefs\shelves\'''
 
4. Extract '''maya\version\prefs\icons\''' content, into '''\maya\version\prefs\icons\'''
 
5. Extract '''maya\version\maya.env''' and open it into a text editor ( notepad, notepad++, CONtext )
 
6. Go into your ''' c:\User\Your-Profile\Documents\Maya\version\ directory and open the maya.env file
 
7. Go to read the [[MESA#Maya.env_Sample_.28standard.29|Maya.env sample]] and especially all the comments included between the Env_variable paths declaration.
 
 
 
==== Maya.env Sample (standard)====
 
<source lang=cpp>
 
//--------------------------------------------------------------------------------//
// Here is the paths for your plugins, if you got some installed there,  you have to separate each path with a semi colon ''';''' .
 
MAYA_PLUG_IN_PATH=C:\Program Files (x86)\Autodesk\MayaBonusTools2012\plug-ins;
 
 
//--------------------------------------------------------------------------------//
//here is the paths for your scripts.
 
MAYA_SCRIPT_PATH=C:\Program Files (x86)\Autodesk\MayaBonusTools2012\scripts;G:\Steam\steamapps\SourceMods\ModName_Source\melscripts;
 
//--------------------------------------------------------------------------------//
// here is the path for the Icons
 
 
XBMLANGPATH = C:\Program Files (x86)\Autodesk\MayaBonusTools2012\icons;C:\Steam\steamapps\SourceMods\ModName_Source\melscripts\icons;
 
//--------------------------------------------------------------------------------//
//If your are using Source 2007 Engine branch set this path or change the path to .\source2009\bin directory.
 
SOURCE_BIN_PATH = C:\Steam\steamapps\You-steam-Account\sourcesdk\bin\source2007\bin\
 
//--------------------------------------------------------------------------------//
// here is the path of the mod directory that contain all your source files.
// require with Standard and Absolute installation.
 
SOURCE_MOD_PATH = C:\Steam\steamapps\SourceMods\ModName_Source\
 
//--------------------------------------------------------------------------------//
// here is the name of your working directory ( the source )
// require with Standard and Absolute installation.
 
SOURCE_MOD_NAME = MOD NAME Source
 
//--------------------------------------------------------------------------------//
// Unfortunately it's important to  set this path  of the souce sdk tool a second time.
// require with Standard and Absolute installation.
// update to Source2009 if you source 2009 engine branch.
 
SOURCESDK = C:\Steam\steamapps\You-steam-Account\sourcesdk\bin\source2007\bin\;
 
//--------------------------------------------------------------------------------//
// if you want to compile the final model into the different Sourcemods directory.
// ex: when you using a directory with all the source file of your assets, and another
//    mod directory to put all the released assets. good management with SVN usage.
// require with Standard and Absolute installation.
 
 
VPROJECT = C:\Steam\steamapps\SourceMods\ModName\;
 
</source>
 
 
----
 
=== Absolute Installation (full featured )===
 
{{note| To take advantage of the automatic compiling, you must have Steam and the sourceSDK opened.
This version works With and without Steam and the source sdk launcher. }}
 
'''Stage 1'''
 
1. Download MESA Importer/exporter
 
2. Extract '''maya\version\scripts\MESA\''' directory into ''' c:\steam\steamapps\Sourcemods\ModName_Source\MESA
 
3. Extract '''maya\version\prefs\shelves\SourceEngine_Shelf.mel''' into '''\maya\version\prefs\shelves\'''
 
4. Extract '''maya\version\prefs\icons\''' content, into '''c:\steam\steamapps\Sourcemods\ModName_Source\MESA\icons'''
 
5. Extract '''maya\version\maya.env''' and open it into a text editor ( notepad, notepad++, CONtext )
 
6. Go into your ''' c:\User\Your-Profile\Documents\Maya\version\''' directory and open the maya.env file
 
7. Go to read the [[MESA#Maya.env_Sample_.28Absolute.29|Maya.env Sample (Absolute)]] and especially all the comments included between the Environment_Variables and their paths declaration.
 
'''Stage 2'''
 
1. Extract The modName_source\ directory from the MESA Archive file to '''Steam\steamapps\Sourcemods\ModName_Source\'''.
 
2. Extract the ModName\ directory into '''Steam\steamapps\Sourcemods\"ModName"'''.
 
 
==== Maya.env Sample (Absolute) ====
 
{{note|If you already got some personal plugins installed you must separate all path with a semi colon ''';''' .
Here i got the BonusTools 2012 installed.}}
 
<source lang=cpp>
 
//--------------------------------------------------------------------------------//
//here is the paths for your plugins if you got some installed.
MAYA_PLUG_IN_PATH=C:\Program Files (x86)\Autodesk\MayaBonusTools2012\plug-ins;
 
//--------------------------------------------------------------------------------//
//here is the paths for your scripts.
// not require, for the Standard Version
MAYA_SCRIPT_PATH=C:\Program Files (x86)\Autodesk\MayaBonusTools2012\scripts;G:\Steam\steamapps\SourceMods\ModName_Source\mesa;
 
//--------------------------------------------------------------------------------//
// here is the path for the Icons
 
XBMLANGPATH = C:\Program Files (x86)\Autodesk\MayaBonusTools2012\icons;C:\Steam\steamapps\SourceMods\ModName_Source\MESA\icons;
 
//--------------------------------------------------------------------------------//
//If your are using Source 2007 Engine branch set this path or change the path to .\source2009\bin directory.
 
SOURCE_BIN_PATH = C:\Steam\steamapps\You-steam-Account\sourcesdk\bin\source2007\bin\
 
//--------------------------------------------------------------------------------//
// here is the path of the mod directory that contain all your source files.
// require with Standard and Absolute installation.
 
SOURCE_MOD_PATH = C:\Steam\steamapps\SourceMods\ModName_Source\
 
//--------------------------------------------------------------------------------//
// here is the name of your working directory ( the source )
// require with Standard and Absolute installation.
 
SOURCE_MOD_NAME = MOD NAME Source
 
//--------------------------------------------------------------------------------//
// Unfortunally it's important to  set this path  of the souce sdk tool a second time.
// require with Standard and Absolute installation.
 
SOURCESDK = C:\Steam\steamapps\You-steam-Account\sourcesdk\bin\source2007\bin\;
 
//--------------------------------------------------------------------------------//
// if you want to compile the final model into the different Sourcemods directory.
// ex: when you using a directory with all the source file of your assets, and
//    another mod directory to put all the released assets. good management with SVN usage.
// require with Standard and Absolute installation.
 
VPROJECT = C:\Steam\steamapps\SourceMods\ModName\;
 
</source>
 
= Ready to export and compile ? =
 
'''Compatibility ''':
This process works for absolute installation and  with the standard installation to but steam and the SourceSdk must runs.
 
1. Run Steam + Source SDK launcher
 
2. Run Maya and set the project to Sourcemods\ModName_source\
 
3. Open the Maya Scene Sample from the '''\Scene\''' directory in Maya.
 
4. select the model on the perspective view
 
5. display the Source Engine Shelf and click on SMD Option Icon
 
6. Save the maya Scene
 
7. go into '''Path Settings''' tab, and click on the '''Default''' button, the paht will b updated.
 
if your models ar not directly into the modelsrc folder, you have to update the path for the desired location, ( do not forget the .smd )
Note Enter your custum path and do not  click again on the Default Button, or the '''SMD /QC Path''' will be update again.
 
<center>http://puppet-master.net/mesa/Mesa_v1.0_Path_tab.png</center>
 
8. For '''Materials / QC Path''' enter the desired path for the final vtf/vmt files that will be exported.
 
;Example :
G:/Steam/steamapps/SourceMods/JL_Source/materialsrc/models/props/
 
9. Go on to the '''Export Tab''' now, and check all the attributes as on the next image.
 
<center>http://puppet-master.net/mesa/Mesa_v1.0_Export_tab.png</center>


{{note| The Feed back of the script process is located into the window process of maya, and into the Script Editor.
== Links ==
So don't forget to check out this two output log to see the potential errors you could get.}}


* [http://puppet-master.net/plugins/mesa-2.0/ MESA - Maya Exporter for Source Assets]


{{sdktools|0}}
[[Category:Maya]] [[Category:Third_Party_Tools]]
[[Category:Maya]] [[Category:Third_Party_Tools]]

Latest revision as of 10:27, 15 November 2023

Not to be confused with Black Mesa (Third-party remake of Half-Life).
https://puppet-master.net/wp-content/uploads/2015/09/mesa21-logo.png

Description

MESA MESA 2.0 is a suite of MEL Scripts to export and import 3d models for the Valve Source Engine with Autodesk Maya. This is the short name for Maya Exporter for Source Absolute.

The objective of MESA, is about to make the full asset creation process within Maya interface. It includes static, physics, breakable, dynamic and ragdoll models, and supported bodygroups , It become easy to use maya to export to the source engine the NPCs (Monsters and Humanoid), Vehicles, Weapons and Items for your game.

MESA is Mel scripts bases exporter and importer Tools. This scripts are the rewritten / edited Scripts from Valve, and originally designed for maya 4.5, that was also deeply rewritten by Prall .

MESA is compatible with all recent version of Maya ( 2011/2012/2013/2014 with x86 and x64 bits )


Download MESA

MESA - Maya Exporter for Source Absolute
Release Date MESA Version Download Link Compatibility
04 Nov 2015 MESA v2.1 MESA v 2.1 Tested on x86 and x64 version of :
  • Maya 2016
  • Maya 2015
  • Maya 2014
  • Maya 2013
  • Maya 2012
  • Maya 2011
06 Oct 2013 MESA v2.0 MESA v 2.0 (396ko)
23 Apr 2013 MESA v1.1 MESA v 1.1 (127ko)

Documentation

Features list

The main interest of MESA exporter, is the easy way to compile and convert the assets in few clicks within Maya Interface.

Support / Usage Documentation
  • Maya Workspace
  • SMD Import
  • SMD Export
  • SMD Animations
  • LODS ( level of detail )
  • Physic / Ragdoll Model
  • VTA export
  • Ref break
  • Phys_break
  • BodyGroups
  • QC export
  • VMT export
  • VTF Export
  • MDL Compile

Install Guide :

Export Guide :

Links

Mod tools
Map editors
Map compilers
Map compiler frontends
Map converters
005 Decompiler • BSPSource • MapFool • VMEX
Map tools
AutoBSPpackingTool • BSPEntSpy • Crafty • Convexer • EntEd • Entspy • JERC • Map Analyst • Map Obfuscator • Material Enumerator • Pakrat • Source Compile Analyzer • TAR • TeamSpen's Hammer Addons • Vgroup • VMF Optimizer • VMF Updater • WinBSPZip • LumpStich • VPKEdit
Model compilers
Model compiler frontends
Model converters
Model tools
3Dcoat • 3DS Max • Blender • Cinema 4D • Fragmotion • GMax • HLMV++ • kHED • Lightwave • Maya • MilkShape 3D • Modo • SourceOps • VSIF2VCD • Softimage Mod Tool • Zbrush
Displacement tools
Particle converters
Texture converters
Texture tools
Sound tools
VPK tools
Libraries
AVIKit • HLLib • VectorLib • VTFLib
Plugins
Other
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=MESA&oldid=355925"