MiniScript Wiki - User contributions [en]

File.makedir

2022-12-25T00:45:13Z

Khorne: Changed .delete to .makedir

The <c>[[file]].makedir</c> method creates a new directory on disk.

=== Arguments ===

{| class="wikitable"
|-
! Parameter Name !! Default Value !! Meaning
|-
| path || "" || file name, partial path, or absolute path to directory to be created
|}

If given a file name or partial path, it will be interpreted relative to the current working directory (see <c>[[file.curdir]]</c>).

=== Result ===

If the directory was successfully deleted, this method returns [[true]] (1).
Otherwise, it returns [[false]] (0). This can happen if the given path is invalid, a file or directory already exists at that location, or any other file-level error occurs.

== Example ==

The following attempts to create a directory called "data" in the [[file.curdir|current directory]].

<ms>file.makedir "data"</ms>

[[Category:Mini Micro]]
[[Category:Command-Line MiniScript]]

File.name

2022-03-20T14:09:34Z

Khorne: typo

As it says in the name [[File|file]].'''name''' it is used to retrieve the exact name of the file you designate in the file path that was provided as a string.

Example: [[File|file]].'''name''' "/usr/startup.ms"

File.name

2022-03-20T14:08:56Z

Khorne: created file.name page

As it says in the name [[File|file]].'''name''' it is used to retrieve the exact name of the file you designate in the file path your provided as a string.

Example: [[File|file]].'''name''' "/usr/startup.ms"

File.export

2022-03-20T13:53:45Z

Khorne: Created page for file.export

Similar to file.import a dialog box will appear after you type example: [[File|file]].'''export''' "/usr/startup.ms". Note that the export path is an internal path within the Mini Micro environment. This will save to the host system the desired item to export.

File.import

2022-03-20T13:49:13Z

Khorne: typo

[[File]].'''import''' opens a dialog box from which you can navigate the host system and select files to import into the Mini Micro environment. This is useful if you are working in a '''minidisk''' file.

File.import

2022-03-20T13:48:51Z

Khorne: Created page for file.import

[[File]].'''import''' opens a dialog box from which you can navigate the host system and select files to import into the Mini Micro enviroment. This is useful if you are working in a '''minidisk''' file.

How to package a Mini Micro game

2022-03-13T19:34:10Z

Khorne: Minor explanation over changing exe name

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 ==

# 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.laptopmag.com/articles/how-to-zip-files-windows-10 zip it]. Rename the zip file exactly '''user.minidisk'''.
# 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.
# If desired, make a '''[[bootOpts.grfon]]''' file and place that in the '''Mini Micro_Data/StreamingAssets''' subfolder.
# If you like, rename '''Mini Micro.exe''' to the name of your game. Note: Do not forget to change the folder '''Mini Micro_data''' to the name change with the exe with '''_data'''. example: '''strat.exe''', data folder would be '''strat_data'''.
# 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 ==

# 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 inside the application bundle under '''Contents/Resources/Data/StreamingAssets'''.
# 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 ==

# 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 in the '''MiniMicro_Data/StreamingAssets''' folder.
# 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 ==

# 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:How To]]

Super

2022-03-12T22:11:26Z

Khorne: Fix yet another typo

<c>super</c> is a [[:Category:Keywords|keyword]] used to access base class methods from within a subclass method. It is part of MiniScript's support for [[object-oriented programming]].

Example code:

<ms>
//PLANT base class
PLANT = new Sprite
PLANT.image = Image.create(25, 25, color.lime)
PLANT.maxGrowth = 20
PLANT.scale = 0
PLANT.grow = function
self.scale = self.scale + .1
if self.scale > self.maxGrowth then
self.scale = self.maxGrowth
return
end if
end function

//tree subclass
tree = new PLANT
tree.x = 480
tree.y = 320

tree.grow = function //trees function that would override grow within the PLANT base class
super.grow //reaches out to the PLANT base class and calls it
print "I grew!" //end of the function prints after super.grow is called.
end function

//pushes tree to default sprite display
display(4).sprites.push tree

//loop for tree.grow
while not tree.scale == tree.maxGrowth
tree.grow
wait .5
end while
</ms>

[[Category:Language]]
[[Category:Keywords]]

{{stub}}

Super

2022-03-12T22:08:14Z

Khorne: fixed typo

<c>super</c> is a [[:Category:Keywords|keyword]] used to access base class methods from within a subclass method. It is part of MiniScript's support for [[object-oriented programming]].

Example code:

<ms>
//PLANT base clasee
PLANT = new Sprite
PLANT.image = Image.create(25, 25, color.lime)
PLANT.maxGrowth = 20
PLANT.scale = 0
PLANT.grow = function
self.scale = self.scale + .1
if self.scale > self.maxGrowth then
self.scale = self.maxGrowth
return
end if
end function

//tree subclass
tree = new PLANT
tree.x = 480
tree.y = 320

tree.grow = function //trees function that would override grow within the PLANT base class
super.grow //reaches out to the PLANT base class and calls it
print "I grew!" //end of the function prints after super.grow is called.
end function

//pushes tree to default sprite display
display(4).sprites.push tree

//loop for tree.grow
while not tree.scale == tree.maxGrowth
tree.grow
wait .5
end while
</ms>

[[Category:Language]]
[[Category:Keywords]]

{{stub}}

Super

2022-03-12T22:04:34Z

Khorne: Added example code

<c>super</c> is a [[:Category:Keywords|keyword]] used to access base class methods from within a subclass method. It is part of MiniScript's support for [[object-oriented programming]].

Example code:

<ms>
//PLANT base clasee
PLANT = new Sprite
PLANT.image = Image.create(25, 25, color.lime)
PLANT.maxGrowth = 20
PLANT.scale = 0
PLANT.grow = function
self.scale = self.scale + .1
if self.scale > self.maxGrowth then
self.scale = self.maxGrowth
return
end if
end function

//tree subclass
tree = new PLANT
tree.x = 480
tree.y = 320

tree.grow = function //trees function that would override grow within the PLANT base class
super.grow //reaches out to the PLANT base class and calls it
print "I grew!" //end of the function prints after super.grow is called.
end function

//pushes tree to default sprite display
display(4).sprites.push tree

//loop for tree.grow
while not tree.scale
tree.grow
wait .5
end while
</ms>

[[Category:Language]]
[[Category:Keywords]]

{{stub}}