Packages are a convenient means of bundling objects, media, patchers, and resources for distribution.
A package is simply a folder adhering to a prescribed structure and placed in the 'packages' folder. Folders adhering to this structure can be accessed by Max to integrate seamlessly at launch time.
To install a package, simply copy it to your 'packages' folder. To uninstall a package, simply remove it from your 'packages' folder.
There are two packages folders you may use. One is called 'packages' in your Max folder. The other is the 'Max/Packages' in your Documents (Mac) or My Documents (Windows) folder.
Additional folders containing packages may be added by creating a text file in your Max application folder, named "packages.txt". This file may then contain the path to a folder (that contains package folders) of your choosing on each line, terminated with a semi-colon. For example:
You may create your own packages, either for your own use or for distribution to others. The folders comprising a package may optionally include the following:
|clippings*||Patchers to list in the "Paste From..." contextual menu when patching|
|default-definitions||Definition info for Object Defaults support in UI externals|
|default-settings||Saved color schemes for Object Defaults|
|docs*||Reference pages and Vignettes to be accessible from the Documentation Window|
|examples*||Example patchers and supporting material|
|extensions||Special external objects loaded on Max launch|
|extras||Patchers to be listed in the "Extras" menu|
|help*||Help patchers and supporting material|
|init||Text files interpreted by Max at launch|
|interfaces||Supporting files for objects to display in the Object Exporer and other Max integration.|
|java-classes*||Compiled Java classes for use in mxj~|
|java-doc||Documentation for Java classes|
|jsextensions*||Extensions to JS implemented as special externals or js files|
|media*||Media files to be included in the searchpath|
|patchers*||Patchers or abstractions to be included in the searchpath|
|object-prototypes||Object Prototypes will be listed in the context menu for a selected ui object|
|queries||Saved searches for the File Browser|
|readme.txt||Information about your package|
|source||Source code for external objects, ignored by Max|
|templates||Patchers to be listed in the "File > New From Template" menu|
Items in folders marked with a star will automatically be included in the searchpath.
The "source" folder is ignored entirely by Max, it simply provides a standard location to include source code in a distribution if desired.