CtruLua 3DS

ctrµLua
General
Author	Firew0lf, Reuh, Negi
Type	Game engine
Version	1.0
License	Mixed
Last Updated	2016/11/27
Links
[1.0 and CI server Download]
Website
Source

ctrµLua is a Lua parser for 3DS. It's born within the µLua community as an attempt to bring their favorite piece of software to the 3DS. The result ended being mighty different from what was µLua itself.

With the latest release, ctrµLua supports all the most common features needed to create a 2D game or app.

Features

• HID (everything).
• 2D graphics.
• 3D support (with 2D graphics).
• Texture loading and saving (PNG, JPEG, BMP, a lot of other formats).
• Fonts (TTF, a lot of other formats).
• Maps (.csv).
• Sound (WAV and OGG with/without streaming).
• Sockets (TCP and UDP).
• HTTP contexts (with/without SSL).
• Infrared communication (untested on hardware).
• UDS services (local wireless communication).
• Filesystem.
• LZLib (zlib compression).
• ROMFS.
• Camera.
• Microphone.
• Threads.
• PTM services.
• Head tracking.
• APT services.
• User and system informations.
• News.

Installation

Installing

Unzip ctrµLua on your SD card, in a folder inside your homebrews folder; if you use HBL, extract it in /3ds/ctrulua/

Put some scripts wherever you want, just remember where.

Launch CtrµLua from your homebrew launcher, then use the shell to run your scripts.

Building

Setup your environment as shown here.

Clone this repository and run the command make build-all to build all the dependencies.

If you only made changes to ctrµLua, run make to rebuild ctrµLua without rebuilding all the dependencies.

Note: May not work under Windows.

User guide

Hello world

local ctr = require(""ctr"")
local gfx = require(""ctr.gfx"")
local hid = require(""ctr.hid"")

while ctr.run() do
 hid.read()
 local keys = hid.keys()
 if keys.held.start then break end
 
 gfx.start(gfx.TOP)
  gfx.text(2, 2, ""Hello, world !"")
 gfx.stop()
 
 gfx.render()
end

This script will print "Hello, world !" on the top screen, and will exit if the user presses Start.

This is the "graphical" version; there's also a text-only version, based on the console:

local ctr = require(""ctr"")
local gfx = require(""ctr.gfx"")
local hid = require(""ctr.hid"")

gfx.console()
print(""Hello, world !"")

while ctr.run() do
 hid.read()
 local keys = hid.keys()
 if keys.held.start then break end
 
 gfx.render()
end

gfx.disableConsole()

Lua API Documentation

• An online version of the documentation can be found here.
• To build the documentation, run make build-doc-html (requires LDoc).

Changelog

v1.0 Build f118baa

• Sprite library.
• Configurable filepicker.
• Shell to select and launch scripts.
• Configurable keyboard library.
• Text editor with Lua syntax highlighting.
• Code examples.

Release notes.

Credits

• Smealum and everyone who worked on the ctrulib.
• Xerpi for the sf2dlib, sftdlib and sfillib.
• All the Citra developers.
• Everyone who worked on DevKitARM.
• Nothings for the stb libs.
• Everyone who worked on the other libs we use.

External links

• Official website - http://ctrulua.github.io
• GitHub - https://github.com/ctruLua/ctruLua