How to get started with Mini Micro - Revision history

JoeStrout: /* 3. About synthesized sounds */

2025-03-05T16:39:26Z

3. About synthesized sounds

JoeStrout: /* Play a sound */ (fixed typo)

2025-03-05T16:36:09Z

Play a sound: (fixed typo)

Redspark at 03:10, 30 January 2025

2025-01-30T03:10:46Z

JoeStrout: /* Create a sprite */

2024-12-19T14:06:38Z

Create a sprite

JoeStrout: /* Where to learn more */

2024-10-10T14:05:22Z

Where to learn more

JoeStrout: /* Play a sound */

2024-10-10T14:03:26Z

Play a sound

JoeStrout: /* Where to learn more */

2024-09-19T16:49:44Z

Where to learn more

JoeStrout: /* Where to learn more */

2024-08-26T03:02:56Z

Where to learn more

JoeStrout at 14:14, 25 August 2024

2024-08-25T14:14:47Z

JoeStrout: /* Package your game for the web */

2024-08-25T14:07:11Z

Package your game for the web

@@ Line 176: / Line 176: @@
 === 3. About synthesized sounds ===
-Mini Micro has a sophisticated API for creating sounds out of nothing but code.  You can specify a base waveform, frequency, envelope, fade-in/fade-out, and even mix basic sounds together to create more sophisticated sounds.  You can find a couple of simple examples on the [[Sound.init]] page, and some more complex ones by doing <c>run "/sys/lib/sounds"</c> (followed by <c>edit</c> to see how those examples were made).
+Mini Micro has a sophisticated API for creating sounds out of nothing but code.  You can specify a base waveform, frequency, envelope, fade-in/fade-out, and even mix basic sounds together to create more sophisticated sounds.  You can find a couple of simple examples on the [[Sound.init]] page, and some more complex ones by doing <c>run "/sys/lib/sounds"</c> (followed by <c>edit</c> to see how those examples were made).  You can also <c>run "/sys/demo/soundLab"</c> for a graphical synthesizer, which can then output code you to recreate the sound.
 == Write a program ==

@@ Line 136: / Line 136: @@
 == Play a sound ==
-Almost any game needs [[sound]] effects!  Mini Micro supports both playing both digitized sounds loaded from a file, and sounds synthesized at runtime.  We'll focus here on playing sounds from a file, which can be in either WAV or OGG format.
+Almost any game needs [[sound]] effects!  Mini Micro supports playing both digitized sounds loaded from a file, and sounds synthesized at runtime.  We'll focus here on playing sounds from a file, which can be in either WAV or OGG format.
 === 1. Play one of the built-in sounds ===

@@ Line 145: / Line 145: @@
 snd.play</ms>
-You should hear a twinkle sound.  The [[Sound.play]] method supports several optional parameters.  A handy trick when you need a quick reminder of function parameters is to use [[@]] (the at-sign) before a function reference, to return the function without invoking it.  On the command line, that will print the function parameter names and default values.  Try it:
+You should hear a twinkle sound.  The [[Sound.play]] method supports several optional parameters.  A handy trick when you need a quick reminder of function parameters is to use [[@ operator|@]] (the at-sign) before a function reference, to return the function without invoking it.  On the command line, that will print the function parameter names and default values.  Try it:
 <ms>@snd.play</ms>

@@ Line 90: / Line 90: @@
 [[File:ManualSprite.png|thumb]]
