Core Commands
Create Collection
The mplx core collection create
command allows you to create MPL Core Collections using three different methods: simple creation, file-based creation, or an interactive wizard. This command provides flexibility in how you want to create your collections while maintaining a consistent output format.
Methods
1. Simple Creation
Create a single Collection by providing the name and URI of the metadata directly through command line arguments.
mplx core collection create --name "My Collection" --uri "https://example.com/metadata.json"
2. File-based Creation
Create a single Collection by providing an image file and a JSON metadata file. The command will handle uploading both files and creating the collection.
mplx core collection create --files --image "./my-collection.png" --json "./metadata.json"
3. Interactive Wizard
Create a Collection using the interactive wizard which guides you through the entire process, including file uploads and metadata creation.
mplx core collection create --wizard
Options
Basic Options
--name <string>
: Collection name (required for simple creation)--uri <string>
: URI of the Collection metadata (required for simple creation)
File-based Options
--files
: Flag to indicate file-based creation--image <path>
: Path to image file to upload and assign to Collection--json <path>
: Path to JSON metadata file
Plugin Options
--plugins
: Use interactive plugin selection--pluginsFile <path>
: Path to a JSON file with plugin data
Examples
- Create a collection using the interactive wizard:
mplx core collection create --wizard
- Create a collection with name and URI:
mplx core collection create --name "My Collection" --uri "https://example.com/metadata.json"
- Create a collection from files:
mplx core collection create --files --image "./my-collection.png" --json "./metadata.json"
Output
The command will output the following information upon successful creation:
--------------------------------
Collection: <collection_address>
Signature: <transaction_signature>
Explorer: <explorer_url>
Core Explorer: https://core.metaplex.com/explorer/<collection_address>
--------------------------------
Notes
- When using the file-based creation method, both
--image
and--json
flags are required - The wizard method provides a guided experience for creating collections, including file uploads and metadata creation
- Plugin configuration can be done either interactively or through a JSON file
- The JSON metadata file must include a
name
field for the collection - The command will automatically handle file uploads and metadata creation when using the file-based or wizard methods
- Collection metadata follows the standard NFT metadata format with additional collection-specific fields