A Guide To Working With Mari0

Qcode
User avatar
Posts: 1463
Joined: 05 Feb 2012, 18:00
Reputation: 71
Contact:

Post » 11 Mar 2013, 03:06

I've been seeing a lot of good guides on how to create with Mari0. I thought I'd make a compilation of these posts so people can easily find them here.
Mapping
1.Finding your mappack's folder
2.Loading a tileset into Mari0
3.Loading custom music
4.Loading custom backgrounds
5.Releasing your mappack

Modding
1.What is a mod?
2.How to create your own mods

Mapping

Loading a tileset into Mari0
In all your mappacks, you can add a custom tileset. This can add to your mappacks appeal, especially if you are talented at pixel art. Mari0Maker has released a tutorial on installing tilesets here: viewtopic.php?f=12&t=2955. It includes examples, how to load tilesets, how to format them, and more! Check it out for all your tileset needs.

Finding your mappack's folder
First, you'll want to launch Mari0, then enter the "Select Mappack" menu. Then, press "M". That should open your mappacks folder, quick and easy. If it doesn't, use the following steps to find where your mappacks folder is stored on your respective OS.

Windows:
On windows you'll need to head to your %appdata% folder. You can do this by either searching for %appdata% via the Run application, or by searching it in the Start menu. After this, go to the LOVE folder, then mari0, then mappacks. Go to the folder named your mappack name.
Image Image
Image
(Credit to Mr.Cytosine for this tutorial)
Mac:
On a Mac, you'll need to access your Application Support files. First head to your users home folder. There should be a Library folder. Inside there will be the Application Support folder. From that folder, look for the folder entitled "LOVE". Inside there should be a "mari0" folder. From there enter mappacks, and a folder with your mappacks name should exist. TL;DR Users/youruser/Library/Application Support/LOVE/mari0/mappacks/your mappack's name
Linux:
On Linux the directory for the mappacks is located at home/user/.local/share/love/mari0/mappacks/mappack.
(Thanks, Kiwi7)

How to load custom music
If you're tired of the default SMB music and you have your own awesome music, then you can insert this into your mappack. First, check your music's extension. Mp3's and Ogg files, however Ogg Vorbis files are recommended, because they have smaller file size, and are more compatible with Mari0's engine. You'll need to find your mappack's folder first. After finding that folder, simply drop your music in. Rename it to "music" and save it. When opening Mari0 there should the custom option under the music dropdown.
Image

Loading Custom Backgrounds
The screen of Mari0 is 400x224 pixels.
The portal background is the standard custom background, you can overwrite it by doing the following:

Place “background1.png” inside your mappack folder (tutorial on accessing your mappack folder above).
You can keep adding consecutive numbers to add more than 1 background (background2.png, background3.png, etc) for parallax scrolling. Adjust the scroll factor slider (main tab) to control the speed of parallax scrolling.

This standard background can be overwritten by each map individually by putting “1-1background1.png” (for world 1-1) inside the folder. Also supports multiple backgrounds.
For sublevels, use “1-1_1background1.png”.

Then check the “Custom Background” box in the main tab of the editor.
(Credit for this tutorial goes to stabyourself.net)

Releasing your mappack
Mr. Cytosine has written an AMAZING thread just on releasing your mappack. It explains how to set up your thread properly, how to capture screenshots, and how to upload files. Check it out here: viewtopic.php?f=12&t=1642. Make sure you read this COMPLETELY before releasing, otherwise your thread will be more annoying to read, and therefore your mappack will get less downloads.

Modding

What is a mod?
Automatik has written a detailed tutorial on what a mod is and how to install it. I'll simply quote it here, since the post isn't giant.
Automatik wrote:What's a mod ? How do you do mods?
Okay, modding is modifying a game (Mari0) to add and change features(Ennemies,Shaders,Cheats...).
They are done by editing the source files (Lua code, you need to know how to program), and the ressource files (Images,Txt...)

How do you download mods?
You go on the Modding forum(here).
You click on the topic (ex):

You search for the download link, and click it :

Then you are on the download page, you click the big button:
Download (3.77 MB)

Then, the mod will be downloaded.

How to install/run the mods?
Okay, you first need to install Love2d : https://love2d.org/
LÖVE 0.8.0 for Windows – Installer 32-bit 64-bit

