Skip to content

Latest commit

 

History

History
47 lines (30 loc) · 3.24 KB

README.md

File metadata and controls

47 lines (30 loc) · 3.24 KB

WiiLÖVE

An awesome framework for making 2D Nintendo Wii homebrew games in Lua. Its API is based on LÖVE, but its functions are mostly written from scratch and optimized for the Wii.

function love.draw()
	love.graphics.print("WiiLÖVE is awesome!", 320, 240)
end

Why is it awesome?

The Wii has a lot of potential for homebrew development, but unfortunately getting started requires a lot of work. Not only do you need to learn C/C++, but you also need to set up a toolchain and a proper development environment. You also have to learn how to use many different Wii homebrew libraries and functions. What if there was an easier way to start developing a Wii homebrew game?

WiiLÖVE aims to make this much easier, at least for 2D game development. All you have to do is learn Lua, an easy-to-learn and flexible programming language, write your game with WiiLÖVE's versatile API, and run it from your SD card with WiiLÖVE's binary, both during development and for your finished product. It will automatically compile and run your game for you, no complex setup needed.

WiiLÖVE also has a built-in error handler, making game development much easier to debug. It also allows your game to cleanly exit back to its loader (for example, the Homebrew Channel) if it crashes.

Setup

Standard

Download the latest wiilove.zip and extract it to the root of your SD card.

Rename the supergame folder to something else (for example, the name of your game).

Start writing your game using the main.lua template! Add and edit files as needed, such as new script files and the icon and metadata.

Test your game by running it from the Homebrew Channel.

Dolphin

Download the latest wiilove-dolphin.zip and extract the contents of the sd folder to the root of your virtual SD card.

Start writing your game using the main.lua template! Add and edit files as needed, such as new script files and the icon and metadata.

Test your game by launching the wiilove.dol file in Dolphin.

Once your project is complete, refer to the standard setup for structuring an app for the Homebrew Channel.

Resources

Since there isn't a guide for WiiLÖVE yet, I recommend checking out Sheepolution's How to LÖVE guide, and then accounting for the differences in WiiLÖVE's API.

Docs are currently a WIP.

Check out some open-source projects that use WiiLÖVE!

  • Wiirdle - Wordle clone for the Wii made to demonstrate WiiLÖVE's features

License

WiiLÖVE is licensed under the GNU Lesser General Public License v3.0. Therefore, modifications to WiiLÖVE must be open-source and licensed under the same license. However, projects and files that interact with WiiLÖVE externally (for example, Lua scripts that WiiLÖVE runs) are not required to be open-source and can use any license.

Exceptions to this license are the files in the game folder, which are meant to be a project template. These files are unlicensed and free-to-use for any purpose.