-If you don't see this, go back and double-check your typing.  Note that you can recall a previous command on the command line by pressing the '''up-arrow'' key, then just edit it and press Return to run the edited command.
+If you don't see this, go back and double-check your typing.  Note that you can recall a previous command on the command line by pressing the '''up-arrow''' key, then just edit it and press Return to run the edited command.
 How does this work?  Let's break it down:

@@ Line 273: / Line 273: @@
 * Various blog posts, perhaps found through the [[Bibliography]] page
-Most important of all, rely on the '''community Discord server''', a link to which can be found at the bottom of the [https://miniscript.org/ MiniScript home page].  An active and friendly community hangs out here, and you are encouraged to share screenshots, code snippets, and questions there.
+Most important of all, rely on the '''community Discord server''', a link to which can be found at the bottom of the [https://miniscript.org/ MiniScript home page].  An active and friendly community hangs out on Discord, and you are encouraged to share screenshots, code snippets, and questions there.
 [[Category:Mini Micro]]
 [[Category:How To]]

@@ Line 172: / Line 172: @@
 snd2.play</ms>
-Again, use <c>snd2.stop</c>.  Or you can use <c>Sound.stopAll</c> to make it stop.
+Again, use <c>snd2.stop</c> to make it stop, or <c>Sound.stopAll</c> to stop all sounds.  (The <c>reset</c> command will also do that, in addition to clearing the current program and variables.)
 === 3. About synthesized sounds ===

← Older revision		Revision as of 16:49, 19 September 2024
Line 263:		Line 263:

	Congratulations! You have learned how to set up a local Mini Micro environment for development, using your own game assets, and learned to use both the built-in and external code editors. You've made a very simple game demo, and know how to upload it to the web. All toolchain hurdles are behind you; now it's just a matter of designing a game, and writing the code!		Congratulations! You have learned how to set up a local Mini Micro environment for development, using your own game assets, and learned to use both the built-in and external code editors. You've made a very simple game demo, and know how to upload it to the web. All toolchain hurdles are behind you; now it's just a matter of designing a game, and writing the code!
		+
		+	If you are a Python or Lua programmer, see the [[Python]] or [[Lua]] page of this wiki to see how MiniScript compares to those.

	When writing the code, you will probably lean most heavily on these resources:		When writing the code, you will probably lean most heavily on these resources:

← Older revision		Revision as of 03:02, 26 August 2024
Line 272:		Line 272:

	Most important of all, rely on the '''community Discord server''', a link to which can be found at the bottom of the [https://miniscript.org/ MiniScript home page]. An active and friendly community hangs out here, and you are encouraged to share screenshots, code snippets, and questions there.		Most important of all, rely on the '''community Discord server''', a link to which can be found at the bottom of the [https://miniscript.org/ MiniScript home page]. An active and friendly community hangs out here, and you are encouraged to share screenshots, code snippets, and questions there.
		+
		+	[[Category:Mini Micro]]
		+	[[Category:How To]]

← Older revision		Revision as of 14:14, 25 August 2024
Line 259:		Line 259:

	This process is described in detail on [[How to package a Mini Micro game]]. Focus on the general instructions at the top, and the "packaging for the web" instructions at the bottom.		This process is described in detail on [[How to package a Mini Micro game]]. Focus on the general instructions at the top, and the "packaging for the web" instructions at the bottom.
		+
		+	== Where to learn more ==
		+
		+	Congratulations! You have learned how to set up a local Mini Micro environment for development, using your own game assets, and learned to use both the built-in and external code editors. You've made a very simple game demo, and know how to upload it to the web. All toolchain hurdles are behind you; now it's just a matter of designing a game, and writing the code!
		+
		+	When writing the code, you will probably lean most heavily on these resources:
		+
		+	* The [https://miniscript.org/files/MiniMicro-CheatSheet.pdf Mini Micro Cheat Sheet], a 4-page summary of the Mini Micro API and MiniScript language
		+	* This wiki, especially the [[How To]] articles
		+	* Sample code found in <c>/sys/demo</c>
		+	* Various blog posts, perhaps found through the [[Bibliography]] page
		+
		+	Most important of all, rely on the '''community Discord server''', a link to which can be found at the bottom of the [https://miniscript.org/ MiniScript home page]. An active and friendly community hangs out here, and you are encouraged to share screenshots, code snippets, and questions there.

← Older revision		Revision as of 14:07, 25 August 2024
Line 255:		Line 255:

	== Package your game for the web ==		== Package your game for the web ==
		+
		+	If you've come here because you want to make a Mini Micro game for a game jam, then you should almost certainly learn how to package your game for playing on the web, and upload it to a site like itch.io.
		+
		+	This process is described in detail on [[How to package a Mini Micro game]]. Focus on the general instructions at the top, and the "packaging for the web" instructions at the bottom.