(If you don't know how to choose between 32-bit and 64-bit, just choose 32-bit.)
Then you download and install the .exe .
Once it's done, you can double click the .love mod you downloaded earlier. :)


Creating mods
EntranceJew has written a tutorial on modding. It only instructs you on how to create your own entity, however. It's for Mari0 1.3, but all the steps are the same for current Mari0. You can read this and get a general idea about modding, though you'll still need to know Lua to create your own unique mods. Thread here: viewtopic.php?f=13&t=580.

This is the end of the thread. I'm open on suggestions on how to improve this. Until then, I hope this helped!
Last edited by Qcode on 30 Dec 2013, 14:08, edited 2 times in total.

Mari0Maker
User avatar
Posts: 1347
Joined: 07 Apr 2012, 17:10
Reputation: 39
Contact:

Post » 11 Mar 2013, 03:08

Nice job, Qcode!
This should be pinned/stickied for sure!

You should also add my "All About Tilesets" thread to this.
viewtopic.php?f=12&t=2955

Qcode
User avatar
Posts: 1463
Joined: 05 Feb 2012, 18:00
Reputation: 71
Contact:

Post » 11 Mar 2013, 03:10

I did.
Qcode wrote:Loading a tileset into Mari0
In all your mappacks, you can add a custom tileset. This can add to your mappacks appeal, especially if you are talented at pixel art. Mari0Maker has released a tutorial on installing tilesets here: viewtopic.php?f=12&t=2955. It includes examples, how to load tilesets, how to format them, and more! Check it out for all your tileset needs.

Mari0Maker
User avatar
Posts: 1347
Joined: 07 Apr 2012, 17:10
Reputation: 39
Contact:

Post » 11 Mar 2013, 03:11

Qcode wrote:I did.
Qcode wrote:Loading a tileset into Mari0
In all your mappacks, you can add a custom tileset. This can add to your mappacks appeal, especially if you are talented at pixel art. Mari0Maker has released a tutorial on installing tilesets here: viewtopic.php?f=12&t=2955. It includes examples, how to load tilesets, how to format them, and more! Check it out for all your tileset needs.

Wow, I'm blind...
Thanks anyways. :P

luigi1fan
Posts: 5
Joined: 21 Oct 2013, 23:00
Reputation: 0

Post » 17 Dec 2013, 01:09

i may sound like a gigantic noob
but how do you intall non .love file
the mod in question is the extra entities mod foud here
viewtopic.php?f=13&t=2231
i allerady understand how to work .love files, so if there is a way to just use it as a .love file, that would be great.

Mari0Maker
User avatar
Posts: 1347
Joined: 07 Apr 2012, 17:10
Reputation: 39
Contact:

Post » 17 Dec 2013, 01:14

Are you trying to run a .love file? If so, download LÖVE from here. http://www.love2d.org/

luigi1fan
Posts: 5
Joined: 21 Oct 2013, 23:00
Reputation: 0

Post » 17 Dec 2013, 01:19

i mean NOT .love files

luigi1fan
Posts: 5
Joined: 21 Oct 2013, 23:00
Reputation: 0

Post » 17 Dec 2013, 01:20

*that file is a .zip folder witch i do not understand how to run

Mari0Maker
User avatar
Posts: 1347
Joined: 07 Apr 2012, 17:10
Reputation: 39
Contact:

Post » 17 Dec 2013, 01:31

For me it's a .love file. To run it, just rename the extension to .love instead of .zip.
Make sure file extensions are being shown on your computer (Go to the control panel to change that).

Qcode
User avatar
Posts: 1463
Joined: 05 Feb 2012, 18:00
Reputation: 71
Contact:

Post » 17 Dec 2013, 01:48

Are you sure you've downloaded the .love file and not the Extra Gels mappack? The mappack is at the bottom of the post, the download for the mod is about halfway up.

sonic1fan
User avatar
Posts: 15
Joined: 10 May 2013, 22:50
Reputation: 0

Post » 17 Dec 2013, 02:54

for me it does not say.love or .zip
it just says Mari0_EE_v18
i tried to add .Love to the end but nothing changed

sonic1fan
User avatar
Posts: 15
Joined: 10 May 2013, 22:50
Reputation: 0

Post » 17 Dec 2013, 02:56

bty i am the same person
just realized i made 2 acounts LOL

sonic1fan
User avatar
Posts: 15
Joined: 10 May 2013, 22:50
Reputation: 0

Post » 17 Dec 2013, 02:58

i just re downloaded it and called it rathe .zip
witch only apeared at the end
to .love witch then when it downloaded i selected open adn now i am going to play it :)

Kiwi7
Posts: 1
Joined: 30 Dec 2013, 12:58
Reputation: 0

Post » 30 Dec 2013, 13:03

Thanks for the guide, but you should also add a section on how to find your mappack's folder on Linux. I had to figure this out for myself (/home/user/.local/share/love/mari0/mappacks/mappack).

Qcode
User avatar
Posts: 1463
Joined: 05 Feb 2012, 18:00
Reputation: 71
Contact:

Post » 30 Dec 2013, 14:08

Thanks, added. Also added tip for pressing m in the mappack select screen to bring the folder up.

JellyBeenz
Posts: 3
Joined: 25 Jun 2015, 19:58
Reputation: 0
Contact:

Post » 25 Jun 2015, 20:05

how do you do multiplayer?

ElijahZAwesome
User avatar
Posts: 12
Joined: 31 Aug 2015, 18:11
Reputation: 0

Post » 31 Aug 2015, 23:24

how do you use a bluetooth controller for player 2 or 3 or whatever?

Sašo
Stabyourself.net
User avatar
Posts: 1377
Joined: 06 Jan 2012, 12:07
Reputation: 318
Contact:

Post » 21 Sep 2015, 15:51

You just need to make sure that the operating system recognised the controller and that the keys are working properly (in windows run "joy.cpl" to open a test panel).

ElijahZAwesome
User avatar
Posts: 12
Joined: 31 Aug 2015, 18:11
Reputation: 0

Post » 21 Sep 2015, 23:27

Ok

ShadowLink1231
Posts: 4
Joined: 19 Aug 2016, 17:31
Reputation: 0

Post » 19 Aug 2016, 19:46

Is there a way to input multiple music tracks into the game or no?

MF064DD
User avatar
Posts: 733
Joined: 20 May 2014, 00:08
Reputation: 282
Contact:

Post » 19 Aug 2016, 19:56

ShadowLink1231 wrote:Is there a way to input multiple music tracks into the game or no?


I don't know about stock Mari0 or Mari0 SE (perhaps SE Extended?), but I think A99E and a number of other Mari0 mods can do this.

Squidish
User avatar
Posts: 801
Joined: 05 Apr 2014, 04:04
Reputation: 210
Contact:

Post » 19 Aug 2016, 23:10

MF064DD wrote:
ShadowLink1231 wrote:Is there a way to input multiple music tracks into the game or no?


I don't know about stock Mari0 or Mari0 SE (perhaps SE Extended?), but I think A99E and a number of other Mari0 mods can do this.

Regular SE can have multiple songs as well.


Return to “Mari0”

Who is online

Users browsing this forum: No registered users and 7 guests