Skip to content

Commit 4e86267

Browse files
mikeskydevgitbook-bot
authored andcommitted
GitBook: [master] 7 pages and 4 assets modified
1 parent a16609c commit 4e86267

File tree

8 files changed

+78
-3
lines changed

8 files changed

+78
-3
lines changed

.gitbook/assets/filemenu.png

5.62 KB
Loading

.gitbook/assets/first-open.png

33.6 KB
Loading

.gitbook/assets/newproject.png

7.92 KB
Loading

.gitbook/assets/openproject.png

37.7 KB
Loading

SUMMARY.md

+2
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@
55
## Minish Maker
66

77
* [Minish Maker](minish-maker/minish-maker.md)
8+
* [Getting Started](minish-maker/getting-started.md)
9+
* [Map Editor](minish-maker/map-editor.md)
810

911
## Save Editor
1012

minish-maker/getting-started.md

+71
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
description: Ready to make some minish?
3+
---
4+
5+
# Getting Started
6+
7+
## First Run
8+
9+
If you followed the steps in the introduction page, you should have downloaded and launched Minish Maker. You'll have been greeted with this window:
10+
11+
![It's a bit empty in here.](../.gitbook/assets/first-open.png)
12+
13+
This is the central window of the program and ties together all of the sub editors we offer. This window will look very blank to start with as you still need to open a project at this point. How do you open a project?!
14+
15+
## File Menu
16+
17+
![](../.gitbook/assets/filemenu.png)
18+
19+
The file menu deals with all the project management bits. From the top:
20+
21+
* **New project**. This will open up the project creation window.
22+
* **Open Project**. Open a previously created Minish Maker project.
23+
* **Save Project**. Commit your current changes to the project folder.
24+
* **Build Project**. Saves and generates your romhack from it's source files.
25+
* **Exit**. Hope this doesn't need explained!
26+
27+
### New Project Window
28+
29+
![](../.gitbook/assets/newproject.png)
30+
31+
Clicking on **New Project** opens the project creation wizard. From here, you need to enter the following information:
32+
33+
* Project Name. This will appear in the `.mmproj` filename, and the name of the generated ROM. This can be changed later if needed.
34+
* Base ROM. Hit Browse and navigate to an unmodified copy of _The Legend of Zelda: The Minish Cap._ This can be any version of the game \(EU, JP, US\).
35+
36+
{% hint style="danger" %}
37+
Do **not** ask us where to find ROMs of the game, or share them with others who ask for them. Doing so is illegal, so you will have to find your own.
38+
{% endhint %}
39+
40+
* Project Location: A folder to save all the project files in. This helps keep the project tidy and portable.
41+
42+
Once you've entered the required information, hit **Create Project**. This will generate all of the required files, and create a copy of your supplied ROM in the project folder called `baserom.gba`.
43+
44+
If you're wanting to get stuck in, jump over to the [Map Editor](map-editor.md). To find out more about how our project system works, read on.
45+
46+
### Open Project
47+
48+
![](../.gitbook/assets/openproject.png)
49+
50+
Clicking the Open project button will open up the file selection window. Navigate to where you saved your project, and double click on the file with the extension `.mmproj`.
51+
52+
### Save Project
53+
54+
Saves any changes made throughout the various windows, be sure to use this often.
55+
56+
### Build Project
57+
58+
This will apply all the change patches to a copy of the ROM you provided, and save it in the project folder with the name being the project name you supplied earlier. When building, Minish Maker will also save to make sure all your changes are taken into the new ROM.
59+
60+
{% hint style="info" %}
61+
Minish Maker uses a build system that is designed around the wonderful [ColorzCore](https://github.com/FireEmblemUniverse/ColorzCore) system built by the Fire Emblem romhacking community. This system allows us to add changes to the ROM in a modular fashion, breaking each component \(map, chest data, enemy data\) into it's own set of instructions that are combined together at build time to create the finished ROM.
62+
63+
We decided on this method as we noticed a lot of level editors for different games just immediately generated the ROM directly from the input, which can lead to messy versioning and allows the hack to enter an irreversible state if saved incorrectly.
64+
65+
By saving each change as it's own set of files, it allows projects to be managed through version control software \(don't upload the ROM!\) and promotes collaboration on larger hacks. the ColorzCore build language also allows users to directly inject custom patches into the ROM, either generated from other programs or custom assembly files and plugins for features we haven't written yet. We plan to add a visual plugin manager to Minish Maker later for easier management of these files.
66+
{% endhint %}
67+
68+
### Exit
69+
70+
Exits out of the application, pressing the X button in the top right has the same effect. Be sure to save your changes before doing this.
71+

minish-maker/map-editor.md

+2
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# Map Editor
2+

minish-maker/minish-maker.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,13 @@ Make sure you download the zip file named **MinishMaker x.x.x.zip**, and not the
2929

3030
### Installation\(ish\)
3131

32-
Once you've downloaded the zip, unzip it in whatever folder you want. Minish Maker currently functions as a portable app and can be run from most folders.
32+
Once you've downloaded the zip, unzip it in whatever folder you want. Minish Maker currently functions as a portable app and can be run from most folders. Then double click **Minish Maker.exe** to run the program.
3333

3434
Note: On Windows 10, you may see this popup when attempting to run the program:
3535

3636
![Pesky Windows, who does it think it is protecting you?!](../.gitbook/assets/smartscreen.png)
3737

38-
This is normal, and appears because we can't afford to pay for a signing certificate. To run the program, click 'More info' which will reveal the 'Run anyway' button.
39-
38+
This is normal, and appears because we can't afford to pay for a signing certificate. To run the program, click **More info** which will reveal the **Run anyway** button.
4039

40+
Once Minish Maker opens, you're good to go! Jump over to the [Getting Started](getting-started.md) section of this guide.
4141

0 commit comments

Comments
 (0)