Difference between revisions of "How to package a Mini Micro game"

From MiniScript Wiki
Jump to navigation Jump to search
(added note about bootOpts.grfon)
(4 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
The basic idea is simple: Mini Micro will automatically look for a zip file (or folder) next to the executable called '''user.minidisk''', and if it finds this, it would automatically mount that as '''/usr''' and run any program it finds there as '''/usr/startup.ms'''.  So packaging amounts to taking a standard Mini Micro distribution, adding the desired '''user.minidisk''' file, and tweaking things like the app name and icon.  Exact details, though, vary with the platform you're targeting.
 
The basic idea is simple: Mini Micro will automatically look for a zip file (or folder) next to the executable called '''user.minidisk''', and if it finds this, it would automatically mount that as '''/usr''' and run any program it finds there as '''/usr/startup.ms'''.  So packaging amounts to taking a standard Mini Micro distribution, adding the desired '''user.minidisk''' file, and tweaking things like the app name and icon.  Exact details, though, vary with the platform you're targeting.
 +
 +
Note that while the directions below include links to zip instructions/tools on the corresponding platform, it is ''not'' necessary to be on the platform you are packaging for.  In other words, it should work perfectly well to package for all platforms, from whatever platform you happen to use.  Also note that the first three steps in each section below are the same, and only need to be done once no matter how many platforms you package for.
  
 
== Packaging for Windows Download ==
 
== Packaging for Windows Download ==
Line 10: Line 12:
 
# Download the Windows distribution of Mini Micro from the [https://miniscript.org/MiniMicro/ official web page].
 
# Download the Windows distribution of Mini Micro from the [https://miniscript.org/MiniMicro/ official web page].
 
# Put your '''user.minidisk''' file next to the '''Mini Micro.exe''' file.
 
# Put your '''user.minidisk''' file next to the '''Mini Micro.exe''' file.
 +
# If desired, make a '''[[bootOpts.grfon]]''' file and place that next to '''user.minidisk'''.
 
# If you like, rename '''Mini Micro.exe''' to the name of your game.
 
# If you like, rename '''Mini Micro.exe''' to the name of your game.
 
# Zip up (or otherwise archive, as you prefer) the whole folder containing the .exe, your '''user.minidisk''' file, and everything else that came with the original Windows distribution.
 
# Zip up (or otherwise archive, as you prefer) the whole folder containing the .exe, your '''user.minidisk''' file, and everything else that came with the original Windows distribution.
  
The resulting archive file can then be uploaded to DropBox or itch.io or otherwise distributed to your players.
+
The resulting archive file can then be uploaded to DropBox or itch.io, or otherwise distributed to your players.
  
 
== Packaging for MacOS Download ==
 
== Packaging for MacOS Download ==
 +
 +
# Make a virtual disk containing just the files needed for your game or app.
 +
# Add a [[startup.ms]] script that loads and runs your program.
 +
# If your virtual disk is (in the real file system) a folder, [https://www.lifewire.com/how-to-zip-and-unzip-files-and-folders-on-a-mac-2260188 zip it].  Rename the zip file exactly '''user.minidisk'''.
 +
# Download the MacOS distribution of Mini Micro from the [https://miniscript.org/MiniMicro/ official web page].
 +
# Put your '''user.minidisk''' file next to the '''MiniMicro.app''' file.  (If you are doing this in Windows or Linux, '''MiniMicro.app''' will appear as a folder; on a Mac, the same folder appears as an app, and the .app extension may be hidden.)
 +
# If desired, make a '''[[bootOpts.grfon]]''' file and place that next to '''user.minidisk'''.# If you like, rename '''MiniMicro.app''' to the name of your game.
 +
# Zip up (or place on a [https://support.apple.com/guide/disk-utility/create-a-disk-image-dskutl11888/mac disk image]) the whole folder containing the app and your '''user.minidisk''' file.
 +
 +
The resulting zip or DMG can then be uploaded to DropBox or itch.io, or otherwise distributed to your players.
  
 
== Packaging for Linux Download ==
 
== Packaging for Linux Download ==
 +
 +
# Make a virtual disk containing just the files needed for your game or app.
 +
# Add a [[startup.ms]] script that loads and runs your program.
 +
# If your virtual disk is (in the real file system) a folder, [https://www.cyberciti.biz/tips/how-can-i-zipping-and-unzipping-files-under-linux.html zip it].  Rename the zip file exactly '''user.minidisk'''.
 +
# Download the Linux distribution of Mini Micro from the [https://miniscript.org/MiniMicro/ official web page].
 +
# Put your '''user.minidisk''' file next to the '''MiniMicro.x86_64''' file.
 +
# If desired, make a '''[[bootOpts.grfon]]''' file and place that next to '''user.minidisk'''.
 +
# If you like, rename '''MiniMicro.x86_64''' to the name of your game.
 +
# Zip up (or otherwise archive, as you prefer) the whole folder containing the executable, your '''user.minidisk''' file, and everything else that came with the original Linux distribution.
 +
 +
The resulting archive file can then be uploaded to DropBox or itch.io, or otherwise distributed to your players.
  
 
== Packaging for the Web ==
 
== Packaging for the Web ==
 +
 +
# Make a virtual disk containing just the files needed for your game or app.
 +
# Add a [[startup.ms]] script that loads and runs your program.
 +
# If your virtual disk is (in the real file system) a folder, zip it.  Rename the zip file exactly '''user.minidisk'''.
 +
# Download the WebGL Template from the [https://miniscript.org/MiniMicro/ official web page].
 +
# Put your '''user.minidisk''' file into the  '''StreamingAssets''' folder, replacing the (empty) user.minidisk there in the template.
 +
# If desired, make a '''[[bootOpts.grfon]]''' file and place that next to '''user.minidisk'''.
 +
# If uploading to itch.io, zip up the whole folder containing '''Build''', '''index.html''', and '''StreamingAssets'''.
 +
# Upload that archive to itch.io, or upload the folder to your web site.  If asked for viewport dimensions, use 1024 by 768 pixels.
  
 
[[Category:Mini Micro]]
 
[[Category:Mini Micro]]
 
[[Category:How To]]
 
[[Category:How To]]

Revision as of 23:11, 6 April 2020

To "package" a Mini Micro game means to bundle up all the files into a format that end-users can download (or access on the web) and play without needing anything else.

The basic idea is simple: Mini Micro will automatically look for a zip file (or folder) next to the executable called user.minidisk, and if it finds this, it would automatically mount that as /usr and run any program it finds there as /usr/startup.ms. So packaging amounts to taking a standard Mini Micro distribution, adding the desired user.minidisk file, and tweaking things like the app name and icon. Exact details, though, vary with the platform you're targeting.

Note that while the directions below include links to zip instructions/tools on the corresponding platform, it is not necessary to be on the platform you are packaging for. In other words, it should work perfectly well to package for all platforms, from whatever platform you happen to use. Also note that the first three steps in each section below are the same, and only need to be done once no matter how many platforms you package for.

Packaging for Windows Download

  1. Make a virtual disk containing just the files needed for your game or app.
  2. Add a startup.ms script that loads and runs your program.
  3. If your virtual disk is (in the real file system) a folder, zip it. Rename the zip file exactly user.minidisk.
  4. Download the Windows distribution of Mini Micro from the official web page.
  5. Put your user.minidisk file next to the Mini Micro.exe file.
  6. If desired, make a bootOpts.grfon file and place that next to user.minidisk.
  7. If you like, rename Mini Micro.exe to the name of your game.
  8. Zip up (or otherwise archive, as you prefer) the whole folder containing the .exe, your user.minidisk file, and everything else that came with the original Windows distribution.

The resulting archive file can then be uploaded to DropBox or itch.io, or otherwise distributed to your players.

Packaging for MacOS Download

  1. Make a virtual disk containing just the files needed for your game or app.
  2. Add a startup.ms script that loads and runs your program.
  3. If your virtual disk is (in the real file system) a folder, zip it. Rename the zip file exactly user.minidisk.
  4. Download the MacOS distribution of Mini Micro from the official web page.
  5. Put your user.minidisk file next to the MiniMicro.app file. (If you are doing this in Windows or Linux, MiniMicro.app will appear as a folder; on a Mac, the same folder appears as an app, and the .app extension may be hidden.)
  6. If desired, make a bootOpts.grfon file and place that next to user.minidisk.# If you like, rename MiniMicro.app to the name of your game.
  7. Zip up (or place on a disk image) the whole folder containing the app and your user.minidisk file.

The resulting zip or DMG can then be uploaded to DropBox or itch.io, or otherwise distributed to your players.

Packaging for Linux Download

  1. Make a virtual disk containing just the files needed for your game or app.
  2. Add a startup.ms script that loads and runs your program.
  3. If your virtual disk is (in the real file system) a folder, zip it. Rename the zip file exactly user.minidisk.
  4. Download the Linux distribution of Mini Micro from the official web page.
  5. Put your user.minidisk file next to the MiniMicro.x86_64 file.
  6. If desired, make a bootOpts.grfon file and place that next to user.minidisk.
  7. If you like, rename MiniMicro.x86_64 to the name of your game.
  8. Zip up (or otherwise archive, as you prefer) the whole folder containing the executable, your user.minidisk file, and everything else that came with the original Linux distribution.

The resulting archive file can then be uploaded to DropBox or itch.io, or otherwise distributed to your players.

Packaging for the Web

  1. Make a virtual disk containing just the files needed for your game or app.
  2. Add a startup.ms script that loads and runs your program.
  3. If your virtual disk is (in the real file system) a folder, zip it. Rename the zip file exactly user.minidisk.
  4. Download the WebGL Template from the official web page.
  5. Put your user.minidisk file into the StreamingAssets folder, replacing the (empty) user.minidisk there in the template.
  6. If desired, make a bootOpts.grfon file and place that next to user.minidisk.
  7. If uploading to itch.io, zip up the whole folder containing Build, index.html, and StreamingAssets.
  8. Upload that archive to itch.io, or upload the folder to your web site. If asked for viewport dimensions, use 1024 by 768 pixels.