Skip to content

Commit b02011d

Browse files
committed
Update README
1 parent fa7091c commit b02011d

File tree

1 file changed

+39
-25
lines changed

1 file changed

+39
-25
lines changed

README.md

Lines changed: 39 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,54 +1,68 @@
1-
![Nano logo](https://raw.githubusercontent.com/BlueVoidStudios/Nano/master/Media/GitHub_Logo.png)
1+
![Nano logo](Media/GitHub_Logo.png)
22

3-
Nano is a tiny UE4 template designed for people who want to make tiny games. It was inspired by a special award in Epic's #ue4jam that goes to the best game under 100 MB. This award tends to raise a lot of questions in the community about how to make a UE4 game so small, so I decided to create a template that does most of the heavy lifting for you!
3+
Nano is a tiny project template for people who want to make tiny games with UE4 and UE5. It was created to support developers competing for the Tiny Award in Epic's Unreal game jams, which requires your game to be under 150 MB. The Tiny Award tends to raise a lot of questions in the community about how to make a game so small, so I created this template to give people a head start.
44

5-
> Currently, Nano requires Unreal Engine 4.24 or older in order to get below 100MB. I'm still investigating this, but as of 4.25, Nano can no longer get below 100MB, even with extensive changes. For now, stick with 4.24 and below.
5+
> If you're going for the Tiny Award in an Unreal game jam, you'll have to skip Unreal Engine 4.27 because Nano won't get you below the 150 MB limit. It currently works with 4.26 or older, as well as Unreal Engine 5 Early Access.
66
77
## Benchmarks
8-
Here's how Nano compares to the blank template that ships with UE4:
9-
10-
> Numbers are based on the Shipping build configuration
11-
8+
Here's how Nano compares to the blank template that ships with UE4 and UE5. Numbers are based on the Shipping build configuration
9+
### Unreal Engine 4.26
1210
| | 64-bit | 32-bit |
1311
| ----- | ------ | ------ |
14-
| Blank | 181 MB | 150 MB |
15-
| Nano | 116 MB | 85 MB |
16-
17-
You can take this even further if you exclude the prerequisites installer:
12+
| Blank | 211 MB | 176 MB |
13+
| Nano | 113 MB | 95 MB |
1814

15+
### Unreal Engine 5 Early Access
1916
| | 64-bit | 32-bit |
2017
| ----- | ------ | ------ |
21-
| Blank | 141 MB | 126 MB |
22-
| Nano | 76 MB | 62 MB |
23-
24-
_Please keep in mind: excluding the prerequisites installer means your game may not work for players who have never installed a UE4-based game before. This is probably fine for most people during the #ue4jam, but if you want your game to be accessible to everyone, skip this step!_
18+
| Blank | 240 MB | N/A |
19+
| Nano | 127 MB | N/A |
2520

2621
## How it works
2722
To help achieve its small size, Nano comes out of the box with the following configuration:
2823

2924
- Windows only
3025
- DirectX 11 & 12 only
31-
- No editor startup map
26+
- Shipping build config
3227
- No editor content
28+
- Default game map set to Entry (an empty map included with the engine)
3329
- Shared material code & libraries
3430
- Compressed cooked packages
3531
- Oculus VR and Steam VR plugins disabled
32+
- Magic Leap plugins disabled
33+
- No prerequisites installer
34+
35+
> ⚠ Excluding the prerequisites installer means your game may not work for players who have never played a UE4 or UE5 game before. This is fine for Unreal game jams because the rules don't require you to include it, but if you want your game to be accessible to more players, consider packaging a second build that includes the prerequisites installer.
36+
37+
There are ways to reduce the size of your game even further — such as blacklisting engine content — but this template focuses on modifications that have significant results while remaining safe and usable for most developers.
38+
39+
## Installation
40+
To use Nano, download the latest release for your engine version and copy it to the templates directory (e.g. `Epic Games/UE_4.26/Templates/`). Once you do this, Nano should appear as a template option in the New Project dialog.
41+
42+
### Unreal Engine 4
43+
![New Project UE4 screenshot](Media/GitHub_NewProject_UE4.png)
44+
45+
### Unreal Engine 5
46+
![New Project UE5 screenshot](Media/GitHub_NewProject_UE5.png)
47+
48+
## Packaging your game
49+
**Visual Studio is required to package your game with Nano.** I use Visual Studio Community 2019.
3650

37-
There are ways to reduce the size even further, but I decided to focus on the modifications that had significant results while remaining safe and usable for most people.
51+
If you're a Blueprint programmer like me, fear not! You don't have to use Visual Studio or write any C++; just install it with the appropriate components selected and you should be good to go.
3852

39-
## Instructions
40-
To use Nano, download the latest release and copy it to your templates directory (e.g. `Epic Games/UE_4.22/Templates/`). Once you do this, Nano should appear as a template option in the New Project dialog.
53+
> Nano uses the Development build config out of the box so you can use Print String nodes, console commands, and other development-only features. When it's time to package the final version of your game, remember to set your build config to Shipping to get the smallest size!
4154
42-
![New Project dialog screenshot](https://raw.githubusercontent.com/BlueVoidStudios/Nano/master/Media/GitHub_NewProjectDialog.png)
55+
### Unreal Engine 4
56+
Select **Game development with C++** in the Workloads tab.
4357

44-
### Packaging your game
45-
- **Visual Studio is required to package your game with Nano.** This is because the VR plugins are disabled. You don't have to use it; just install it with the configuration shown below and you should be good to go.
58+
![Visual Studio config for UE4](Media/GitHub_VSConfig_UE4.png)
4659

47-
![Visual Studio configuration](https://raw.githubusercontent.com/BlueVoidStudios/Nano/master/Media/GitHub_VisualStudioConfig.png)
60+
### Unreal Engine 5
61+
Select **Game development with C++** in the Workloads tab, then add **.NET 3.1 Core Runtime** in the Individual Components tab.
4862

49-
- Nano is configured for development out of the box. When it's time to package the final version of your game, don't forget to set your build config to Shipping!
63+
![Visual Studio config for UE5](Media/GitHub_VSConfig_UE5.png)
5064

5165
## Credits
5266
- The font used in the Nano logo is [Playlines](https://creativemarket.com/putracetol/2962806-Playlines-Typeface) by PutraCetol Studio
5367
- Whomever at Epic Games wrote [this article](https://docs.unrealengine.com/en-us/Engine/Performance/ReducingPackageSize) on reducing your package size
54-
- Heff, Tate Hartel, and AzorMachine from the #gamejams channel on [Unreal Slackers](https://unrealslackers.org) for their tips on reducing package size
68+
- Heff, Tate Hartel, and AzorMachine from the #game-jam-chat channel on [Unreal Slackers](https://unrealslackers.org) for their tips on reducing package size

0 commit comments

Comments
 (0)