GameBrew - User contributions [en-gb]

BlocksDS

2026-05-14T02:09:30Z

SkyLyrac: Update links

{{Infobox DS Homebrews
|title=BlocksDS
|image=Ndspc2.png
|description=Main BlocksDS SDK repository.
|author=AntonioND
|lastupdated=2026/04/26
|type=Development
|version=1.20.0
|license=Mixed
|download=https://blocksds.skylyrac.net/docs/setup/
|website=https://blocksds.skylyrac.net/
|source=https://codeberg.org/blocksds
}}
{{#seo:
|title= (Development Tools) - GameBrew
|title_mode=append
|image=Ndspc2.png
|image_alt=BlocksDS
}}

BlocksDS SDK is an SDK for Nintendo DS. It's built on the hard work of many talented individuals. Here are its goals:

* Create a user-friendly NDS software development kit based on GCC, with minimal dependencies.
* Encourage developers to tinker and enhance the SDK by providing them with its complete source code. It also demonstrates how straightforward it is to build the entire codebase. The only exception is the tolchain, which can be tricky to build. To simplify things, we use Wonderful Toolchains instead of asking users to build it themselves.
* Strive to maintain compatibility with existing C projects. Ideally, replacing the makefile with one from BlocksDS should be sufficient to build any project that utilizes libnds.

This project is currently in beta stage, and most features are working. Please, check the [https://github.com/blocksds/sdk/blob/master/docs/libc.rst libc port documentation] for more information about the supported libc functions.

If you want to port a project built with devkitPro, follow [https://github.com/blocksds/sdk/blob/master/docs/porting-guide.rst this guide] for instructions.

For detailed information about the design of BlocksDS, check [https://github.com/blocksds/sdk/blob/master/docs/design-guide.rst this other document].

For licensing information, check [https://github.com/blocksds/sdk/blob/master/docs/licenses.rst this].

==Changelog==
'''v1.16.0'''
* libnds:
** <code>glDeinit()</code> has been implemented. This function frees all memory used by videoGL and stops the 3D hardware until <code>glInit()</code> is called again.
** <code>fsync()</code> has been implemented. <code>fflush()</code> doesn't currently guarantee a flush to the disk, so <code>fsync(fileno(fp))</code> can be used instead. [https://github.com/asiekierka @asiekierka]
** Function <code>fatGetDefaultDrive()</code> can now return <code>"nand:/"</code> if the application runs from NAND.
** New definitions have been added for the window registers. The old ones didn't use the same names used by GBATEK.
** Fix <code>SOUNDXCNT_VOL_DIV_x</code> defines.
** Add defines <code>GL_TRANS_YSORT</code> and <code>GL_ZBUFFERING</code> for <code>glFlush()</code>.
** Define <code>GL_SPECULAR_USE_TABLE</code> has been added so that it can be added to <code>glMaterial()</code> instead of using magic numbers.
** <code>glMaterialShinyness()</code> has been deprecated. The name is a typo, and the new name is <code>glMaterialShininess()</code>. The old name will be kept around forever because too many projects use it.
** Add warning to material <code>GL_SHININESS</code> because it isn't used for anything.
** Align the Huffman temporary buffer to a word just in case it's needed.
** Stop expecting a size field in the <code>GRF</code> chunk of GRF files.
** Support <code>PIDX</code> chunks in GRF files. This is used for Tex4x4 texture format.
* DSWiFi:
** Access points with hidden SSID (the name of the network) are now supported in DS mode (not in DSi mode yet). This only works for APs that send probe responses that contain a SSID (some APs don't, and they aren't supported).
* Maxmod:
** Fix mode C mixer. Version 1.14.0 did a partial fix, but it didn't update the volume divider bits of the audio channel control register correctly. This bug could be seen in the <code>audio_modes</code> example.
* grit:
** Remove size field from <code>GRF</code> chunks in GRF files. This was added by BlocksDS and it makes it harder to be compatible with other GRF files. Removing it doesn't affect anything because the RIFF chunk already has the size.
** When exporting tiled backgrounds grit didn't check if the size of the tile set was too big. There was a check but it was incorrect. Now, grit will fail if it's trying to export too many tiles for the specified format. For example, affine backgrounds can only have up to 256 tiles. Previously, grit would export a broken tile map silently, which was hard to detect if there were too many similar tiles. If you were taking advantage of this broken check to overflow the tile index into th e tile flip bits of regular maps, use options <code>-mB16:p4i12 -mRtp</code> to achieve the same effect.
* ndstool:
** The CRC of the secure area wasn't calculated when generating the header. This is now fixed. [https://github.com/edo9300 @edo9300].
** Support for GRF files has been removed. It was outdated and it didn't make sense to update it. This format was worse than PNG and BMP for static icons because it needs to be pre-converted by hand. Also, it didn't support animated icons like GIF files.
* SDK:
** The first official logo of BlocksDS has been created. Thanks to Megan Gozzard.<br />
** A new icon has been added to the SDK to be used as default icon for all ROMs. The old icon file is still available for projects that depend on it, but it has been updated to use the new icon. Thanks to [https://github.com/DieGo367 @DieGo367].<br />
** <code>dprintf()</code> and <code>vdprintf()</code> have been added to picolibc.<br />
** Arguments <code>-std=gnu17</code> and <code>-std=gnu++17</code> have been removed from all default and template makefiles. They prevented users from changing this themselves.<br />
** <code>dldipatch</code> now returns the version string when it runs with argument <code>-V</code> (this change was applied to all other tools in version 1.15.0).<br />
** Examples:
*** Delete both examples about loading textures in GRF format and create a better example that doesn't hardcode any values (<code>grf_textures_nitrofs</code>).
*** Add example of using windows and DMA to create a circular window.
*** Add example of the material properties of 3D objects. It shows several combinations of properties to understand the effect they have on the resulting color of the polygons.
*** Add example of using the master brightness registers (not the LCD brightness).
*** Add example of drawing a single colored 3D quad.
*** Add example that compares modulation and decal 3D polygon modes.
*** Add example of using fog to fade 3D objects over 2D layers.
*** Add example of 3D antialiasing and edge marking.
*** Fix 3D box test example.
*** Set transparent color explicitly in grit files that convert tiled backgrounds. Index 0 is always transparent, so it's a good idea to tell grit which color to use as transparent so that we don't get surprises later.
*** Simplify background image used in the <code>bg_rotation</code> example. It was using way more tiles than the limit of 256, but it wasn't noticeable because many tiles looked similar.
*** Set backdrop color in some examples to black instead of leaving magenta, which is the transparent color of the background.
*** The graphics of the examples in the <code>video_effects</code> folder have been replaced by prettier images.
*** In 3D examples that draw cubes the old vertex order was incorrect (so culling wasn't working properly). It has been fixed.
*** A new example has been added to show how to draw a 3D cube and what's the effect of changing the culling setting.
*** Use GL helpers for texture coordinates instead of raw register writes.
*** Minor improvements to 3D examples.
*** The graphics files used in some 3D examples have been improved.
*** The example that loads a compressed texture has been simplified so that the concatenation happens at build time rather than at run time.
*** A new example has been added to show the different effects of using texture coordinates outside of bounds (stretch, wrap, wrap and flip).
*** Improve the example of drawing several 3D translucent objects to let the user break it in different ways and see the results.
*** Add an example of how to draw a polygon in which all faces are translucent and visible at the same time.
*** Add an example of how to use the 3D alpha test.
*** Add an example of how to draw a simple pre-converted display list.
*** Add an example of how to apply lighting to a 3D cube drawn manually. The previous examples used pre-converted display lists so the developer couldn't see the <code>glNormal()</code> commands.
*** The images used in some examples that combine 2D and 3D graphics have been improved.
*** In the BIOS decompression example, align the Huffman temporary buffer to a word just in case it's needed. Clear the destination buffer before each decompression to make sure that a decompression that doesn't write anything doesn't pass as a correct decompression. Use VRAM-safe compression for LZSS so that it works with WRAM and VRAM decompression routines.
** Documentation:
*** The documentation has been completely reorganized. Old links to specific pages won't work.
*** The old Hugo theme has been replaced by one that supports different sections better (SDK documentation vs tutorial, for example).
*** A lot of icons and nicer formatting has been added to all the previous documentation. In particular, the setup instructions have been simplified.
*** The documentation now includes information about all the libraries provided in the BlocksDS and Wonderful Toolchain repositories. They weren't easily discoverable before.
*** Add a new page with documentation about filesystem support.
*** The tutorial has new sections about background and sprite extended palettes.
*** The tutorial has new chapters about 2D effects (blending, mosaic, etc), memory management, and 3D.
*** The tutorial has been merged into the SDK repository to unify the documentation of BlocksDS.
*** The tutorial is now licensed under the license CC BY-NC-SA 4.0.
** Tests:
*** Make DLDI-on-ARM7 test work in DSi Slot-1 flashcarts.
'''v1.15.7
* libnds:
** Add a wait loop to <code>systemReboot()</code> to give the power management hardware enough time to do the reboot (before <code>systemShutDown()</code> is called, which is faster to act).
** Update FatFs to version R0.16p1.
* DSWiFi:
** <code>gethostbyname()</code> has been marked as deprecated. This function only returns IPv4 addresses and it's deprecated in the libraries of modern systems. You should use <code>getaddrinfo()</code> instead, which returns IPv4 and IPv6 addresses. That way applications will be future-proof.
** A new flag called <code>WFLAG_APDATA_CONFIG_IN_WFC</code> has been added to <code>Wifi_AccessPoint.flags</code> to tell the developer that the access point has been configured in the WFC settings.
** <code>Wifi_ConnectWfcAP()</code> has been implemented. This function allows the user to select one of the APs configured in the WFC settings instead of connecting to the first one that the library finds. Previously you could only use<br />
<code>Wifi_ConnectSecureAP()</code>, which forces you to provide the password instead of reading the data stored in the WFC settings. Now you can use either function depending on whether you want to use the WFC settings or a different password.
* Maxmod:
** <code>mmInitNoSoundbank()</code> has been improved to initialize the pointer to the soundbank to <code>NULL</code> for clarity. This wasn't causing any issue because the number of songs and samples was correctly initialized to 0.
* SDK:
** The documentation about using filesystems has been improved a lot.
** Improve synchronization of ARM9 and ARM7 CPUs before the ARM7 is allowed to enter <code>main()</code>. In very rare cases, if the user modified <code>REG_IPC_SYNC</code> too soon inside <code>main()</code> the ARM9 synchronization code would never see the message from the ARM7 allowing it to continue and it would hang.
** All DSWiFi examples have been updated to stop using <code>gethostbyname()</code> and to use <code>getaddrinfo()</code> instead. One of the examples has been moved to the <code>tests</code> folder to make sure we can still test <code>gethostbyname()</code> in the future (the plan is to keep it and discourage its use, not to remove it). Now all examples support IPv4 and IPv6 as recommended.
** The DSWiFi examples have been updated to use <code>Wifi_ConnectWfcAP()</code> in addition to the other functions to connect to access points.
'''v1.15.6'''
* libnds:
** Fix <code>pianoIsInserted()</code> always returning <code>false</code>. [https://github.com/exelotl @exelotl]
** Fix sound playback helpers not starting or stopping sounds when requested.
* DSWiFi:
** Fix race condition when writing packets to the IPC RX/TX circular buffers that could cause a crash in the library.
* SDK:
** Fix the timer index used for RTC on the ARM7 in the ARM9+ARM7 template.
** Fix <code>make clean</code> target in the examples that use Mbed TLS or libcurl. It used to cause an error if the libraries weren't present in the system.
** The documentation about multithreading locks has been updated.
'''v1.15.5''''
* libnds:
** Split <code>systemShutDown()</code> to create <code>systemReboot()</code>.
** Clean power management definitions.
** Un-deprecate <code>glTranslate3f32()</code> because it's used in several projects.
** Stop writing the NAND CID to arbitrary RAM addresses used by the official SDK but not by BlocksDS. [https://github.com/edo9300 @edo9300]
** Stop writing to <code>REG_VCOUNT</code> during initialization of the ROM. Thanks to [https://github.com/TuxSH @TuxSH] for finding the original bug.
** Add global timer definitions so that other libraries know which timer they can use.
** Ensure that file descriptors passed to <code>truncate()</code> are valid FAT descriptors.
* DSWiFi:
** Drop lwIP packets if there isn't enough RAM to allocate a buffer for them (instead of crashing in an <code>assert()</code>).
** Add a workaround to prevent IPC buffer overflows.
* SDK:
** Use the new libnds timer defines in ARM7 templates and examples, as well as in DSWiFI, Maxmod and LibXM7.
** Fixed the orientation of normals for planes in the volumetric shadow example. [https://github.com/Mori-TM @Mori-TM]
** Improve exit-to-loader test.
'''v1.15.4'''
* libnds:
** <code>glTranslate3f32()</code> has been converted from a define to a <code>static inline</code> function. The define could cause issues if someone was creating a C++ wrapper with the same name, for example.
* DSWiFi:
** Don't crash on an <code>assert()</code> when sending fragmented lwIP packets.
* SDK:
** Support unusual <code>main()</code> prototypes with 3 arguments instead of two. The third argument is set to <code>NULL</code>.

'''v1.15.3'''
* DSWiFi:
** IPv6 support has been added. The <code>ASSOCSTATUS_DHCP</code> state now waits for an IPv4 or an IPv6 address to be available (normally IPv4 is available first). Function <code>Wifi_GetIPv6()</code> has been added, which lets the caller check if there is an available IPv6 address for the DS.
** In DS mode, only send data packets to the ARM9 by default. Previously all management packets were being sent.
** In DS mode, send multicast packets to lwIP. Previously only packets addressed to the console or to the broadcast address (FF:FF:FF:FF:FF:FF) were sent to lwIP, which prevented DHCPv6 from working, for example.
** TX packets generated by lwIP and passed to DSWiFi weren't handled correctly if they were in a fragmented <code>pbuf</code>. This has been fixed.
** Fix implementations of <code>ioctl()</code> and <code>fcntl()</code>, as well as the defines <code>O_RDONLY</code>, <code>O_WRONLY</code>, <code>O_RDWR</code> and <code>O_NONBLOCK</code>.
* SDK:
** Added a new package with libcurl named <code>blocksds-libcurl</code>.
** Added a new example of how to use libcurl with BlocksDS.
** Improve documentation of exception handler example.
** Add a bloom example based on the original demo by Bluescrn.
** Mention the multiple ARM7 cores in the migration guide.
** Support edge-triggered rumble cartridges in the Slot-2 example.
'''v1.15.2'''
* libnds:
** Fix mounting filesystems in SD cards with multiple partitions. [https://github.com/edo9300 @edo9300]
* DSWiFi:
** A potential buffer overflow has been fixed in the DSi RX/TX queues.
** The DS RX/TX queues that transfer packets between the ARM9 and ARM7 have been rewritten to behave like in DSi mode. Now packets are written to the circular buffer one after the other, but they are never cut into two parts when the end of the buffer is reached. This guarantees that packets are always stored in one piece, which means that the ARM9 can avoid doing an extra copy to concatenate both parts, making communications faster.
** In DS mode packets are now read from/written to MAC RAM using DMA for extra speed and simplify the code.
** Now that packets are always stored in one piece, it isn't needed to use <code>Wifi_RxRawReadPacketPointer()</code> to copy them to a user-allocated buffer. Function <code>Wifi_RxRawReadPacketPointer()</code> has been implemented as an alternative. It returns an uncached pointer to the packet in RAM. Please, check the documentation for advice on how to use them.
** Improve random number generation. Previously, in DS mode, <code>W_RANDOM</code> was used for WEP seeds, a bad handmade RNG was used for WPA2 handshakes, and <code>rand()</code> was used in Mbed TLS instead of hardware entropy collection. A new system has replaced all of them. It constantly collects randomness from different events and updates a seed that is used to seed a xorshift32 generator. It isn't super secure because there is no real source of randomness on the DS, but it's better than the previous systems.
** The <code>Wifi_TxHeader</code> and <code>Wifi_RxHeader</code> structs are now private. They are never required by user code, and there is no equivalent in DSi mode, so it's better to hide them.
* SDK:
** Fix linker warning about the implementation of <code>__sync_synchronize</code>. Thanks to [https://github.com/asiekierka @asiekierka] for the workaround.
** In a DSWiFi example some missing instructions have been added to the console output.
** The SSL DSWiFi example has been updated with more test websites.
'''v1.15.1'''
* DSWiFi:
** In the ARM7, Mbed TLS has been moved to twl sections. This code is only required to connect to WPA2 networks.
** Transfer of data between DSWiFi and lwIP in the ARM9 has been fixed. The way <code>pbuf</code> structs were managed was incorrect, and caused frequent assertion panic screens.
** Some missing defines have been added to public DSWiFI headers.
** Some settings have been changed in lwIP (for example, to increase the number of available simultaneous sockets).
'''v1.15.0'''
* libnds:
** Fix reading console ID with <code>SCFG_ROM</code> registers disabled. [https://github.com/edo9300 @edo9300]
** Ensure crypto has been initialized when a NAND read/write command is received in the ARM7. [https://github.com/edo9300 @edo9300]
** Support using <code>write()</code> to send text to the console with file descriptors <code>STDOUT_FILENO</code> and <code>STDERR_FILENO</code>.
** Fix potential cache corruption caused by <code>DC_InvalidateRange()</code> in <code>readFirmware()</code>. It has been replaced by <code>DC_FlushRange()</code>, and all calls to <code>DC_InvalidateRange()</code> have been removed. For more details, check Cearn's articles [https://www.coranac.com/2009/05/dma-vs-arm9-fight/ here] and [https://www.coranac.com/2010/03/dma-vs-arm9-round-2 here].
** Add some missing SCFG and NDMA register definitions.
** Add no$gba debug register definitions (also used in melonDS).
** Simplify no$gba message print on the ARM9 (melonDS doesn't support the simplified system on the ARM7).
* DSWiFi:
** Add new DSi mode driver with support for Open, WEP and WPA2 networks. [https://github.com/shinyquagsire23 @shinyquagsire23] is the original author of the driver. It has been extracted from [https://github.com/shinyquagsire23/dsiwifi dsiwifi] and modified to integrate it with the previous DSWiFi code.
** This driver can be enabled by passing <code>WIFI_ATTEMPT_DSI_MODE</code> as one of the flags to <code>Wifi_InitDefault()</code>. It's also possible to use <code>WIFI_DS_MODE_ONLY</code> to force DS mode even on DSi consoles (this is the default setting).
** The new DSi driver doesn't support NiFi mode, it's only available in backwards-compatible DS mode.
** The library now reads all Access Points configured in the WFC settings of DSi consoles. It uses them even in backwards-compatible DS mode (but it ignores access points that use WPA).
** <code>Wifi_ConnectAP()</code> has been deprecated, <code>Wifi_ConnectSecureAP()</code> supersedes it. It's more convenient because it takes as input a key and key length instead of a key and hardware definitions. It supports WPA, WEP and open networks.
** The code on the ARM7 side is now divided into two parts. One of them is for DS mode, which is always loaded. The other one is for the DSi driver, which is only loaded to RAM in DSi mode. Some code can be shared between both modes, but not much.
** The code has been refactored a lot. The <code>WIFI_MODE</code>, <code>WIFI_AUTHLEVEL</code> and <code>WIFI_CONNECT_STATE</code> state machines are now decoupled and they can't directly change the state of other state machines, making it easier to understand the execution flow.
** The internal IPC code of the library has been simplified. Several status flags have been removed as they are no longer needed.
** <code>Wifi_FindMatchingAP()</code> has been simplified. It now only checks the BSSID and SSID of the reference AP we're looking for.
** Some new fields related to the security of the AP have been added to struct <code>Wifi_AccessPoint</code>. Also, field <code>rssi</code> is now signed instead of unsigned.
** Mbed TLS 3.4.6 has been added to the repository. This is required by the WPA2 handshake code. The license has been added to the repository, and the SDK documentation has been update to mention the new requirements.
** Flag <code>WFLAG_APDATA_ADHOC</code> no longer works as ad hoc mode support has been removed (this is different from multiplayer mode, that's still supported). Field <code>macaddr</code> has been removed from struct <code>Wifi_AccessPoint</code>.
** Unused define <code>WFLAG_APDATA_SHORTPREAMBLE</code> has been removed.
** The strings of <code>ASSOCSTATUS_STRINGS</code> have been modified to make them useful.
** The network interface (netif) used by lwIP is now set down when the WiFi connection is lost and set up when the console connects to an access point. This helps lwIP do some things better, like DHCP.
** Scan mode is now a bit faster in DS mode, the library stays for a shorter period of time in each channel.
** A few definitions and structs have been added to the public headers, as well as <code>freeaddrinfo()</code> and <code>getaddrinfo()</code>.
* SDK:
** Improve SDK version string generation. The makefiles of all tools (except for <code>dldipatch</code>) have been modified to use the value of <code>VERSION_STRING</code> provided by the user. If the string is not provided, it tries to generate a version string in 2 different ways. If that fails, it defaults to "DEV".<br />

** Added a prototype Mbed TLS 3.6.4 package to the pacman repository. Note that the entropy generation isn't correct, so don't use this for any application that requires security for now!<br />

** All tools (except for <code>dldipatch</code>) now accept a <code>-V</code> flag. When the tools are run with <code>-V</code> they print the version string and exit right away. This flag has been selected because some tools were already using <code>-v</code> for other purposes (like verbose output).<br />

** The file <code>$BLOCKSDS/version.txt</code> will now contain the value of <code>VERSION_STRING</code> generated when building BlocksDS instead of the commit ID.<br />

** Update license information about DSWiFi.<br />

** To reduce the size of NDS ROMs the default ARM9-only Makefile now uses the default ARM7 core with maxmod but without DSWiFi. Programs that require DSWiFi need to select the right core by adding this line to the Makefile: <code>ARM7ELF := $(BLOCKSDS)/sys/arm7/main_core/arm7_dswifi_maxmod.elf</code><br />

** Examples:
*** New example that lets you display the photos stored in the NAND of a DSi console. [https://github.com/edo9300 @edo9300]
*** The DSWiFi examples have been updated to use DSi mode and connect to WPA2<br />
networks whenever possible.
*** There's a new example to show how to use the new version check helpers.
'''v1.14.2'''
* libnds:
** Improve error checking in <code>nitroFSInit()</code> when using official card commands to access NitroFS. <code>nitroFSInit()</code> now reads the new magic string stored by ndstool in the NDS ROM to check that the cartridge data can be read. The previous system was incorrect because the ROM header can't be read after the initial load of the ROM.
** Prevent changing the filesystem label of DSi NAND partitions with <code>fatSetVolumeLabel()</code>. [https://github.com/edo9300 @edo9300]
** Add support for the photo partition of the DSi NAND. [https://github.com/edo9300 @edo9300]
** Save some RAM related to FatFs structs by moving them to TWL RAM. [https://github.com/edo9300 @edo9300]
** Some minor code cleanup.
* DSWiFi:
** Implemented <code>inet_aton()</code>, <code>inet_addr()</code>, <code>inet_ntop()</code> and <code>inet_pton()</code>.
** DSWiFi now prevents lwIP from updating its state before being connected to an access point.
** Some minor code cleanup.
* ndstool:
** Add a magic string after the FAT filesystem table. This string can be used by libnds to check that card commands can read the cartridge data correctly.
** The unit code and title ID of the DSi ROM header can now be set by the user independently.
** The default title ID for DSi ROMs is now the DSiware code rather than the DSi gamecard code. This is a compatibility break with older versions. To get the same result as previous invocations of ndstool you need to use the argument <code>-u 00030000</code>. If you were using a different title ID already now you will need to specify the unit code. For example, <code>-u 00030004</code> now becomes <code>-u 00030004 -uc 3</code>, and you can skip the <code>-u 00030004</code> because that's the new default value.
* SDK:
** NitroFS now works when ROMs are loaded from Unlaunch (with some limitations, paths can only be up to 0x40 characters long, and file/folder names are in 8.3 name format). Thanks to [https://github.com/edo9300 @edo9300] for his device list support additions and his suggestions for ndstool.
** The example that accessess all filesystems has been improved to check the <code>nand2</code> filesystem as well.
'''v1.14.1'''
* libnds:
** NitroFS now detects failures during initialization. <code>nitroFSInit()</code> has been cleaned and documented. Normally, <code>nitroFSInit()</code> tries to open the NDS ROM as a file, then it tries to read NitroFS from Slot-2 cartridge memory, and then it falls back to cartridge commands. There were no checks to verify that cartridge commands worked.
** The exit-to-loader system has been slightly modified to increase compatibility with loaders that don't determine the size of DSi RAM correctly. The compatibility break happened in Version 0.13.0.
** <code>keysCurrent()</code> has been marked as deprecated. <code>keyboardUpdate()</code> has been modified to use <code>keysHeld()</code> instead. This isn't a new break, this just adds a warning for users of BlocksDS. The break happened in Version 0.13.0.
** Function <code>dlopen_FILE()</code> has been introduced. It works like <code>dlopen()</code>, but it takes a <code>FILE</code> handle as input instead of a path. This is useful to load dynamic libraries that are already in RAM instead of in the filesystem.
** The check that verifies that the IPC transfer region fits in memory has been fixed to not overlap the following memory regions.
** Card functions now use the right <code>CARD_</code> defines. [https://github.com/lifehackerhansol @lifehackerhansol]
* DSWiFi:
** Some minor improvements to the intergration with lwIP.
** Enable and fix some compiler warnings.
* LibXM7:
** Enable and fix some compiler warnings.
* grit:
** Fix <code>dib_pixel_replace()</code> for 32-bit values.
** Added some missing <code>break</code> statements.
** Enable and fix some compiler warnings.
* mmutil:
** Enable and fix some compiler warnings.
* SDK:
** Document more of the behaviour of the exit-to-loader process of the NDS Homebrew Menu and the bootstub struct.
** Enable and fix some compiler warnings in dsltool, teaktool and mkfatimg.
'''v1.14.0'''
* libnds:
** Added a new driver to read the NAND filesystem using standard filesystem functions (like <code>fopen()</code> and <code>fread()</code>). The NAND filesystem is normally mounted in read-only mode, but developers can enable writing to it if required. This is done so that the contents of NAND are protected by default. [https://github.com/edo9300 @edo9300]
** Fix regression causing <code>keysDownRepeat()</code> not report keys on their first press. [https://github.com/edo9300 @edo9300]
** Improve accuracy of <code>dotf32()</code> and <code>crossf32()</code>. In ARM mode their performance has increased. <code>crossf32()</code> is now always built as ARM. [https://github.com/Kuratius @Kuratius]
** Fix a bug that caused <code>rmdir()</code> to be unable to remove empty directories (because they still contained entries <code>"."</code> and <code>".."</code>). Thanks to [https://github.com/edo9300 @edo9300] for the report and [https://github.com/asiekierka @asiekierka] for the fix.
** Added <code>fatGetVolumeLabel()</code> and <code>fatSetVolumeLabel()</code>. [https://github.com/asiekierka @asiekierka]
** Added <code>SDMMC_getCidRaw()</code>. [https://github.com/edo9300 @edo9300]
** Add basic counting semaphore helpers for the cothread module.
** Implement <code>cothread_yield_signal()</code> and <code>cothread_send_signal()</code> to allow threads to sleep until a user-defined event is sent to the scheduler. If all threads are waiting for signals or interrupts the CPU will enter low-power mode.
** Mutexes and semaphores now use signals to yield and to notify other threads of changes to their state.
** Add a function to create an <code>argv</code> struct if the program is running on DSi, the loader hasn't provided a valid <code>argv</code> struct, but there is a valid device list. [https://github.com/edo9300 @edo9300]
** Replaced old FIFO IRQ defines by the new ones.
** Some warnings have been fixed.
* DSWiFi:
** Migrate from sgIP to lwIP. lwIP is being maintained, and it is used by lots of other projects, which means it has been tested properly. It also supports more features than sgIP.
** This migration makes the size of NDS ROMs increse, so the build system of DSWiFi now creates new releases of the library without lwIP. They are useful for developers that only want to use the local multiplayer (NiFi) features of DSWiFi. The new library archives are called <code>libdswifi9_noip.a</code> and <code>libdswifi9d_noip.a</code>.
** One big difference is that programs using DSWiFi will need to use threads. Instead of using <code>swiWaitForVBlank()</code> they will need to use <code>cothread_yield_irq(IRQ_VBLANK)</code>, for example. If they have a loop where they call <code>recv()</code> they will also need to call <code>cothread_yield()</code> at some point in the loop.
** Functions <code>write()</code>, <code>read()</code> and <code>close()</code> now work with socket file descriptors.
** Functions <code>readv()</code>, <code>writev()</code>, <code>recvmsg()</code> and <code>sendmsg()</code> have been implemented.
** Some warnings have been fixed on ARM9 code.
* Maxmod:
** <code>mmPlayModule()</code> has been deprecated because its name is misleading and it expects you to pass the address of the MAS file with an offset. The new function <code>mmPlayMAS()</code> replaces it. It doesn't require the offset, and it has a name more descriptive. <code>mmPlayMAS()</code> is also available in the ARM9, not just the ARM7.
** Fix mode C mixer. Sounds didn't end until they were stopped manually, not when they reached the end of their sample.
** Some small optimizations. [https://github.com/GValiente @GValiente]
** Document some parts of the code.
* mmutil:
** Make the output less verbose by default.
** In module files, if a pattern uses an invalid instrument (with a sample of length zero), the instrument is now removed from the pattern before being exported. This prevents crashes on GBA when playing songs with invalid instruments. A warning is printed for each instance of invalid instruments being used.
** In module files with instrument note maps (supported by IT and XM) mmutil now checks that the samples used in all note map entries are valid. If not, a warning is printed and it is set to 0. The warning is only printed once per sample per instrument.
** Prevent mmutil from exporting more than 200 pattern orders for modules. The MAS format is hardcoded to 200 pattern orders, so any module that has more entries than that will be clamped and mmutil will print a warning.
* SDK:
** In the crt0 of the ARM9, generate an <code>argv</code> struct if the application is running on a DSi, there is no valid <code>argv</code> provided by the loader, but there is a valid device list. [https://github.com/edo9300 @edo9300]
** Add example of how to play MAS files with Maxmod manually without a soundbank.
** Improve example <code>nitrofs_and_fat</code> to also display the contents of the NAND filesystem. It has been renamed to <code>all_filesystems</code>.
** Update DSWiFi examples to work with the new version of DSWiFi.
** Add example of how to wait for signals in multithreading applications.
** Add test of setting and getting filesystem labels.
** Allow building all examples and tests in parallel. [https://github.com/steveschnepp @steveschnepp]
'''v1.13.1'''
* libnds:
** The detection of the official Slot-2 rumble pak (NTR-008) has been fixed. It used to be detected as a SuperCard. Also, the rumble API of libnds is now more flexible when detecting the type of activation of rumble. [https://github.com/asiekierka @asiekierka]
** The enum of IPC commands used by DSWiFi has been moved from libnds to DSWiFi and made private.
** The system monitor of DS debugger units is now preserved during the startup process of libnds. The last 512KB of RAM are reserved so that the heap can't grow too much and overwrite them (they can be used again if the developer manually calls <code>reduceHeapSize(0)</code>). Additionally, libnds won't setup an exception handler if it detects a debugger unit. The developer has to do it manually by calling <code>defaultExceptionHandler()</code>. Thanks [https://github.com/Gericom @Gericom] for the bug report.
* Maxmod:
** Fix instruments with panning and pitch envelope enabled at the same time. Previously, the panning envelope was used for the pitch envelope by mistake.
** On GBA now <code>mmInit()</code> and <code>mmInitDefault()</code> return error if the number of requested channels is bigger than 32. This wasn't supported anyway, and it would have silently failed if allowed.
** The memory used by the panning slide VCMD on XM modules was using the volume slide memory when panning to the right (it used the right memory when panning to the left).
** The memory entries used by effects and volume effects has been documented.
** The IPC command for the ARM9 <code>mmReverbConfigure()</code> function has been simplified. It will now send all parameters in all cases, but this is what users will be using in most cases. In exchange for this, the function becomes a lot smaller and easier to maintain.
** Check a few TODO notes and fix them (or remove them if they didn't need any work).
** In the GBA port, move a function outside of IWRAM. This brings down IWRAM usage to a size lower than the ASM version of Maxmod, and it doesn't affect performance in a noticeable way. [https://github.com/aronson @aronson]
** Remove <code>always_inline</code> attribute from some functions to fix a build error with clang. [https://github.com/GalaxyShard @GalaxyShard]
** In DS mode, using Maxmod commands before initializing it will now show a crash error. This is more informative than simply ignoring commands.
** A critical bug has been fixed on the ARM7. In some cases, it was possible for the ARM7 message handler to be interrupted while editing the state of the circular buffer. This would leave the buffer in an inconsistent state and make the ARM7 treat uninitialized values in memory as legitimate ARM9 commands, causing crashes. Thanks to @pyramidensurfer for a test that managed to reproduce the error reliably.
** The ARM7 communications code is now built as Thumb instead of ARM to save space.
** The GBA version of Maxmod is now built with a format of debug symbols that no$gba can understand.
* DSWiFi:
** The enum of IPC commands used by DSWiFi has been moved from libnds to DSWiFi and made private. Some commands weren't used and they have been removed.
** <code>Wifi_InitDefault()</code> now takes an int as argument instead of a bool. This lets the function get more flags in the future if they are implemented. Old C code using true or false will still work.
** Lots of functions have been made private: Everything that has to do with manual initialization and synchronization between CPUs. Making this code private gives DSWiFi more flexibility to refactor the code.
** The initialization code of the library has been cleaned up and simplified.
** It is now possible to deinitialize DSWiFi with <code>Wifi_Deinit()</code>. This will keep the sgIP memory pool still in the heap, but it will free all other resources. sgIP can't be reinitialized safely at the moment.
** <code>Wifi_InitDefault()</code> now accepts flags <code>WIFI_DISABLE_LED</code> and <code>WIFI_ENABLE_LED</code> to let DSWiFi know if it can control the LED blinking or not. By default, the LED is controlled by DSWiFi.
** <code>Wifi_InitDefault()</code> now accepts flags <code>WIFI_INTERNET_AND_LOCAL</code> and <code>WIFI_LOCAL_ONLY</code>. It makes it possible to initialize DSWiFi without sgIP if the game isn't going to connect to the Internet. This saves over a 100 KBs of RAM in games that only want to setup a local multiplayer game. DSWiFi can be de-initialized and re-initialized in "local only" or "internet and local" modes whenver your application requires it. The documentation has been updated to reflect the new improvements.
** Some static arrays used by sgIP are now allocated dynamically when the library is initialized. They are also freed when it is de-initialized.
* mmutil:
** Change version number. Now it's set from the environment instead of a hardcoded variable in the Makefile.
** Fix pattern flags when notes have non-empty volume. This bug was introduced in version 1.12.0. Thanks [https://github.com/GValiente @GValiente] for the bug report and [https://github.com/asiekierka @asiekierka] for the help.
* SDK:
** The local multiplayer example of DSWiFi now initializes DSWiFi without sgIP so to save RAM.
** Use C23 and C++23 to build all the ARM libraries.
** GCC has been patched to always build <code>__aeabi_lmul</code> in ARM mode, even for Thumb targets. This always leads to smaller and faster 64-bit multiply operations. [https://github.com/asiekierka @asiekierka]
** picolibc has been updated with minor fixes to the <code>printf</code> function family.
'''v1.13.0'''
* libnds:
** A new function to control the LCD backlight level has been implemented, <code>systemSetBacklightLevel()</code>. It works on DS, DS Lite and DSi.
** Add a helper to set the master sound volume from the ARM9 called <code>soundSetMasterVolume()</code>.
** videoGL functions now copy textures and palettes to VRAM using <code>memcpy()</code> instead of DMA copies. This will allow interrupts to happen while the copy is taking place instead of blocking the interrupts.
** FatFs has been updated to R0.16. Also, <code>stat()</code> now returns the actual creation timestamp of the file instead of using the time of the last access or modification. [https://github.com/asiekierka @asiekierka]
** libnds now checks that TLS isn't used from IRQ handlers. This is only checked in debug builds of libnds because it would affect performance of some applications.
** Add support for compile-time evaluation of the <code>math.h</code> functions. [https://github.com/Kuratius @Kuratius]
** <code>errno</code> handling has been fixed in <code>scandir()</code>. [https://github.com/shinyquagsire23 @shinyquagsire23]
** Fix memory leak in <code>open()</code> when a file is failed to be opened. [https://github.com/shinyquagsire23 @shinyquagsire23]
** Return 0 as modification and access dates of NitroFS files instead of leaving the fields uninitialized.
** Don't clear <code>errno</code> in <code>readdir()</code>. [https://github.com/asiekierka @asiekierka]
** Add new ARM7 audio defines that are less confusing than the previous ones. They are based on the names used by GBATEK. The audio helpers of libnds now use the new defines.
** The FatFs submodule link has been changed. If you want to update your current clone of BlocksDS you will need to manually edit <code>.git/modules/libs/libnds/modules/fatfs/config</code> and change the URL to "blocksds" instead of "WonderfulToolchain". You can also do a fresh clone.
** Some Doxygen comments with missing information have been completed.
** The internal function <code>vramGetBank()</code> has been improved with error checking.
** Some videoGL code has been documented.
* Maxmod
** The port to C has been completed. The only code left in assembly is the one that does software audio mixing on the GBA and the ARM7 of the DS. All of the definitions to access structures from assembly code have been deleted (except for the ones needed for the software mixing code).
** Some functions now return error codes instead of <code>void</code>: <code>mmInit()</code>, <code>mmInitDefault()</code>, <code>mmInitDefaultMem()</code>, <code>mmLoad()</code>, <code>mmUnload()</code>, <code>mmLoadEffect()</code> and <code>mmUnloadEffect()</code>.
** In the GBA port Maxmod can now be deinitialized with <code>mmEnd()</code>. This isn't possible on DS yet.
** Helpers <code>mmGetModuleCount()</code> and <code>mmGetSampleCount()</code> have been added to get the number of modules and samples available in the loaded sound bank. They are available from both CPUs. Previously, it was only possible on the ARM9, and only by accessing internal variables of Maxmod.
** The following functions now check if the provided ID is out of bounds: <code>mmEffect()</code>, <code>mmEffectEx()</code>, <code>mmStart()</code>, <code>mmJingle()</code>, <code>mmLoad()</code>, <code>mmUnload()</code>, <code>mmLoadEffect()</code> and <code>mmUnloadEffect()</code>.
** All arrays have been marked as <code>const</code>. Some functions have been moved back from IWRAM to ROM. This has no effect in the DS port, but it helps the GBA port reduce IWRAM usage.
** Several comments have been added to the code.
** The code now uses the struct definitions of the headers instead of using magic numbers and assembly defines. Several variables have been modified to use the right types (for example, instead of using a <code>void</code> pointer, they use now pointers to the right type of struct).
** A small bug when handling module channel bflags has been fixed.
** Fix the way in which the code that handles DCT accesses the instrument note map. This is a bug carried on from the assembly code.
** <code>mmSetPosition()</code> is now available on the DS, not just the GBA.
** <code>mmJingleStart()</code> and <code>mmJingleStop()</code> have been implemented. They behave like <code>mmStart()</code> and <code>mmStop()</code>, so now jingles can also be played in a loop and they can be stopped at any point.
** <code>mmJinglePause()</code> and <code>mmJingleResume()</code> have been implemented.
** <code>mmJingleActive()</code> has been implemented.
** <code>mmPosition()</code>, <code>mmJingle()</code> and <code>mmActiveSub()</code> have been deprecated. Use <code>mmSetPosition()</code>, <code>mmJingleStart()</code> and <code>mmJingleActive()</code> instead.
** <code>mmGetPosition()</code> and <code>mmGetPositionRow()</code> have been implemented on the ARM9. The ARM7 refreshes the position once per frame, so the tick counter can easily skip values from the point of view of the ARM9. For that reason, <code>mmGetPositionTick()</code> hasn't been implemented.
** Sound effect handling has been heavily refactored. The ARM7 code that creates and reuses handles is now cleaner. The code that synchronizes the state of the sound effects from the ARM7 to the ARM9 has been removed. Now, the ARM9 sends messages to the ARM7 and it waits for the ARM7 to send the resulting handle to the ARM9. The previous system generated handles on the ARM9, which could cause channels to become permanently marked as "busy" on the ARM9 even if they were free on the ARM7.
** <code>mmEffectCancel()</code> and <code>mmEffectCancelAll()</code> now work properly on DS.
** <code>mmEffectCancelAll()</code> can now stop released sound effects.
** <code>mmEffectRelease()</code> now has a big warning in the documentation mentioning that any effect that has been released can only be stopped by itself, by another effect or module, or by <code>mmEffectCancelAll()</code>. It can't be stopped by <code>mmEffectCancel()</code>.
** A bug has been fixed where there could be memory corruption if a new active channel was requested but no more channels were available.
** In the documentation, create individual section for functions related to jingles. Keeping them in a different page than the functions for the main module means it's easier to see the limitations of jingles.
** Events of type <code>MMCB_SONGMESSAGE</code> now include the layer (<code>MM_MAIN</code> or <code>MM_JINGLE</code>) as part of the data passed to the callback. This is a compatibility break, but it's very unlikely that anyone is getting events from a jingle, so it's very unlikely to break any project. Events are rarely used, so the probability of ever finding a compatibility issue is almost 0.
** Fix a crash that would happen when playing modules or jingles with more channels than allocated by Maxmod. Now, when Maxmod detects that the module (or jingle) tries to use a channel that is outside of the limits, it will just stop the song.
** <code>mmSetPatternEx()</code> has been implemented, which lets the caller specify the new pattern order and row, not just the order like with <code>mmSetPattern()</code>.
** Build library with <code>-Os</code> instead of <code>-O2</code> in the ARM7 of the NDS to save memory.
* mmutil:
** Some error checks have been added to prevent crashes if files can't be opened or an output path isn't provided. The application will now exit gracefully.
** Some magic numbers have been replaced by defines extracted from Maxmod. The code has been documented a bit.
** Some warnings have been fixed.
** The code has been reorganized. Variables now have reduced scopes instead of having whole functions as their scope.
** The command to build NDS test ROMs has been fixed in the documentation.
** The names of the temporary files created by the tool is no longer hardcoded. This makes it possible to execute mmutil multiple times from the same folder without conflicts.
* DSWifi:
** Update instructions of how to enable debug output.
** Build library with <code>-Os</code> instead of <code>-O2</code> to save memory.
* LibXM7:
** Use new libnds ARM7 audio defines.
* SDK:
** GCC has been updated to version 15.2.0 and binutils has been updated to version 2.45. [https://github.com/asiekierka @asiekierka]
** The default makefiles now print the mmutil command in verbose mode (<code>V=</code>).
** The documentation now has a note about symlinks not working with MinGW.
** Some Maxmod examples have been improved.
** An example has been added to show how to set the LCD brightness level on different DS models.
'''v1.12.0'''
* libnds:
** Rename symbols of FatFs inside libnds so that users can have their own copy of FatFs. [https://github.com/asiekierka @asiekierka]<br />

** Improve <code>normalizef32()</code>: Fix normalization of large and small vectors and optimize its performance. [https://github.com/Kuratius @Kuratius], [https://github.com/19tracks @19tracks]<br />

** Fix base address of the bootstub struct.<br />

** Clarify documentation about how <code>keysDownRepeat()</code> works.<br />

** Move some key state handling to critical sections to prevent race conditions.<br />

** Fix implementation of <code>swiIntrWait()</code> on both CPUs. It has been rewritten in C and moved to the common folder so that both CPUs use the same implementation.<br />

** Two defines have been added for <code>swiIntrWait()</code>: <code>INTRWAIT_KEEP_FLAGS</code> and <code>INTRWAIT_CLEAR_FLAGS</code>.<br />

** Improve FIFO communications code:
*** In FIFO wait loops, don't discard current interrupts flags when calling <code>swiIntrWait()</code>. If a FIFO interrupt has happened, exit the wait loop right away.
*** In <code>fifoWait*()</code>, check <code>REG_IME</code> before calling <code>swiIntrWait()</code>. If interrupts are disabled, skip the wait. <code>swiIntrWait()</code> enables interrupts internally, and this may be an issue for code that relies on interrupts being disabled. The only side-effect of not calling <code>swiIntrWait()</code> is that the CPU won't be able to enter low-power mode.
*** Fix some race conditions by moving some code and checks to critical sections.
*** Add some new definitions related to FIFO interrupts that are clearer than the previous ones.
*** Prevent deadlocks in some situations. For example, if the software RX queue was almost full, the hardware RX queue is half emptied in the IRQ handler, but it can't be completely emptied, the FIFO code would never check the hardware RX queue again. There were similar situations with the TX queue. The new code adds checks for the RX and TX hardware queues in some other places (like <code>fifoCheck*()</code> or <code>fifoInternalSend()</code>) that are likely to be executed in any potential user wait loop.
*** The FIFO buffer has been renamed to global FIFO pool. The send and receive queues have been renamed to RX and TX queues.
*** Fix global pool corruption when the pool got filled with packets that hadn't been handled. The code that allocates and frees blocks from the pool can't handle the situation in which zero blocks are left, so the new code makes sure that there is always at least one free block in the pool.
*** The code has been documented, and things like the global pool of blocks have been refactored to be much clearer.
*** Unknown system FIFO commands will now crash the application instead of being ignored.
** Improve cothread system:
*** Show a crash message when trying to remove a nonexistent cothread context.
*** Optimize <code>cothread_yield_irq()</code>.
*** Prevent <code>cothread_yield()</code>, <code>cothread_yield_irq()</code> and <code>cothread_yield_irq_aux()</code> from inside interrupt handlers. Instead of yielding, <code>cothread_yield()</code> returns right away, and the others call <code>swiIntrWait()</code> instead.
*** <code>swiIntrWait()</code> is now only called if <code>REG_IME=1</code>. If not, it is skipped.
** Refactor global IRQ handler:
*** Remove the <code>irqDummy()</code> function, use <code>NULL</code> pointers instead.
*** Use fewer cycles to exit the handler when there isn't an user interrupt handler assigned to the interrupt.
*** Optimize code that wakes up threads waiting for an interrupt, preventing racen conditions.
** Compile <code>getHeap*()</code> functions on the ARM7 too. [https://github.com/asiekierka @asiekierka]<br />

* Maxmod:
** Fix Portamento + Volume Slide effect.
* Grit:
** Crash if mode append is selected but it's not allowed due to other settings. In the past, grit would just overwrite the invalid setting without warning the user.
** Add note to the documentation about how it is better to reduce quality of graphics before passing them to grit than to let grit reduce the quality.
* SDK:
** Documentation:
*** Add a section to the "Usage notes" page about how to move the DTCM user variables to the end of DTCM using the <code>__dtcm_data_size</code> symbol.
** Examples:
*** Fix example of streaming audio with Maxmod. Instead of reading the file from the Maxmod callback handler (which is inside an interrupt handler) the example now keeps a circular buffer. The main loop writes new data read from the file and the interrupt handler reads the data and sends it to Maxmod.
*** Add example of displaying a 4 BPP tiled background. Rename the previous <code>bg_regular</code> example to <code>bg_regular_8bit</code> to clarify that it loads a 8 BPP tiled background.
*** Add example of creating an FPS counter.
*** Add example of how to use the VBL interrupt.
*** Improve C++ example to also run on the ARM7.
*** Add example of how to use DMA to do HBLANK scroll effects.
*** Add example of how to save and load data from the filesystem.
*** Improve <code>key_input</code> example to show the values returned by <code>keysDownRepeat()</code>.
*** Fix build of the example that prints no$gba debug messages from both CPUs. Floating point support has been removed from <code>printf()</code> on the ARM7 to save space.
** Tests:
*** The exit to loader test has been fixed (even though the exit code doesn't work properly yet).
*** Add a test to see how to exit CPU halt state with IRQs.
*** Add a test to see the effect of deleting threads in different ways.
*** Add a test to check that CPU contexts are preserved after returning from a cothread yield.
*** Add a test to check the behaviour of the FIFO handling code when the FIFO hardware and software queues are full.
*** Some test folders have been moved around for clarity.
*** Add test of using the <code>__dtcm_data_size</code> symbol.
** Other:
*** Modify the default makefiles to allow the user to specify additional <code>LDFLAGS</code> when including them.
'''v1.11.1'''
* libnds:
** Fix a bug that would crash the application if <code>__aeabi_atexit()</code> was called when a dynamic library isn't being loaded.
* SDK:
** Fix linker scripts to include the picolibc hook that calls all functions registered with the <code>atexit()</code> family of functions. This also affected global destructors, which weren't called at exit. [https://github.com/asiekierka @asiekierka]
** Improve C++ example to test global destructors in addition to global constructors.
'''v1.10.1'''
* SDK:
** Other:
*** Global initializers have been fixed for picolibc 1.8.10.
*** Fix conflicting types when including <code>math.h</code> instead of <code>cmath</code> from C++ files.
'''v1.10.0'''
* Maxmod:
** Most of the files of the library have been converted from assembly to C to help people understand, maintain and improve the code. The remaining assembly code is the software mixing code of the ARM7 (on both DS and GBA modes) and the song player code (which is too big to convert in one go and it will require more work in the future). Both the GBA and DS ports have been tested. Thanks to [https://github.com/Lorenzooone @Lorenzooone] for all his work!
** Some error checks have been added to code that didn't have it (like all code using <code>fopen()</code>, <code>fread()</code> or <code>malloc()</code>.
** Code that allocates memory now uses <code>calloc()</code> instead of <code>malloc()</code> to clear the buffer before using it.
** The unused Value32 FIFO handler code in the ARM7 has been removed.
** Cache management has been fixed. The cache handling functions of Maxmod were incorrect, and they have been removed. Now Maxmod uses the functions of libnds.
** IPC code that synchronized streaming between ARM7 and ARM9 has been improved. Instead of using shared memory to synchronize CPUs, new FIFO messages have been implemented. The old code required dangerous cache management that could corrupt variables surounding the "ready" flag used by the library.
* SDK:
** Other:
*** GCC has been updated to version 15.1.0 in Wonderful Toolchain. You can check the release notes [https://gcc.gnu.org/gcc-15/changes.html here]. An important addition is the support for <code>#embed</code>.
*** picolibc has been updated to version 1.8.10 in Wonderful Toolchain. Check the release notes [https://github.com/picolibc/picolibc/releases/tag/1.8.10 here].
** Examples:
*** A new example of how to use sound effects with Maxmod has been added.
*** The Maxmod streaming example has been fixed to not hang in DSi consoles or DS consoles with DLDI running on the ARM7.
*** The reverb Maxmod example has bee improved with a new song that makes the effect more evident.
*** The "sprites" example has been renamed to "sprites_regular" for clarity. Also, 128 KB sprite mapping mode is now used in this example, as this is what most developers would want in their own code.
*** Some comments have been added to the libnds sound example.
*** A missing example description has been added.
'''v1.9.0'''
* libnds:
** Add initial helpers to load dynamic libraries with <code>dlfcn.h</code> functions. Note that this is still experimental. <code>dlopen()</code>, <code>dlsym()</code>, <code>dlerror()</code> and <code>dlclose()</code> are supported.
** Fixed global C++ constructors that require libnds and the cothread scheduler to be initialized. Some functions previously called from the crt0 have been moved to <code>cothread_main()</code>, which runs after there is a valid multithreading environment.
** Deallocate memory reserved for the FAT file system cache if <code>fatInit()</code> fails.
** Extend <code>statvfs()</code> to return the <code>ST_RDONLY</code> flag for read-only media.
** File system operations should now return <code>EROFS</code> for read-only DLDI drivers.
** Made <code>libndsCrash()</code> public.
** Fix potential issues involving FAT file system cache initialization.
** Add some checks to libc system call functions like <code>open()</code>.
* DSWifi:
** Fix <code>ioctl(FIONREAD, x)</code>, which used to return <code>EINVAL</code> even when it succeeded.
** Remove Access Points from the list of availabled APs after enough time has passed without receiving any beacon packet from them. <code>Wifi_GetData()</code> and <code>Wifi_GetAPData()</code> have been updated to work with the changed system.
** The array that specifies the order in which channels are scanned has been modified so that each channel is scanned the same number of times. This makes it easier to determine which APs to remove from the list of APs because we aren't prioritizing APs from any channel. Also, scan mode now always start with channel 1.
** Old RSSI values of APs are now discarded instead of being used to average the value of the RSSI. This doesn't really affect how the values behave in real life that much, so this change saves memory with no noticeable change in the behaviour of the library.
** Return error on timeouts when writing to baseband chip.
** Add error checks when initializing RF chip.
** Print debug message if the ARM7 TX queue is full when the library tries to add a new packet to it.
** Some documentation improvements.
* dsltool:
** Introduced tool to the repository. This tool is used to convert dynamic libraries in ELF format to DSL format, which is similar to ELF, but simplified. This DSL format can be loaded by libnds with <code>dlopen()</code>.
* teaktool:
** Ensure that ELF files are loaded correctly instead of crashing if they aren't loaded and the pointer is NULL.
** Fix format in a printf.
* SDK:
** Documentation:
*** The new dynamic library system has been documented in the main documentation of BlocksDS.
** Examples:
*** Three new examples have been added to show how to use the new dynamic library system.
** crts:
*** Some initialization has been moved away from the crt0 of the ARM9 to libnds to fix global C++ constructors that require libnds and the cothread scheduler to be initialized.
*** A new linkerscript to build dynamic libraries has been added.
** Other:
*** Libraries are now built with debug symbols (<code>-g</code>) to help debug applications made with them.
'''v1.8.1'''
* libnds:
** Add a helper to convert UTF-16LE text (like the firmware player name and message) to UTF-8.
** Modify <code>assert()</code> on the ARM7 to send the information to the ARM9 instead of displaying it on the no$gba console.
** Added <code>swiIntrWaitAUX()</code> for the ARM7.
** The Doxygen documentation of interrupt functions has been fixed.
** The documentation of the firmware personal data has been improved with a warning saying that the struct may not be initialized right af the beginning of <code>main()</code> on the ARM9.
** Always use <code>fake_heap_start</code> and <code>fake_heap_end</code> in <code>sbrk()</code>.
** Some assertions in the timer functions were missing checks for values lower than zero, this has been fixed.
** All instances of <code>sassert()</code> in common ARM7 and ARM9 code have been replaced by <code>assert()</code>.
* DSWifi:
** Add player name information to beacon packets, and add it to the <code>Wifi_AccessPoint</code> struct so that clients can see it. This name can be replaced by any string defined by the developer if required.
** Add way to get the RSSI of the AP we're connected to. It can be done by calling <code>Wifi_GetData(WIFIGETDATA_RSSI)</code>. [https://github.com/snowshoe @snowshoe]
** Always include <code>ASSOCSTATUS_STRINGS</code> array in builds. It used to be removed in builds without sgIP.
** Some minor documentation fixes.
* grit:
** Update documentation (command line interface and changelog).
** Let the build system define the version string compiled in the binary.
* SDK:
** Examples:
*** In DSWifi examples, print multiplayer access points in color red when they aren't accepting new connections. Also, display the player name provided by the beacon frames.
*** There's a new test to verify that <code>sbrk()</code> works correctly in both the ARM7 and ARM9.
*** Update the asserts example to show that asserts that happen in the ARM7 are sent to the ARM9 and displayed on the screen.
** Documentation:
*** Document flag used for "twl" sections in ndstool and the linkerscripts.
** Other:
*** Remove duplicated <code>__end__</code> entries in ARM7 linkerscript files.
*** The fake heap pointers are now setup on the ARM7, not only the ARM9.
*** The fake heap limit setup has been documented.
*** The R4RF DLDI driver included in the SDK has been updated.
*** Update CMake build system to link the debug version of libnds in debug builds.
'''v1.8.0'''
* libnds:
** videoGL now tracks the number of textures using a palettes correctly. Previously, palettes would be deleted even when there were textures using them. [https://github.com/sillysagiri @sillysagiri]
** <code>scanf()</code> has been fixed so that it doesn't record modifier keys on the output string.
** Fix <code>readFirmware()</code> and <code>writeFirmware()</code> on the ARM9. They would silently fail when the source or destination buffer wasn't in main RAM (for example, when the buffer was in the stack in DTCM) because the ARM7 can't access other memory regions. Now, the functions will allocate temporary buffers to transfer data between the ARM7 and ARM9. Also, now they use a mutex so that they are thread-safe.
** FatFs has been updated to version R0.15ap1.
** The values used by <code>ledBlink()</code> have been documented as an enum.
** There's a new define for the WiFi hardware in <code>REG_POWERCNT</code>.
** There are new definitions for GRF files to specify background types.
** <code>consoleVprintf()</code> is now exposed on the ARM7.
** In the GRF struct there used to be a byte of padding in the struct that wasn't documented. It has now been explicitly documented as padding.
** A helper has been added to check if a buffer is inside of main RAM.
** Some unused internal FIFO command names have been removed.
* DSWifi:
** Local multiplayer support has been added (NiFi). One DS acts as a multiplayer host (Access Point) and the other consoles connect to it.
** The old operation mode has been renamed "Internet mode". It is possible to switch between Internet and local multiplayer modes depending on the needs of the application.
** Scan mode now works differently. In Internet mode it shows all Access Points. In local multiplayer mode it only lists multiplayer hosts, in Internet mode the behaviour remains unchanged.
** CMD/REPLY packet transmit support has been added to the library. This is a way to transfer data between a host and many clients more efficiently. However, regular data packets can still be sent between multiplayer clients and the host if the CMD/REPLY system isn't adequate for the application.
** Beacon packet transmission is now properly supported and documented. The packets advertise the number of players currently connected to a host DS and whether the host accepts new connections or not. It also shows the game ID defined by the user, which is used to identify the right AP for a game.
** When connecting to an Access Point, DSWifi is now honest about the transfer rates supported by the DS. If the AP rejects the connection, it will retry with all the rates defined in the IEEE 802.11b standard (even though only the first 2 out of the 4 are supported), which helps the AP accept the DS.
** Many new multiplayer-related functions have been added to the library.
** New documentation has been added, which explains how the library works internally, and how to use DSWifi in Internet and local multiplayer mode.
** Huge refactor of ARM7 code and the corresponding ARM9 code that communicates with the ARM7. sgIP has been largely untouched. The code has been split into several files, and there is now a clearer split between sgIP and the rest of DSWifi.
** The helper functions to read the firmware and to set the LED blink status have been removed. Now DSWifi calls the libnds functions instead.
** Functions have been documented, IEEE 802.11 frame formats have been documented.
** There are new defines for hardware registers based on GBATEK, and new defines for the fields in the hardware registers that are in used. The [https://melonds.kuribo64.net/board/thread.php?id=34 melonDS forums] have a lot of information (by [https://github.com/Arisotura @Arisotura]) that has also been used as source when documenting register fields (like <code>W_RXFILTER</code> and <code>W_RXFILTER2</code>).
** Debug messages have been added to the ARM7 code of the library. They are only available in debug builds.
** WEP password usage has been documented. It wasn't clear how to use Hex/ASCII passwords.
** Some unused fields of the <code>WifiData</code> struct have been removed.
** Private definitions have been removed from public headers.
* grit:
** Update GRF export code to use the new background type definitions proposed by [https://github.com/Garhoogin @Garhoogin] in [https://github.com/Garhoogin/ptexconv/issues/3 ptexconv].
* SDK
** Examples:
*** New DSWifi examples have been added, including local multiplayer examples that show how to send CMD/REPLY packets and regular data frames of arbitrary sizes.
*** The WEP password input in the AP list example has been improved. The output of the example has also been improved.
*** The "get website" example now uses socket-related functions the way DSWifi expects them (<code>closesocket()</code> instead of <code>close()</code>).
*** The templates and examples now use the new LED defines.
** Documentation:
*** The documentation of DSWifi now explains how to use the Internet and local multiplayer modes, as well as how the library works internally.
*** The licensing requirements of some libraries (picolibc, libstdc++) has been clarified by [https://github.com/asiekierka @asiekierka].
** Other:
*** New debug ARM7 cores have been added. They use the debug versions of libnds and DSWifi.
*** The CMake build system now uses a linker group for the standard libraries to prevent linking errors due to circular dependencies. Also, banner title formation has been improved.

'''v1.7.3'''
* libnds:
** Use custom version of <code>swiSoftReset()</code> instead of instruction <code>swi #0</code> to prevent crashes on DSi mode, where <code>swi #0</code> isn't implemented.
** <code>swi*()</code> functions that don't actually use <code>swi</code> instructions (because of bugs in the implementation in the BIOS) have been documented.
** <code>nitroFSInit()</code> now sets <code>errno</code> correctly if there is no NitroFS filesystem in the ROM.
** The DSi mode checks of <code>soundExtSetFrequencyTWL()</code> have been moved out of <code>twl</code> sections so that this function can be safely called even in DS mode (even if it doesn't have any effect).
** Calling <code>irqSet(flags, NULL)</code> or <code>irqSetAUX(flags, NULL)</code> is now safe. Previously, this would cause <code>NULL</code> to be used as interrupt handler instead of disabling the interrupt handler as expected.
** The type <code>IntFn</code> has been deprecated in favour of <code>VoidFn</code>. Even the <code>interrupts.h</code> header didn't use <code>IntFn</code>, it was only used internally in <code>interrupts.c</code>.
* SDK:
** Docker:
*** The Docker images are now built in a GitHub Actions pipeline in the SDK repository instead of locally in the computers of the developers.
** Examples:
*** In the LibXM7 example that uses NitroFS, set pointer to <code>NULL</code> when it stops being used so that the program keeps track of whether songs are playing or not. This fixes a crash when trying to start a song after stopping a song.
** Documentation:
*** Document the release process for new BlocksDS versions.
*** Document the existence minimal ARM7 core.
*** Remove references to scripts related to the release process used before using GitHub Actions.
*** Add link to <code>ndslib-archive</code> repository so that it can be used as reference to understand old NDS homebrew source code.
*** Clarify how to build examples in the setup instructions.
** Other:
*** Use the right system header in <code>dldipatch</code> to fix a compiler warning.
*** PAlib is now available as a pacman package: <code>blocksds-palib</code>
'''v1.7.2'''
* libnds:
** Fix compilation error due to incorrect names of slot-2 rumble functions.
** Add debug assertions to check that <code>cothread_yield_irq()</code> is never called with interrupts disabled (when <code>IME</code> is 0).
** Small optimization in <code>cothread_yield_irq()</code> wait loop on the ARM9.
** Add helper constants for <code>swiUnpackBits()</code>.
** Implement <code>getBatteryLevel()</code> on the ARM7 to mirror the ARM9 implementation.
** Add function to check if FatFs cache has been initialized or not.
** Fix code to read official cartridges from the ARM7. The previous code wasn't able to read data when the destination was in the stack (DTCM isn't visible by the ARM7).
** Add error checks on the ARM7 to crash if DLDI is used before being setup.
** Fix undefined C behaviour with some left shifts.
** Add missing system include to ARM7 console header.
* SDK:
** ARM7:
*** Restructure default ARM7 code to allow for multiple built-in ARM7 cores. Add <code>ARM7ELF</code> to the default makefiles to easily select the ARM7 core. Thanks, [https://github.com/GalaxyShard @GalaxyShard].
** Documentation:
*** Document the new pre-built ARM7 cores.
** Examples:
*** Use the new pre-built ARM7 core in LibXM7 examples instead of custom ARM7 cores.
*** Update the BIOS bit unpack example to use the new constants introduced to libnds.
** Other:
*** In the makefiles of DSWiFi, LibXM7 and Maxmod use <code>ar</code> from the ARM toolchain rather than the host to build the library.
*** Improve scripts to release new SDK versions.
'''v1.7.1'''
* libnds:
** Fixed a bug where some assembly functions would be removed by the linker. This happened when a function is supposed to fall through the following one, but it is in a different section. If this other section isn't referenced anywhere, the linker would remove it.
** A new system to send formatted text messages from the ARM7 to the ARM9 has been implemented. This works by using a ring buffer in main RAM that is allocated from the ARM9, so the user can adjust its size easily. This is still being tested and it may change.
* SDK:
** Docker:
*** Install BlocksDS from pacman packages instead of building it from source. This will make it easier to install other third-party packages. It won't be needed to build them from source and install them, you will be able to simply install the package. The slim image only has the <code>blocksds-toolchain</code> package, the dev image has all the <code>blocksds-*</code> packages.
** Documentation:
*** Update setup instructions.
** Examples:
*** New example of how to use the ARM7 console to print text on the screen.

'''v1.7.0'''

'''IMPORTANT NOTICE'''

If you're updating your previous BlocksDS installation with <code>wf-pacman</code>, run this command twice instead of once:

<pre class="language-shell">wf-pacman -Syu
</pre>
This is required because of the new repository that contains the BlocksDS pacman packages.

'''Changelog'''

<ul>
<li>libnds:
<ul>
<li>An exception handler has been added to the ARM7. This one is a lot less useful than the ARM9 one because it's only called on undefined instructions and internal libnds errors.</li>
<li>Add <code>dldiRelocate()</code>, which allows relocating a DLDI driver to a different memory address.</li>
<li>Fix DLDI memory pointers not being relocated for non-BSS/noinit areas.</li>
<li>Update FatFs to R0.15a.</li>
<li><code>glColorSubTableEXT()</code> now supports allocating empty palettes by passing a NULL pointer in the <code>table</code> argument. This is a small compatibility break because this used to free the palette. However, the old behaviour stays as long as <code>width</code> is 0. In most cases, <code>table</code> would be NULL and <code>width</code> would be 0, so this change is only a problem in unusual cases.</li>
<li>Disable MPU safely before calling the exit-to-loader ARM9 hook in case the hook doesn't do it properly.</li></ul>
</li>
<li>maxmod:
<ul>
<li>Remove non-standard <code>.struct</code> directives.</li></ul>
</li>
<li>SDK:
<ul>
<li>picolibc:
<ul>
<li>Add <code>asnprintf()</code> and <code>vasnprintf()</code>, matching newlib.</li>
<li>Fix memory leak in <code>asprintf()</code> and <code>vasprintf()</code>.</li></ul>
</li></ul>
</li>
<li>ndstool:
<ul>
<li>Add a default icon for new <code>.nds</code> files, preventing the generation of invalid banners.</li>
<li>Add support for extracting static <code>.nds</code> icons as <code>.bmp</code> files.</li>
<li>Allow specifying <code>-bt</code> without a language ID.</li>
<li>Fix the <code>-n</code> (latency) argument being a no-op, add corresponding <code>-n1</code> argument.</li>
<li>Fix the <code>-fh</code> (fix header CRC) command not working with TWL-enhanced <code>.nds</code> files.</li></ul>
</li>
<li>Docker:
<ul>
<li>curl has been added to both the development and slim images.</li>
<li>Add new BlocksDS pacman repository during setup.</li></ul>
</li>
<li>pacman:
<ul>
<li>The pacman server of BlocksDS is now independent from Wonderful Toolchain.
<ul>
<li>The repository with the package build files is now in the BlocksDS GitHub organization in this URL: https://github.com/blocksds/packages<br />
</li>
<li>BlocksDS still uses Wonderful Toolchain as source for the compiler and the standard C and C++ libraries. It will keep using wf-pacman for the forseeable future as well.<br />
</li>
<li>Special thanks to asie for all his help.<br />
</li>
<li><p>Updating old installations requires the user to run the following commands:</p>
<pre class="language-shell">wf-pacman -Sy wf-pacman
wf-pacman -Syu
wf-pacman -Syu
</pre></li></ul>
</li>
<li>New libraries are now available as pacman packages (µLibrary, libwoopsi, dsmi) as well as the tool ptexconv.<br />
</li>
<li>The GitHub pipeline of the SDK repository has been removed and added to the packages repository.<br />
</li></ul>
</li>
<li>Documentation:
<ul>
<li>Update documentation with the instructions to use the new pacman repository.</li>
<li>Some outdated licensing information has been updated.</li>
<li>The docs generation script has been split into a script that generates it and a script that pushes the built documentation to the repository.</li>
<li>The updating guide has been updated for versions between 1.3.0 and 1.7.0.</li></ul>
</li>
<li>Examples:
<ul>
<li>New example of gesture recognition using the $N Multistroke Recognizer.</li>
<li>New example of how to use CMake to build a project with BlocksDS.</li>
<li>Update the exception handler example to also support triggering ARM7 exceptions.</li></ul>
</li>
<li>Other:
<ul>
<li>BlocksDS now has a dedicated URL (https://blocksds.skylyrac.net/) which means that it doesn't rely on GitHub URLs anymore. This main page redirects to the documentation, GitHub organization, and a NDS homebrew development manual.</li>
<li>A new prototype CMake build system has been added to the repository.</li>
<li><code>CC</code> makefile variables have been renamed to <code>HOSTCC</code> when they refer to building host tools. This will make it possible to overwrite the host toolchain without also overwriting the ARM toolchain.</li>
<li>Use standard C types and fix includes in mkfatimg.</li>
<li>bin2c now has an option (<code>--noext</code>) that lets it export files excluding the extension from the name, the way some very old homebrew projects expect it.</li>
<li>Some sample defines have been added to the makefiles of the templates to clarify its syntax.</li></ul>
</li></ul>

'''v1.6.3'''
* libnds:
** Add compile-time warnings about unused result values to various library methods.
** Ensure <code>nitroFSInit()</code> checks for successful FAT initialization.
** Protect the alternate vector base region (<code>0x0000000</code> onwards) from writing and, if said base is not explicitly enabled, reading. This allows catching null pointer accesses at runtime as data aborts.
* SDK:
** crt0:
*** Fix thread-local storage not being initialized properly during global constructor initialization.
*** Fix thread-local storage not being initialized at all on ARM7.
** picolibc:
*** Add <code>memset_explicit()</code>.
*** Improve wctype compatibility.
*** Update ctype case conversion table to Unicode 15.1.0 .
** Other:
*** Add regression test for <code>setVectorBase()</code>.
*** Modify templates to use toolchain <code>gcc-ar</code> over host <code>ar</code> for packaging libraries; this ensures correct operation on systems without <code>binutils</code> installed, as well as when building libraries with link-time optimized objects.
*** Update ARM assembly code to always use UAL syntax.
*** Update official Docker image to Ubuntu 24.04.
'''v1.6.2'''
* libnds:
** Filesystem:
*** Fixed a bug involving incorrect reads of recently written sectors.
* SDK:
** Changes to examples:
*** Clean the 8-bit double-buffered bitmap example.
** Other:
*** Improve FAQ and updating guide.
'''v1.6.1'''
* libnds:
** Filesystem:
*** This version was supposed to include a fix for a bug involving incorrect reads of recently written sectors, but the submodule wasn't updated correctly so the fix was left out.
'''v1.6.0'''
* libnds:
** Peripherals:
*** Add support for the "retail" (ATTiny-based) Motion Pack accelerometer to the DS Motion Card/Pak driver.
*** Clean up the DS Motion Card/Pak driver.
*** Fix the DS Motion Card driver not working on DSi consoles.
*** Fix the solar sensor not being detected on Boktai 1 cartridges.
*** Fix <code>peripheralSlot2SolarScanFast()</code> not working correctly.
** GL2D:
*** Fix off-by-one errors when drawing textures with GL2D when the textures aren't flipped.
*** Reorganize GL2D setup code to reduce code duplication.
** Other:
*** Fix return types and improve performance of integer square root helpers.
*** In <code>initSystem()</code>, fix video register clearing ranges and remove redundant VRAM configuration.
*** The GRF "HDR" RIFF chunk has been deprecated and it has been replaced by a new chunk called "HDRX", which is exactly the same, but it includes a version field so that it is future-proof.
*** Fix some issues that prevented LLVM from building the library. Add missing arguments to UDF instructions in the codebase. Add some explicit casts. Use <code>inttypes.h</code> definitions in <code>printf()</code> instead of explicit size modifiers.
*** Fix undefined behaviour warnings due to left shifts of signed integers.
* grit:
** Update GRF export code to match the new format used by libnds.
* ndstool:
** Use <code>git describe</code> output as version string instead of a hardcoded outdated version number.
* SDK:
** crt0 and linker script files:
*** It is now possible to place DTCM variables and data at the end of DTCM instead of the beginning. This means the stack can grow downwards without affecting the variables at the beginning of DTCM. This is done by setting the value of the new symbol <code>__dtcm_data_size</code> to a non-zero value. The linker will helpfully point out if the data area is too small for a given program.
*** The user-configurable symbol <code>__shared_wram_size</code> has been added.
*** Assertions have been added to check that the user-defined sizes produce a valid executable.
*** Support for <code>.noinit</code> sections has been added.
*** Missing copyright notices have been added to linker scripts.
*** Minor cleanups and adjustments have been done to the crt0 code.
** picolibc:
*** Add implementation of <code><uchar.h></code>.
*** Improve <code>powf()</code> accuracy.
** Documentation:
*** Provide information about the build process of .nds files.
*** Add a FAQ to the documentation.
*** Add IRC channels to the support channels page.
*** Add notes about what to do after installing BlocksDS.
*** Credit all known contributors to all repositories of BlocksDS.
** Examples:
*** Add NDS Motion card example.
*** Add example of scaling and rotating GL2D sprites.
*** Add <code>inttypes.h</code> include in some examples that require it after picolibc changes.
'''v1.5.0'''
* libnds:
** Exception handling:
*** Add trivial crash handler to inform the user of unrecoverable error conditions, such as stack corruptions with stack smash protection enabled.
*** Add trivial release exception handler to inform the user of data aborts and other exception conditions even in release builds. This is enabled by default; this implementation omits stack and register dumps, making the <code>.nds</code> size increase negligible.
*** Tweak default exception handler to use a darker red for the background.
** Filesystem:
*** Fix using Slot-2 direct access on <code>.nds</code> files over 32 MB. In particular, this fixes accessing large NitroFS filesystems under NO$GBA.
** GRF loader:
*** Improve performance by using fast <code>memcpy()</code> over <code>swiCopy()</code>.
*** Rework loader to only read requested chunks from the filesystem, as opposed to reading all chunks and filtering them at a later stage.
** Sound:
*** Add functions to play PSG, noise and sound samples on specific channels.
*** Add <code>soundCaptureStart</code> and <code>soundCaptureStop</code> high-level helpers for the sound capture functionality.
** Other:
*** Add additional error checks to NitroFS and GRF functions.
*** Add unused result warnings to functions which can cause memory leaks if their result is not deallocated.
*** Document high-level DSi camera functions.
*** Fix console 'K' ANSI escape code not clearing characters on the line.
*** Fix includes for the latest picolibc commits.
* SDK:
** New examples:
*** Add ANSI escape code tests.
*** Add sound capture example.
** Changes to examples:
*** Add <code>.MOD</code> files to LibXM7 examples.
*** Add missing <code>fclose()</code> error checks.
*** Adjust examples using GRF files to showcase the loader's built-in asset decompression functionality.
*** Clean up camera and LibXM7 examples.
** picolibc:
*** Add support for C11 Annex K functions (<code>_s</code>-suffixed functions).
*** Deprecate BSD-specific <code><sys/tree.h></code>.
*** Fix handling <code>NaN</code> in <code>scanf()</code> and <code>strtod()</code>.
*** Fix return values for <code>glob()</code>.
*** Fix the <code>FD_ZERO()</code> macro.
*** Initial support for POSIX.1-2024 in header files.
*** Other minor header file cleanups.
*** Replace <code><_ansi.h></code> with <code><sys/cdefs.h></code>.
** Other:
*** Fix support for placing the Maxmod soundbank file in the NitroFS file system.
*** Make the SD card root directory configurable in default Makefile templates.
*** Remove Teak LLVM from the <code>-slim</code> Docker image. Most people don't need this toolchain, as it is in a highly experimental and unmaintained state; in addition, removing it from the image does not prevent people from installing it on top, but significantly reduces the download size for everyone else.
*** Remove usage of <code>__DATE__</code> in teaktool.
'''1.4.0'''
* libnds:
** Console:
*** Fix 'D' ANSI escape code, which was broken in version 1.3.1.
*** Document console struct fields. Some of them are only meant to be used by libnds, which has been documented.
*** The size of some fields in the console struct has been reduced, and the fields have been reordered to reduce padding in the struct. Some fields were unused, and they have been removed.
*** Now it's possible to specify the 16-color palette to be used when loading custom fonts with their own palette.
*** <code>fontCharOffset</code> now works, which means that it is possible to specify that a font should be loaded after another font, so that two fonts can use the same tile block and save VRAM.
*** In order to be able to specify the palette and the <code>fontCharOffset</code>, a new function has been created: <code>consoleInitEx()</code>.
*** Mark the defaultConsole struct as const. It is needed to keep that data untouched because the user may initialize the default console several times in a program, and it's important to be able to return to the right initial state.
*** Some variables have been made private.
*** When a character outside of the character set of the font is printed, a space is now printed instead. Previously, it printed tiles outside of the font, which could result in garbage being printed on the screen.
*** New functions have been added to control the console without using awkward ANSI escape sequences: <code>consoleSetCursor()</code>, <code>consoleGetCursor()</code>, <code>consoleAddToCursor()</code> and <code>consoleSetColor()</code>.
** Keyboard:
*** Make custom keyboards work. This seems to have never worked because libnds overwrote the custom keyboard struct with the default keyboard struct.
*** Keyboard struct fields have been refactored. Some field sizes are now smaller, some fields are now const. The order has been changed to reduce padding between fields and save even more RAM.
*** Ensure that the keyboard is always initialized to the right state with <code>keyboardShow()</code>. This lets you make a keyboard start in uppercase or lowercase state depending on your preferences.
*** Prevent keyboard functions from hanging if no keyboard is actually visible.
** Other:
*** Fix crash when calling <code>peripheralSlot2InitDefault()</code> in a DSi retail unit. This didn't happen in DS, or in debugger DSi units.
*** Add helper to tell the GPU to apply fog to the clear buffer.
*** Flush RAM before copying console graphics to VRAM.
*** Implement <code>assert()</code> in the ARM9 and ARM7. In the ARM9 it works like <code>sassert()</code>, in the ARM7 it prints a no$gba debug message.
*** Clarify some comments about decompression routines of the BIOS.
*** Stop using ANSI escape sequences everywhere. Use direct console API functions instead, which are more self-explanatory.
*** The functions <code>sysGetCartOwner()</code> and <code>sysGetCardOwner()</code> have been added to be able to check the CPU owner of the Slot-1 and Slot-2 buses.
*** Add documentation to some functions without it, and fix some Doxygen comments.
* DSWiFi:
** Stop generating <code>dswifi_version.h</code> as part of the build process.
** Some warnings have been fixed.
* LibXM7:
** Fix a crash when unloading MOD files.
* ndstool:
** Fix NitroFS filesystem corruption when no banner is generated.
* grit:
** Fix <code>libplum</code> build error with LLVM.
* mmutil:
** Fix some incorrect types.
* SDK:
** New examples:
*** Using fog in a 3D scene.
*** Sorting 3D translucent objects based on their distance to the camera and drawing them in the correct order.
*** How to use Maxmod song events.
*** How to stream a WAV file from the filesystem using Maxmod.
*** How to use the sound API of libnds to play PSG, noise and PCM audio.
*** How to use custom keyboards with libnds.
** Changes to examples:
*** The basic Maxmod example now also shows how to play sound effects.
*** The example that loads custom fonts with the libnds console has been improved to load 2 fonts with custom 16-color graphics on one screen and one font with 256-color graphics on the other one.
*** Examples and test now don't use ANSI escape sequences. This makes the code a lot harder to understand.
** Other:
*** Add page to the documentation about how to debug programs with libnds.
*** dlditool: Use <code>stdbool.h</code> instead of a custom boolean type.
*** Doxygen comments have been reorganized in all repositories so that they are uniform across all the codebase.
*** All Doxyfiles have been updated.
'''v1.3.1'''
* libnds:
** Added memory barriers to libnds functions which remap user-accessible memory.
** <code>consolePrintChar()</code> has been exposed in the public API. Coupled with internal refactors, this allows using the built-in console without pulling in printf/scanf as a dependency.
** Fixed function parameters and improved parameters for BIOS RSA functions.
** Fixed potential memory corruption when <code>micStopRecording()</code> was called twice.
** Fixed regression in new touchscreen driver on CDC (TWL).
** Improved documentation for the BIOS CRC-16 calculation function.
** Minor optimizations to videoGL and console code.
* SDK:
** New examples:
*** Added a 3D billboard drawing example.
*** Added a 3D spot lights example.
*** Added a 3D two-pass rendering example.
*** Added a BIOS bit unpacking example.
*** Added a BIOS CRC-16 calculation example.
*** Added a BIOS RSA decruption example.
*** Added a microphone recording example.
*** Added a Maxmod audio modes example.
*** Added a Maxmod reverb example.
*** Fixed a regression in the exception handler example.
** picolibc:
*** The bundled version of picolibc has been updated.
*** Added an implementation of <code>posix_memalign()</code>.
*** Added support for <code>%a</code> and <code>%A</code> formats in <code>scanf()</code>.
*** Fixed <code>freopen()</code> not resetting the unget buffer.
*** Fixed hexadecimal string conversion in <code>strtod()</code>, <code>strtof()</code> and <code>strtold()</code>.
*** Fixed <code>lgammal()</code> corrupting the application-defined <code>signgam</code> value.
*** Fixed potential issue when calling <code>fclose()</code> more than once.
*** Fixed <code>printf()</code> rounding issues for <code>%a</code> and <code>%f</code> formats.
*** General header cleanups have been performed.
** Other:
*** Expanded the touch input test to allow sampling input on initial pen press only, as opposed to every frame while the pen is touching the display.
'''v1.3.0'''
* libnds:
** New touchscreen driver:
*** The touchscreen driver has been rewritten from the ground up.
*** A new routine for filtering measurements is now used for both TSC (NTR) and CDC (TWL) touch inputs. This should provide more accurate results, particularly on more worn down displays and screen protectors. More testing is required, however.
*** On TSC (NTR), <code>tscMeasure()</code> now uses the 16-clock-per-conversion method to speed up measurement readouts.
*** The duration of the critical (interrupt-blocking) section of the touch driver has been reduced, and the TSC (NTR) driver has had its performance optimized on top of that compared to 1.2.0 and below.
*** On the ARM7 side, <code>touchApplyCalibration</code> and <code>touchReadData</code> have been added to allow more granular access to the touchscreen driver's logic.
*** As these commands were only intended for TSC (NTR), <code>touchRead</code> and <code>touchReadTemperature</code> were moved to a new header, <code>tsc.h</code>, and renamed to <code>tscRead</code> and <code>tscReadTemperature</code> respectively.
** Interrupt handling:
*** The interrupt dispatcher has been optimized to use <code>O(1)</code> as opposed to <code>O(n)</code> lookups. This is always faster on ARM9, and faster for more than 2-3 defined IRQ handlers on ARM7, which is the common scenario.
*** Fixed a bug where <code>irqClearAUX()</code> would disable the non-auxillary interrupt of the same bit mask on ARM7.
*** Fixed behaviour in setting and clearing of multiple interrupt handlers at a time (bit masks with more than one bit set). Now, setting multiple bits at once with <code>irqSet()</code> or <code>irqClear()</code> acts the same as setting one bit at a time.
** Memory usage:
*** ITCM use has been reduced by about 320-380 bytes, depending on your codebase's use of libnds.
*** DTCM use has been reduced by 192 bytes - the size of the reserved section at the end of memory is now 64 bytes by default and can be controlled with the <code>__dtcm_reserved_size</code> linker<br />
symbol.
*** ARM7 IWRAM use has been reduced by 192 bytes - the size of the reserved section at the end of memory is now 64 bytes by default and can be controlled with the <code>__iwram_reserved_size</code> linker symbol.
*** The size of the supervisor and IRQ stack can now be controlled by defining the <code>__svc_stack_size</code> and <code>__irq_stack_size</code> linker symbols.
** Graphics:
*** A new function has been added to set the object mode (regular, bitmap, window, blended): <code>oamSetBlendMode()</code>.
*** A new function has been added to get a SpriteSize entry from the size of a sprite in pixels: <code>oamDimensionsToSize()</code>. Also, <code>SpriteSize_Invalid</code> has been introduced to represent dimensions that aren't valid 2D sprite sizes.
*** New definitions have been added for the bit fields of the <code>BLDALPHA</code> and <code>BLDY</code> registers.
*** The following functions now return error codes: <code>glBindTexture()</code>, <code>glAssignColorTable()</code>, <code>glGetColorTableParameterEXT()</code>, and <code>glTexParameter()</code>, making it easier to handle errors gracefully when using them.
*** There has been a big refactor in videoGL to handle allocation errors gracefully (or at least crash with an assertion if the code can't recover from the error).
** Code refactoring:
*** <code>RTC_CR</code>, <code>RTC_CR8</code> and <code>HALT_CR</code> have been renamed to <code>REG_RTCCNT</code>, <code>REG_RTCCNT8</code> and <code>REG_HALTCNT</code>, respectively.
*** GL2D now uses existing <code>videoGL.h</code> helpers instead of reimplementing its own copies.
*** Many fields and functions have been documented, including firmware flash commands, DLDI driver structures.
*** Missing <code>DMA_START</code> constants have been added.
*** The constants used in <code>tscReadTemperature</code> have been documented.
*** <code>SerialWaitBusy</code> has been renamed to <code>spiWaitBusy</code>.
*** <code>oamSetGfx()</code> has been moved away from the header to fix C++ builds.
** Other:
*** ARM7 SPI bus helper functions have been added: <code>spiExchange</code>, <code>spiRead</code> and <code>spiWrite</code>.
*** <code>consoleLoadFont()</code> has been cleaned up. Note that the <code>convertSingleColor</code> option has been removed, as 1bpp fonts are now supported.
*** Decompression of Huffman-compressed data has been implemented. To faciliate this, <code>decompressStreamStruct()</code> has been added.
*** Decompression utility functions are now available in both the ARM9 and ARM7 build of libnds.
*** <code>glCallList()</code> and <code>cardStartTransfer()</code> now use the safe helper function <code>dmaSetParams()</code>.
*** wf-fatfs has been updated, bringing minor performance improvements to directory lookups.
*** The magic numbers used to represent MPU memory regions have been replaced by definitions.
*** A missing include has been added to <code>grf.h</code>.
* SDK:
** New examples:
*** Added an 8-bit bitmap background loading example.
*** Added an example of combining 3D, 2D sprite, and 2D background display.
*** Added an example of loading sprites of all graphics types from GRF files.
*** Added an example of loading bitmap sprites.
*** Added an example of loading and using affine sprites.
*** Added examples of using regular windows and windows using objects as mask.
*** Added examples of using extended palettes for sprites and backgrounds.
*** Added an example of using a text console in an extended affine background.
*** Added an example of using the mosaic effect in sprites and backgrounds.
*** Added an example of animating 2D sprites by updating frames in real time or by pre-loading all frames to VRAM from the start.
*** Added an example of using 2D alpha blending and fade effects.
*** Added a BIOS decompression example.
*** Added a NitroFS paletted texture loading example.
*** Added a touch input test, and two examples.
*** Added an example of creating graphics effects using the horizontal blanking interrupt.
*** Added a sample minigame based on Space Invaders.
** Changes to examples:
*** OAM memory and textures is now freed in all examples that allocate them. While this isn't needed in examples as short as ours, it's good practice to show developers how to free resources when they aren't needed anymore.
*** The names of the ROMs and the titles and subtitles in the ROM header have been modified to make them consistent across all examples.
*** Background IDs returned by <code>bgInit()</code> are now used instead of hardcoded layer numbers.
*** <code>videoSetMode()</code> is no longer used to enable sprites or to set sprite mapping modes, that should be done by the <code>libnds</code> sprite API.
*** Tilemaps are now explicitly excluded from grit generation in all the grit files that are used to convert sprites.
** grit:
*** Fixed reading data from assembly files as input.
*** Fixed uninitialized memory use when loading a picture with an odd width.
** picolibc:
*** The bundled version of picolibc has been updated.
*** Added an implementation of <code>funopen</code>.
*** Added bounds checking to <code>asctime_r</code> and <code>ctime_r</code>.
*** Added implementations of <code>fgetpos</code> and <code>fsetpos</code>.
*** Added stub implementations for POSIX unlocked file functions.
*** Fixed <code>fgetwc</code> and <code>fputwc</code> not setting the file stream to wide orientation.
*** Fixed <code>regex.h</code> not being usable when compiling C++ code.
** Other:
*** Fixed NitroFS generation in the combined ARM7+ARM9 ROM template.
*** The BlocksDS SDK now depends on the <code>wf-nnpack</code> package, which provides standalone, command-line compressors for the decompression methods supported by the console's BIOS.
*** The code style of <code>libteak</code> and <code>DSWiFi</code> has been changed using <code>clang-format</code> to improve readability.
*** The documentation has been updated with additional notes about migrating from older and current versions of devkitARM, covering further potential issues.
*** The Teak LLVM toolchain is no longer mentioned in the Windows setup instructions, as it is not available there.
'''v1.2.0'''
* libnds:
** videoGL:
*** Add <code>glGetColorTablePointer()</code> (returns pointer in VRAM to the palette of a texture).
*** Add <code>glGetTextureExtPointer()</code> (returns pointer in VRAM to the additional texture data of <code>GL_COMPRESSED</code> textures).
*** Fix allocation of <code>GL_COMPRESSED</code> textures when <code>VRAM_A</code> is not allocated to the 3D engine.
*** Fix crash in <code>glTexImage2D()</code> with no active texture.
*** Fix error checking in <code>glColorTableEXT()</code> and <code>glTexImage2D()</code>.
*** General code cleanup and improvements.
*** Minor optimization to loading <code>GL_RGB</code> textures using <code>glTexImage2D()</code>. Note that using this format is not recommended; see documentation for additional details.
*** <code>TEXTURE_SIZE_INVALID</code> has been added to GL_TEXTURE_SIZE_ENUM.
*** <code>glTexImage2D()</code> now fails correctly when invalid sizes are used.
*** Some minor comment improvements.
** GL2D:
*** Improve error checking when loading textures.
*** Modify sprite sets to use <code>uint16_t</code> arrays for texture coordinates.
** Add <code>hw_sqrtf()</code> - a hardware-accelerated alternative to <code>sqrtf()</code>.<br />

** Small optimizations to functions that use the hardware accelerators of division and square root.<br />

** Add support for detecting stack smash canaries.
*** As a result, the debug versions of libnds are now built with the stack protector enabled.
** Add support for printing standard output to the debug console if the on-display console is not initialized.<br />

** Change <code>SOUND_FREQ</code> (ARM7) and <code>TIMER_FREQ</code> to always return the correct frequency value, rounded to the nearest achievable one.
*** This has been found in user research to be the most intuitive default; if you'd like alternate options, please let us know.
** Fix <code>swiSwitchToGBAMode()</code>.<br />

** Improve documentation of RTC structs.<br />

* SDK:
** Add error code checks to 3D engine examples.
** Add GL2D spriteset and tileset examples.
** Add new tool: squeezer (by [https://github.com/huxingyi @huxingyi]), used for generating packed textures for GL2D sprite sets. It has been forked to easily export formats used by GL2D instead of generic formats.
** Add tests for <code>hw_sqrtf()</code>.
** Avoid using <code>GL_RGB</code> and <code>TEXTURE_SIZE_n</code> defines in 3D engine examples.
** Fix VRAM bank setup in "text over 3D" example.
** Improve timer example.
** Add a test for the videoGL functions that allocate textures and palettes.
'''v1.1.0'''
*libnds:
**Add keyboardExit() function to deinitialize keyboard structures.
**Add realpath() implementation.
**Adjust keyboardInit() to only link the default keyboard if no custom keyboard is being used.
**Fix getcwd() result when called in the root NitroFS directory.
**Fix Slot-1 card reads not being aligned to 512 bytes.
**Minor allocation/string handling bugfixes.
**Fix some memory allocation issues found by GCC 14.
*SDK:
**Add examples (paletted textures, rotation backgrounds, 16-bit backgrounds, sprites in sub screen, FAT file attributes, GL2D usage).
**Add tests for realpath().
**Fix warnings found by GCC 14 in examples.
'''v1.0.0'''
*libnds:
**Fix C++ builds (there was a missing cast from enum to int, and the Makefile
**was using the wrong program to link binaries).
**Optimize some videoGL functions (compile them as ARM instead of Thumb to
**take advantage of the faster multiplication instructions).
**Fix bug in readdir().
**Implement __retarget_lock_*() family of functions to allow libc functions
**to work in a multithreaded environment.
**Make glCallList() take a void pointer instead of u32.
**Add checks to NWRAM functions to see if MBK1-MBK5 are writable.
**Don't remap NWRAM-A when starting the DSP (only B and C are needed).
**Fix swiUnpackBits().
**Fix some casts to respect "const".
**Fix some warnings.
**Improve some documentation comments.
**Deprecate typedef fp (the name is too short!) and PUnpackStruct.
**Add missing files to the Doxygen documentation.
*SDK:
**Add examples (3D object picking, 3D toon shading, building 3D display lists,
**3D volumetric shadows, compressed textures, orthogonal projections, using
**console windows with the default console API).
**Improve C++ test to prevent regressions like during the last few versions.
**Document memory map of the DS.
**Add note about the Makefiles of BlocksDS not supporting paths outside of the
**root folder of the project (thanks, @lifehackerhansol).
**Fix linking C++ projects in default makefiles.
*maxmod:
**Fix return type of mmEffectCancel() in ARM9 code.
'''v0.14.0'''
*libnds:
**The GRF loading functions have been modified to be actually useful. In some cases it wasn't possible to infer the size of some data chunks of the file (it was impossible to calculate the size of a tileset, for example). The new functions break compatibility with the old ones, but this change was required.
**Added glTexSizeToEnum() to convert sizes in pixels to GL_TEX_SIZE_ENUM values. Also, the funciton glTexImage2D() now accepts sizes in pixels as well as GL_TEX_SIZE_ENUM values.
**Added a function to return the default drive (sd: in the case of DSi, fat: in the case of a DS).
**FatFs has been moved to an external repository (wf-fatfs) which is included in libnds as a submodule. The documentation of FatFs has been removed from this repository.
**Added some missing 3D polygon attribute definitions.
**Fixed the return type of swiSHA1Verify().
**The fatfs.h header has been removed, it is redundant.
*SDK:
**Refactor documentation.
***It now uses Hugo, and it is available as a static website.
***Some old sections have been updated.
***The documentation of all libraries has been integrated with the documentation of BlocksDS so that everything is linked.
***Document how to use Slot-2 flashcards with BlocksDS applications.
***Reword devkitARM porting guide.
***A doxygen theme has been applied to the documentation of all the libraries used by BlocksDS.
**Add lots of examples:
***3D and 2D graphics.
***DSWifi.
***How to use multiple DSP binaries in the same application
***General NitroFS usage in an application (such as loading music for LibXM7 or graphics to be used as 2D backgrounds or sprites).
***DSi SHA1 functions.
***Hardware timers.
***Video capture (render to texture, dual screen 3D, save screenshot as PNG).
***More text console examples.
**Small change to makefiles that modifies the destination folder of build artifacts.
*LibXM7:
**It now uses timer 0 instead of timer 1, so that Maxmod and LibXM7 use the same timer and it's easier to switch libraries.
**The documentation has been improved.
*DSWifi:
**WEP modes have been documented.
**The prototypes of some functions have been cleaned up.
**The documentation has been improved.
*Maxmod:
**The return type of mmEffectCancel() has been fixed.
**Some definitions have been turned into enums.
**inline functions in headers have been turned into static inline.
'''v0.13.0'''
*libnds:
**Breaking change: Refactor input handling in the ARM9. In order to fix a race condition where the touch screen state could be updated between calls to scanKeys() and touchRead() it has become mandatory to call scanKeys() before touchRead(), keyboardGetChar(), keyboardUpdate() and the deprecated touchReadXY(). Most programs are already doing this, but this may break a small number of programs that don't do it.
**Implemented isHwDebugger(), which returns 1 if the console running the code is a hardware debugger, regardless of the DS model and CPU state. This is meant to replace swiIsDebugger(), which only works if the cache is disabled, and only in DS models (not DSi). The documentation of swiIsDebugger() has been updated to mention its limitations.
**Fix Slot-2 tilt API introduced in version 0.11.0, which hadn't been tested on hardware. The old peripheralSlot2TiltUpdate() has been replaced by peripheralSlot2TiltStart() and peripheralSlot2TiltRead().
**Implemented utime() and utimes() for changing file modification dates.
**Implemented scandir(), alphasort() and versionsort(),
**Fixed statvfs() and fstatvfs() on NitroFS paths and files.
**Added stubs for getwd() and get_current_dir_name().
**Added stubs for getuid(), getgid(), etc.
**Add helpers to load GRF files generated by grit.
**Reintroduce logic to read Slot-1 cartridges with card commands from the ARM7 to save CPU cycles on the ARM9.
**The value of the RAM size field in REG_SCFG_EXT in the ARM9 is now set to 16 MB or 32 MB instead of being fixed to 32 MB even in retail DSi units.
**Some CP15 defines have been fixed.
**Simplify logic in ARM7 input handler.
**Generate default font from a PNG at build time instead of doing it from a preconverted BIN file to make it easier to replace it in the future.
*grit:
**Added the -D argument, specifying the destination folder for non-shared data as a counterpart to -O.
**Fixed a situation in which the first color in an image's palette would be used as transparent if the user-provided color (with -gT) was not present in the image.
**Breaking change: Fixed GRF file output to properly follow the RIFF chunk format. It will also export new information in the file header, like using special magic values to specify the formats A3I5, A5I3 and TEX4x4, and specifying the number of colors contained in the palette (for 16-bit
**textures it's 0). In order for the new information to fit in the header, some fields have been increased in size.
**Fixed palette size calculation for DS textures.
**Improvements to error messages.
*libxm7:
**Make types XM7_XMModuleHeader_Type and XM7_MODModuleHeader_Type private. Developers consider their MOD/XM files as a typeless blob of data, they shouldn't need to cast it to anything, the library should do it itself.
**The structs that define the MOD and XM formats have been made private, as well as some definitions internal to the player.
**Some defines have been turned into enums, which will help developers and IDEs identify what to use in which functions.
**The documentation has been updated.
*Tests:
**Add test to read DSi SCFG registers to see which DSi features are available with the loader that has been used to launch the application.
**Add test to display all configured MPU regions.
'''v0.12.0'''
*libnds:
**Dot and dot-dot entries are now properly emitted in readdir(). In line with common software expectations, they mirror standard FAT filesystem behaviour, that is are present for all subdirectories. For NitroFS, these entries are emulated accordingly.
**The d_ino field in readdir() output is now correctly populated, to match stat() and fstat().
**Added nitroFSOpenById() and nitroFSFopenById() functions, allowing opening files directly without paying the cost of a directory lookup.
**Accordingly, NitroFS file systems which contain a FAT table but no FNT table can now be opened.
**Optimized glMaterialShinyness().
*SDK:
**The default Makefiles have been simplified and now use compiler-provided .specs files. In turn, a few additional features have been added:
***Support for picolibc's compiler define-based selection of the printf and scanf implementations.
***The __BLOCKSDS__ define, which can be used to detect a BlocksDS environment during building.
**Fixed camera initialization with the default ARM7 binary.
*grit:
**Added the -ftB argument, which outputs files with .img, .map, .meta, .pal extensions, as opposed to .img.bin, .map.bin, .meta.bin and .pal.bin.
'''v0.11.3'''
*libnds:
**Added helpers to control microphone power independently from recording. This can be used for scenarios in which the DSP is tasked from recording microphone input.
**Added helpers and definitions for the DSi GPIO registers.
**Added function to detect availability of NWRAM.
**Fixed atexit() handlers not being called during a normal main() return.
**Fixed TSC configuration for enabling 47 kHz input/output in DSi mode.
**Improved error handling in Teak DSP code execution helpers.
**The Teak DSP is now powered off before loading a DSP binary.
*dswifi:
**Reduced memory usage, especially while Wi-Fi is not initialized.
*ndstool:
**Breaking: Instead of providing alternate-language banner text using -bt5 "Text", the form -bt 5 "Text" is now required.
**Added support for providing mutliple root directories for building NitroFS images. All specified root directories are combined to create the root of the file system.
**Fixed -w treating other options as file masks.
**Improved argument handling.
*SDK:
**Updated compiler flags:
***The superfluous -mtune=arm7tdmi has been removed from ARM7 Makefiles.
***-march=armv5te -mtune=arm946e-s has been replaced with -mcpu=arm946e-s+nofp in ARM9 Makefiles.
***-Wl,--use-blx has been added to ARM9 linker flags. This allows the use of the BLX opcode for linking ARM/Thumb code in place of trampolines, slightly improving final executable size and performance.
'''v0.11.2'''
*libnds:
**Fixed a bug introduced in version 0.11.1 that didn't initialize audio hardware correctly in DSi mode.
**Some superfluous audio helpers added in version 0.11.1 have been removed.
**Move libteak to its own repository so that it can be reused by other toolchains.
**Modify functions to load DSP binaries to return int instead of bool for more flexibility.
*DSP:
**Move crt0 and linkerscript to libteak repository.
**Preprocess all assembly files, not just the crt0.
'''v0.11'''
*libc:
**Fixed an important regression in memcpy() and memset() implementations.
*Improved file I/O performance:
**Added support for batch reads and writes of contiguous clusters, improving SD card performance for very large sequential reads/writes.
**Added fatInitLookupCacheFile(). This allows opting a file into having a special in-memory cache which significantly speeds up file seek operations.
**Provisionally automatically enabled the in-memory cache for NitroFS files. If you're experiencing slowdowns, make sure to defragment your SD card - this requirement will be loosened in future releases (but it's still a good idea).
**Integrated profi200's dsi_sdmmc driver, improving reliability and performance for reading from and writing to the DSi's SD card.
**Optimized unaligned buffer I/O performance for the DSi's SD card.
**Only cluster table/directory-related reads will now be cached by the built-in sector cache. This allows better use of this sector cache; one can use setvbuf() to enable a larger cache for file I/O.
**Other minor optimizations have been made throughout the code.
*Added a new Slot-2 API (arm9/peripherals/slot2.h).
**Added support for detecting external RAM cartridges (SuperCard, M3, G6, DS Memory Expansion Pak, EZ-Flash variants, EverDrive).
**Added support for enabling and disabling the data cache on the Slot-2 memory area. Combined with suitable bus speed detection for these cartridges, this allows efficient usage of such an external RAM area.
**Added support for detecting and using the Gyro, Solar and Tilt sensors available on various GBA game cartridges.
**Fixed detection of GBA cartridge rumble (WarioWare, Drill Dozer).
**Modify rumble example to show how to use the new API.
*DLDI:
**Moved the built-in sector cache into unused memory occupied by the reserved DLDI driver area. This effectly saves ~20KB of heap RAM for most homebrew.
**The DLDI driver area size can now be changed by defining the __dldi_size symbol to a value away from the default of 16384, such as 8192 (if your application is highly RAM-constrained - this may break support with some cartridges, however) or 32768 (restores compatibility with MoonShell versions at the cost of an additional 16KB of RAM).
**The DLDI driver area is now guaranteed to be close to the beginning of the .nds file, which may slightly improve load times.
*DSP:
**Add BTDMP and ICU helpers.
**Refactor crt0.s.
**Add examples of handling interrupts, including timer interrupts.
*libnds:
**Rename some cache helpers for consistency.
**Fixed a file handle leak that could occur if nitroFSInit() was pointed to an .nds file which does not contain a NitroFS file system.
**Fixed a rare case in which nitroFSInit() could try reading from the GBA slot on the DSi, causing an exception.
**Added readFirmwareJEDEC() function to read the ID of the DS firmware flash chip. (lifehackerhansol)
**Minor optimizations have been done to readUserSettings().
**Fixed the NDMA_DST_FIX macro definition.
'''v0.10.2'''
*NitroFS: Fix file traversal not working without running a chdir() first.
'''v0.10.1'''
*Fix NitroFS directory reads occasionally failing on non-DLDI environments.
'''v0.10.0'''
*Build system:
**The default makefiles no longer rely on the toolchain being in the current
**PATH. Now, the default Makefiles have the default path to Wonderful
**Toolchain, which can be overriden by the user if desired.
**The makefiles used by the tests and examples have been moved to a system
**location so that they are more easily reused.
**dldipatch has replaced dlditool as the default to apply DLDI
**patches, due to bugs in dlditool's patch application process:
**https://problemkaputt.de/gbatek-ds-cart-dldi-driver-guessed-address-adjustments.htm
**Update your makefiles to take advantage of the updates.
*Filesystem improvements:
**Replaced NitroFAT by a new Zlib-licensed implementation of the NitroFS
**filesystem by @asiekierka. This fixes the performance drawbacks of NitroFAT.
**In stat() and fstat(), the fields st_dev and st_ino are now
**properly populated.
**Fixed stat() not acknowledging / as a directory.
**Remove NitroFAT support from ndstool.
**The example makefiles have been modified to stop using mkfatimg.
*DSP:
**Initial experimental, incomplete support for the Teak DSP of the DSi.
**This isn't ready to be used, it's still under development and it's going
**through a lot of changes. Most of the code is derived from @Gericom's
**prototype code.
**Support for building DSP binaries won't be present on Windows until it's
**more stable. However, if you already have pre-built DSP binaries, it's
**possible to use them on Windows.
**Introduced teaktool, which converts ELF files into TLF (Teak Loadable
**Format) files that can be loaded by libnds.
**Added ARM9 functions to libnds to handle the DSP, load TLF files and
**communicate with programs running on the DSP.
**Introduce libteak, a library with helpers to use the AHBM, DMA, APBP,
**ICU and timer peripherals. It has been documented and added to the Doxygen
**pages of libnds.
**Added a few examples of how to use the currently supported DSP features.
**Update user instructions and Dockerfile to use and mention the LLVM Teak
**toolchain.
**Add NWRAM defintions and helpers.
*DLDI improvements:
**The DLDI template now automatically calculates the "size" and "fix flags"
**fields of the header.
**The binary R4 DLDI driver, used for DeSmuMe compatibility, has been replaced
**by a Zlib-licensed impementation built from source.
*libnds:
**Microphone samples can now be captured using full 16-bit precision on DSi.
**Cleaned up and added some missing MMIO/bitfield defines throughout libnds.
**Implemented inlined BIOS calls based on gba-hpp. This should make code
**using BIOS calls slightly smaller and faster.
**Small reorganization of syscalls code.
**Slightly optimized coroutine threading code.
**Added documentation about ARM7 audio helpers.
*Submodules:
**Before this version, repositories owned by third parties were added as
**submodules to the SDK repository. This can be a problem if the owner isn't
**responsive, changes name, deletes the repository... In order to avoid
**issues, forks have been created under the BlocksDS organization.
**It is expected to contribute to the original repositories and update the
**fork to stay in sync. Contributing to the forks is a last resort option.
*Tests:
**Added a new test for SWI functions.
'''v0.9.1'''
*Revert changes in maxmod that duplicated some symbols.
'''v0.9.0'''
*SDK:
**Native windows support added. Wonderful toolchains now distribute native Windows binaries, and the only required change in BlocksDS was to change a library used by Grit. Thanks you, Generic and asie!
**The stdio implementation of picolibc provided by Wonderful Toolchains has been patched by asie and this has substantially improved direct SD card read and write speeds.
**The RTC interrupt is no longer used in any test, example or template. Users are now expected to timer interrupt instead because the RTC interrupt isn't supported on 3DS in DS/DSi mode or most emulators. Check the new code to see how to adapt old code. The RTC interrupt functions will still be supported to preserve compatibility with old projects that aren't updated.
**Document the ARM9 <-> ARM7 boot synchronization routine.
**In the dockerfile, set a locale to be able to pass UTF-8 characters to ndstool to appear in the title of the NDS ROM.
**Add a test to ensure that the libnds modules that use the ARM9 <-> ARM7 transfer memory region don't break.
**New examples:
***Getting key input state.
***Using NitroFAT, DLDI and DSi SD in the same program.
***Send a buffer in main RAM to the ARM7 from the ARM9.
***Read battery status.
***Set the real time clock of the NDS.
*libnds:
**RTC:
***Add new helpers to get and set the date. They use typedefs to move values between functions instead of byte arrays.
***The old helpers that use byte arrays have been deprecated.
***Using the RTC interrupt as a way to update the time every second has been deprecated.
***Documentation:
***Document values returned by the battery read function.
***Document RTC helpers.
***Add some ARM7 modules to the front page of the Doxygen documentation.
**Memory:
***Disable data cache and instruction fetch access to DTCM.
***Rumble detection functions won't try to detect anything on DSi.
***Change location of transfer region area on DSi so that it's uncached.
***Import safe DMA helpers written by Gericom and use them from all DMA helpers.
**Video:
***Make glGetInt() wait for the GPU to be idle when getting the polygon and vertices count. It is common for developers to forget to wait.
***Cleanup some helpers and add some missing VRAM definitions.
***Document hardware bug of the DMA in GFX FIFO mode.
**Other:
***FatFs updated to R0.15p3.
***Support the debug button (only available in emulators and debug consoles).
***Switch to using ARM unified syntax (UAL).
*Grit:
**Switch from libfreeimage to libplum. This allows us to build Grit on Windows easier.
'''v0.8.1'''
*libnds:
**Fix NitroFAT in emulators. It only worked when DLDI was initialized correctly, which isn't the case in emulators like no$gba.
**Set the right CPU as owner of the Slot-1 bus in NitroFAT handling functions.
*SDK:
**Update build systems to generate Maxmod soundbanks in the NitroFAT filesystem if the filesystem is used. This isn't supported by ARM9 + ARM7 makefiles for now, only by ARM9 makefiles.
**Fix segmentation fault in mkfatimg when not enough arguments are provided.
**Stop relying on make -j in Makefiles. It is passed by make to any sub-make, so it isn't required.
**Add basic Maxmod and Maxmod + NitroFAT examples.
'''v0.8'''
*libnds:
**Document MPU setup code properly.
**Cleanup exception handling code.
**Add asynchronous math functions to complement the previous synchronous ones.
**Support redirecting stdout and stderr to user functions.
**Fix code that selects the default filesystem (DSi SD or DLDI).
**Fix leaking file handlers in truncate().
**Fix memory leaks in image and pcx modules.
**Support more rumble packs.
*ndstool:
**Fix warnings.
**Remove non-homebrew-related functionality.
*SDK:
**Automatically link with libc and libstdc++ rather than forcing users to do it explicitly.
**Support *.arm.c and *.arm.cpp filenames for compatibility with devkitARM.
**Correctly initialize TLS in the ARM7.
**Improve bin2c.
**Update libc documentation.
**Improve and cleanup some examples.
'''v0.7'''
*libnds:
**Unify all coding and documentation style of the codebase.
**Change license of GL2D to Zlib (with the author's permission).
**Improve sassert() so that it can exit to the loader instead of locking the application.
**Keyboard:
***Fix initialization glitch where it would blink for a frame.
***Fix backspace handling.
***Make it use cothread functions so that it never blocks the application.
**cothread:
***Fixed stack alignment
***Fixed stack size of the scheduler thread.
**libc:
***Fix no$gba debug messages on the ARM9.
***Add support of no$gba debug messages to the ARM7.
*mmutil:
**Fix segfault with samples with implied zero loop.
*SDK:
**Improve some old examples. Fix memory leaks in all examples that used
**getcwd().
**Fix ARM9 linkerscript to place ITCM sections in ITCM correctly.
**Add new examples: Exception handling, assertions, no$gba debug console.
**Prevent mkfatimg from generating FAT images that are so small that FatFs
**can't mount them.
**Improve installation instructions.
'''v0.6'''
*libnds:
**Document MPU setup steps and CP15 registers.
**Enable more warnings in the Makefile and fix them.
**FIFO subsystem:
***The FIFO subsystem has been cleaned up and documented.
***Some bugs in the FIFO subsystem have been fixed (the stress test still fails, though).
***Prevent using cothread_yield() in the ARM7.
**libc:
***Alignment of thread local storage sections has been fixed.
***Support stat() in the root directory of a filesystem.
***Support statvfs() and fstatvfs().
**Avoid including the default keyboard data if it isn't used.
**Allow setting the duration of the lid sleep check, and to disable it completely.
**Build release versions of the library as well as debug.
*ndstool:
**Support multiple languages in the banner.
**Support more file formats for icons (GIF, PNG).
**Support animated icons (from GIF files).
*SDK:
**Refactor install targets of the SDK components. Now, all components can
**be installed on their own, and they copy the licenses of the components to
**the installation directory.
**Emulate behaviour of bin2s of devkitPro more closely with bin2c.
**Use SPDX license identifiers in all libraries and components that end up in
**the NDS application binary.
**Some cleanup of code formatting.
**Added a DLDI driver template.
'''v0.5'''
*Define a default location for BlocksDS: /opt/blocksds/
*Use mkfatimg (distributed with FatFs) instead of imgbuild.sh to reduce
*the number of dependencies.
*Fix mmutil target in Makefiles in parallel builds.
*Cleanup of GBA slot peripherals drivers.
*Integrate libxm7 as a core library.
*Fix exit to loader code from the ARM7. It has been simplified a bit.
*Document exit to loader code.
'''v0.4'''
*Use Wonderful Toolchains to get full C++ standard library support.
*Remove picolibc and avr-libstdcpp as submodules (all previous history has been condensed to one commit).
*Multithreading:
**Add cooperative multithreading scheduler.
**Enable scheduler in the ARM9 by default.
**Add examples of having multiple threads, mutexes, and asynchronous file
**loading.
**Support thread local storage.
*Added mutexes to problematic parts of libnds and FatFs.
*Add initial support and example of DSi camera (thanks, asie!).
*Support malloc() in the ARM7.
*Simplify build system of tests and examples.
*Bugfixes.

== Credits ==
This project wouldn't have been possible without:

* Many thanks to [https://asie.pl asie] for his help and advice, and for [https://wonderful.asie.pl/ Wonderful Toolchains]
* [https://devkitpro.org/ devkitPro]
* [https://github.com/picolibc/picolibc picolibc]
* [https://github.com/devkitPro/libnds libnds]
* [http://akkit.org/dswifi/ dswifi]
* [https://maxmod.devkitpro.org/ maxmod] (and mmutil)
* [https://www.coranac.com/projects/grit/ grit]
* [https://gcc.gnu.org/ GCC]
* [https://www.gnu.org/software/make/ make]
* And many others!

== External links ==
* GitHub - https://github.com/blocksds/sdk

NitrousTracker DS

2026-04-27T17:16:51Z

SkyLyrac: Update link of git repository.

{{Infobox DS Homebrews
|title=NitrousTracker
|image=nitroustracker.png
|description=DSi-compatible, enhanced fork of NitroTracker.
|author=NitrousTracker developers
|lastupdated=2026/04/17
|type=Music Apps
|version=0.6.2
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/dshomebrew2/nitroustracker.7z
|website=https://docs.asie.pl/nitroustracker/
|source=https://github.com/NitrousTracker/nitroustracker
}}
NitrousTracker is a fork of [[NitroTracker]], a FastTracker II style tracker for the Nintendo DS originally created by 0xtob.

It is a versatile tool for creating music - everywhere! It supports the popular XM file format that is used by many PC trackers and that can be played on many PC audio players such as Winamp or XMMS.

You can learn more about NitrousTracker on [https://docs.asie.pl/nitroustracker the official documentation website].

== Installation ==
Copy NitrousTracker and some music and samples to any folder of your memory card and start tracking.

== Compatibility ==
Full DSi/3DS support (in DSi mode).

== Changelog ==
'''v0.6.2 2026/04/17'''
* New features:
** four new themes! (Orjis)
* Improvements:
** moved sample editor and envelope editor zoom buttons to the horizontal scrollbar (prayerie)
** confirmation dialog box before previewing a large sample (prayerie)
** increase maximum note skip from 8 to 32 (prayerie)
** updated BlocksDS to 1.19.1
* Fixes:
** fix accessing uninitialized memory when playing auto notes (asie)
** fix record box RAM check crashing (asie)
** fix use-after-free when loading modules (asie)
** fix effects commands not displaying a parameter of <code>00</code> (prayerie)
** fix incorrect fx parameter interpolation (prayerie)
** other minor fixes
* Additional thanks to oxygenfad for helping to test this release!
'''v0.6.1 2026/03/21'''
* New features:
** sample trim button (prayerie)
* Improvements:
** removed confusing quirk in "clr" button behaviour added in v0.4.6 (prayerie)
** the "ren" button is now disabled when not useful (prayerie)
** touch keyboard can now be used while the song is playing (prayerie)
** updated BlocksDS to 1.19.0
* Fixes:
** fixed memory corruption by adding more than 256 patterns
** fixed scroll bar not becoming visible after inserting patterns (prayerie)
** fixed visual bug when scrolling the envelope editor with sustain set
** fixed visual bug when switching instruments in effect mode (prayerie)
** fixed wifi crash when trying to enable dsmidi
'''v0.6.0 2026/03/03'''
* New features:
** '''effect editing keyboard''' (prayerie, exelotl)
** support for loading 24/32-bit WAV files (asie)
** support for loading WAV files with JUNK headers (prayerie)
** support for 09xx sample offset effect (prayerie)
** support for E1x/E2x/X1x/X2x fine portamento effects (exelotl)
* Improvements:
** improved portamento accuracy (exelotl)
** optimized sample display drawing (prayerie)
** separated message box and sample editor zoom button colors (prayerie)
** updated BlocksDS to 1.18.0
* Fixes:
** fixed disk tab being visible without DLDI driver (asie)
** fixed scroll bar not working in sample drawing mode (asie)
'''v0.5.2 2025/11/29'''
*New features:
** automatic normalization for samples (prayerie)
** instrument zapping can now filter to selected or unused
*instruments only (prayerie)
** songs with unsaved changes now have a visual indicator
*in the file tab icon (prayerie)
** typewriter theming support (prayerie)
*Improvements:
** clear button in typewriter (prayerie)
** support for polyphony in DSMIDI and for Easy Piano (exelotl)
*Fixes:
** fixed libntxm loading >16-channel XM files which it could not
*play (asie)
** fixed memory leak in NormalizeBox (prayerie)
** fixed red border disappearing after recording from mic in edit
*mode (prayerie)
** fixed regression in selection pasting (prayerie)
** fixed settings reading uninitialized values on first boot
*(prayerie)
** fixed visual indicators for mute/solo channels being incorrect
*upon changing songs (asie)
'''v0.5.1 2025/11/22'''
*New features:
** Additional themes! (oxygenfad, prayerie).
** Support for the piano in interface theming (prayerie).
*Improvements:
** Improved button disabling depending on state (prayerie).
** Reduced flicker when adjusting sample loop points.
** The currently displayed/selected sample is now switched based on the multisample note just played (prayerie).
** The piano is now outlined when in mapping mode (prayerie).
** When out of memory, the tracker will now "fail fast" instead of causing potential unwanted memory corruption and leading to unpredictable errors.
*Fixes:
** Fixed a slight inconsistency regarding the current sample when clicking on a new instrument which should reset it to 0, but only did so visually (prayerie).
** Fixed drawing mapping labels when in mapping mode but after disabling the sample listbox (prayerie).
** Fixed memory corruption issues involving ping-pong loop samples.
** Fixed minor theme color calculation bugs (prayerie).
** Fixed piano not respecting volume envelope (prayerie).
** Fixed strange behaviour when mapping a key to a null sample then playing that after playing a non-null one (prayerie).
** Fixed tabbox rounding disappearing after selecting a tab (prayerie).
'''v0.5.0 2025/11/12'''
* New features:
** Interface theming support! (prayerie).
*** Many themes are bundled with this release, with more to come.
*** The .nttheme format is documented here: https://docs.asie.pl/nitroustracker/contributing/theming/
* Improvements:
** Disabled live memory indicator updates, improving stability.
** Slight tweaks to UI font and button layout.
** Songs and samples are now saved as .tmp files first, preventing data loss if a crash occurs mid-saving.
** Updated BlocksDS toolchain.
* Fixes:
** [<nowiki/>[https://github.com/NitrousTracker/nitroustracker/pull/146 #146]] fixed not displaying instrument values properly in edge cases, part 2 (Arikari405).
** Fixed incorrectly trying to load .xm files with OpenMPT format hacks (prayerie).
** Fixed regression in tab box rendering.
** Fixed text being overzealously trimmed.
** Fixed typewriter not showing when paused (prayerie).
** General stability improvements and minor fixes.

'''0.4.16 2025/10/22'''
* Improvements:
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/pull/147 #147]] transpose buttons! hold R to transpose selection by an octave (Arikari405).
** updated BlocksDS toolchain.
* Fixes:
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/pull/142 #142]] fixed oversized pastes not working (prayerie).
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/143 #143]] fixed crashes on too short microphone samples.
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/pull/146 #146]] fixed not displaying instrument values properly in edge cases (Arikari405).

'''0.4.15 2025/07/12'''
* Improvements:
** DSMIDI now better handles polyphony (Rachel Birdy).
** updated BlocksDS toolchain.
* Fixes:
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/126 #126]] poor performance in large directories.
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/128 #128]] fixed bugs in DSMIDI USB support (Rachel Birdy).
'''0.4.14 2025/04/26'''
*Improvements:
** actually enabled USB cartridge support for DSMIDI.
** updated BlocksDS toolchain.
Fixes:
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/125 #125]] Fix playback regressions from v0.4.12.
'''0.4.13 2024/11/10'''
*Fixes:
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/40 #40]] Fix freeze when attempting to loop samples in certain .xm files.
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/117 #117]] Fix "map samples" button UI overlap.
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/123 #123]] Fix playback regressions from v0.4.12.
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/84 #84]] Fix sample selection glitch.
'''0.4.12 2024/11/10'''
*New features:
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/95 #95]] WAV sample import and export now supports loop points.
** [<nowiki/>[https://github.com/asiekierka/nitroustracker/issues/111 #111]] adjustable lines per beat.
*Improvements:
** minor maintenance work in libntxm.
** updated BlocksDS toolchain.
** updated DSMIDI NRIO USB support library.
*Fixes:
** fixed some scrollbar render issues in list boxes.

'''0.4.11 2024/11/04'''
*New features:
** DSMIDI support for NRIO/DS Linker Writer Slot-2 USB cartridges.
*** This allows using a special cartridge with a mini-USB port to connect your DS to a PC as a MIDI device.
*** More information available [https://wiki.asie.pl/doku.php?id=notes:flashcart:ds_linker_writer here].
*Improvements:
** updated BlocksDS toolchain to 1.6.2.
** the about screen now lists the version and the Git commit hash of the build.

'''0.4.10 2024/07/29'''
*New features:
** Support for Bxx XM command (exelotl).
** Support for EEx XM command (exelotl).
*Improvements:
** Updated BlocksDS toolchain to 1.3.0.
*Fixes:
** [<nowiki/>[https://github.com/asiekierka/nitrotracker/issues/112 #112]] fixed freeze on recording long samples.
** Fixed XM pattern decoding bug leading to missing notes (exelotl).

'''0.4.9 2024/04/26'''
*New features:
** env sustain playback + configuration (LeviathaninWaves).
** Player now supports more pattern effects (LeviathaninWaves).
*Improvements:
** NitrousTracker now uses a distinct logo.
** Updated BlocksDS toolchain.
*Fixes:
** Fixed about message box width.
** Fixed crash if paths were set without trailing slashes in config file.
** Fixed combined loop and lock not working correctly.
** Fixed panning being incorrectly set (exelotl).
** Fixed sample panning slider (exelotl).
** Fixed saving of sample panning information (exelotl).

'''0.4.8 2024/11/28'''
*Improvements:
** Updated BlocksDS toolchain.

'''0.4.7 2023/11/27'''
*Improvements:
** Updated BlocksDS toolchain.
*Fixes:
** Fixed microphone recording length.

'''0.4.6 2023/11/10'''
*New features:
** Holding "clr" while playing music will now continue clearing notes.
*Improvements:
** fFster file I/O operations.
** Updated BlocksDS toolchain.
*Fixes:
** Fixed ".." appearing in root directory.
** Fixed pattern lock and loop being enabled at the same time.

'''0.4.5 2023/04/08'''
*New features:
** nowifi build: ~100K more free RAM, but no dsmidiwifi support.
** Scroll lock: loop pattern + detach cursor from song playback.
*** The old "loop ptn" option has been moved to the pattern/song tab.
*Improvements:
** General layout adjustments
** Shaved ~10K more from the filesize/starting RAM usage.
** The "sel" button can now be used to clear a selectiont.
*Fixes:
** Fixed sample tune value not displaying correctly for values below -99.
** Fixed some directories being above ".." in file selector.
** General minor visual glitch fixes.

'''0.4.4-unofficial 2023/04/08'''
*New features:
** "Lock" option in pattern/song tab.
*** Allows queueing patterns to be played without immediately jumping to them.
** New directory creation button in file manager.
** Mono/Stereo output override in the options tab.
*Improvements:
** Sample highlight visual now darkens the sample area.
** Adjusted the pattern/song tab's button layout.
*Fixes:
** Fixed visual glitch upon a failed file save.
** Fixed visual glitches when font goes outside a list box.
** Further fixes to saving files in subdirectories.
** Provided missing license files.

'''0.4.3-unofficial 2023/04/07'''
*Improvements:
** Migrated to the BlocksDS toolchain.
*** The most visible difference is about ~140KB more free RAM on start.
** Minor optimizations.
** Support renaming longer filenames.
*Fixes:
** Fixed crash related to song renaming.
** Fixed loading 8-bit stereo .WAV files.
** Fixed minor memory leak when loading .WAV files.
** Fixed race condition causing some sample files to not be previewable.

'''0.4.2-beta 2023/02/19'''
*New features:
** In-tracker file deletion support ([https://github.com/asiekierka/nitrotracker/issues/5 #5]).
*Improvements:
** Further filesize reduction.
** Further improvements to file selector.
*Fixes:
** Fixed file selector crashing when tapping ".." on the root directory.
** Updated to devkitARM r59, libnds 1.8.2.

'''0.4.1-beta 2020/07/09'''
*New features:
** Full DSi/3DS support:
*** Improved CPU/RAM specifications.
*** Support for built-in SD card reader.
*** Support for built-in microphone (with 16-bit samples).
** Undo/Redo buffer:
*** Use undo and redo buttons in the UI to prevent mistakes.
*** Currently limited to pattern operations (no order table/sample/instrument).
** Untested DS Easy Piano peripheral support.
** It is now possible to exit NitroTracker by tapping on the logo and selecting "exit" -> "yes".
*Improvements:
** Pattern viewer:
*** New, more readable 3x5 font.
*** Slight tweak to font colors for better readability.
*** Selections are now visible behind current row highlight.
** Pattern editing:
*** ins/del/clr/--/vol now operate on selections in addition to single cells.
** Piano:
*** Added the ability to slide your stylus on the keyboard (@reinvdwoerd).
** "Stop" immediately jumps back to top of pattern (@reinvdwoerd).
** NitroTracker now starts in the directory it's launched from.
** The "disk" tab is now only shown if a filesystem has been detected.
** The memory indicator is now dynamically updated as a .XM/.WAV file is being loaded.
** The config is now saved explicitly as opposed to automatically, to reduce SD card wear and improve UI performance.
** Major performance improvements to tobkit (widget drawing library).
** Minor performance improvements in other areas.
** Minor visual tweaks.
** Better mechanisms for checking free RAM.
*Fixes:
** Settings now work even without a filesystem ([https://github.com/0xtob @0xtob]).
** Fixed file browser crashing after deleting a folder ([https://github.com/0xtob @0xtob]).
** Slight improvements to executable size.
** Fixed many memory leaks (including fixes by [https://github.com/fincs @fincs]).
** Updated to devkitARM r54, libnds 1.8.0.

'''NitroTracker-unofficial 2020/07/05'''
*Additions:
** Full DSi mode support (including SD/MMC and microphone).
** New, more readable 3x5 font (for the pattern view).
** Soft reset support (hold START+SELECT).
** Untested DS Easy Piano support.
** Pressing "Stop" immediately jumps back to top. (reinvdwoerd)
** Dragging the pen across the piano now works. (inspired by reinvdwoerd)
*Bugfixes:
** Performance improvements to GUI drawing (some through fincs's fork).
** Fixed certain memory leaks in NTXM and NitroTracker (some through fincs's fork).
** Many edge case string handling fixes (some through fincs's fork).

== Credits ==
NitrousTracker is built using a large number of components, each with their own distinct licenses:
* NitrousTracker: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.nitrotracker GNU General Public License v3]
** libdsmi: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.nitrotracker GNU Lesser General Public License v2.1]
*** dserial: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.dserial BSD-3-Clause License]
*** tinyusb: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.tinyusb MIT License]
** libntxm: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.nitrotracker GNU General Public License v3]
** tobkit: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.tobkit Apache License 2.0]
* BlocksDS SDK:
** crt0: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.crt0 Mozilla Public License v2]
** dswifi: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.dswifi MIT License]
** FatFs: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.fatfs FatFs License]
** libnds: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.libnds zlib License]
** lwIP: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.lwip BSD-3-Clause License]
** mbedTLS: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.mbedtls Apache License 2.0]
** picolibc: [https://github.com/NitrousTracker/nitroustracker/blob/new/licenses/COPYING.picolibc MIT/BSD-style licenses]

== External links ==
* Official website - https://docs.asie.pl/nitroustracker/
* GitHub - https://github.com/asiekierka/nitrotracker/
* The Mod Archive - https://modarchive.org/forums/index.php?topic=4510.0

UCity GB

2026-01-25T15:53:34Z

SkyLyrac: Update link to user guide

{{Infobox GB Homebrews
|title=uCity
|image=ucitygbc.png
|description=The open-source city-building game for Game Boy Color.
|author=AntonioND (SkyLyrac)
|lastupdated=2025/08/09
|type=Strategy
|version=1.3
|license=GPL-3.0
|format=CGB
|download=https://dlhb.gamebrew.org/gbhomebrews/ucitygbc.7z
|website=https://github.com/AntonioND/ucity/
|source=https://codeberg.org/SkyLyrac/ucity
}}
{{#seo:
|title=GameBrew
|title_mode=append
|image=ucitygbc.png
|image_alt=uCity
}}{{lowercase title}}
This is µCity (also spelled 'uCity', pronounced 'micro-city'), the open-source city-building game for Game Boy Color.

Note: There's also a version for GBA [https://www.gamebrew.org/wiki/Ucity_Advance_GBA here].

== Installation ==
The ROM file can be used with an emulator or on a real Game Boy.

There are two available ROMs. ucity.gbc is the preferred ROM that you should use. It can save up to 16 cities depending on the memory available in your emulator or flashcart.

If your emulator fails to load this ROM because of an unknown RAM size or your flashcart fails to save data, try ucity_compat.gbc. This ROM will only be able to save up to 4 cities, but it is more likely to work in all cases.

== User guide ==
Game manual can be found [https://codeberg.org/SkyLyrac/ucity/src/branch/master/manual.rst here].

=== Getting started ===
The game's objective is city-building. You can choose to start with a predefined scenario or with a completely empty random map.

If you decide to go for a random map, remember that the number used as seed to generate the map will always generate the same map, in case you want to play again the same map.

Note that, at some point, a red dot may appear on the screen and not let you do certain actions. This means that the game is simulating something and it can't let you do that until the simulation step has ended.

=== Building ===
Most buildings can be built by the player, but some of the most important ones can't. Residential, commercial and industrial buildings (houses, shops and factories respectively) must be created by the city. The player can only try to attract people to the city.

Also, buildings can't be built on top of others. The exception are power lines, which can be replaced by any building (not roads or train tracks).

Demolishing buildings is as easy as building them, just select the dynamite in the building selection menu.

There are some buildings that require specific things to be built (like having more than a certain number of people, having a specific technological level, etc).

The type of the building can be checked by pressing A when the cursor is over it. However, as an additional help, this is the list of available buildings in the menu:

* Delete - Demolish building.
* RCI Zones - Residential, commercial, industrial.
* Roads and power - Road, train tracks, power lines.
* Services - Police department, fire department, hospital.
* Parks and Recreation - Small park, big park, stadium.
* Education - School, high school, university.
* Culture - Museum, library.
* Transportation - Port, airport.
* Fossil power plants - Coal, oil, nuclear fission.
* Renewable power plants - Solar, wind, nuclear fusion.

=== Services ===
Services are needed to make the population happy. While all buildings have a level of happiness based on the needs that are met, it is specially important for residential, commercial and industrial zones. If those zones don't have their needs covered, people will leave them.

The services needed by people are determined by the class of the settlement.

Police departments and schools are always needed. It is only needed to build fire department, hospitals and high schools when the settlement becomes a town.

Universities are a special case. They are not needed to cover the needs of the population, but they are the only ways of making the technological level of the city increase. This is the only way of unlocking fission nuclear power plants and, eventually, fusion power plants.

=== Transportation ===
Transportation is essential to allow people move between different buildings. Residential areas are sources of traffic and other areas are sinks of traffic.

If people in residential areas cannot reach schools and workplaces (commercial and industrial zones, for example) they will leave.

Roads and train tracks have a specific capacity. The more people using them, the less people will want to use them. At some point, they are too crowded for more people to use them.

Roads and train tracks can be interleaved and they count as being connected even if the drawing of the tiles in the map don't look like they are connected. It is enough for them to be next to each other.

Ports and airports don't have any effect on transportation within a city, they are only a source of income, like stadiums.

=== Power ===
Power plants are needed to provide energy to all your buildings (even parks!). Buildings with no power can't work.

The generation depends on the time of the year. Some power plants are more effective in summer, like solar power plants, and others are more effective in winter, like wind power plants. All other power plants are slightly affected by the time of the year, the efficiency depends on the temperature of the environment after all.

=== Pollution ===
Transportation, factories, polluting power plants... They all create pollution. A polluted city will make less people want to come!

=== City class ===
A settlement changes class depending on the population and the presence of some buildings.

* Village - From the start.
* Town - Population >= 500.
* City - At least one library. Population >= 1000.
* Metropolis - At least one stadium, university and museum. Population >= 3000.
* Capital - At least one port and an airport. Population >= 6000.

The requirements add up, that is, to upgrade to a capital it is needed to meet all requirements of the lower classes.

Similarly, some building types are unlocked by reaching specific classes.

* City - Unlocks stadiums, ports and airports.

=== Loans ===
If you are short of money, you can ask the bank for a loan. Information about the payments is in the same screen where you can get them. You can only have one loan at a time.

=== Disasters ===
Sometimes, unexpected disastrous events can happen. In this game, fires can happen anytime, as well as nuclear meltdowns (if there are fission nuclear power plants).

The more fire departments, the lower the risk of fires. However, once a fire has started, the best way to get rid of it is to demolish every tile around it as soon as possible, edit mode isn't disabled during disasters.

Nuclear meltdowns always have the same risk of happening. When a fission nuclear power plant explodes it spreads radiation (even if the fire was propagated from another building). Radiation takes a really long time to disappear, and there is no way of building things on top of it or of removing it. It can stay in both water and land.

Disasters can be turned off in the options menu, if you prefer to play that way.

=== Game Over ===
The only way to lose in this game is to have a negative budget 4 times in a row. If there is a positive budget, the counter decreases back to 0 once per positive budget. Note that negative funds don't matter in this case.

After 4 negative budgets, the population will get tired of you and remove you from your position as mayor.

There is no way to win - Isn't the satisfaction of a fully developed city enough for everybody?

== Controls ==
'''City map:'''

Select - Build menu

Start - Pause menu

B - Hold to move around the map

A - If not building, show the name of the element under the cursor

== Screenshots ==
https://dlhb.gamebrew.org/gbhomebrews/ucitygbc2.png
https://dlhb.gamebrew.org/gbhomebrews/ucitygbc3.png

==Media==
'''[GBC Game] µCity v1.0''' ([https://www.youtube.com/watch?v=2rir-TVx020 Antonio Niño Díaz]) <br>
<youtube>2rir-TVx020</youtube>

== Changelog ==
'''v1.3 2025/08/09'''
* Improve multiplication routine. [https://github.com/lancekindle @lancekindle]
* Update source code syntax for new versions of rgbasm.
* Fix a bug that prevented disabling the cartridge RAM and kept it writeable. [https://github.com/Rangi42 @Rangi42]
* Fix the maximum and minimum memory limits. [https://github.com/Rangi42 @Rangi42]

'''v1.2 2018/01/31'''
* Update links to website.

'''v1.1 2017/12/13'''
* Fixed bug that would prevent the background from being updated if the animations were disabled.
* Small improvements to the documentation.

'''v1.0 2017/06/15'''
* First official release of the game.

'''Beta v0.5 2017/05/03'''
* Final beta version. All elements of the game are implemented. Remaining tasks are testing, cleanup and documentation.

'''Beta v0.4 2017/02/01'''
* Beta version. Most of the elements of the game are implemented, but they need to be polished.

'''Alpha 3 2016/08/15'''
* Alpha version - Non playable.

'''Alpha 2 2016/06/05'''
* Alpha version - Non playable.

'''Alpha 1 2016/04/09'''
* Alpha version - Non playable.

== Credits ==
Game made by AntonioND/SkyLyrac (Antonio Niño Díaz).

Tools:
* [https://openmpt.org/ Open ModPlug Tracker]
* [https://github.com/AntonioND/gbt-player GBT Player]
* [http://www.devrs.com/gb/hmgd/gbmb.html GBTD (Game Boy Tile Designer)]
* [http://www.devrs.com/gb/hmgd/gbtd.html GBMB (Game Boy Map Builder)]

Thanks to:
* beware: For the emulator [http://bgb.bircd.org/ BGB], extremely useful tool used to develop this game.
* Pan of Anthrox, Marat Fayzullin, Pascal Felber, Paul Robson, Martin Korth (nocash) and kOOPa for the pandocs.
* Otaku No Zoku (Justin Lloyd) for the Gameboy Crib Sheet.
* Everyone that has contributed to develop <code>RGBDS</code> over the years, specially Carsten Sorensen, Justin Lloyd, Vegard Nossum and Anthony J. Bentley.

== External links ==
* Author's website - http://www.skylyrac.net/
* Codeberg - https://codeberg.org/SkyLyrac/ucity
* GitHub - https://github.com/AntonioND/ucity/

UCity GB

2026-01-25T15:52:28Z

SkyLyrac: Fix links and add link to uCity Advance

{{Infobox GB Homebrews
|title=uCity
|image=ucitygbc.png
|description=The open-source city-building game for Game Boy Color.
|author=AntonioND (SkyLyrac)
|lastupdated=2025/08/09
|type=Strategy
|version=1.3
|license=GPL-3.0
|format=CGB
|download=https://dlhb.gamebrew.org/gbhomebrews/ucitygbc.7z
|website=https://github.com/AntonioND/ucity/
|source=https://codeberg.org/SkyLyrac/ucity
}}
{{#seo:
|title=GameBrew
|title_mode=append
|image=ucitygbc.png
|image_alt=uCity
}}{{lowercase title}}
This is µCity (also spelled 'uCity', pronounced 'micro-city'), the open-source city-building game for Game Boy Color.

Note: There's also a version for GBA [https://www.gamebrew.org/wiki/Ucity_Advance_GBA here].

== Installation ==
The ROM file can be used with an emulator or on a real Game Boy.

There are two available ROMs. ucity.gbc is the preferred ROM that you should use. It can save up to 16 cities depending on the memory available in your emulator or flashcart.

If your emulator fails to load this ROM because of an unknown RAM size or your flashcart fails to save data, try ucity_compat.gbc. This ROM will only be able to save up to 4 cities, but it is more likely to work in all cases.

== User guide ==
Game manual can be found [https://github.com/AntonioND/ucity/blob/master/manual.rst here].

=== Getting started ===
The game's objective is city-building. You can choose to start with a predefined scenario or with a completely empty random map.

If you decide to go for a random map, remember that the number used as seed to generate the map will always generate the same map, in case you want to play again the same map.

Note that, at some point, a red dot may appear on the screen and not let you do certain actions. This means that the game is simulating something and it can't let you do that until the simulation step has ended.

=== Building ===
Most buildings can be built by the player, but some of the most important ones can't. Residential, commercial and industrial buildings (houses, shops and factories respectively) must be created by the city. The player can only try to attract people to the city.

Also, buildings can't be built on top of others. The exception are power lines, which can be replaced by any building (not roads or train tracks).

Demolishing buildings is as easy as building them, just select the dynamite in the building selection menu.

There are some buildings that require specific things to be built (like having more than a certain number of people, having a specific technological level, etc).

The type of the building can be checked by pressing A when the cursor is over it. However, as an additional help, this is the list of available buildings in the menu:

* Delete - Demolish building.
* RCI Zones - Residential, commercial, industrial.
* Roads and power - Road, train tracks, power lines.
* Services - Police department, fire department, hospital.
* Parks and Recreation - Small park, big park, stadium.
* Education - School, high school, university.
* Culture - Museum, library.
* Transportation - Port, airport.
* Fossil power plants - Coal, oil, nuclear fission.
* Renewable power plants - Solar, wind, nuclear fusion.

=== Services ===
Services are needed to make the population happy. While all buildings have a level of happiness based on the needs that are met, it is specially important for residential, commercial and industrial zones. If those zones don't have their needs covered, people will leave them.

The services needed by people are determined by the class of the settlement.

Police departments and schools are always needed. It is only needed to build fire department, hospitals and high schools when the settlement becomes a town.

Universities are a special case. They are not needed to cover the needs of the population, but they are the only ways of making the technological level of the city increase. This is the only way of unlocking fission nuclear power plants and, eventually, fusion power plants.

=== Transportation ===
Transportation is essential to allow people move between different buildings. Residential areas are sources of traffic and other areas are sinks of traffic.

If people in residential areas cannot reach schools and workplaces (commercial and industrial zones, for example) they will leave.

Roads and train tracks have a specific capacity. The more people using them, the less people will want to use them. At some point, they are too crowded for more people to use them.

Roads and train tracks can be interleaved and they count as being connected even if the drawing of the tiles in the map don't look like they are connected. It is enough for them to be next to each other.

Ports and airports don't have any effect on transportation within a city, they are only a source of income, like stadiums.

=== Power ===
Power plants are needed to provide energy to all your buildings (even parks!). Buildings with no power can't work.

The generation depends on the time of the year. Some power plants are more effective in summer, like solar power plants, and others are more effective in winter, like wind power plants. All other power plants are slightly affected by the time of the year, the efficiency depends on the temperature of the environment after all.

=== Pollution ===
Transportation, factories, polluting power plants... They all create pollution. A polluted city will make less people want to come!

=== City class ===
A settlement changes class depending on the population and the presence of some buildings.

* Village - From the start.
* Town - Population >= 500.
* City - At least one library. Population >= 1000.
* Metropolis - At least one stadium, university and museum. Population >= 3000.
* Capital - At least one port and an airport. Population >= 6000.

The requirements add up, that is, to upgrade to a capital it is needed to meet all requirements of the lower classes.

Similarly, some building types are unlocked by reaching specific classes.

* City - Unlocks stadiums, ports and airports.

=== Loans ===
If you are short of money, you can ask the bank for a loan. Information about the payments is in the same screen where you can get them. You can only have one loan at a time.

=== Disasters ===
Sometimes, unexpected disastrous events can happen. In this game, fires can happen anytime, as well as nuclear meltdowns (if there are fission nuclear power plants).

The more fire departments, the lower the risk of fires. However, once a fire has started, the best way to get rid of it is to demolish every tile around it as soon as possible, edit mode isn't disabled during disasters.

Nuclear meltdowns always have the same risk of happening. When a fission nuclear power plant explodes it spreads radiation (even if the fire was propagated from another building). Radiation takes a really long time to disappear, and there is no way of building things on top of it or of removing it. It can stay in both water and land.

Disasters can be turned off in the options menu, if you prefer to play that way.

=== Game Over ===
The only way to lose in this game is to have a negative budget 4 times in a row. If there is a positive budget, the counter decreases back to 0 once per positive budget. Note that negative funds don't matter in this case.

After 4 negative budgets, the population will get tired of you and remove you from your position as mayor.

There is no way to win - Isn't the satisfaction of a fully developed city enough for everybody?

== Controls ==
'''City map:'''

Select - Build menu

Start - Pause menu

B - Hold to move around the map

A - If not building, show the name of the element under the cursor

== Screenshots ==
https://dlhb.gamebrew.org/gbhomebrews/ucitygbc2.png
https://dlhb.gamebrew.org/gbhomebrews/ucitygbc3.png

==Media==
'''[GBC Game] µCity v1.0''' ([https://www.youtube.com/watch?v=2rir-TVx020 Antonio Niño Díaz]) <br>
<youtube>2rir-TVx020</youtube>

== Changelog ==
'''v1.3 2025/08/09'''
* Improve multiplication routine. [https://github.com/lancekindle @lancekindle]
* Update source code syntax for new versions of rgbasm.
* Fix a bug that prevented disabling the cartridge RAM and kept it writeable. [https://github.com/Rangi42 @Rangi42]
* Fix the maximum and minimum memory limits. [https://github.com/Rangi42 @Rangi42]

'''v1.2 2018/01/31'''
* Update links to website.

'''v1.1 2017/12/13'''
* Fixed bug that would prevent the background from being updated if the animations were disabled.
* Small improvements to the documentation.

'''v1.0 2017/06/15'''
* First official release of the game.

'''Beta v0.5 2017/05/03'''
* Final beta version. All elements of the game are implemented. Remaining tasks are testing, cleanup and documentation.

'''Beta v0.4 2017/02/01'''
* Beta version. Most of the elements of the game are implemented, but they need to be polished.

'''Alpha 3 2016/08/15'''
* Alpha version - Non playable.

'''Alpha 2 2016/06/05'''
* Alpha version - Non playable.

'''Alpha 1 2016/04/09'''
* Alpha version - Non playable.

== Credits ==
Game made by AntonioND/SkyLyrac (Antonio Niño Díaz).

Tools:
* [https://openmpt.org/ Open ModPlug Tracker]
* [https://github.com/AntonioND/gbt-player GBT Player]
* [http://www.devrs.com/gb/hmgd/gbmb.html GBTD (Game Boy Tile Designer)]
* [http://www.devrs.com/gb/hmgd/gbtd.html GBMB (Game Boy Map Builder)]

Thanks to:
* beware: For the emulator [http://bgb.bircd.org/ BGB], extremely useful tool used to develop this game.
* Pan of Anthrox, Marat Fayzullin, Pascal Felber, Paul Robson, Martin Korth (nocash) and kOOPa for the pandocs.
* Otaku No Zoku (Justin Lloyd) for the Gameboy Crib Sheet.
* Everyone that has contributed to develop <code>RGBDS</code> over the years, specially Carsten Sorensen, Justin Lloyd, Vegard Nossum and Anthony J. Bentley.

== External links ==
* Author's website - http://www.skylyrac.net/
* Codeberg - https://codeberg.org/SkyLyrac/ucity
* GitHub - https://github.com/AntonioND/ucity/

UCity GB

2026-01-25T15:49:34Z

SkyLyrac:

{{Infobox GB Homebrews
|title=uCity
|image=ucitygbc.png
|description=The open-source city-building game for Game Boy Color.
|author=AntonioND (SkyLyrac)
|lastupdated=2025/08/09
|type=Strategy
|version=1.3
|format=CGB
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/gbhomebrews/ucitygbc.7z
|website=https://github.com/AntonioND/ucity/
|source=https://github.com/AntonioND/ucity/
|donation=
}}
{{#seo:
|title=GameBrew
|title_mode=append
|image=ucitygbc.png
|image_alt=uCity
}}{{lowercase title}}
This is µCity (also spelled 'uCity', pronounced 'micro-city'), the open-source city-building game for Game Boy Color.

== Installation ==
The ROM file can be used with an emulator or on a real Game Boy.

There are two available ROMs. ucity.gbc is the preferred ROM that you should use. It can save up to 16 cities depending on the memory available in your emulator or flashcart.

If your emulator fails to load this ROM because of an unknown RAM size or your flashcart fails to save data, try ucity_compat.gbc. This ROM will only be able to save up to 4 cities, but it is more likely to work in all cases.

== User guide ==
Game manual can be found [https://github.com/AntonioND/ucity/blob/master/manual.rst here].

=== Getting started ===
The game's objective is city-building. You can choose to start with a predefined scenario or with a completely empty random map.

If you decide to go for a random map, remember that the number used as seed to generate the map will always generate the same map, in case you want to play again the same map.

Note that, at some point, a red dot may appear on the screen and not let you do certain actions. This means that the game is simulating something and it can't let you do that until the simulation step has ended.

=== Building ===
Most buildings can be built by the player, but some of the most important ones can't. Residential, commercial and industrial buildings (houses, shops and factories respectively) must be created by the city. The player can only try to attract people to the city.

Also, buildings can't be built on top of others. The exception are power lines, which can be replaced by any building (not roads or train tracks).

Demolishing buildings is as easy as building them, just select the dynamite in the building selection menu.

There are some buildings that require specific things to be built (like having more than a certain number of people, having a specific technological level, etc).

The type of the building can be checked by pressing A when the cursor is over it. However, as an additional help, this is the list of available buildings in the menu:

* Delete - Demolish building.
* RCI Zones - Residential, commercial, industrial.
* Roads and power - Road, train tracks, power lines.
* Services - Police department, fire department, hospital.
* Parks and Recreation - Small park, big park, stadium.
* Education - School, high school, university.
* Culture - Museum, library.
* Transportation - Port, airport.
* Fossil power plants - Coal, oil, nuclear fission.
* Renewable power plants - Solar, wind, nuclear fusion.

=== Services ===
Services are needed to make the population happy. While all buildings have a level of happiness based on the needs that are met, it is specially important for residential, commercial and industrial zones. If those zones don't have their needs covered, people will leave them.

The services needed by people are determined by the class of the settlement.

Police departments and schools are always needed. It is only needed to build fire department, hospitals and high schools when the settlement becomes a town.

Universities are a special case. They are not needed to cover the needs of the population, but they are the only ways of making the technological level of the city increase. This is the only way of unlocking fission nuclear power plants and, eventually, fusion power plants.

=== Transportation ===
Transportation is essential to allow people move between different buildings. Residential areas are sources of traffic and other areas are sinks of traffic.

If people in residential areas cannot reach schools and workplaces (commercial and industrial zones, for example) they will leave.

Roads and train tracks have a specific capacity. The more people using them, the less people will want to use them. At some point, they are too crowded for more people to use them.

Roads and train tracks can be interleaved and they count as being connected even if the drawing of the tiles in the map don't look like they are connected. It is enough for them to be next to each other.

Ports and airports don't have any effect on transportation within a city, they are only a source of income, like stadiums.

=== Power ===
Power plants are needed to provide energy to all your buildings (even parks!). Buildings with no power can't work.

The generation depends on the time of the year. Some power plants are more effective in summer, like solar power plants, and others are more effective in winter, like wind power plants. All other power plants are slightly affected by the time of the year, the efficiency depends on the temperature of the environment after all.

=== Pollution ===
Transportation, factories, polluting power plants... They all create pollution. A polluted city will make less people want to come!

=== City class ===
A settlement changes class depending on the population and the presence of some buildings.

* Village - From the start.
* Town - Population >= 500.
* City - At least one library. Population >= 1000.
* Metropolis - At least one stadium, university and museum. Population >= 3000.
* Capital - At least one port and an airport. Population >= 6000.

The requirements add up, that is, to upgrade to a capital it is needed to meet all requirements of the lower classes.

Similarly, some building types are unlocked by reaching specific classes.

* City - Unlocks stadiums, ports and airports.

=== Loans ===
If you are short of money, you can ask the bank for a loan. Information about the payments is in the same screen where you can get them. You can only have one loan at a time.

=== Disasters ===
Sometimes, unexpected disastrous events can happen. In this game, fires can happen anytime, as well as nuclear meltdowns (if there are fission nuclear power plants).

The more fire departments, the lower the risk of fires. However, once a fire has started, the best way to get rid of it is to demolish every tile around it as soon as possible, edit mode isn't disabled during disasters.

Nuclear meltdowns always have the same risk of happening. When a fission nuclear power plant explodes it spreads radiation (even if the fire was propagated from another building). Radiation takes a really long time to disappear, and there is no way of building things on top of it or of removing it. It can stay in both water and land.

Disasters can be turned off in the options menu, if you prefer to play that way.

=== Game Over ===
The only way to lose in this game is to have a negative budget 4 times in a row. If there is a positive budget, the counter decreases back to 0 once per positive budget. Note that negative funds don't matter in this case.

After 4 negative budgets, the population will get tired of you and remove you from your position as mayor.

There is no way to win - Isn't the satisfaction of a fully developed city enough for everybody?

== Controls ==
'''City map:'''

Select - Build menu

Start - Pause menu

B - Hold to move around the map

A - If not building, show the name of the element under the cursor

== Screenshots ==
https://dlhb.gamebrew.org/gbhomebrews/ucitygbc2.png
https://dlhb.gamebrew.org/gbhomebrews/ucitygbc3.png

==Media==
'''[GBC Game] µCity v1.0''' ([https://www.youtube.com/watch?v=2rir-TVx020 Antonio Niño Díaz]) <br>
<youtube>2rir-TVx020</youtube>

== Changelog ==
'''v1.3 2025/08/09'''
* Improve multiplication routine. [https://github.com/lancekindle @lancekindle]
* Update source code syntax for new versions of rgbasm.
* Fix a bug that prevented disabling the cartridge RAM and kept it writeable. [https://github.com/Rangi42 @Rangi42]
* Fix the maximum and minimum memory limits. [https://github.com/Rangi42 @Rangi42]

'''v1.2 2018/01/31'''
* Update links to website.

'''v1.1 2017/12/13'''
* Fixed bug that would prevent the background from being updated if the animations were disabled.
* Small improvements to the documentation.

'''v1.0 2017/06/15'''
* First official release of the game.

'''Beta v0.5 2017/05/03'''
* Final beta version. All elements of the game are implemented. Remaining tasks are testing, cleanup and documentation.

'''Beta v0.4 2017/02/01'''
* Beta version. Most of the elements of the game are implemented, but they need to be polished.

'''Alpha 3 2016/08/15'''
* Alpha version - Non playable.

'''Alpha 2 2016/06/05'''
* Alpha version - Non playable.

'''Alpha 1 2016/04/09'''
* Alpha version - Non playable.

== Credits ==
Game made by AntonioND/SkyLyrac (Antonio Niño Díaz).

Tools:
* [https://openmpt.org/ Open ModPlug Tracker]
* [https://github.com/AntonioND/gbt-player GBT Player]
* [http://www.devrs.com/gb/hmgd/gbmb.html GBTD (Game Boy Tile Designer)]
* [http://www.devrs.com/gb/hmgd/gbtd.html GBMB (Game Boy Map Builder)]

Thanks to:
* beware: For the emulator [http://bgb.bircd.org/ BGB], extremely useful tool used to develop this game.
* Pan of Anthrox, Marat Fayzullin, Pascal Felber, Paul Robson, Martin Korth (nocash) and kOOPa for the pandocs.
* Otaku No Zoku (Justin Lloyd) for the Gameboy Crib Sheet.
* Everyone that has contributed to develop <code>RGBDS</code> over the years, specially Carsten Sorensen, Justin Lloyd, Vegard Nossum and Anthony J. Bentley.

== External links ==
* Author's website - http://www.skylyrac.net/
* GitHub - https://github.com/AntonioND/ucity/

Ucity Advance GBA

2026-01-25T15:44:21Z

SkyLyrac: Update links

{{#seo:
|title= (Simulation) - GameBrew
|title_mode=append
|image=ucityadvance2.png
|image_alt=ucity Advance
}}
{{Infobox GBA Homebrews
|title=ucity Advance
|image=ucityadvance02.png
|description=An open-source city-building game.
|author=AntonioND (SkyLyrac)
|lastupdated=2022/04/01
|type=Simulation
|version=1.0.2
|license=Mixed
|download=https://dlhb.gamebrew.org/gbahomebrews/ucityadvance.7z
|website=https://codeberg.org/SkyLyrac/ucity-advance
|source=https://codeberg.org/SkyLyrac/ucity-advance
}}
This is µCity Advance (also spelled 'uCity', pronounced 'micro-city'), the open-source city-building game for Game Boy Advance and PC. This is a remake of the original [https://www.gamebrew.org/wiki/UCity_GB µCity for Game Boy Color].

It was showcased in the GBA Jam 2021.

==User guide==
===Getting start===
The aim of the game is to build a city. Simple enough.

The first thing to do is to decide whether you want to start with a predefined scenario or with a completely empty random map.

If you decide to go for a random map, remember that the number used as seed to generate the map will always generate the same map, in case you want to play again the same map.

Note that, at some point, a red dot may appear on the screen and not let you do certain actions. This means that the game is simulating something and it can't let you do that until the simulation step has ended.

===Building===
Most buildings can be built by the player, but some of the most important ones can't. Residential, commercial and industrial buildings (houses, shops and factories respectively) must be created by the city. The player can only try to attract people to the city.

Also, buildings can't be built on top of others. The exception are power lines, which can be replaced by any building (not roads or train tracks).

Demolishing buildings is as easy as building them, just select the dynamite in the building selection menu.

There are some buildings that require specific things to be built (like having more than a certain number of people, having a specific technological level, etc).

The type of the building can be checked by pressing A when the cursor is over it. However, as an additional help, this is the list of available buildings in the menu:

* Delete - Demolish building.
* RCI Zones - Residential, commercial, industrial.
* Roads and power - Road, train tracks, power lines.
* Services - Police department, fire department, hospital.
* Parks and Recreation - Small park, big park, stadium.
* Education - School, high school, university.
* Culture - Museum, library.
* Transportation - Port, airport.
* Fossil power plants - Coal, oil, nuclear fission.
* Renewable power plants - Solar, wind, nuclear fusion.

===Services===
Services are needed to make the population happy. While all buildings have a level of happiness based on the needs that are met, it is specially important for residential, commercial and industrial zones. If those zones don't have their needs covered, people will leave them.

The services needed by people are determined by the class of the settlement.

Police departments and schools are always needed. It is only needed to build fire department, hospitals and high schools when the settlement becomes a town.

Universities are a special case. They are not needed to cover the needs of the population, but they are the only ways of making the technological level of the city increase. This is the only way of unlocking fission nuclear power plants and, eventually, fusion power plants.

===Transportation===
Transportation is essential to allow people move between different buildings. Residential areas are sources of traffic and other areas are sinks of traffic.

If people in residential areas cannot reach schools and workplaces (commercial and industrial zones, for example) they will leave.

Roads and train tracks have a specific capacity. The more people using them, the less people will want to use them. At some point, they are too crowded for more people to use them.

Roads and train tracks can be interleaved and they count as being connected even if the drawing of the tiles in the map don't look like they are connected. It is enough for them to be next to each other.

Ports and airports don't have any effect on transportation within a city, they are only a source of income, like stadiums.

===Power===
Power plants are needed to provide energy to all your buildings (even parks!). Buildings with no power can't work.

The generation depends on the time of the year. Some power plants are more effective in summer, like solar power plants, and others are more effective in winter, like wind power plants. All other power plants are slightly affected by the time of the year, the efficiency depends on the temperature of the environment after all.

===Pollution===
Transportation, factories, polluting power plants... They all create pollution. A polluted city will make less people want to come!

===City class===
A settlement changes class depending on the population and the presence of some buildings.

*Village - From the start.
*Town - Population >= 500.
*City - At least one library. Population >= 1000.
*Metropolis - At least one stadium, university and museum. Population >= 3000.
*Capital - At least one port and an airport. Population >= 6000.

The requirements add up, that is, to upgrade to a capital it is needed to meet all requirements of the lower classes.

Similarly, some building types are unlocked by reaching specific classes.

*City - Unlocks stadiums, ports and airports.

===Loans===
If you are short of money, you can ask the bank for a loan. Information about the payments is in the same screen where you can get them. You can only have one loan at a time.

===Disasters===
Sometimes, unexpected disastrous events can happen. In this game, fires can happen anytime, as well as nuclear meltdowns (if there are fission nuclear power plants).

The more fire departments, the lower the risk of fires. However, once a fire has started, the best way to get rid of it is to demolish every tile around it as soon as possible, edit mode isn't disabled during disasters.

Nuclear meltdowns always have the same risk of happening. When a fission nuclear power plant explodes it spreads radiation (even if the fire was propagated from another building). Radiation takes a really long time to disappear, and there is no way of building things on top of it or of removing it. It can stay in both water and land.

Disasters can be turned off in the options menu, if you prefer to play that way.

===Game Over===
The only way to lose in this game is to have a negative budget 4 times in a row. If there is a positive budget, the counter decreases back to 0 once per positive budget. Note that negative funds don't matter in this case.

After 4 negative budgets, the population will get tired of you and remove you from your position as mayor.

There is no way to win - Isn't the satisfaction of a fully developed city enough for everybody?

==Controls==
'''City map:'''

Select/L - Build menu

Start/R - Pause menu

B - Hold to move around the map

A - If not building, show the name of the element under the cursor

==Screenshots==
https://dlhb.gamebrew.org/gbahomebrews/ucityadvance3.png
https://dlhb.gamebrew.org/gbahomebrews/ucityadvance4.png

https://dlhb.gamebrew.org/gbahomebrews/ucityadvance5.png
https://dlhb.gamebrew.org/gbahomebrews/ucityadvance6.png

==Media==
'''[GBA Game] µCity Advance v1.0''' ([https://www.youtube.com/watch?v=xYQfRM_zih0 Antonio Niño Díaz]) <br>
<youtube>xYQfRM_zih0</youtube>

==Compatibility==
Runs on GBA emulator like mGBA, or a flashcart and a real GBA.

==Changelog==
'''v1.0.2'''
*Fix potential issue when accessing SRAM. This hasn't been confirmed to be an issue, but it's better to be safe than sorry.
*Change game code to tell the EverDrive GBA that the save type of this game is SRAM.
*Lots of build system changes under the hood that don't affect the game.

'''v1.0.1'''
*Add some missing credits.

==Credits==
Game, art, SFXs and some music made by AntonioND/SkyLyrac (Antonio Niño Díaz).

Most music obtained from [https://modarchive.org/ The Mod Archive].

Third party tools and libraries used:
* [https://devkitpro.org/ devkitPro].
* [https://www.libsdl.org/ SDL 2].
* [http://www.libpng.org/pub/png/libpng.html libpng].
* [https://codeberg.org/SkyLyrac/giibiiadvance GiiBiiAdvance].
* [https://www.aseprite.org/ Aseprite].
* [https://www.mapeditor.org/ Tiled].
* [https://jfxr.frozenfractal.com/ JFXR].
* [https://openmpt.org/ Open ModPlug Tracker].
* [https://modarchive.org/ The Mod Archive].

==External links==
* Author's website - http://www.skylyrac.net/
* itch.io - https://skylyrac.itch.io/ucity-advance
* Codeberg - https://codeberg.org/SkyLyrac/ucity-advance
* GitHub - https://github.com/AntonioND/ucity-advance

[[Category:GBA Jam 2021]]

Meteora Galatic Battle

2026-01-22T22:54:45Z

SkyLyrac: Update link

{{Infobox DS Homebrews
|title=Meteora Galactic Battle
|image=meteora.png
|description=Meteroa is a space/fantasy based god-sim game by J.
|author=Jerome Wax (X-Blaster)
|lastupdated=2007/08/21
|type=Simulation
|version=0.9.2
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/meteora.7z?k33p0fil35 0.8.0 & 0.9.2
|downloadraw=http://meteora.lo2k.net/download/meteora-src.rar
|website=http://meteora.lo2k.net
|source=https://codeberg.org/SkyLyrac/meteora
}}
Meteroa is a space fantasy based god-sim game by Jerome Wax that lies somewhere between populous, world of sand and pong. From over 8 months of development, it is a game of strategy action in space.

It was submitted to the NEO Summer Coding Compo 2007 (NDS Game, 3rd place). Verion 0.8.0 Meteora Evolution was presented in the Dev-fr Coding Compo 2007 (Game, 2nd place).

In 2024, the game was ported to [https://blocksds.skylyrac.net BlocksDS] by AntonioND to support modern tools and for better compatibility on DSi mode.

==Feature==
* An engine containing a garbage collector to avoid memory leaks during development.
* Use the microphone for certain powers.
* Use of gestures.
* Visual effects (explosions, earthquakes, meteor streaks).
* Use of dual-screen 3D (thanks to the ulib).
* Sprites more than 1200 on the screen.

==User guide==
Meteora is an action version of meteos. It is a game where planets attack each other. You control one of the two planets and by sending mana your goal is to get your opponent's life to zero before you do.

You and your opponent have:
* Mana (to use your powers).
* A shield that constantly regenerates.
* The clean energy of your planet.

Whenever you send an attack up the screen, your opponent will receive it (planets can be several light years apart). Your opponent can deflect your attacks as you might, ie by using his God Powers.

You must therefore send as many attacks as possible towards your opponent while trying to stop the attacks coming from your opponent.

===Mana===
Your planet has a certain amount of mana you regain all the time. Free the mana to deflect, destroy the enemy attacks.

Your Stylus acts as a magnet to which you belong. The more you're ready for a ball of mana, the more you attract, the more you are away, your pen is less effective. Keep this principle in mind as you play. To successfully send an attack so do not give a boost with the stylus but with your attack.

===Powers of God===
You can at any time use your powers of god. However, you should have enough mana and respect the cooldown (cooldown).

Some powers require additional action on your part such as creating glyphs or a certain breath.

The list of powers is quite long, it is suggested to read [http://meteora.lo2k.net/Master/pouvoirs the list of powers] for more information of each of them.

===Attacks===
* '''Instant:'''
** Send a volley of meteorites towards your opponent (e.g. Multiple Shot). A formidable weapon, the more you use it, the less its cost and reload time will be.
** You can direct your attacks with your stylus.

* '''Charged:'''
** These attacks will load over time (e.g. Frost Flame). 10 to 15 seconds and your mana size is maximum. Leave no respite and send this kind of monster on your opponent.
** Merge the different types of charged mana together, they will grow even faster. Also remember to bring them back to your planet to grow your mana.

* '''Shrapnel:'''
** The shrapnel attack explodes at the slightest shock with an attack from your opponent. Indispensable to decimate an enemy attack or to create an effective defense.
** Merge there with a charged attack to make it even more effective. If you manage to merge several shrapnel between them ... your attack can become ultimate.

===Defenses===
* '''God's wind:'''
** The Wind of God can repel enemy attacks or send your own attacks more effectively. When you activate it, you have a limited time of use (icons available in the upper right corner of the bottom screen). If you blow on the Nintendo DS while the icon is visible, your breath will be transmitted in the game and it will allow many things to happen.
** Be careful not to hyperventilate. The more you use it, the longer its reload time...

* '''Change of sides:'''
** When you activate this spell, you will need to perform a glyph in a limited time.
** To do this, you have to touch the yellow symbols before they disappear. It is also necessary to make sure that nothing touches a symbol during the invocation of this spell. If you can do it right, whatever is on the screen will be yours. If you perform it during an enemy attack, that attack will be in your possession. You are free to return it to your opponent or to attract it to your planet in order to benefit from a mana bonus.
** If you have a hard time at first, use it in conjunction with god's wind, so that the bottom part of the screen is blank while the glyph is running.

===Power ups===
* '''Mana increase:'''
** You can increase the maximum mana rate and the speed of your mana gain. Don't overlook this kind of power, they can actually play a big part in the game. Be careful though, the more you use them, the more they cost.

==Controls==
Up/Down - Release mana

Stylus - Attract mana

L/R - Use God Powers

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/meteora2.png
https://dlhb.gamebrew.org/dshomebrew/meteora4.png

https://dlhb.gamebrew.org/dshomebrew/meteora3.png
https://dlhb.gamebrew.org/dshomebrew/meteora5.png

==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/c/c8/Meteora.png
|EJS_core=nds
|EJS_gameName=Meteora Galactic Battle
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/meteora.7z
}}
{{DS Control Settings}}

==Credits==
Brunni, Mollusk, Reppa, Benoit Charcosset, Audrey.

Everyone in dev-fr.

==External links==
* Official website - [https://web.archive.org/web/20140615140612/http://meteora.lo2k.net http://meteora.lo2k.net] (archived)
* NeoFlash - [https://web.archive.org/web/20210208003002/https://www.neoflash.com/forum/index.php?topic=4569.0 https://www.neoflash.com/forum/index.php?topic=4569.0] (archived)

[[Category:NEO Summer Coding Compo 2007]]
[[Category:Dev-fr Coding Compo 2007]]

Bunjalloo

2026-01-09T02:41:38Z

SkyLyrac: Update URL of git repository.

{{Infobox DS Homebrews
|title=Bunjalloo
|image=Snapshot 2025-11-02 02-42-36.png
|description=Simple web browser for the Nintendo DS.
|author=quirkysoft, AntonioND
|lastupdated=2025/11/29
|type=Utilities
|version=0.12.0
|license=Mixed
|download=https://codeberg.org/SkyLyrac/bunjalloo/releases
|website=https://codeberg.org/SkyLyrac/bunjalloo
|source=https://codeberg.org/SkyLyrac/bunjalloo
}}

This is Bunjalloo, the open source Nintendo DS web browser. It was originally developed by Richard Quirk until 2010. This repository contains a working fork that you can build with modern BlocksDS.

Bunjalloo has been implemented from scratch [http://www.whatwg.org/ using the whatwg user agent design rules].

This version can take advantage of the additional RAM, CPU power, and WPA2 support of DSi. It also uses modern cryptographic libraries to support modern TLS protocols.

==Features==
* Bookmark support.
* Cookie and image support.
* Optional CA certificate checks.

==Installation==
Extract the data folder and contents to the root of your SD card.

Extract the .nds file to the root of your SD Card.

[[DLDI|DLDI]] patch the .nds file if your card needs it.

==Controls==
* Start: Enter a URL
* Up/Down: Scroll screen up and down
* Left/Right: Scroll screen a page at a time
* R: Move forwards in the history
* L: Move backwards in the history
* Click stylus: Follow link, enter data in forms, press keys.
* Hold stylus: Scroll.

==Changelog==
'''Version 0.12.0'''
* User changes:
** Lists (unordered and ordered) are now supported. They aren't perfect, but they make lots of websites a lot more readable than before.
** The system that lays out elements on the screen has been heavily reworked, which was needed to support lists. Some websites display more spaces than before in some places.
** Links of the type <code>//yourdomain.com/about/example.html</code> now work. They are absolute links that contain everything except for the schema (HTTP, HTTPS, etc), which is preserved.
** The download queue used to stop before some files were fully downloaded. This prevented some images from being displayed, for example.
** MIME type <code>text/xhtml</code> is now allowed. It's parsed the same way as HTML.
** Editable text areas were very buggy. The caret jumped around when editing text around the edges, adding and deleting characters could make the application crash. This has been fixed.
** Combo boxes with entries that were too long displayed text outside of the box, on the right (only after selecting a too long entry). The text is now clipped correctly.
** The font Bitstream Vera has been replaced by DejaVu, which is based on Bitstream Vera and adds a lot of additional characters. The license text has been replaced as well. Note that it wasn't possible to keep using the old TTF file because the converted font wasn't created using <code>convertftf</code>, but a conversion script that was removed before version 0.8.0.
** Charset detection has been improved. Some websites, like Wikipedia, were using <code>meta</code> tags to communicate the encoding, and they were ignored by the parser.
** Websites are now considered to be encoded in UTF-8 instead of ISO 8859-1. This is needed because some websites may communicate the encoding in ways that Bunjalloo doesn't understand, and most websites are in UTF-8 anyway.
** ISO 8859-1 decoding has been improved. Replacement characters are printed when invalid encodings are found.
** The home page of the browser has been simplified.
** Websites that ended with an incomplete UTF-8 character would hang the HTML parser. This has been fixed.
** Version 0.11.0 partially fixed a bug where combo boxes would remain open after going forwards or backwards in the browsing history, for example. This has now been fixed properly.
** The SDL application will exit instead of crashing if the inittialization of SDL fails.
* Dev changes:
** Components now support having indentation. ViewRender and BoxLayout have been modified to support components with indentation, like lists. In a list, new text areas are created whenever a new indentation is needed.<br />

** The HTML renderer and BoxLayout have been modified to support indentation.<br />

** 3 digit color codes are now supported in the HTML parser. They will be used to change the background color, but it isn't supported yet.<br />

** The HTML formatting of the in-application user documentation has been fixed.<br />

** The build system has been heavily refactored. Instead of building many libraries (libbunjalloo, libbwt, libndspp) and linking them with the final binary (Bunjalloo and unit tests), now there's a common makefile that generates libbunjalloo and the Bunjalloo binary. Thanks to this the makefiles of the tests only have to link one library instead of three. Also, it's easier to make changes to Bunjalloo because any changes in the code will trigger a rebuild of the final binary (with different libraries the Makefile of the binary couldn't detect changes to the libraries).<br />

** The HTML parser now looks for <code>noscript</code> tags explicitly. Previously it still displayed the contents inside of them, but now it will be easier to change their display style if needed.<br />

** libvera has been renamed to libfont to be more generic and to not require more changes in the future.<br />

** Some outdated documentation has been cleaned and moved out of the wiki folder where they were initially saved.<br />

** All remaining tests with issues have been fixed. For example, the updater tests no longer crash on exit (it was caused due to a call to a pure virtual function in the Client class, which has been fixed).<br />

** There is now some debug code that paints rectangles around website elements on the screen. This is useful for debugging only, and it requires a rebuild to be enabled.<br />

** Some hardcoded strings have been replaced by constant names.<br />

** Bunjalloo now requests UTF-8 encoding before ISO 8859-1 in GET requests.<br />

** <code>convertftf</code> has been improved:
*** It has more error checks.
*** It allows cutting off pixels from the top or bottom of the font so that it fits better in the current widgets.
*** Color rounding has been simplified.
*** An additional shell script has been added to convert DejaVu automatically instead of having to remember how to run <code>convertftf</code> every time.

'''Version 0.11.0'''
* User changes:
** Slot-2 RAM expansion cartridges (such as the one that came with Opera) is now supported. They are used as temporary storage for images.
** Search engine shortcuts have been updated. Google and Yahoo have been removed because they no longer work. The Wikipedia search string has been updated, and DuckDuckGo, FrogFind! and GitHub have been added to the list.
** The URL used by the auto-updater has been fixed, so future versions of Bunjalloo can be downloaded by Bunjalloo itself. Note that auto-update only seems to work if the Bunjalloo ROM is in the root of the SD card.
** The NDS ROM of Bunjalloo now contains all the files it needs to run, it doesn't need to be distributed with a folder with lots of extra files. <code>data/bunjalloo</code> is now only used as temporary storage and for user configuration storage. Unfortunately, changing the font of the CA certificates now requires the user to use <code>ndstool</code> to modify the NitroFS files. Also, if <code>data/bunjalloo</code> doesn't exist at boot it will be created automatically.
** The text box used for keyboard input has been made a lot more stable. Sometimes some lines would be too long to fit and they would overflow to the next one displaying the last character. Sometimes deleting a character or adding a character would make the caret go over the line limit and cause a crash. This has been fixed. Also, now it's possible to press the white area after the text and the caret will be set to the last line with text instead of disappearing.
** A new protocol called <code>about://</code> has been added. This protocol is used for built-in pages that aren't stored in the filesystem or downloaded. Also, the home page <code>file://licence</code> has been moved to a file in NitroFS.
** The <code>file://</code> URI schema support has been improved. Now it supports servers. <code>file://localhost/file.txt</code> accesses a file at the root of the filesystem, <code>file://bunjalloo/file.txt</code> accesses a file inside <code>data/bunjalloo</code>, and <code>file://nitro/file.txt</code> accesses a file inside the NitroFS filesystem of Bunjalloo.
** A new internal page called <code>about://sysinfo</code> has been added. It shows system information such as available RAM. This page can be loaded while browsing a website and it will show the memory available after loading that website.
** Add missing credits and licenses to the homepage of the browser.
** Implement option that allows user to decide to clear the cache at boot or not. The setting was there, but it was unused.
** Transparency has been fixed in images that don't need to be scaled down to fit on the screen.
** The palette of the scroll touch screen icon is now loaded correctly so that it doesn't overlap with the colors used by the toolbar.
** Combo boxes have been made a lot more stable. Boxes that were too big would have a scroll bar outside of the screen (or cause a crash). If a combo box was left open and the user, for example, pressed "back" in the toolbar, or button Y to open the bookmarks, it would cause a crash. This all has been fixed in this version.
** In the SDL version, allow the user to set the gap between screens and the zoom factor with the environment variables <code>BUNJALLOO_SCREEN_GAP</code> and <code>BUNJALLOO_SCREEN_SCALE</code>. <code>NDS_GAP</code> is no longer supported.
** The SDL window now displays "Bunjalloo" as title instead of "SDL Application".
** In the SDL version, keyboard input with the PC input now works in a fluid way rather than having to wait for a second or so between each key press. Backspace and return keys are also supported now.
** Some checks have been added to the Canvas class to avoid crashes because of writting out bounds.
** Environment variable <code>NDS_DLDI</code> has been renamed to <code>BUNJALLOO_DLDI</code> and <code>NDS_LANG</code> has been renamed to <code>BUNJALLOO_LANGUAGE</code>.
* Dev changes:
** The HTML parser doesn't support partial parsing of data. The code is organized to fed it partial data, but the parser has several loops that assume that there is more data to be used, and they hang if there isn't more data. Instead of modifying the whole parser, a partial fix has been added: the HTML parser is now only called when the full website has been downloaded. This only fixes well-formed websites, and it will still hang on malformed websites.
** Codebase reorganized. Different libraries are now in different folders and can be built independently as static archives. This makes it possible to build tests without rebuilding all the codebase for each tests.
** Fully replace the old build system by a new one. Tools and tests can now be built with the new build system. Tests can also be run automatically with <code>make PLAT=SDL run</code> from the <code>tests</code> folder.
** GoogleTest v1.17.0 has been added to the repository. It is used by the test binaries.
** The instructions to change the TTF font used by Bunjalloo have been updated to work with <code>convertftf</code>.
** The crashes in the HtmlParser tests have been fixed.
** Some tests have been fixed. Some of them were broken during the development of versions 0.9.0 and 0.10.0 because the behaviour of some things changed.
** Most tests can be run automatically with one command from make.
** Many classes have been refactored to require fewer dynamic instantiations and reduce heap fragmentation.
** Lots of checks have been added to dynamic allocations. This should prevent some crashes due to running out of memory.
** Some memory leaks have been fixed.
** C++ exceptions have been enabled in DS builds. They were already enabled in SDL builds.
** Some code has been moved to ITCM to increase speed.
** The home page is now a file in NitroFS rather than being hardcoded in the Bunjalloo binary.
** Cache management has been fixed. The destination (VRAM) was flushed instead of the source (main RAM).
'''Version 0.10.0'''
* Fixed SSL connections. Entropy is now gathered correctly and the main thread yields every now and then to let the SSL handshake finish.
* Support checking CA certificates when using SSL. This uses a lot of RAM and it's a bit slow so it's disabled by default, and there's a new option in the settings menu to enable it or disable it. Also, users can provide their own sets of CA certificates.
* Fixed the type of position markers when searching strings. It was only valid in 32-bit platforms like the DS, so some code wasn't working on the SDL port. This prevented the configuration settings page from showing up.
* The DS version now expects the "data/bunjalloo" folder to be in the root of the SD, not in the same folder as the NDS ROM.
* The home page has been updated. The page with the licenses used by components of Bunjalloo has been split into multiple pages. Also, the licenses of BlocksDS libraries are now included as well.
* Support BMP and APNG formats.
* Fix scale down calculations for very big images. Sometimes they were left too big in one dimension.
* Display transparent pixels as white instead of black.
* A bad debug check has been removed. This prevented some elements from loading, like some (but not all) images.
* Improved handling of errors when receiving packets.
* Restore code that parses dates.
* Fix timeout counter so that it uses seconds instead of retry attempts.
* Zlib has been updated to version 1.3.1.
* Some unused features of Mbed TLS have been disabled to reduce code size.
* The code is now built with "-Os" to save RAM.
* Flush data cache before doing a DMA copy.
* Removed some superfluous waits for VBL.
* Fixed some warnings, silenced some of them.
* Some internal code cleanup.
* Updated instructions in readme.

'''Version 0.9.0'''
* Migrated to BlocksDS from devkitARM. Now Bunjalloo can take advantage of the Wifi driver in DSi mode, with WPA2 support and the additional RAM of DSi.
* The old versions of libpng, libjpeg and giflib have been replaced by libplum.
* MatrixSsl isn't currently maintained and it has been replaced by Mbed TLS. Switching between HTTP and HTTPS is still a bit unreliable.
* The PC port has been fixed. It builds, some infinite loops have been fixed, and images are now displayed correctly.
* Test can't be built at the moment, they will be re-enabled in the future.
* Initialize keyboard state correctly so that the extra symbols aren't displayed after the first key press.
* Modify cache CRC32 calculation to include the protocol, not just the rest of the address. This lets us retry a website with http and then https if it fails, for example. Previously it would just reload the cached error page.
* Added missing copyright notices to the "show copying" page.

'''Version 0.8'''
* Updated to the latest devkitARM, libnds, libfat and libpng.
* Fix the updater that was broken in 0.7.7.
* Fix some layout randomness (on e.g config screen).
* Change the progress bar to be textless.
* Fix for occasional giant whitespaces.
* Use last-modified in cache calculations.
* Fix flashing when swapping from browser to keyboard.
* Show on-screen password fields with circles.
* Change the password field to use circles.
* Speed up scrolling.
* Performance improvements.
* Change to Okiwi font generation and rendering.
* Fix some major memory leaks.

==External links==
* Codeberg (new) - https://codeberg.org/SkyLyrac/bunjalloo/releases
* Google Code (old archive) - http://code.google.com/p/quirkysoft

WolveSlayer

2026-01-09T02:20:24Z

SkyLyrac: Update URL of git repository.

{{Infobox DS Homebrews
|title=WolveSlayer
|image=wolveslayer.png
|description=3D hack n slash game.
|author=Firehazard Studio, AntonioND
|lastupdated=2024/07/31
|type=Action
|version=v20240731
|license=MIT
|download=https://dlhb.gamebrew.org/dshomebrew2/wolveslayer.7z?0714
|website=https://codeberg.org/SkyLyrac/wolveslayer
|source=https://codeberg.org/SkyLyrac/wolveslayer
}}
WolveSlayer is a 3D hack'n'slash game for the NDS. Its graphics engine uses effects that have yet to be seen on commercial DS games.

Developed by Firehazard Studio, this homebrew game was released for the NEO Spring Coding Compo 2007, where it won 1st place in the GBA/NDS Game category.

In 2024, the game was ported to [https://blocksds.skylyrac.net/ BlocksDS] by AntonioND to support modern tools.

==Features==
* 3D graphics (effect of lighting and bump mapping).

==Installation==
<tabber>
|-|BlocksDS port=

Copy the .nds file to your storage device.

|-|Neoflash compo ver.=

[[DLDI|DLDI]] patch the ROM if needed and copy it to your flashcard.

One of those ROMs has an icon and ROM infos attached. But this causes bugs on some flashcards (e.g. sccf and ds-x). If you have trouble use the other rom (blank rom).

Don't forget to copy the folder wolveslayer to the root of your flashcard.
</tabber>

==User guide==
Main aim of this game is to find and slay down a big grey wolf (you will meet smaller ones too). Of course you will lose if they kill you.

==Controls==
D-Pad - Move character

A - Open doors (so far only one)

B - Swing the sword

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/wolveslayer2.png
https://dlhb.gamebrew.org/dshomebrew/wolveslayer3.png

https://dlhb.gamebrew.org/dshomebrew/wolveslayer4.png
https://dlhb.gamebrew.org/dshomebrew/wolveslayer5.png

==Media==
'''WolveSlayer (walktrough and killing endbss)''' ([https://www.youtube.com/watch?v=q-SZ4lWB1Qs DrunkencoderPayk]) <br>
<youtube width="515">q-SZ4lWB1Qs</youtube>


==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/c/c7/Wolveslayer.png
|EJS_core=nds
|EJS_gameName=WolveSlayer
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/wolveslayer.7z
}}
{{DS Control Settings}}


==Changelog==
'''2024/07/31'''
* The internal code of the game engine has been cleaned up and reorganized.
* Some of the code that loads assets has been optimized.
* Many checks have been added to the code to make the code more memory-safe.
* A buffer underflow buffer has been fixed. This sometimes manifested as video glitches when swinging the sword to the right of the screen (but only with custom builds, not with the builds on GitHub).
* The MOD player has been replaced by LibXM7. This reduces the amount of code to maintain in this repository and will mean that this game gets the benefits of other projects that also use LibXM7 and fix bugs there.
* The code of the repository has been licensed under the MIT license with permission from Payk.

'''2024/07/14'''
* This version fixes the super slow speed when loading files, which was particularly bad on DSi. It also changes the format of fatal error messages so that they are more readable.

'''2024/07/12''' (AntonioND)
* First release of the port to BlocksDS.

'''2007/03/24'''
* This version has a bit shorter loading times in the first map and solved umlaut problem.

'''2007/03/20''' (Firehazard Studio)
* Released for the Neoflash Spring Coding Compo 07.

==External links==
* Author's website (Payk) - [https://web.archive.org/web/20071212183823/http://payk.drunkencoders.com http://payk.drunkencoders.com] (archived)
* GitHub (AntonioND) - https://codeberg.org/SkyLyrac/wolveslayer/releases/
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=3895.0
* Forum - https://forums.gamebrew.org/threads/old-release-wolveslayer-source-code.601/

[[Category:NEO Spring Coding Compo 2007]]

PA lib

2026-01-09T00:14:02Z

SkyLyrac: Update URL of git repository.

{{Infobox DS Homebrews
|title=PAlib
|image=palib4.png
|description=A Nintendo DS library used to create homebrew games/apps.
|author=Mollusk
|lastupdated=2025/02/28
|contributor=AntonioND
|type=Development
|version=250228
|license=Mixed
|download=https://codeberg.org/SkyLyrac/palib
|downloadraw=https://dlhb.gamebrew.org/dshomebrew2/pallib_100707.rar
|website=https://codeberg.org/SkyLyrac/palib
|source=https://codeberg.org/SkyLyrac/palib
}}
PAlib is a DS library that works on top of libnds. It is aimed towards simple DS development to make DS games and programs in c and C++. It used to work with devkitARM, but now it is only compatible with BlocksDS.

It was presented in the NEO Coding Compo 2005 (App, 1st place).

While this library isn't recommended for new projects due to its design flaws, it is still useful to build old projects that were built using it.

==Features==
* Sprites functions.
* Background function.
* Text functions.
* An API for buttons.
* Sliders.
* Checks.
* Sound effects support.
* MOD/XM/S3M/IT support thanks to Maxmod.
* MP3 support thanks to ASlib
* Stylus and Pad.
* Draw function.
* Variable case text.
* Retrieve info on DS (user name, birthday, language, time/date, etc).

==Installation==
To install PAlib follow the instructions [https://codeberg.org/SkyLyrac/palib here].

==User guide==
Tutorials can be found [http://code.google.com/p/palib-tutorial-pdf here].

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/palib2.png

==Media==
'''C/PALib Simple Nintendo DS Platformer''' ([https://www.youtube.com/watch?v=HzqdLHI0SG8 bl0ckeduser]) <br>
<youtube>HzqdLHI0SG8</youtube>

==Changelog==

'''PAlib 250228 beta | AntonioND'''
* [Fix] Fix code that sets the LED blink speed.

'''PAlib 250114 beta | AntonioND'''
* [Fix] Flush cache whenever a DMA copy is made so that users of PAlib don't need to worry about it.
* [ASlib] Flush data cache when a MP3 file is played from RAM so that the developer doesn't need to do it.
* [DMA_Copy] Use safe BlocksDS libnds DMA functions instead of the old PAlib macros.
* [Fix] Actually send temperature and battery level to the ARM9 from the ARM7.

'''PAlib 250107 beta: PAlib lives on | AntonioND'''
* [General] PAlib builds and works again, even on DSi consoles.
* [General] devkitARM build system has been removed in favour of BlocksDS.
* [General] Repository structure has been refactored so that it's clearer.
* [ARM7] The ARM7 cores have been slightly refactored for modern libnds and to support DSi. Also, the libnds exception handler for the ARM7 is now enabled by default.
* [ASlib] Interrupts are now enabled in the VBL handler of ASlib so that it doesn't block multithreading.
* [Fix] The IPC structure is now allocated at runtime instead of using a hardcoded address, which doesn't work on DSi.
* [Fix] Several bugs in ASlib have been fixed.

'''PAlib 100707 QuickFix: The last PAlib release | fincs'''
* [General] Removed the ASlib IPC clear code, it was doing more harm than good.
* [3DSprites] PA_3DCreateSprite now returns the GFX number.
* [Linux] Fixed a backslash (\) path to use forward slash (/).
* [Examples] The updating script screwed up some sound examples, it's now fixed.
* [EFS] EFS support was dropped in favor of libfilesystem.
* [Editors] PN support is now dropped.
* [Fix] PAlib now works with devkitARM r31.
* [Sprite] Fixed PA_DeleteSprite bug (thanks BassAceGold).

==External links==
* devkitPro wiki - http://devkitpro.org/wiki/PAlib
* Google Code - http://code.google.com/p/palib-tutorial-pdf
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=563.0

[[Category:PC utilities for DS]]
[[Category:NEO Coding Compo 2005]]

ΜLibrary

2026-01-09T00:06:44Z

SkyLyrac: Update URL of git repository.

{{Infobox DS Homebrews
|title=µLibrary
|image=ulibrary.png
|description=New library to use the 3D GPU to create nice 2D games very easily.
|author=Brunni
|lastupdated=2024/08/05
|type=Game Engine
|version=1.13
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/ulibrary_1.12.rar 1.12
|website=http://brunni.dev-fr.org/index.php?page=ndssoft_ulib
|source=https://codeberg.org/blocksds/ulibrary
}}
µLibrary is a new library for Nintendo DS. Basically, it is meant to use the 3D GPU to create nice 2D games very easily, using a different approach than existing libraries (similar to OSLib). A few examples are supplied, as well as a Doxygen documentation and a small .chm documentation with a FAQ. There are also 2 templates for VHAM, Programmers Notepad or just make, one with PALib and one without it.

The 3D GPU provides additional effects over the 2D GPU, like full transparency with alpha channel (objects can blend amongst them), a larger number of sprites (up to 1536 instead of 128), no zoom or rotation limit (2x with the 2D GPU), a larger limit for the sprite size (2048x2048 instead of 64x64). It is also possible to draw primitives like lines, rectangles, etc. allowing nice effects like in Yoshi's island for example.

µLibrary also provides a low level layer and is open to the hardware. You can also mix 2D and 3D in a single project.

It was participated in the NEO Spring Coding Compo 2007 (NDS App).

In 2024, the library was ported to [https://blocksds.skylyrac.net/ BlocksDS] by AntonioND to support modern tools.

==Features==
* Supported image formats: PNG, GIF, JPG.
* Special image effects: stretching, tinting (4 corners), mirroring, rotation (with a defined center), selection of an image frame to display (just like on spritesheets).
* 18-bit render quality instead of 15-bit: provides 8 times more colors.
* Virtual file system: possible to load files independantly from the actual support (RAM, libFat, GBFS are supported by default, but you can define your own). Allows to create more easily software that are compatible with all existing linkers.
* Untextured geometry (rectangles, gradients, lines, etc).
* Basic message box system.
* VideoGL wrapper for texture and palette loading in VRAM: Able to load and unload things dynamically and more flexible (you can choose which banks you want to use for what, etc).
* Keypad and touchscreen handler namely with support of stylus speed and double click and support of autorepeated keys (menus for example).
* Includes 2 splash screens.
* Low level wrapper to draw primitives.
* Text system using the same font format as OSLib.

==Installation==
<tabber>
|-|BlocksDS port=

Follow the instructions in [https://codeberg.org/blocksds/ulibrary the repository].

|-|Neoflash compo ver.=

Enter into the Install folder of your distribution.

There is a batch file, named Install.bat, that will copy files. First edit it and verify that the paths are corrects (ROOTPATH=C:\devkitpro\libnds by default, change it to the path where libnds is located).

Once finished, execute it. After a confirmation, it will copy all files to their respective locations so that you can use it.
</tabber>

==User guide==
Library comes with two templates, located in the Templates folder of its install:
* uLib_without_PALib - This project will begin with µLibrary only.
* uLib_with_PALib - As its name suggests, this project contains everything to get started on a new project using simultaneously µLibrary and PALib.

The render method is similar to a sheet of paper. You first draw a background, then put some mountains, then some trees, some characters and so on: you draw your objects in the order they should appear on the screen (the first is behind, the last one is over the others).

Some examples are provided by the developer:
* [http://www.mobile-dev.ch/ulib/tmp/Example01b.rar Example01b.rar]
* [http://www.mobile-dev.ch/ulib/tmp/Example09.rar Example09.rar]

The doxygen documentation is available [http://www.mobile-dev.ch/ulib/doc/doxygen/index.html here].

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/ulibrary2.png

==Changelog==
'''Version 1.13 05.08.2024'''
* µLibrary has been ported to BlocksDS, allowing programs that use it to be built with modern tools.
* ulBindTextureToGl() has been removed, as it required access to internal state of libnds, which is no longer exposed.
* libpng and zlib are no longer included in the repository, they are taken from the toolchain. The code that loads PNG images with libpng has been updated to work with modern libpng.
* PAlib examples are broken until there is a new version of PAlib that works with BlocksDS.
* The Doxygen documentation has been fixed and updated.

'''Version 1.12 2009/03/17'''
* This release is only to keep working with the newest devkitpro & libnds releases.
* A lot of things have changed and some important things must have been rewritten.
* This was the occasion of creating better makefiles, update samples, changing the logo and do other minor changes.

'''Version 1.11 2008/08/23'''
* devKitPro has not really changed (thankfully), so no mandatory updates were needed.
* Fixes a few bugs, namely the palette issues reported by some people.

'''Version 1.10 2007/12/26'''
* As usual, works with and requires the latest libnds version; that's a shame because nothing will run on emulators from now. You can however solve this problem by replacing your copy of basic.arm7 in your libnds folder by mine (you can find it in the tools folder).
* Added ulMoveScreenView, ulRotateScreenView, ulScaleScreenView and ulResetScreenView to apply special transformations to your screen. You can for example rotate the screen as a whole or only a list of objects without any effort. This will namely allow you to scale and rotate objects like maps and text, which isn't available by default.
* Fonts now work better. Now the font2oft tool is in the 'tools' folder.
* Added ulGetColorRed, ulGetColorGreen, ulGetColorBlue to retrieve the component values of a color.
* Added ulLoadFontFile to directly load a font from a file.
* PNG files with alpha can now be loaded directly as UL_PF_PAL5_A3 and UL_PF_PAL3_A5. The alpha will be taken in account and set in the resulting image. Note that you will have to enable blending as usual with ulSetAlpha and by setting another polygroup, because if all objects are with the same polygroup, none will blend with any other.
* Loading unpaletted PNG files to paletted formats reworked. If there isn't enough colors for the whole image, the nearest is taken. However you should avoid this situation because it's an extremely simple but weak method for reducing the colors of an image.

'''Version 1.00 bêta 4 2007/07/14'''
* Works with, and requires the last libnds version.
* Added ulDeleteMap function.
* Using bank B for textures wasn't working correctly; all my excuses.
* Some JPG files with a vertical size not multiple of 8 or 16 were loaded incorrectly.

==External links==
* Author's website - [https://web.archive.org/web/20080507043108/http://brunni.dev-fr.org/index.php?page=ndssoft_ulib http://brunni.dev-fr.org/index.php?page=ndssoft_ulib] (archived)
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=3954.0

[[Category:NEO Spring Coding Compo 2007]]

Tetris 3DS

2026-01-08T23:53:14Z

SkyLyrac: Update URL of git repository.

{{Infobox DS Homebrews
|title=Tetris 3DS
|image=tetris3dsant.png
|description=Tetris in 3D.
|author=AntonioND
|lastupdated=2025/01/07
|type=Puzzle
|version=1.4
|license=Mixed
|download=https://github.com/AntonioND/tetris-3ds/releases/download/v1.4/Tetris_3DS_v1.4.zip
|downloadraw=https://dlhb.gamebrew.org/dshomebrew2/tetris3ds_antonio.rar
|website=https://codeberg.org/SkyLyrac/tetris-3ds
|source=https://codeberg.org/SkyLyrac/tetris-3ds
}}
This is a 3D tetris game for Nintendo DS and DSi that lets you listen to your own MP3 songs while you play.

This was submitted to the Scenery Beta 2008 (NDS Games, 1st place).

==User guide==

Create folder Tetris_3DS in the root of your SD card. Then, add as many songs as you want with the name Song_XX.mp3. The game iterates over all songs until there is a missing number, which will restart the loop. You can also add a song called Menu.mp3, which will play in a loop while in the main menu.

Since version 1.4 the game can also run in DSi mode, so it can also find the files in the internal SD card of the DSi, not just in a flashcard. If you're running the game from a regular DS, remember to patch your rom with DLDI (if your loader doesn't do it automatically).

SD root
|
|-Tetris_3DS
|
|-Tetris_3DS.nds (It can be here or somewhere else!)
|-Menu.mp3
|-Song_00.mp3
|-Song_XX.mp3 (From 01 to 99)
|-Tetris3DS_Config.dat (Created automatically by the game.)

The game will create a file called Error_Log.txt if there is a decoding error so that you can check which files are problematic.

There is a JUKEBOX option that allows you to listen to the music without having to play the game.

==Controls==

L+R+Select+Start - Switch off DS in main menu

'''Classic mode:'''

Can be controlled with Stylus or Keypad.

Up/Down - Left/Right

Left - Down speed increased

Right - Automatically go down

A or Double tap - Rotate

X - Reserve

Start - Pause

'''Multiplayer:'''

Select+Start - Enter Versus CPU mode

Start - Pause

{| class="wikitable" style="width: 400px;"
|-
!style="width: 25%;"| Player 1
!style="width: 25%;"| Player 2
!style="width: 50%;"| Effect
|-
| Up || X || Reserve.
|-
| Left/Right || Y/A || Move.
|-
| Down || B || Down speed increased.
|-
| L || R || Rotate.
|-
|}

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/tetris3dsant3.png
https://dlhb.gamebrew.org/dshomebrew/tetris3dsant4.png

https://dlhb.gamebrew.org/dshomebrew/tetris3dsant2.png
https://dlhb.gamebrew.org/dshomebrew/tetris3dsant5.png

==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/d/d4/Tetris3dsant.png
|EJS_core=desmume2015
|EJS_gameName=Tetris 3DS
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/tetris3dsant.7z
}}
{{DS Control Settings}}


==Credits==
Joat, Dovoto and WinterMute for libnds.

Chishm for libfat.

Mollusk for PAlib.

Noda for ASlib.

==External links==
* Author's website - https://github.com/AntonioND/tetris-3ds
* Author's old website - http://www.skylyrac.net/old-site/nds.html
* SceneBeta - https://nds.scenebeta.com/noticia/tetris-3ds

[[Category:Scenery Beta 2008]]

Tales of Dagur

2026-01-08T22:15:02Z

SkyLyrac:

{{Infobox DS Homebrews
|title=Tales of Dagur
|image=talesofdagur.png
|description=A complete RPG game on DS.
|author=LiraNuna
|lastupdated=2025/03/25
|type=Role Playing
|version=2
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/talesofdagur.7z?k33p0fil35
|downloadraw=https://github.com/AntonioND/talesofdagur/releases/tag/v20250325
|website=http://www.talesofdagur.com/main/index.php
|source=https://codeberg.org/SkyLyrac/talesofdagur
}}
Tales of Dagur is a complete RPG homebrew for the NDS.

It was released for the NEO Spring Coding Compo 2006 (NDS Games, 1st place).

In 2024, the game was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools, DLDI and DSi.

==User guide==
The kingdom of Dagur is in deep troubles: The holy stone that protects the kingdom has been stolen! Further more, the queen of Dagur has disappeared.

A young lad named Alex is summoned by the king to fix the situation. Help Alex return the holy stone, find the queen, and by that save the kingdom!

Don't forget to equip weapons!

==Controls==
'''In game:'''

D-Pad - Movement

A - Perform Action

B - Dash

Start - In-game menu

'''In battle or shop:'''

D-Pad - Scroll through options

A - Select

B - Cancel

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/talesofdagur2.png
https://dlhb.gamebrew.org/dshomebrew/talesofdagur3.png

https://dlhb.gamebrew.org/dshomebrew/talesofdagur4.png
https://dlhb.gamebrew.org/dshomebrew/talesofdagur5.png

==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/e/ea/Talesofdagur.png
|EJS_core=desmume2015
|EJS_gameName=Tales of Dagur
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/talesofdagur.7z
}}
{{DS Control Settings}}

==Compatibility==
Tested on iDeaS.

==Credits==
Code: LiraNuna.

Moral support and font tileset: Chetic.

Storyboard, Script, & Music collection: RVman.

Graphics: Enterbrain.

Mapping and level design: Nikolas Lahtinen.

Beta-testing: Cameron, Chetic and Nikolas.

Special thanks to Rat for the splash screen.

==External links==
* Official website - [https://web.archive.org/web/20090617202956/http://www.talesofdagur.com/main/index.php http://www.talesofdagur.com/main/index.php] (archived)
* Author's website - [https://web.archive.org/web/20100105060038/https://www.liranuna.com/nds-projects/tales-of-dagur https://www.liranuna.com/nds-projects/tales-of-dagur] (archived)
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=1917.0
* Port to BlocksDS - https://github.com/AntonioND/talesofdagur

[[Category:NEO Spring Coding Compo 2006]]

Pong 3DS - AntonioND

2026-01-08T22:12:00Z

SkyLyrac:

{{Infobox 3DS Homebrews
|title=Pong 3DS
|image=Pong3dsant2.png
|description=A pong with stereoscopic 3D.
|author=AntonioND (Antonio Niño Díaz)
|lastupdated=2015/02/21
|type=Arcade Games
|version=1.0.2
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/3dshomebrews/pong3dsant.7z
|website=http://www.skylyrac.net/category/nintendo-3ds.html
|source=https://codeberg.org/SkyLyrac/pong-3ds
}}
Pong 3DS is a Pong game with stereoscopic 3D. This homebrew game is inspired by [[Pong_3DS|Pong 3DS]] previously written for the Nintendo DS.

==Installation==
Available in 3DSX/SMDH format.

Copy the folder containing .3dsx and .smdh into the 3ds folder on your SD card, run it with Homebrew Launcher.

==User guide==
You can choose among the following game modes in the main menu:
* 2D Room.
* 2.5D Room.
* 3D Room.

When you change the 3D slider's position, the 3D engine renders each top screen in a separate core when working in 3D mode so that the game will always run at 60 FPS.

Screenshot is saved in PNG format (2 files in 3D mode, 1 in 2D mode).

==Controls==
Touchscreen - Enter game room (main menu)

Circle Pad/Joystick - Move

A - Jump (in 2.5D room)

Y - Screenshot

X - Pause

Start - Return to menu

Select - Exit to loader

L+R - Show FPS and CPU usage

==Screenshots==
https://dlhb.gamebrew.org/3dshomebrews/pong3dsant3.png
https://dlhb.gamebrew.org/3dshomebrews/pong3dsant4.png

https://dlhb.gamebrew.org/3dshomebrews/pong3dsant5.png
https://dlhb.gamebrew.org/3dshomebrews/pong3dsant6.png

==Media==
'''3DS Homebrew: Pong 3DS [Deutsch|HD]''' ([https://www.youtube.com/watch?v=3aqceyySnuM Flashcardsinfo]) <br>
<youtube>3aqceyySnuM</youtube>

==Changelog==
'''v1.0.2 2015/02/21'''
* Release with a few bugfixes.

'''v1.0.1 2015/02/18'''
* Just a minor update with a few fixes and compiled with devkitARM r44.

'''v1.0 2015/02/18'''
* First release of Pong 3DS. Binaries for the hbmenu.

==Credits==
Thanks to:
* smea for Ninjhax.
* smea, yellows8, plutoo, fincs and mtheall for ctrulib.
* smea, mtheall, GEMISIS, Fluto and Arkhandar for hbmenu.
* WinterMute for devkitARM and 3dslink.
* mtheall for ftbrony.
* Andreas Nylin for the font Polygon Power.
* JuDelCo, NightFox and icesoul for the support during the developement of this game.
* DrPetter for sfxr.
* Claudio Matsuoka and Hipolito Carraro Jr for Extended Module Player Lite.

[http://modarchive.org Music]:
* 'Kaos och Dekadens' by Nightbeat.
* 'Essentials Intact' by Nightbeat.
* 'Roots' by Nightbeat.
* 'Secret Message' by Frequent/Ephidrena.

==External links==
* Author's website - http://www.skylyrac.net
* Author's website (former) - http://www.skylyrac.net/old-site
* GitHub - https://github.com/AntonioND/pong-3ds
* GBAtemp - https://gbatemp.net/threads/homebrew-pong-3ds-v1-0.381907

Meteora Galatic Battle

2026-01-05T23:31:00Z

SkyLyrac: Update URL of git repository.

{{Infobox DS Homebrews
|title=Meteora Galactic Battle
|image=meteora.png
|description=Meteroa is a space/fantasy based god-sim game by J.
|author=Jerome Wax (X-Blaster)
|lastupdated=2007/08/21
|type=Simulation
|version=0.9.2
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/meteora.7z?k33p0fil35 0.8.0 & 0.9.2
|downloadraw=http://meteora.lo2k.net/download/meteora-src.rar
|website=http://meteora.lo2k.net
|source=https://codeberg.org/SkyLyrac/meteora
}}
Meteroa is a space fantasy based god-sim game by Jerome Wax that lies somewhere between populous, world of sand and pong. From over 8 months of development, it is a game of strategy action in space.

It was submitted to the NEO Summer Coding Compo 2007 (NDS Game, 3rd place). Verion 0.8.0 Meteora Evolution was presented in the Dev-fr Coding Compo 2007 (Game, 2nd place).

In 2024, the game was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools and for better compatibility on DSi mode.

==Feature==
* An engine containing a garbage collector to avoid memory leaks during development.
* Use the microphone for certain powers.
* Use of gestures.
* Visual effects (explosions, earthquakes, meteor streaks).
* Use of dual-screen 3D (thanks to the ulib).
* Sprites more than 1200 on the screen.

==User guide==
Meteora is an action version of meteos. It is a game where planets attack each other. You control one of the two planets and by sending mana your goal is to get your opponent's life to zero before you do.

You and your opponent have:
* Mana (to use your powers).
* A shield that constantly regenerates.
* The clean energy of your planet.

Whenever you send an attack up the screen, your opponent will receive it (planets can be several light years apart). Your opponent can deflect your attacks as you might, ie by using his God Powers.

You must therefore send as many attacks as possible towards your opponent while trying to stop the attacks coming from your opponent.

===Mana===
Your planet has a certain amount of mana you regain all the time. Free the mana to deflect, destroy the enemy attacks.

Your Stylus acts as a magnet to which you belong. The more you're ready for a ball of mana, the more you attract, the more you are away, your pen is less effective. Keep this principle in mind as you play. To successfully send an attack so do not give a boost with the stylus but with your attack.

===Powers of God===
You can at any time use your powers of god. However, you should have enough mana and respect the cooldown (cooldown).

Some powers require additional action on your part such as creating glyphs or a certain breath.

The list of powers is quite long, it is suggested to read [http://meteora.lo2k.net/Master/pouvoirs the list of powers] for more information of each of them.

===Attacks===
* '''Instant:'''
** Send a volley of meteorites towards your opponent (e.g. Multiple Shot). A formidable weapon, the more you use it, the less its cost and reload time will be.
** You can direct your attacks with your stylus.

* '''Charged:'''
** These attacks will load over time (e.g. Frost Flame). 10 to 15 seconds and your mana size is maximum. Leave no respite and send this kind of monster on your opponent.
** Merge the different types of charged mana together, they will grow even faster. Also remember to bring them back to your planet to grow your mana.

* '''Shrapnel:'''
** The shrapnel attack explodes at the slightest shock with an attack from your opponent. Indispensable to decimate an enemy attack or to create an effective defense.
** Merge there with a charged attack to make it even more effective. If you manage to merge several shrapnel between them ... your attack can become ultimate.

===Defenses===
* '''God's wind:'''
** The Wind of God can repel enemy attacks or send your own attacks more effectively. When you activate it, you have a limited time of use (icons available in the upper right corner of the bottom screen). If you blow on the Nintendo DS while the icon is visible, your breath will be transmitted in the game and it will allow many things to happen.
** Be careful not to hyperventilate. The more you use it, the longer its reload time...

* '''Change of sides:'''
** When you activate this spell, you will need to perform a glyph in a limited time.
** To do this, you have to touch the yellow symbols before they disappear. It is also necessary to make sure that nothing touches a symbol during the invocation of this spell. If you can do it right, whatever is on the screen will be yours. If you perform it during an enemy attack, that attack will be in your possession. You are free to return it to your opponent or to attract it to your planet in order to benefit from a mana bonus.
** If you have a hard time at first, use it in conjunction with god's wind, so that the bottom part of the screen is blank while the glyph is running.

===Power ups===
* '''Mana increase:'''
** You can increase the maximum mana rate and the speed of your mana gain. Don't overlook this kind of power, they can actually play a big part in the game. Be careful though, the more you use them, the more they cost.

==Controls==
Up/Down - Release mana

Stylus - Attract mana

L/R - Use God Powers

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/meteora2.png
https://dlhb.gamebrew.org/dshomebrew/meteora4.png

https://dlhb.gamebrew.org/dshomebrew/meteora3.png
https://dlhb.gamebrew.org/dshomebrew/meteora5.png

==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/c/c8/Meteora.png
|EJS_core=nds
|EJS_gameName=Meteora Galactic Battle
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/meteora.7z
}}
{{DS Control Settings}}

==Credits==
Brunni, Mollusk, Reppa, Benoit Charcosset, Audrey.

Everyone in dev-fr.

==External links==
* Official website - [https://web.archive.org/web/20140615140612/http://meteora.lo2k.net http://meteora.lo2k.net] (archived)
* NeoFlash - [https://web.archive.org/web/20210208003002/https://www.neoflash.com/forum/index.php?topic=4569.0 https://www.neoflash.com/forum/index.php?topic=4569.0] (archived)

[[Category:NEO Summer Coding Compo 2007]]
[[Category:Dev-fr Coding Compo 2007]]

Volumetric Shadow Demo

2026-01-04T12:23:55Z

SkyLyrac: Update link to repository.

{{Infobox DS Homebrews
|title=Volumetric Shadow Demo
|image=vsd.png
|description=NDS Tech Demo, formerly know as the Stencil Shadow Demo.
|author=Rob (silent_code, R.H.L.)
|lastupdated=2024/08/08
|type=Demos
|version=1.7.2
|license=Mixed
|downloadraw=[https://dlhb.gamebrew.org/dshomebrew2/vsd.7z 1.6.0] - [https://github.com/AntonioND/volumetric_shadow_demo/releases 1.7.2]
|website=http://www.robs-basement.de/#RB_NDS_VSD
|source=https://codeberg.org/SkyLyrac/volumetric_shadow_demo
}}
Volumetric Shadow Demo is a NDS tech demo program formerly know as the Stencil Shadow Demo, and later Volume Shadow Demo. This small open source program demonstrates, among other things, some of the NDS' graphics hardware capabilities.

In 2024, the demo was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools.

==Features==
* Hardware accelerated volumetric shadowing.
* Motion blur with video capture, using only one VRAM bank, at 60 FPS.
* Hardware lighting, texturing, fogging, antialiasing etc.
* Display brightness control.
* Viewport scissoring (thanks to gabebear off the gbadev.org forum).
* Loading binary and text files from disk (through libfat).
* Converting .tga 24/32bit image data to 16bit nds textures.
* Displaying a custom font and a text area over a background image, all loaded from disk.
* Smooth touch input.
* Simple frame rate counting and some other rendering status info.

==Installation==
<tabber>
|-|BlocksDS port=

Copy the .nds file to your storage device.

|-|Neoflash compo ver.=

Copy the .nds file to the root of your card.

You will see all (data) files are located in the vsd_data directory.

Copy them into the /data/ folder on the root of your card. Or alternatively, directly into the root.

Create the data directory, if not already present on your card.
</tabber>

'''Files that need to be copied:'''

vsd_###.nds (or vsd_###_fcsr.nds, in which case nothing else is needed) <br>
doll.char <br>
room.char <br>
shadow.char <br>
font.pbi <br>
splash.pbi <br>
loading.pbi <br>
doll256.tga <br>
test.tga <br>

Depending on your device, you may have to manually patch the .nds file to make it work with [[DLDI|DLDI]]. Your card's manufacturer can help you with how to accomplish that.

==User guide==
===Initialization===
Prepare the hardware by setting the flush mode to manual and w-depth sorting with:
glFlush(GL_TRANS_MANUALSORT | GL_WBUFFERING);

Do so in the frame before the frame you will draw the shadows. Usually, you would set this up when initializing the application and flush each frame with those settings.

You might need to sort your translutient polygons/meshes. Remember, that certain volumetric shadow geometry configurations will cause artifacts.

===Render volumetric shadows===
These are the three basic steps you need to follow to render volumetric shadows.

1) Render all the shadow casting and receiving geometry as usually.

2) For every shadow geometry, draw the Stencil Mask. Shadow polygons must be translutient, so enable blending and render the shadow geometry's front using the following settings:
glPolyFmt(POLY_ALPHA(1) | POLY_CULL_FRONT | POLY_ID(0) | POLY_SHADOW);

Alpha must be between 1 and 30 and ID also must be 0.

3) The Stencil Shadow: Now, finally draw the shadow geometry's back with these settings:
glPolyFmt(POLY_ALPHA(20) | POLY_CULL_BACK | POLY_ID(63) | POLY_SHADOW);

Again, alpha needs to be between 1 and 30, but this time ID must not be 0.

Now you should have a volume shadow on screen. Repeat steps two and three for all other shadow geometry.

Tutorials can be found at [http://www.code-basement.net/files/nds/vsd/volumetric-shadows-nds.tutorial.txt the official website].

==Controls==
'''During demo:'''

Touch (Stylus) - Look

D-Pad - Move the camera (forward/backward)

A/B/X/Y - Move the character

Start - Reset scene

Select+A - toggle shadowing

Select+B - toggle texturing

Select+X - toggle lighting

Select+Y - toggle capturing (motion blur)

R+D-Pad - Move a scissor box

L+D-Pad - Move the camera (up/down)

R+L+Up/Down - Change the brightness

R+L+Start - Reset the scene and the brightness

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/vsd2.png
https://dlhb.gamebrew.org/dshomebrew/vsd3.png

==Compatibility==
'''Emulators:'''

When using [http://dev-scene.com/NDS/FCSR_Tutorial FCSR], it is mostly compatible with no$gba 2.6 (the emulator is still missing some features). Other emulators are not supported.

'''Hardware:'''

Compatible with DLDI-able FAT cards, tested with SLOT1 M3 Real via the firmware's autopatching. Through [http://dev-scene.com/NDS/FCSR_Tutorial FCSR], it is also compatible with older SLOT2 (GBA) NOR cartridges, tested with NeoFlash 512Mb.

==Changelog==
'''Revision 7.1'''
* Update format of documentation.

'''Revision 7.0'''
* Migrated to BlocksDS.
* Switched to using NitroFS instead of libfat.

'''Revision 6.0'''
* Fixed the tutorial (thanks to zeruda at gabdev).
* Fixed a typo in the readme (thanks to jello!) and updated it.
* Cleaned up console initialization and proper use of libnds' definitions.
* Fixed material/lighting bug.
* Added and fixed come source comments.
* Fixed initialization function.
* Fixed the view class and its usage.
* Replaced the floating point gluPerspective() whith its fixed point counterpart.
* Reworked some parts of the mesh rendering.
* Removed last bits of "useless stuff."

'''Revision 5.1'''
* Refactored and fixed the scissor class.
* Fixed fopen() usage.
* Reduced file path to 31 (+ \0) characters and renamed some files.
* Cleaned up glEnable() usage.
* Added vertex and primitive list RAM usage display.
* Added free render buffer lines display.
* Readme has been fixed and updated.

'''Revision 5.0'''
* Renamed to "Volumetric Shadow Demo".
* Fixed input bug: textures could not be toggled.
* Fixed: Single "include all" header style was remedied with only including and declaring what is needed in each compilation unit.
* Restructured some source files.
* Removed ARM7 source file and rearranged the project to ARM9 only (Using the default ARM7 binary).
* Changed to unmodified default Makefile.
* Changed the source usage "policy" a little bit.
* Separated the tutorial from the readme.
* Readme has been updated accordingly.

'''Revision 4.0'''
* Did quite some source clean-up, rewriting and rearranging.
* Added view and scissor box classes.
* Added data directory support.
* Added better error detection and handling.
* Changed fog table generation.
* Refactored a lot of variables and functions.
* Added some more comments.
* Fixed some typos in the readme and updated it.

'''Revision 3.0'''
* Changed file system to libfat.
* Added frame rate counter.
* Added touch input smoothing (still need to fix the slight drifting).
* Fixed the fog color.
* Rearranged and cleaned up the sources.
* Updated and fixed the readme.
* Cleaned up and fixed the tutorial.

'''Revision 2.0'''
* Moved to devkitARM R23b.
* Updated to libnds 20071023.
* Fixed the readme.
* Slightly changed the .pbi format - old data and routines are incompatible.
* Fixed "odd" loading routines.
* Fixed some minor bugs.
* Cleaned up the sources a little bit.
* Added some info about the .tga format in "tgaloader.cpp".
* Added an overview of controls to the bottom screen.

'''Revision 1.2'''
* Fixed and rearranged some things in the readme.
* Changed the term "shadow volumes" to the more precise term "volume shadows" in the readme.
* Added a tutorial section.
* Updated to libnds 20070503.
* Added hardware fog.
* Added capture support and a slight motion blur effect.
* Added some new controls.

'''Revision 1.1'''
* Fixed and rearranged some things in the readme.
* Updated to libnds 2007050.
* Removed my FIX versions of previously 'broken' libnds funktions.

'''Revision 1.0'''
* Fixed and added things to the readme: additional thanks, change log, controls etc.
* Replaced the shadow volume with a better suited (and simpler) one.
* Fixed the controls.

'''1.0.0'''
* Initial release.

==Credits==
It was built with devkitARM R23b, libnds 20071023 and libfat 20070127 from the libnds "touch_look" example (as a project kick-start), so credit and thanks go out to their respective authors.

Credit also goes to gabebear for the scissor pick matrix implementation.

Very special thanks go out to Larry E. and Brandon M. for helping with the hardware.

Special thanks to tepples, simonjhall and Alphanoob.

Also, greetings to everybody at the gbadev.org forums.

==External links==
* Author's website - http://www.robs-basement.de/#RB_NDS_VSD

Bunjalloo

2025-11-02T02:54:40Z

SkyLyrac:

Bunjalloo

2025-11-02T02:44:13Z

SkyLyrac:

File:Snapshot 2025-11-02 02-42-36.png

2025-11-02T02:44:04Z

SkyLyrac: Screenshot of Bunjalloo

Screenshot of Bunjalloo

Bunjalloo

2025-11-02T02:39:54Z

SkyLyrac:

{{Infobox DS Homebrews
|title=Bunjalloo
|image=Bunjalloo2.png
|description=Simple web browser for the Nintendo DS.
|author=quirkysoft, AntonioND
|lastupdated=2025/11/02
|type=Utilities
|version=0.10.0
|license=Mixed
|download=https://github.com/AntonioND/bunjalloo/releases/download/v0.10.0/bunjalloo_v0.10.0.zip
|website=https://github.com/AntonioND/bunjalloo
|source=https://github.com/AntonioND/bunjalloo
}}
This is Bunjalloo, the open source Nintendo DS web browser. It was originally developed by Richard Quirk until 2010. This repository contains a working fork that you can build with modern BlocksDS.

Bunjalloo has been implemented from scratch [http://www.whatwg.org/ using the whatwg user agent designrules].

This version can take advantage of the additional RAM, CPU power, and WPA2 support of DSi. It also uses modern cryptographic libraries to support modern TLS protocols.

==Features==
* Bookmark support.
* Cookie and image support.
* Optional CA certificate checks.

==Installation==
Extract the data folder and contents to the root of your SD card.

Extract the .nds file to the root of your SD Card.

[[DLDI|DLDI]] patch the .nds file if your card needs it.

==Controls==
* Start: Enter a URL
* Up/Down: Scroll screen up and down
* Left/Right: Scroll screen a page at a time
* R: Move forwards in the history
* L: Move backwards in the history
* Click stylus: Follow link, enter data in forms, press keys.
* Hold stylus: Scroll.

==Changelog==
'''Version 0.10.0'''
* Fixed SSL connections. Entropy is now gathered correctly and the main thread yields every now and then to let the SSL handshake finish.
* Support checking CA certificates when using SSL. This uses a lot of RAM and it's a bit slow so it's disabled by default, and there's a new option in the settings menu to enable it or disable it. Also, users can provide their own sets of CA certificates.
* Fixed the type of position markers when searching strings. It was only valid in 32-bit platforms like the DS, so some code wasn't working on the SDL port. This prevented the configuration settings page from showing up.
* The DS version now expects the "data/bunjalloo" folder to be in the root of the SD, not in the same folder as the NDS ROM.
* The home page has been updated. The page with the licenses used by components of Bunjalloo has been split into multiple pages. Also, the licenses of BlocksDS libraries are now included as well.
* Support BMP and APNG formats.
* Fix scale down calculations for very big images. Sometimes they were left too big in one dimension.
* Display transparent pixels as white instead of black.
* A bad debug check has been removed. This prevented some elements from loading, like some (but not all) images.
* Improved handling of errors when receiving packets.
* Restore code that parses dates.
* Fix timeout counter so that it uses seconds instead of retry attempts.
* Zlib has been updated to version 1.3.1.
* Some unused features of Mbed TLS have been disabled to reduce code size.
* The code is now built with "-Os" to save RAM.
* Flush data cache before doing a DMA copy.
* Removed some superfluous waits for VBL.
* Fixed some warnings, silenced some of them.
* Some internal code cleanup.
* Updated instructions in readme.

'''Version 0.9.0'''
* Migrated to BlocksDS from devkitARM. Now Bunjalloo can take advantage of the Wifi driver in DSi mode, with WPA2 support and the additional RAM of DSi.
* The old versions of libpng, libjpeg and giflib have been replaced by libplum.
* MatrixSsl isn't currently maintained and it has been replaced by Mbed TLS. Switching between HTTP and HTTPS is still a bit unreliable.
* The PC port has been fixed. It builds, some infinite loops have been fixed, and images are now displayed correctly.
* Test can't be built at the moment, they will be re-enabled in the future.
* Initialize keyboard state correctly so that the extra symbols aren't displayed after the first key press.
* Modify cache CRC32 calculation to include the protocol, not just the rest of the address. This lets us retry a website with http and then https if it fails, for example. Previously it would just reload the cached error page.
* Added missing copyright notices to the "show copying" page.

'''Version 0.8'''
* Updated to the latest devkitARM, libnds, libfat and libpng.
* Fix the updater that was broken in 0.7.7.
* Fix some layout randomness (on e.g config screen).
* Change the progress bar to be textless.
* Fix for occasional giant whitespaces.
* Use last-modified in cache calculations.
* Fix flashing when swapping from browser to keyboard.
* Show on-screen password fields with circles.
* Change the password field to use circles.
* Speed up scrolling.
* Performance improvements.
* Change to Okiwi font generation and rendering.
* Fix some major memory leaks.

==External links==
* GitHub (new) - https://github.com/AntonioND/bunjalloo
* Google Code (old archive) - http://code.google.com/p/quirkysoft

Bunjalloo

2025-11-02T02:38:43Z

SkyLyrac:

{{Infobox DS Homebrews
|title=Bunjalloo
|image=Bunjalloo2.png
|description=Simple web browser for the Nintendo DS.
|author=quirkysoft
|lastupdated=2025/11/02
|type=Utilities
|version=0.10.0
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/bunjalloo_0.8.zip
|website=http://code.google.com/p/quirkysoft
|source=http://code.google.com/p/quirkysoft
}}
This is Bunjalloo, the open source Nintendo DS web browser. It was originally developed by Richard Quirk until 2010. This repository contains a working fork that you can build with modern BlocksDS.

Bunjalloo has been implemented from scratch [http://www.whatwg.org/ using the whatwg user agent designrules].

This version can take advantage of the additional RAM, CPU power, and WPA2 support of DSi. It also uses modern cryptographic libraries to support modern TLS protocols.

==Features==
* Bookmark support.
* Cookie and image support.
* Optional CA certificate checks.

==Installation==
Extract the data folder and contents to the root of your SD card.

Extract the .nds file to the root of your SD Card.

[[DLDI|DLDI]] patch the .nds file if your card needs it.

==Controls==
* Start: Enter a URL
* Up/Down: Scroll screen up and down
* Left/Right: Scroll screen a page at a time
* R: Move forwards in the history
* L: Move backwards in the history
* Click stylus: Follow link, enter data in forms, press keys.
* Hold stylus: Scroll.

==Changelog==
'''Version 0.10.0'''
* Fixed SSL connections. Entropy is now gathered correctly and the main thread yields every now and then to let the SSL handshake finish.
* Support checking CA certificates when using SSL. This uses a lot of RAM and it's a bit slow so it's disabled by default, and there's a new option in the settings menu to enable it or disable it. Also, users can provide their own sets of CA certificates.
* Fixed the type of position markers when searching strings. It was only valid in 32-bit platforms like the DS, so some code wasn't working on the SDL port. This prevented the configuration settings page from showing up.
* The DS version now expects the "data/bunjalloo" folder to be in the root of the SD, not in the same folder as the NDS ROM.
* The home page has been updated. The page with the licenses used by components of Bunjalloo has been split into multiple pages. Also, the licenses of BlocksDS libraries are now included as well.
* Support BMP and APNG formats.
* Fix scale down calculations for very big images. Sometimes they were left too big in one dimension.
* Display transparent pixels as white instead of black.
* A bad debug check has been removed. This prevented some elements from loading, like some (but not all) images.
* Improved handling of errors when receiving packets.
* Restore code that parses dates.
* Fix timeout counter so that it uses seconds instead of retry attempts.
* Zlib has been updated to version 1.3.1.
* Some unused features of Mbed TLS have been disabled to reduce code size.
* The code is now built with "-Os" to save RAM.
* Flush data cache before doing a DMA copy.
* Removed some superfluous waits for VBL.
* Fixed some warnings, silenced some of them.
* Some internal code cleanup.
* Updated instructions in readme.

'''Version 0.9.0'''
* Migrated to BlocksDS from devkitARM. Now Bunjalloo can take advantage of the Wifi driver in DSi mode, with WPA2 support and the additional RAM of DSi.
* The old versions of libpng, libjpeg and giflib have been replaced by libplum.
* MatrixSsl isn't currently maintained and it has been replaced by Mbed TLS. Switching between HTTP and HTTPS is still a bit unreliable.
* The PC port has been fixed. It builds, some infinite loops have been fixed, and images are now displayed correctly.
* Test can't be built at the moment, they will be re-enabled in the future.
* Initialize keyboard state correctly so that the extra symbols aren't displayed after the first key press.
* Modify cache CRC32 calculation to include the protocol, not just the rest of the address. This lets us retry a website with http and then https if it fails, for example. Previously it would just reload the cached error page.
* Added missing copyright notices to the "show copying" page.

'''Version 0.8'''
* Updated to the latest devkitARM, libnds, libfat and libpng.
* Fix the updater that was broken in 0.7.7.
* Fix some layout randomness (on e.g config screen).
* Change the progress bar to be textless.
* Fix for occasional giant whitespaces.
* Use last-modified in cache calculations.
* Fix flashing when swapping from browser to keyboard.
* Show on-screen password fields with circles.
* Change the password field to use circles.
* Speed up scrolling.
* Performance improvements.
* Change to Okiwi font generation and rendering.
* Fix some major memory leaks.

==External links==
* GitHub (new) - https://github.com/AntonioND/bunjalloo
* Google Code (old archive) - http://code.google.com/p/quirkysoft

PA lib

2025-03-28T02:10:16Z

SkyLyrac:

{{Infobox DS Homebrews
|title=PAlib
|image=palib4.png
|description=A Nintendo DS library used to create homebrew games/apps.
|author=Mollusk
|lastupdated=2025/02/28
|contributor=AntonioND
|type=Development
|version=250228
|license=Mixed
|download=https://github.com/AntonioND/palib
|downloadraw=https://dlhb.gamebrew.org/dshomebrew2/pallib_100707.rar
|website=https://github.com/AntonioND/palib
|source=https://github.com/AntonioND/palib
}}
PAlib is a DS library that works on top of libnds. It is aimed towards simple DS development to make DS games and programs in c and C++. It used to work with devkitARM, but now it is only compatible with BlocksDS.

It was presented in the NEO Coding Compo 2005 (App, 1st place).

While this library isn't recommended for new projects due to its design flaws, it is still useful to build old projects that were built using it.

==Features==
* Sprites functions.
* Background function.
* Text functions.
* An API for buttons.
* Sliders.
* Checks.
* Sound effects support.
* MOD/XM/S3M/IT support thanks to Maxmod.
* MP3 support thanks to ASlib
* Stylus and Pad.
* Draw function.
* Variable case text.
* Retrieve info on DS (user name, birthday, language, time/date, etc).

==Installation==
To install PAlib follow the instructions [https://github.com/AntonioND/palib here].

==User guide==
Tutorials can be found [http://code.google.com/p/palib-tutorial-pdf here].

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/palib2.png

==Media==
'''C/PALib Simple Nintendo DS Platformer''' ([https://www.youtube.com/watch?v=HzqdLHI0SG8 bl0ckeduser]) <br>
<youtube>HzqdLHI0SG8</youtube>

==Changelog==

'''PAlib 250228 beta | AntonioND'''
* [Fix] Fix code that sets the LED blink speed.

'''PAlib 250114 beta | AntonioND'''
* [Fix] Flush cache whenever a DMA copy is made so that users of PAlib don't need to worry about it.
* [ASlib] Flush data cache when a MP3 file is played from RAM so that the developer doesn't need to do it.
* [DMA_Copy] Use safe BlocksDS libnds DMA functions instead of the old PAlib macros.
* [Fix] Actually send temperature and battery level to the ARM9 from the ARM7.

'''PAlib 250107 beta: PAlib lives on | AntonioND'''
* [General] PAlib builds and works again, even on DSi consoles.
* [General] devkitARM build system has been removed in favour of BlocksDS.
* [General] Repository structure has been refactored so that it's clearer.
* [ARM7] The ARM7 cores have been slightly refactored for modern libnds and to support DSi. Also, the libnds exception handler for the ARM7 is now enabled by default.
* [ASlib] Interrupts are now enabled in the VBL handler of ASlib so that it doesn't block multithreading.
* [Fix] The IPC structure is now allocated at runtime instead of using a hardcoded address, which doesn't work on DSi.
* [Fix] Several bugs in ASlib have been fixed.

'''PAlib 100707 QuickFix: The last PAlib release | fincs'''
* [General] Removed the ASlib IPC clear code, it was doing more harm than good.
* [3DSprites] PA_3DCreateSprite now returns the GFX number.
* [Linux] Fixed a backslash (\) path to use forward slash (/).
* [Examples] The updating script screwed up some sound examples, it's now fixed.
* [EFS] EFS support was dropped in favor of libfilesystem.
* [Editors] PN support is now dropped.
* [Fix] PAlib now works with devkitARM r31.
* [Sprite] Fixed PA_DeleteSprite bug (thanks BassAceGold).

==External links==
* devkitPro wiki - http://devkitpro.org/wiki/PAlib
* Google Code - http://code.google.com/p/palib-tutorial-pdf
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=563.0

[[Category:PC utilities for DS]]
[[Category:NEO Coding Compo 2005]]

PA lib

2025-03-28T02:09:55Z

SkyLyrac:

{{Infobox DS Homebrews
|title=PAlib
|image=palib4.png
|description=A Nintendo DS library used to create homebrew games/apps.
|author=Mollusk
|lastupdated=2025/01/14
|contributor=AntonioND
|type=Development
|version=250228
|license=Mixed
|download=https://github.com/AntonioND/palib
|downloadraw=https://dlhb.gamebrew.org/dshomebrew2/pallib_100707.rar
|website=https://github.com/AntonioND/palib
|source=https://github.com/AntonioND/palib
}}
PAlib is a DS library that works on top of libnds. It is aimed towards simple DS development to make DS games and programs in c and C++. It used to work with devkitARM, but now it is only compatible with BlocksDS.

It was presented in the NEO Coding Compo 2005 (App, 1st place).

While this library isn't recommended for new projects due to its design flaws, it is still useful to build old projects that were built using it.

==Features==
* Sprites functions.
* Background function.
* Text functions.
* An API for buttons.
* Sliders.
* Checks.
* Sound effects support.
* MOD/XM/S3M/IT support thanks to Maxmod.
* MP3 support thanks to ASlib
* Stylus and Pad.
* Draw function.
* Variable case text.
* Retrieve info on DS (user name, birthday, language, time/date, etc).

==Installation==
To install PAlib follow the instructions [https://github.com/AntonioND/palib here].

==User guide==
Tutorials can be found [http://code.google.com/p/palib-tutorial-pdf here].

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/palib2.png

==Media==
'''C/PALib Simple Nintendo DS Platformer''' ([https://www.youtube.com/watch?v=HzqdLHI0SG8 bl0ckeduser]) <br>
<youtube>HzqdLHI0SG8</youtube>

==Changelog==

'''PAlib 250228 beta | AntonioND'''
* [Fix] Fix code that sets the LED blink speed.

'''PAlib 250114 beta | AntonioND'''
* [Fix] Flush cache whenever a DMA copy is made so that users of PAlib don't need to worry about it.
* [ASlib] Flush data cache when a MP3 file is played from RAM so that the developer doesn't need to do it.
* [DMA_Copy] Use safe BlocksDS libnds DMA functions instead of the old PAlib macros.
* [Fix] Actually send temperature and battery level to the ARM9 from the ARM7.

'''PAlib 250107 beta: PAlib lives on | AntonioND'''
* [General] PAlib builds and works again, even on DSi consoles.
* [General] devkitARM build system has been removed in favour of BlocksDS.
* [General] Repository structure has been refactored so that it's clearer.
* [ARM7] The ARM7 cores have been slightly refactored for modern libnds and to support DSi. Also, the libnds exception handler for the ARM7 is now enabled by default.
* [ASlib] Interrupts are now enabled in the VBL handler of ASlib so that it doesn't block multithreading.
* [Fix] The IPC structure is now allocated at runtime instead of using a hardcoded address, which doesn't work on DSi.
* [Fix] Several bugs in ASlib have been fixed.

'''PAlib 100707 QuickFix: The last PAlib release | fincs'''
* [General] Removed the ASlib IPC clear code, it was doing more harm than good.
* [3DSprites] PA_3DCreateSprite now returns the GFX number.
* [Linux] Fixed a backslash (\) path to use forward slash (/).
* [Examples] The updating script screwed up some sound examples, it's now fixed.
* [EFS] EFS support was dropped in favor of libfilesystem.
* [Editors] PN support is now dropped.
* [Fix] PAlib now works with devkitARM r31.
* [Sprite] Fixed PA_DeleteSprite bug (thanks BassAceGold).

==External links==
* devkitPro wiki - http://devkitpro.org/wiki/PAlib
* Google Code - http://code.google.com/p/palib-tutorial-pdf
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=563.0

[[Category:PC utilities for DS]]
[[Category:NEO Coding Compo 2005]]

Tales of Dagur

2025-03-25T00:49:24Z

SkyLyrac:

{{Infobox DS Homebrews
|title=Tales of Dagur
|image=talesofdagur.png
|description=A complete RPG game on DS.
|author=LiraNuna
|lastupdated=2025/03/25
|type=Role Playing
|version=2
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/talesofdagur.7z?k33p0fil35
|downloadraw=https://github.com/AntonioND/talesofdagur/releases/tag/v20250325
|website=http://www.talesofdagur.com/main/index.php
|source=https://github.com/AntonioND/talesofdagur
}}
Tales of Dagur is a complete RPG homebrew for the NDS.

It was released for the NEO Spring Coding Compo 2006 (NDS Games, 1st place).

In 2024, the game was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools, DLDI and DSi.

==User guide==
The kingdom of Dagur is in deep troubles: The holy stone that protects the kingdom has been stolen! Further more, the queen of Dagur has disappeared.

A young lad named Alex is summoned by the king to fix the situation. Help Alex return the holy stone, find the queen, and by that save the kingdom!

Don't forget to equip weapons!

==Controls==
'''In game:'''

D-Pad - Movement

A - Perform Action

B - Dash

Start - In-game menu

'''In battle or shop:'''

D-Pad - Scroll through options

A - Select

B - Cancel

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/talesofdagur2.png
https://dlhb.gamebrew.org/dshomebrew/talesofdagur3.png

https://dlhb.gamebrew.org/dshomebrew/talesofdagur4.png
https://dlhb.gamebrew.org/dshomebrew/talesofdagur5.png

==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/e/ea/Talesofdagur.png
|EJS_core=desmume2015
|EJS_gameName=Tales of Dagur
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/talesofdagur.7z
}}
{{DS Control Settings}}

==Compatibility==
Tested on iDeaS.

==Credits==
Code: LiraNuna.

Moral support and font tileset: Chetic.

Storyboard, Script, & Music collection: RVman.

Graphics: Enterbrain.

Mapping and level design: Nikolas Lahtinen.

Beta-testing: Cameron, Chetic and Nikolas.

Special thanks to Rat for the splash screen.

==External links==
* Official website - [https://web.archive.org/web/20090617202956/http://www.talesofdagur.com/main/index.php http://www.talesofdagur.com/main/index.php] (archived)
* Author's website - [https://web.archive.org/web/20100105060038/https://www.liranuna.com/nds-projects/tales-of-dagur https://www.liranuna.com/nds-projects/tales-of-dagur] (archived)
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=1917.0
* Port to BlocksDS - https://github.com/AntonioND/talesofdagur

[[Category:NEO Spring Coding Compo 2006]]

Tales of Dagur

2025-03-25T00:48:33Z

SkyLyrac:

{{Infobox DS Homebrews
|title=Tales of Dagur
|image=talesofdagur.png
|description=A complete RPG game on DS.
|author=LiraNuna
|lastupdated=2025/03/25
|type=Role Playing
|version=2
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/talesofdagur.7z?k33p0fil35
|downloadraw=https://github.com/AntonioND/talesofdagur/releases/tag/v20250325
|website=http://www.talesofdagur.com/main/index.php
|source=https://github.com/AntonioND/talesofdagur
}}
Tales of Dagur is a complete RPG homebrew for the NDS.

It was released for the NEO Spring Coding Compo 2006 (NDS Games, 1st place).

In 2024, the game was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools, DLDI and DSi.

==User guide==
The kingdom of Dagur is in deep troubles: The holy stone that protects the kingdom has been stolen! Further more, the queen of Dagur has disappeared.

A young lad named Alex is summoned by the king to fix the situation. Help Alex return the holy stone, find the queen, and by that save the kingdom!

Don't forget to equip weapons!

==Controls==
'''In game:'''

D-Pad - Movement

A - Perform Action

B - Dash

Start - In-game menu

'''In battle or shop:'''

D-Pad - Scroll through options

A - Select

B - Cancel

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/talesofdagur2.png
https://dlhb.gamebrew.org/dshomebrew/talesofdagur3.png

https://dlhb.gamebrew.org/dshomebrew/talesofdagur4.png
https://dlhb.gamebrew.org/dshomebrew/talesofdagur5.png

==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/e/ea/Talesofdagur.png
|EJS_core=desmume2015
|EJS_gameName=Tales of Dagur
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/talesofdagur.7z
}}
{{DS Control Settings}}

==Compatibility==
Tested on iDeaS.

==Credits==
Code: LiraNuna.

Moral support and font tileset: Chetic.

Storyboard, Script, & Music collection: RVman.

Graphics: Enterbrain.

Mapping and level design: Nikolas Lahtinen.

Beta-testing: Cameron, Chetic and Nikolas.

Special thanks to Rat for the splash screen.

==External links==
* Official website - [https://web.archive.org/web/20090617202956/http://www.talesofdagur.com/main/index.php http://www.talesofdagur.com/main/index.php] (archived)
* Author's website - [https://web.archive.org/web/20100105060038/https://www.liranuna.com/nds-projects/tales-of-dagur https://www.liranuna.com/nds-projects/tales-of-dagur] (archived)
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=1917.0

[[Category:NEO Spring Coding Compo 2006]]

M.U.G.E.N. DS

2025-01-16T01:48:00Z

SkyLyrac:

{{Infobox DS Homebrews
|title=M.U.G.E.N. DS
|image=mugends.png
|description=M.U.G.E.N-style fighting game.
|author=AntonioND
|lastupdated=2008/03/20
|type=Action
|version=Beta 0.1
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/mugends.rar
|website=http://www.elotrolado.net/hilo_-Proyecto--M-U-G-E-N--DS_983626?pagenumber=2
}}
M.U.G.E.N-style homebrew fighting game for the DS.

==User guide==
Fight as Naruto (a character from the Japanese comic Naruto) against another Naruto.

==Controls==
Right/Left - Move, Run (press tiwce)

Up - Jump, Double jump

Down - Cover

L/R - Move player 2

Select - Debug mode

==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/0/04/Mugends.png
|EJS_core=nds
|EJS_gameName=M.U.G.E.N. DS
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/mugends.7z
}}
{{DS Control Settings}}

==External links==
* ElOtroLado - http://www.elotrolado.net/hilo_-Proyecto--M-U-G-E-N--DS_983626?pagenumber=2

Advanced Sound Library

2025-01-16T01:44:53Z

SkyLyrac: /* Known issues */

{{Infobox DS Homebrews
|title=Advanced Sound Library
|image=aslib.png
|description=A sound library for the NDS.
|author=Noda
|lastupdated=2007/12/02
|type=Media Players
|version=1.0
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/advancedsoundlibrary.rar
|website=http://nodadev.wordpress.com/nds-projects/advanced-sound-library
}}
The Advanced Sound Library (ASlib) is a new sound library for the NDS.

==Features==
*MP3 engine.
*Audio engine.

==User guide==
===MP3 engine===
* MP3 is decoded on the arm7, so use nearly no CPU time on the arm9.
* Stereo & surround modes available (surround works even for mono mp3s).
* Up to 44Khz/stereo/96Kbps, though it is recommended to use 32Khz/stereo/80Kbps max, which is enough for the DS and works great with up to +25%/-100% pitching.
* Support real-time pitching (changing the playing speed of the mp3).
* Support real-time volume and panning change.
* The MP3 can be paused and restarted.
* The MP3 can be set to loop automatically.
* Support playing from RAM and streaming from FAT or EFS.
* You can disable the mp3 engine if you want, to get 2 more channels.

===Audio engine===
* Can use the whole 16 DS channel or only the first half (so you can use an external mod player, for example).
* Support standard or surround/fx mode (16 channels in standard mode (-2 if mp3), 8 in surround/fx mode (-1 if mp3)).
* Simple sound playing using a priority system: if no channel is available, stop a sound that has less priority than the new one to play it, or skip it if all sounds have more priority.
* Possibility to reserve a particular channel so it won’t be used in the channel pool by the priority playing system. You can then manage the reserved sound channels manually.
* Surround or pseudo-reverb can be activated per sound (works great with mono sounds).
* Support real-time volume, panning and pitch modifications for each sound.
* Support sound looping.

The lib comes with a template and a example of what you can do with it.

==Known issues==
This library build using a way old DKP version: devkitPro r21 and libnds 20071023, newer version may not compile it because the IPC system was removed.

There is a port of ASlib to BlocksDS in the PAlib repository, allowing developers to use ASlib with modern tools: https://github.com/AntonioND/palib

==Credits==
IPC sound system and streaming is based on cold_as_ice streaming example.

Audio stream filling / mp3 decoding based on ThomasS mp3 decoding example.

ASM stereo desinterleave function was made by Thoduv.

==External links==
* Author's website - http://nodadev.wordpress.com/nds-projects/advanced-sound-library

PA lib

2025-01-14T14:26:22Z

SkyLyrac:

{{Infobox DS Homebrews
|title=PAlib
|image=palib4.png
|description=A Nintendo DS library used to create homebrew games/apps.
|author=Mollusk
|lastupdated=2025/01/14
|contributor=AntonioND
|type=Development
|version=250114
|license=Mixed
|download=https://github.com/AntonioND/palib
|downloadraw=https://dlhb.gamebrew.org/dshomebrew2/pallib_100707.rar
|website=https://github.com/AntonioND/palib
|source=https://github.com/AntonioND/palib
}}
PAlib is a DS library that works on top of libnds. It is aimed towards simple DS development to make DS games and programs in c and C++. It used to work with devkitARM, but now it is only compatible with BlocksDS.

It was presented in the NEO Coding Compo 2005 (App, 1st place).

While this library isn't recommended for new projects due to its design flaws, it is still useful to build old projects that were built using it.

==Features==
* Sprites functions.
* Background function.
* Text functions.
* An API for buttons.
* Sliders.
* Checks.
* Sound effects support.
* MOD/XM/S3M/IT support thanks to Maxmod.
* MP3 support thanks to ASlib
* Stylus and Pad.
* Draw function.
* Variable case text.
* Retrieve info on DS (user name, birthday, language, time/date, etc).

==Installation==
To install PAlib follow the instructions [https://github.com/AntonioND/palib here].

==User guide==
Tutorials can be found [http://code.google.com/p/palib-tutorial-pdf here].

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/palib2.png

==Media==
'''C/PALib Simple Nintendo DS Platformer''' ([https://www.youtube.com/watch?v=HzqdLHI0SG8 bl0ckeduser]) <br>
<youtube>HzqdLHI0SG8</youtube>

==Changelog==

'''PAlib 250114 beta | AntonioND'''
* [Fix] Flush cache whenever a DMA copy is made so that users of PAlib don't need to worry about it.
* [ASlib] Flush data cache when a MP3 file is played from RAM so that the developer doesn't need to do it.
* [DMA_Copy] Use safe BlocksDS libnds DMA functions instead of the old PAlib macros.
* [Fix] Actually send temperature and battery level to the ARM9 from the ARM7.

'''PAlib 250107 beta: PAlib lives on | AntonioND'''
* [General] PAlib builds and works again, even on DSi consoles.
* [General] devkitARM build system has been removed in favour of BlocksDS.
* [General] Repository structure has been refactored so that it's clearer.
* [ARM7] The ARM7 cores have been slightly refactored for modern libnds and to support DSi. Also, the libnds exception handler for the ARM7 is now enabled by default.
* [ASlib] Interrupts are now enabled in the VBL handler of ASlib so that it doesn't block multithreading.
* [Fix] The IPC structure is now allocated at runtime instead of using a hardcoded address, which doesn't work on DSi.
* [Fix] Several bugs in ASlib have been fixed.

'''PAlib 100707 QuickFix: The last PAlib release | fincs'''
* [General] Removed the ASlib IPC clear code, it was doing more harm than good.
* [3DSprites] PA_3DCreateSprite now returns the GFX number.
* [Linux] Fixed a backslash (\) path to use forward slash (/).
* [Examples] The updating script screwed up some sound examples, it's now fixed.
* [EFS] EFS support was dropped in favor of libfilesystem.
* [Editors] PN support is now dropped.
* [Fix] PAlib now works with devkitARM r31.
* [Sprite] Fixed PA_DeleteSprite bug (thanks BassAceGold).

==External links==
* devkitPro wiki - http://devkitpro.org/wiki/PAlib
* Google Code - http://code.google.com/p/palib-tutorial-pdf
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=563.0

[[Category:PC utilities for DS]]
[[Category:NEO Coding Compo 2005]]

PA lib

2025-01-14T14:25:24Z

SkyLyrac: PAlib has now been ported to BlocksDS, link to it instead of the old version that doesn't work with devkitARM.

{{Infobox DS Homebrews
|title=PAlib
|image=palib4.png
|description=A Nintendo DS library used to create homebrew games/apps.
|author=Mollusk
|lastupdated=2025/01/14
|contributor=AntonioND
|type=Development
|version=250114
|license=Mixed
|download=https://github.com/AntonioND/palib
|downloadraw=https://dlhb.gamebrew.org/dshomebrew2/pallib_100707.rar
|website=https://github.com/AntonioND/palib
|source=https://github.com/AntonioND/palib
}}
PA_lib is a DS library which based on ndslib. It is aimed towards simple DS development to make DS games and programs in c and C++. It used to work with devkitARM, but now it is only compatible with BlocksDS.

It was presented in the NEO Coding Compo 2005 (App, 1st place).

While this library isn't recommended for new projects due to its design flaws, it is still useful to build old projects that were built using it.

==Features==
* Sprites functions.
* Background function.
* Text functions.
* An API for buttons.
* Sliders.
* Checks.
* Sound effects support.
* MOD/XM/S3M/IT support thanks to Maxmod.
* MP3 support thanks to ASlib
* Stylus and Pad.
* Draw function.
* Variable case text.
* Retrieve info on DS (user name, birthday, language, time/date, etc).

==Installation==
To install PAlib follow the instructions [https://github.com/AntonioND/palib here].

==User guide==
Tutorials can be found [http://code.google.com/p/palib-tutorial-pdf here].

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/palib2.png

==Media==
'''C/PALib Simple Nintendo DS Platformer''' ([https://www.youtube.com/watch?v=HzqdLHI0SG8 bl0ckeduser]) <br>
<youtube>HzqdLHI0SG8</youtube>

==Changelog==

'''PAlib 250114 beta | AntonioND'''
* [Fix] Flush cache whenever a DMA copy is made so that users of PAlib don't need to worry about it.
* [ASlib] Flush data cache when a MP3 file is played from RAM so that the developer doesn't need to do it.
* [DMA_Copy] Use safe BlocksDS libnds DMA functions instead of the old PAlib macros.
* [Fix] Actually send temperature and battery level to the ARM9 from the ARM7.

'''PAlib 250107 beta: PAlib lives on | AntonioND'''
* [General] PAlib builds and works again, even on DSi consoles.
* [General] devkitARM build system has been removed in favour of BlocksDS.
* [General] Repository structure has been refactored so that it's clearer.
* [ARM7] The ARM7 cores have been slightly refactored for modern libnds and to support DSi. Also, the libnds exception handler for the ARM7 is now enabled by default.
* [ASlib] Interrupts are now enabled in the VBL handler of ASlib so that it doesn't block multithreading.
* [Fix] The IPC structure is now allocated at runtime instead of using a hardcoded address, which doesn't work on DSi.
* [Fix] Several bugs in ASlib have been fixed.

'''PAlib 100707 QuickFix: The last PAlib release | fincs'''
* [General] Removed the ASlib IPC clear code, it was doing more harm than good.
* [3DSprites] PA_3DCreateSprite now returns the GFX number.
* [Linux] Fixed a backslash (\) path to use forward slash (/).
* [Examples] The updating script screwed up some sound examples, it's now fixed.
* [EFS] EFS support was dropped in favor of libfilesystem.
* [Editors] PN support is now dropped.
* [Fix] PAlib now works with devkitARM r31.
* [Sprite] Fixed PA_DeleteSprite bug (thanks BassAceGold).

==External links==
* devkitPro wiki - http://devkitpro.org/wiki/PAlib
* Google Code - http://code.google.com/p/palib-tutorial-pdf
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=563.0

[[Category:PC utilities for DS]]
[[Category:NEO Coding Compo 2005]]

Tetris 3DS

2025-01-10T17:38:08Z

SkyLyrac: The known issues section is no longer required

{{Infobox DS Homebrews
|title=Tetris 3DS
|image=tetris3dsant.png
|description=Tetris in 3D.
|author=AntonioND
|lastupdated=2025/01/07
|type=Puzzle
|version=1.4
|license=Mixed
|download=https://github.com/AntonioND/tetris-3ds/releases/download/v1.4/Tetris_3DS_v1.4.zip
|downloadraw=https://dlhb.gamebrew.org/dshomebrew2/tetris3ds_antonio.rar
|website=https://github.com/AntonioND/tetris-3ds
|source=https://github.com/AntonioND/tetris-3ds
}}
This is a 3D tetris game for Nintendo DS and DSi that lets you listen to your own MP3 songs while you play.

This was submitted to the Scenery Beta 2008 (NDS Games, 1st place).

==User guide==

Create folder Tetris_3DS in the root of your SD card. Then, add as many songs as you want with the name Song_XX.mp3. The game iterates over all songs until there is a missing number, which will restart the loop. You can also add a song called Menu.mp3, which will play in a loop while in the main menu.

Since version 1.4 the game can also run in DSi mode, so it can also find the files in the internal SD card of the DSi, not just in a flashcard. If you're running the game from a regular DS, remember to patch your rom with DLDI (if your loader doesn't do it automatically).

SD root
|
|-Tetris_3DS
|
|-Tetris_3DS.nds (It can be here or somewhere else!)
|-Menu.mp3
|-Song_00.mp3
|-Song_XX.mp3 (From 01 to 99)
|-Tetris3DS_Config.dat (Created automatically by the game.)

The game will create a file called Error_Log.txt if there is a decoding error so that you can check which files are problematic.

There is a JUKEBOX option that allows you to listen to the music without having to play the game.

==Controls==

L+R+Select+Start - Switch off DS in main menu

'''Classic mode:'''

Can be controlled with Stylus or Keypad.

Up/Down - Left/Right

Left - Down speed increased

Right - Automatically go down

A or Double tap - Rotate

X - Reserve

Start - Pause

'''Multiplayer:'''

Select+Start - Enter Versus CPU mode

Start - Pause

{| class="wikitable" style="width: 400px;"
|-
!style="width: 25%;"| Player 1
!style="width: 25%;"| Player 2
!style="width: 50%;"| Effect
|-
| Up || X || Reserve.
|-
| Left/Right || Y/A || Move.
|-
| Down || B || Down speed increased.
|-
| L || R || Rotate.
|-
|}

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/tetris3dsant3.png
https://dlhb.gamebrew.org/dshomebrew/tetris3dsant4.png

https://dlhb.gamebrew.org/dshomebrew/tetris3dsant2.png
https://dlhb.gamebrew.org/dshomebrew/tetris3dsant5.png

==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/d/d4/Tetris3dsant.png
|EJS_core=desmume2015
|EJS_gameName=Tetris 3DS
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/tetris3dsant.7z
}}
{{DS Control Settings}}


==Credits==
Joat, Dovoto and WinterMute for libnds.

Chishm for libfat.

Mollusk for PAlib.

Noda for ASlib.

==External links==
* Author's website - https://github.com/AntonioND/tetris-3ds
* Author's old website - http://www.skylyrac.net/old-site/nds.html
* SceneBeta - https://nds.scenebeta.com/noticia/tetris-3ds

[[Category:Scenery Beta 2008]]

Tetris 3DS

2025-01-09T18:12:27Z

SkyLyrac: Update for version 1.4

{{Infobox DS Homebrews
|title=Tetris 3DS
|image=tetris3dsant.png
|description=Tetris in 3D.
|author=AntonioND
|lastupdated=2025/01/07
|type=Puzzle
|version=1.4
|license=Mixed
|download=https://github.com/AntonioND/tetris-3ds/releases/download/v1.4/Tetris_3DS_v1.4.zip
|downloadraw=https://dlhb.gamebrew.org/dshomebrew2/tetris3ds_antonio.rar
|website=https://github.com/AntonioND/tetris-3ds
|source=https://github.com/AntonioND/tetris-3ds
}}
This is a 3D tetris game for Nintendo DS and DSi that lets you listen to your own MP3 songs while you play.

This was submitted to the Scenery Beta 2008 (NDS Games, 1st place).

==User guide==

Create folder Tetris_3DS in the root of your SD card. Then, add as many songs as you want with the name Song_XX.mp3. The game iterates over all songs until there is a missing number, which will restart the loop. You can also add a song called Menu.mp3, which will play in a loop while in the main menu.

Since version 1.4 the game can also run in DSi mode, so it can also find the files in the internal SD card of the DSi, not just in a flashcard.

SD root
|
|-Tetris_3DS
|
|-Tetris_3DS.nds (It can be here or somewhere else!)
|-Menu.mp3
|-Song_00.mp3
|-Song_XX.mp3 (From 01 to 99)
|-Tetris3DS_Config.dat (Created automatically by the game.)

The game will create a file called Error_Log.txt if there is a decoding error so that you can check which files are problematic.

There is a JUKEBOX option that allows you to listen to the music without having to play the game.

==Controls==

L+R+Select+Start - Switch off DS in main menu

'''Classic mode:'''

Can be controlled with Stylus or Keypad.

Up/Down - Left/Right

Left - Down speed increased

Right - Automatically go down

A or Double tap - Rotate

X - Reserve

Start - Pause

'''Multiplayer:'''

Select+Start - Enter Versus CPU mode

Start - Pause

{| class="wikitable" style="width: 400px;"
|-
!style="width: 25%;"| Player 1
!style="width: 25%;"| Player 2
!style="width: 50%;"| Effect
|-
| Up || X || Reserve.
|-
| Left/Right || Y/A || Move.
|-
| Down || B || Down speed increased.
|-
| L || R || Rotate.
|-
|}

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/tetris3dsant3.png
https://dlhb.gamebrew.org/dshomebrew/tetris3dsant4.png

https://dlhb.gamebrew.org/dshomebrew/tetris3dsant2.png
https://dlhb.gamebrew.org/dshomebrew/tetris3dsant5.png

==Online emulator==
{{EmulatorJS Main
|width=515px
|height=384px
|EJS_backgroundImage=https://www.gamebrew.org/images/d/d4/Tetris3dsant.png
|EJS_core=desmume2015
|EJS_gameName=Tetris 3DS
|EJS_gameUrl=https://dlhb.gamebrew.org/onlineemulators/nds/tetris3dsant.7z
}}
{{DS Control Settings}}

==Known issues==
Sometimes the game gives an error while loading and both screens, just turn black and the game freezes.

This happens because it gives a write error even if FAT has inited OK. You can stop FAT init if you hold R+L before the moment when the game freezes (After the [Tetris 3DS / by Antonio Niño Díaz] screen).

It won't load anything from FAT, but the game will work.

==Credits==
Joat, Dovoto and WinterMute for libnds.

Chishm for libfat.

Mollusk for PAlib.

Noda for ASlib.

==External links==
* Author's website - https://github.com/AntonioND/tetris-3ds
* Author's old website - http://www.skylyrac.net/old-site/nds.html
* SceneBeta - https://nds.scenebeta.com/noticia/tetris-3ds

[[Category:Scenery Beta 2008]]

Woopsi

2024-11-02T13:31:28Z

SkyLyrac: Update repository link (the bitbucket one points to GitHub).

{{Infobox DS Homebrews
|title=Woopsi
|image=Woopsi.png
|description=Nintendo DS GUI library.
|author=Ant 512 (Antony Dzeryn)
|lastupdated=2011/07/21
|type=Development
|version=1.3
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/woopsi.7z?k33p0fil35 1.3 & Demo
|website=http://woopsi.org
|source=https://github.com/ant512/Woopsi
}}
Woopsi is a Nintendo DS GUI library for rapidly creating user interfaces for homebrew software. Modelled after the AmigaOS windowing system.

It is a BSD-licenced GUI toolkit for the Nintendo DS, written in C++. It features a 2D graphics library with fast clipping routines and a full suite of UI components, including text boxes, scrolling lists, buttons, windows, etc. It can be used to produce everything from simple GUIs to full-blown window managers.

==Features==
* Support for multiple windows.
* Full set of components of the user interface.
* The elements (windows) can be dragged.
* Windows without frames.
* Debug mode.
* Optimized application to draw and erase.
* System events.
* Automatic application to collect garbage.
* Complete API to build new applications.
* Different types of fonts supported.
* Oriented design to easily adapt to other programs in C++.
* Simple API for rapid creation of a graphical user interface.
* FIFO multitasking, each application runs at a time.
* Unicode strings encoded with UTF-8.
* Support for Windows applications (font2font, bmp2font, etc).

==User guide==
It requires the latest devkitPro and do one of the following things as operating system:

* Windows - 2 methods available. Use the Install.bat found in the folder or copy the folder Woopsi libwoopsi to C:\devkitPro.
* Linux - Same as the second option of Windows, copy the folder libwoopsi to C:\devkitPro.
* MacOSX - Compile what is in the folder Woopsi.

To test the installation:
* Open a command prompt and CD to the template folder (relative to the document) and type <code>make</code>
* Open the /template/Release/template.nds ROM file in a DS emulator or copy it to your flash cart and load it up.

==Media==
'''Woopsi demo v0.99.3''' ([https://www.youtube.com/watch?v=aOA650uKf8s Cid2Mizard]) <br>
<youtube>aOA650uKf8s</youtube>

==Changelog==
'''V1.3'''

Fixes:
* Label and TextBox are more efficient when rendering text changes.
* Removed unused GLYPH_MAP_SIZE constant from fontbase.h.
* Header file in template moved into include directory.
* Animation::play() stops if there are no frames to play.
* Animation::getCurrentFrame() returns NULL if there are no frames.
* Animation::getCurrentBitmap() returns NULL if there are no bitmaps.
* Fixed memory leak when deleting SDL framebuffer.
* Removed extraneous globals from woopsifuncs.cpp.
* WoopsiString::subString() passes the correct arguments to the WoopsiString constructor.
* StringIterator::moveTo() ignores attempts to move to negative indices.
* Improved use of DMA hardware.
* Updated C# tools.
* Removed Visual Studio files.

New Features:
* Added WoopsiTimer::isRunning().
* Added SuperBitmap::setX().
* Added SuperBitmap::setY().
* Added SuperBitmap::getX().
* Added SuperBitmap::getY().
* Added FontConverter, a winforms UI for font2font.

==Credits==
Coding and design - Antony Dzeryn.

Testing, technical advice, other contributions - Jeff Laing.

PALib independence - Steven Harrison.

Testing and suggestions - John Buxton, Chase, Leonelhs, Carpfish.

Unicode work and libfreetype integration - Olivier Binda (Lakedaemon).

Testing and gadget contributions - Mark Adamson.

Simian Zombie logo - John Clay.

Thanks to - The devKitPro team.

==External links==
* Official website - http://woopsi.org
* Bitbucket - https://bitbucket.org/ant512/woopsi

WolveSlayer

2024-08-05T00:31:44Z

SkyLyrac: All the WTFPL code is gone, the license is now 100% MIT.

{{Infobox DS Homebrews
|title=WolveSlayer
|image=wolveslayer.png
|description=3D hack n slash game.
|author=Firehazard Studio, AntonioND
|lastupdated=2024/07/31
|type=Action
|version=v20240731
|license=MIT
|download=https://dlhb.gamebrew.org/dshomebrew/wolveslayer.7z?0714
|website=https://github.com/AntonioND/wolveslayer/
|source=https://github.com/AntonioND/wolveslayer/
}}
WolveSlayer is a 3D hack'n'slash game for the NDS. Its graphics engine uses effects that have yet to be seen on commercial DS games.

Developed by Firehazard Studio, this homebrew game was released for the NEO Spring Coding Compo 2007, where it won 1st place in the GBA/NDS Game category.

In 2024, the game was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools.

==Features==
* 3D graphics (effect of lighting and bump mapping).

==Installation==
<tabber>
|-|BlocksDS port=

Copy the .nds file to your storage device.

|-|Neoflash compo ver.=

[[DLDI|DLDI]] patch the ROM if needed and copy it to your flashcard.

One of those ROMs has an icon and ROM infos attached. But this causes bugs on some flashcards (e.g. sccf and ds-x). If you have trouble use the other rom (blank rom).

Don't forget to copy the folder wolveslayer to the root of your flashcard.
</tabber>

==User guide==
Main aim of this game is to find and slay down a big grey wolf (you will meet smaller ones too). Of course you will lose if they kill you.

==Controls==
D-Pad - Move character

A - Open doors (so far only one)

B - Swing the sword

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/wolveslayer2.png
https://dlhb.gamebrew.org/dshomebrew/wolveslayer3.png

https://dlhb.gamebrew.org/dshomebrew/wolveslayer4.png
https://dlhb.gamebrew.org/dshomebrew/wolveslayer5.png

==Media==
'''WolveSlayer (walktrough and killing endbss)''' ([https://www.youtube.com/watch?v=q-SZ4lWB1Qs DrunkencoderPayk]) <br>
<youtube>q-SZ4lWB1Qs</youtube>

==Online Emulator==
{{#tag:html|
<div style='width:520px;height:390px;max-width:100%'><div id='game'></div></div>
<script type='text/javascript'>
{{DS EmulatorJS Settings}}
EJS_core = 'nds';
EJS_gameName = "WolveSlayer";
EJS_gameUrl = 'https://dlhb.gamebrew.org/onlineemulators/nds/wolveslayer.7z';
</script>
{{EmulatorJS Loader}}
}}
{{DS Control Settings}}


==Changelog==
'''2024/07/31'''
* The internal code of the game engine has been cleaned up and reorganized.
* Some of the code that loads assets has been optimized.
* Many checks have been added to the code to make the code more memory-safe.
* A buffer underflow buffer has been fixed. This sometimes manifested as video glitches when swinging the sword to the right of the screen (but only with custom builds, not with the builds on GitHub).
* The MOD player has been replaced by LibXM7. This reduces the amount of code to maintain in this repository and will mean that this game gets the benefits of other projects that also use LibXM7 and fix bugs there.
* The code of the repository has been licensed under the MIT license with permission from Payk.

'''2024/07/14'''
* This version fixes the super slow speed when loading files, which was particularly bad on DSi. It also changes the format of fatal error messages so that they are more readable.

'''2024/07/12''' (AntonioND)
* First release of the port to BlocksDS.

'''2007/03/24'''
* This version has a bit shorter loading times in the first map and solved umlaut problem.

'''2007/03/20''' (Firehazard Studio)
* Released for the Neoflash Spring Coding Compo 07.

==External links==
* Author's website (Payk) - [https://web.archive.org/web/20071212183823/http://payk.drunkencoders.com http://payk.drunkencoders.com] (archived)
* GitHub (AntonioND) - https://github.com/AntonioND/wolveslayer/releases/
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=3895.0
* Forum - https://forums.gamebrew.org/threads/old-release-wolveslayer-source-code.601/

[[Category:NEO Spring Coding Compo 2007]]

Volumetric Shadow Demo

2024-08-05T00:21:41Z

SkyLyrac: Add link to port of the demo to BlocksDS

{{Infobox DS Homebrews
|title=Volumetric Shadow Demo
|image=vsd.png
|description=NDS Tech Demo, formerly know as the Stencil Shadow Demo.
|author=Rob (silent_code, R.H.L.)
|lastupdated=2024/08/05
|type=Demos
|version=1.7.1
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew/vsd.7z
|downloadraw=https://dlhb.gamebrew.org/dshomebrew/vsd.7z
|website=http://www.robs-basement.de/#RB_NDS_VSD
|source=https://github.com/AntonioND/volumetric_shadow_demo
}}
Volumetric Shadow Demo is a NDS tech demo program formerly know as the Stencil Shadow Demo, and later Volume Shadow Demo. This small open source program demonstrates, among other things, some of the NDS' graphics hardware capabilities.

In 2024, the demo was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools.

==Features==
* Hardware accelerated volumetric shadowing.
* Motion blur with video capture, using only one VRAM bank, at 60 FPS.
* Hardware lighting, texturing, fogging, antialiasing etc.
* Display brightness control.
* Viewport scissoring (thanks to gabebear off the gbadev.org forum).
* Loading binary and text files from disk (through libfat).
* Converting .tga 24/32bit image data to 16bit nds textures.
* Displaying a custom font and a text area over a background image, all loaded from disk.
* Smooth touch input.
* Simple frame rate counting and some other rendering status info.

==Installation==
<tabber>
|-|BlocksDS port=

Copy the .nds file to your storage device.

|-|Neoflash compo ver.=

Copy the .nds file to the root of your card.

You will see all (data) files are located in the vsd_data directory.

Copy them into the /data/ folder on the root of your card. Or alternatively, directly into the root.

Create the data directory, if not already present on your card.
</tabber>

'''Files that need to be copied:'''

vsd_###.nds (or vsd_###_fcsr.nds, in which case nothing else is needed) <br>
doll.char <br>
room.char <br>
shadow.char <br>
font.pbi <br>
splash.pbi <br>
loading.pbi <br>
doll256.tga <br>
test.tga <br>

Depending on your device, you may have to manually patch the .nds file to make it work with [[DLDI|DLDI]]. Your card's manufacturer can help you with how to accomplish that.

==User guide==
===Initialization===
Prepare the hardware by setting the flush mode to manual and w-depth sorting with:
glFlush(GL_TRANS_MANUALSORT | GL_WBUFFERING);

Do so in the frame before the frame you will draw the shadows. Usually, you would set this up when initializing the application and flush each frame with those settings.

You might need to sort your translutient polygons/meshes. Remember, that certain volumetric shadow geometry configurations will cause artifacts.

===Render volumetric shadows===
These are the three basic steps you need to follow to render volumetric shadows.

1) Render all the shadow casting and receiving geometry as usually.

2) For every shadow geometry, draw the Stencil Mask. Shadow polygons must be translutient, so enable blending and render the shadow geometry's front using the following settings:
glPolyFmt(POLY_ALPHA(1) | POLY_CULL_FRONT | POLY_ID(0) | POLY_SHADOW);

Alpha must be between 1 and 30 and ID also must be 0.

3) The Stencil Shadow: Now, finally draw the shadow geometry's back with these settings:
glPolyFmt(POLY_ALPHA(20) | POLY_CULL_BACK | POLY_ID(63) | POLY_SHADOW);

Again, alpha needs to be between 1 and 30, but this time ID must not be 0.

Now you should have a volume shadow on screen. Repeat steps two and three for all other shadow geometry.

Tutorials can be found at [http://www.code-basement.net/files/nds/vsd/volumetric-shadows-nds.tutorial.txt the official website].

==Controls==
'''During demo:'''

Touch (Stylus) - Look

D-Pad - Move the camera (forward/backward)

A/B/X/Y - Move the character

Start - Reset scene

Select+A - toggle shadowing

Select+B - toggle texturing

Select+X - toggle lighting

Select+Y - toggle capturing (motion blur)

R+D-Pad - Move a scissor box

L+D-Pad - Move the camera (up/down)

R+L+Up/Down - Change the brightness

R+L+Start - Reset the scene and the brightness

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/vsd2.png
https://dlhb.gamebrew.org/dshomebrew/vsd3.png

==Compatibility==
'''Emulators:'''

When using [http://dev-scene.com/NDS/FCSR_Tutorial FCSR], it is mostly compatible with no$gba 2.6 (the emulator is still missing some features). Other emulators are not supported.

'''Hardware:'''

Compatible with DLDI-able FAT cards, tested with SLOT1 M3 Real via the firmware's autopatching. Through [http://dev-scene.com/NDS/FCSR_Tutorial FCSR], it is also compatible with older SLOT2 (GBA) NOR cartridges, tested with NeoFlash 512Mb.

==Changelog==
'''Revision 7.1'''
* Update format of documentation.

'''Revision 7.0'''
* Migrated to BlocksDS.
* Switched to using NitroFS instead of libfat.

'''Revision 6.0'''
* Fixed the tutorial (thanks to zeruda at gabdev).
* Fixed a typo in the readme (thanks to jello!) and updated it.
* Cleaned up console initialization and proper use of libnds' definitions.
* Fixed material/lighting bug.
* Added and fixed come source comments.
* Fixed initialization function.
* Fixed the view class and its usage.
* Replaced the floating point gluPerspective() whith its fixed point counterpart.
* Reworked some parts of the mesh rendering.
* Removed last bits of "useless stuff."

'''Revision 5.1'''
* Refactored and fixed the scissor class.
* Fixed fopen() usage.
* Reduced file path to 31 (+ \0) characters and renamed some files.
* Cleaned up glEnable() usage.
* Added vertex and primitive list RAM usage display.
* Added free render buffer lines display.
* Readme has been fixed and updated.

'''Revision 5.0'''
* Renamed to "Volumetric Shadow Demo".
* Fixed input bug: textures could not be toggled.
* Fixed: Single "include all" header style was remedied with only including and declaring what is needed in each compilation unit.
* Restructured some source files.
* Removed ARM7 source file and rearranged the project to ARM9 only (Using the default ARM7 binary).
* Changed to unmodified default Makefile.
* Changed the source usage "policy" a little bit.
* Separated the tutorial from the readme.
* Readme has been updated accordingly.

'''Revision 4.0'''
* Did quite some source clean-up, rewriting and rearranging.
* Added view and scissor box classes.
* Added data directory support.
* Added better error detection and handling.
* Changed fog table generation.
* Refactored a lot of variables and functions.
* Added some more comments.
* Fixed some typos in the readme and updated it.

'''Revision 3.0'''
* Changed file system to libfat.
* Added frame rate counter.
* Added touch input smoothing (still need to fix the slight drifting).
* Fixed the fog color.
* Rearranged and cleaned up the sources.
* Updated and fixed the readme.
* Cleaned up and fixed the tutorial.

'''Revision 2.0'''
* Moved to devkitARM R23b.
* Updated to libnds 20071023.
* Fixed the readme.
* Slightly changed the .pbi format - old data and routines are incompatible.
* Fixed "odd" loading routines.
* Fixed some minor bugs.
* Cleaned up the sources a little bit.
* Added some info about the .tga format in "tgaloader.cpp".
* Added an overview of controls to the bottom screen.

'''Revision 1.2'''
* Fixed and rearranged some things in the readme.
* Changed the term "shadow volumes" to the more precise term "volume shadows" in the readme.
* Added a tutorial section.
* Updated to libnds 20070503.
* Added hardware fog.
* Added capture support and a slight motion blur effect.
* Added some new controls.

'''Revision 1.1'''
* Fixed and rearranged some things in the readme.
* Updated to libnds 2007050.
* Removed my FIX versions of previously 'broken' libnds funktions.

'''Revision 1.0'''
* Fixed and added things to the readme: additional thanks, change log, controls etc.
* Replaced the shadow volume with a better suited (and simpler) one.
* Fixed the controls.

'''1.0.0'''
* Initial release.

==Credits==
It was built with devkitARM R23b, libnds 20071023 and libfat 20070127 from the libnds "touch_look" example (as a project kick-start), so credit and thanks go out to their respective authors.

Credit also goes to gabebear for the scissor pick matrix implementation.

Very special thanks go out to Larry E. and Brandon M. for helping with the hardware.

Special thanks to tepples, simonjhall and Alphanoob.

Also, greetings to everybody at the gbadev.org forums.

==External links==
* Author's website - http://www.robs-basement.de/#RB_NDS_VSD

Tales of Dagur

2024-08-05T00:18:04Z

SkyLyrac: Add link to port of the game to BlocksDS

{{Infobox DS Homebrews
|title=Tales of Dagur
|image=talesofdagur.png
|description=A complete RPG game on DS.
|author=LiraNuna
|lastupdated=2006/03/26
|type=Role Playing
|version=2
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew/talesofdagur.7z?k33p0fil35
|downloadraw=https://dlhb.gamebrew.org/dshomebrew/talesofdagur.7z
|website=http://www.talesofdagur.com/main/index.php
|source=https://github.com/AntonioND/talesofdagur
}}
Tales of Dagur is a complete RPG homebrew for the NDS.

It was released for the NEO Spring Coding Compo 2006 (NDS Games, 1st place).

In 2024, the game was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools, DLDI and DSi.

==User guide==
The kingdom of Dagur is in deep troubles: The holy stone that protects the kingdom has been stolen! Further more, the queen of Dagur has disappeared.

A young lad named Alex is summoned by the king to fix the situation. Help Alex return the holy stone, find the queen, and by that save the kingdom!

Don't forget to equip weapons!

==Controls==
'''In game:'''

D-Pad - Movement

A - Perform Action

B - Dash

Start - In-game menu

'''In battle or shop:'''

D-Pad - Scroll through options

A - Select

B - Cancel

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/talesofdagur2.png
https://dlhb.gamebrew.org/dshomebrew/talesofdagur3.png

https://dlhb.gamebrew.org/dshomebrew/talesofdagur4.png
https://dlhb.gamebrew.org/dshomebrew/talesofdagur5.png

==Online Emulator==
{{#tag:html|
<div style='width:520px;height:390px;max-width:100%'><div id='game'></div></div>
<script type='text/javascript'>
{{DS EmulatorJS Settings}}
EJS_core = 'desmume2015';
EJS_gameName = "Tales of Dagur";
EJS_gameUrl = 'https://dlhb.gamebrew.org/onlineemulators/nds/talesofdagur.7z';
</script>
{{EmulatorJS Loader}}
}}
{{DS Control Settings}}

==Compatibility==
Tested on iDeaS.

==Credits==
Code: LiraNuna.

Moral support and font tileset: Chetic.

Storyboard, Script, & Music collection: RVman.

Graphics: Enterbrain.

Mapping and level design: Nikolas Lahtinen.

Beta-testing: Cameron, Chetic and Nikolas.

Special thanks to Rat for the splash screen.

==External links==
* Official website - [https://web.archive.org/web/20090617202956/http://www.talesofdagur.com/main/index.php http://www.talesofdagur.com/main/index.php] (archived)
* Author's website - [https://web.archive.org/web/20100105060038/https://www.liranuna.com/nds-projects/tales-of-dagur https://www.liranuna.com/nds-projects/tales-of-dagur] (archived)
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=1917.0

[[Category:NEO Spring Coding Compo 2006]]

Meteora Galatic Battle

2024-08-04T23:30:59Z

SkyLyrac: Add link to port of the game to BlocksDS

{{Infobox DS Homebrews
|title=Meteora Galactic Battle
|image=meteora.png
|description=Meteroa is a space/fantasy based god-sim game by J.
|author=Jerome Wax (X-Blaster)
|lastupdated=2007/08/21
|type=Simulation
|version=0.9.2
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew/meteora.7z?k33p0fil35 0.8.0 & 0.9.2
|downloadraw=http://meteora.lo2k.net/download/meteora-src.rar
|website=http://meteora.lo2k.net
|source=https://github.com/AntonioND/meteora
}}
Meteroa is a space fantasy based god-sim game by Jerome Wax that lies somewhere between populous, world of sand and pong. From over 8 months of development, it is a game of strategy action in space.

It was submitted to the NEO Summer Coding Compo 2007 (NDS Game, 3rd place). Verion 0.8.0 Meteora Evolution was presented in the Dev-fr Coding Compo 2007 (Game, 2nd place).

In 2024, the game was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools and for better compatibility on DSi mode.

==Feature==
* An engine containing a garbage collector to avoid memory leaks during development.
* Use the microphone for certain powers.
* Use of gestures.
* Visual effects (explosions, earthquakes, meteor streaks).
* Use of dual-screen 3D (thanks to the ulib).
* Sprites more than 1200 on the screen.

==User guide==
Meteora is an action version of meteos. It is a game where planets attack each other. You control one of the two planets and by sending mana your goal is to get your opponent's life to zero before you do.

You and your opponent have:
* Mana (to use your powers).
* A shield that constantly regenerates.
* The clean energy of your planet.

Whenever you send an attack up the screen, your opponent will receive it (planets can be several light years apart). Your opponent can deflect your attacks as you might, ie by using his God Powers.

You must therefore send as many attacks as possible towards your opponent while trying to stop the attacks coming from your opponent.

===Mana===
Your planet has a certain amount of mana you regain all the time. Free the mana to deflect, destroy the enemy attacks.

Your Stylus acts as a magnet to which you belong. The more you're ready for a ball of mana, the more you attract, the more you are away, your pen is less effective. Keep this principle in mind as you play. To successfully send an attack so do not give a boost with the stylus but with your attack.

===Powers of God===
You can at any time use your powers of god. However, you should have enough mana and respect the cooldown (cooldown).

Some powers require additional action on your part such as creating glyphs or a certain breath.

The list of powers is quite long, it is suggested to read [http://meteora.lo2k.net/Master/pouvoirs the list of powers] for more information of each of them.

===Attacks===
* '''Instant:'''
** Send a volley of meteorites towards your opponent (e.g. Multiple Shot). A formidable weapon, the more you use it, the less its cost and reload time will be.
** You can direct your attacks with your stylus.

* '''Charged:'''
** These attacks will load over time (e.g. Frost Flame). 10 to 15 seconds and your mana size is maximum. Leave no respite and send this kind of monster on your opponent.
** Merge the different types of charged mana together, they will grow even faster. Also remember to bring them back to your planet to grow your mana.

* '''Shrapnel:'''
** The shrapnel attack explodes at the slightest shock with an attack from your opponent. Indispensable to decimate an enemy attack or to create an effective defense.
** Merge there with a charged attack to make it even more effective. If you manage to merge several shrapnel between them ... your attack can become ultimate.

===Defenses===
* '''God's wind:'''
** The Wind of God can repel enemy attacks or send your own attacks more effectively. When you activate it, you have a limited time of use (icons available in the upper right corner of the bottom screen). If you blow on the Nintendo DS while the icon is visible, your breath will be transmitted in the game and it will allow many things to happen.
** Be careful not to hyperventilate. The more you use it, the longer its reload time...

* '''Change of sides:'''
** When you activate this spell, you will need to perform a glyph in a limited time.
** To do this, you have to touch the yellow symbols before they disappear. It is also necessary to make sure that nothing touches a symbol during the invocation of this spell. If you can do it right, whatever is on the screen will be yours. If you perform it during an enemy attack, that attack will be in your possession. You are free to return it to your opponent or to attract it to your planet in order to benefit from a mana bonus.
** If you have a hard time at first, use it in conjunction with god's wind, so that the bottom part of the screen is blank while the glyph is running.

===Power ups===
* '''Mana increase:'''
** You can increase the maximum mana rate and the speed of your mana gain. Don't overlook this kind of power, they can actually play a big part in the game. Be careful though, the more you use them, the more they cost.

==Controls==
Up/Down - Release mana

Stylus - Attract mana

L/R - Use God Powers

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/meteora2.png
https://dlhb.gamebrew.org/dshomebrew/meteora4.png

https://dlhb.gamebrew.org/dshomebrew/meteora3.png
https://dlhb.gamebrew.org/dshomebrew/meteora5.png

==Online Emulator==
{{#tag:html|
<div style='width:520px;height:390px;max-width:100%'><div id='game'></div></div>
<script type='text/javascript'>
{{DS EmulatorJS Settings}}
EJS_core = 'nds';
EJS_gameName = "Meteora Galactic Battle";
EJS_gameUrl = 'https://dlhb.gamebrew.org/onlineemulators/nds/meteora.7z';
</script>
{{EmulatorJS Loader}}
}}
{{DS Control Settings}}

==Credits==
Brunni, Mollusk, Reppa, Benoit Charcosset, Audrey.

Everyone in dev-fr.

==External links==
* Official website - [https://web.archive.org/web/20140615140612/http://meteora.lo2k.net http://meteora.lo2k.net] (archived)
* NeoFlash - [https://web.archive.org/web/20210208003002/https://www.neoflash.com/forum/index.php?topic=4569.0 https://www.neoflash.com/forum/index.php?topic=4569.0] (archived)

[[Category:NEO Summer Coding Compo 2007]]
[[Category:Dev-fr Coding Compo 2007]]

ΜLibrary

2024-08-04T23:21:46Z

SkyLyrac: Add information about port of the library to BlocksDS

{{Infobox DS Homebrews
|title=µLibrary
|image=ulibrary.png
|description=New library to use the 3D GPU to create nice 2D games very easily.
|author=Brunni
|lastupdated=2024/08/05
|type=Game Engine
|version=1.13
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew/ulibrary.7z
|website=http://brunni.dev-fr.org/index.php?page=ndssoft_ulib
|source=https://github.com/AntonioND/ulibrary
}}
µLibrary is a new library for Nintendo DS. Basically, it is meant to use the 3D GPU to create nice 2D games very easily, using a different approach than existing libraries (similar to OSLib). A few examples are supplied, as well as a Doxygen documentation and a small .chm documentation with a FAQ. There are also 2 templates for VHAM, Programmers Notepad or just make, one with PALib and one without it.

The 3D GPU provides additional effects over the 2D GPU, like full transparency with alpha channel (objects can blend amongst them), a larger number of sprites (up to 1536 instead of 128), no zoom or rotation limit (2x with the 2D GPU), a larger limit for the sprite size (2048x2048 instead of 64x64). It is also possible to draw primitives like lines, rectangles, etc. allowing nice effects like in Yoshi's island for example.

µLibrary also provides a low level layer and is open to the hardware. You can also mix 2D and 3D in a single project.

It was participated in the NEO Spring Coding Compo 2007 (NDS App).

In 2024, the library was ported to [https://github.com/blocksds/sdk BlocksDS] by AntonioND to support modern tools.

==Features==
* Supported image formats: PNG, GIF, JPG.
* Special image effects: stretching, tinting (4 corners), mirroring, rotation (with a defined center), selection of an image frame to display (just like on spritesheets).
* 18-bit render quality instead of 15-bit: provides 8 times more colors.
* Virtual file system: possible to load files independantly from the actual support (RAM, libFat, GBFS are supported by default, but you can define your own). Allows to create more easily software that are compatible with all existing linkers.
* Untextured geometry (rectangles, gradients, lines, etc).
* Basic message box system.
* VideoGL wrapper for texture and palette loading in VRAM: Able to load and unload things dynamically and more flexible (you can choose which banks you want to use for what, etc).
* Keypad and touchscreen handler namely with support of stylus speed and double click and support of autorepeated keys (menus for example).
* Includes 2 splash screens.
* Low level wrapper to draw primitives.
* Text system using the same font format as OSLib.

==Installation==
<tabber>
|-|BlocksDS port=

Follow the instructions in [https://github.com/AntonioND/ulibrary the repository].

|-|Neoflash compo ver.=

Enter into the Install folder of your distribution.

There is a batch file, named Install.bat, that will copy files. First edit it and verify that the paths are corrects (ROOTPATH=C:\devkitpro\libnds by default, change it to the path where libnds is located).

Once finished, execute it. After a confirmation, it will copy all files to their respective locations so that you can use it.
</tabber>

==User guide==
Library comes with two templates, located in the Templates folder of its install:
* uLib_without_PALib - This project will begin with µLibrary only.
* uLib_with_PALib - As its name suggests, this project contains everything to get started on a new project using simultaneously µLibrary and PALib.

The render method is similar to a sheet of paper. You first draw a background, then put some mountains, then some trees, some characters and so on: you draw your objects in the order they should appear on the screen (the first is behind, the last one is over the others).

Some examples are provided by the developer:
* [http://www.mobile-dev.ch/ulib/tmp/Example01b.rar Example01b.rar]
* [http://www.mobile-dev.ch/ulib/tmp/Example09.rar Example09.rar]

The doxygen documentation is available [http://www.mobile-dev.ch/ulib/doc/doxygen/index.html here].

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/ulibrary2.png

==Changelog==
'''Version 1.13 05.08.2024'''
* µLibrary has been ported to BlocksDS, allowing programs that use it to be built with modern tools.
* ulBindTextureToGl() has been removed, as it required access to internal state of libnds, which is no longer exposed.
* libpng and zlib are no longer included in the repository, they are taken from the toolchain. The code that loads PNG images with libpng has been updated to work with modern libpng.
* PAlib examples are broken until there is a new version of PAlib that works with BlocksDS.
* The Doxygen documentation has been fixed and updated.

'''Version 1.12 2009/03/17'''
* This release is only to keep working with the newest devkitpro & libnds releases.
* A lot of things have changed and some important things must have been rewritten.
* This was the occasion of creating better makefiles, update samples, changing the logo and do other minor changes.

'''Version 1.11 2008/08/23'''
* devKitPro has not really changed (thankfully), so no mandatory updates were needed.
* Fixes a few bugs, namely the palette issues reported by some people.

'''Version 1.10 2007/12/26'''
* As usual, works with and requires the latest libnds version; that's a shame because nothing will run on emulators from now. You can however solve this problem by replacing your copy of basic.arm7 in your libnds folder by mine (you can find it in the tools folder).
* Added ulMoveScreenView, ulRotateScreenView, ulScaleScreenView and ulResetScreenView to apply special transformations to your screen. You can for example rotate the screen as a whole or only a list of objects without any effort. This will namely allow you to scale and rotate objects like maps and text, which isn't available by default.
* Fonts now work better. Now the font2oft tool is in the 'tools' folder.
* Added ulGetColorRed, ulGetColorGreen, ulGetColorBlue to retrieve the component values of a color.
* Added ulLoadFontFile to directly load a font from a file.
* PNG files with alpha can now be loaded directly as UL_PF_PAL5_A3 and UL_PF_PAL3_A5. The alpha will be taken in account and set in the resulting image. Note that you will have to enable blending as usual with ulSetAlpha and by setting another polygroup, because if all objects are with the same polygroup, none will blend with any other.
* Loading unpaletted PNG files to paletted formats reworked. If there isn't enough colors for the whole image, the nearest is taken. However you should avoid this situation because it's an extremely simple but weak method for reducing the colors of an image.

'''Version 1.00 bêta 4 2007/07/14'''
* Works with, and requires the last libnds version.
* Added ulDeleteMap function.
* Using bank B for textures wasn't working correctly; all my excuses.
* Some JPG files with a vertical size not multiple of 8 or 16 were loaded incorrectly.

==External links==
* Author's website - [https://web.archive.org/web/20080507043108/http://brunni.dev-fr.org/index.php?page=ndssoft_ulib http://brunni.dev-fr.org/index.php?page=ndssoft_ulib] (archived)
* NeoFlash - https://www.neoflash.com/forum/index.php?topic=3954.0

[[Category:NEO Spring Coding Compo 2007]]

Nitro Engine

2023-03-16T10:59:49Z

SkyLyrac:

{{Infobox DS Homebrews
|title=Nitro Engine
|image=nitroengine.png
|description=3D engine which aim to help making 3D game for DS.
|author=AntonioND
|lastupdated=2022/11/10
|type=Game engine
|version=0.8.1
|license=Mixed
|download=https://github.com/AntonioND/nitro-engine
|website=https://github.com/AntonioND/nitro-engine
|source=https://github.com/AntonioND/nitro-engine
}}
Nitro Engine is a 3D engine for DS. The objective of this is to make 3D more easily than using libnds normal funcions. It uses libnds and you can load models and textures from FAT (or EFS, or NitroFS).

Nitro Engine doesn't support any of the 2D hardware of the DS. In order to use the 2D hardware you can use libnds directly, or you can use a library like [https://github.com/knightfox75/nds_nflib NFlib]. There is an example of how to integrate Nitro Engine and NFlib in the same project [https://github.com/AntonioND/nitro-engine/blob/master/examples/templates/using_nflib here].

A setup guide can be found on the [https://github.com/AntonioND/nitro-engine#setup GitHub page].

==Features==
*Support for static models, converted from OBJ files.
*Support for animated models, thanks to the [https://github.com/AntonioND/dsma-library DSMA library], which converts MD5 models (with skeletal animation) into a format that can be rendered with hardware acceleration. It can also blend two animations together (for transitions).
*Support for all format of textures (even compressed textures, but the converter included in this repository doesn't support them yet).
*Dual 3D (render 3D to both screens, but at 30 FPS instead of 60 FPS).
*Functions to render 2D images accelerated by 3D hardware.
*Basic text system.
*Basic GUI elements like buttons and scrollbars.
*Basic physic system: Axis-aligned bounding boxes (AABB) only.

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/nitroengine2.png
https://dlhb.gamebrew.org/dshomebrew/nitroengine3.png

[https://github.com/AntonioND/nitro-engine#screenshots Example screenshots.]

==Compatibility==
Some effects does not work in emulators.

==Changelog==
'''0.8.1 2022/11/10'''
*Add support for compressed textures.
*Add example that combines NFlib and Nitro Engine to have good 2D hardware support.
*Support specular properties in materials.
*Add a few enums to help editor autocompletion features.
*Rename a few functions and deprecate the old names (the old names still work).

'''0.8.0 2022/10/21'''

Models and textures:
*Add support for MD5 animated models (thanks to https://github.com/AntonioND/dsma-library): Introduce tool md5_to_dsma to convert them to a format that Nitro Engine can use.
*Add support for OBJ static models: Introduce tool obj2dl to convert them to a format that Nitro Engine can use.
*Introduce tool img2ds to convert images in many popular formats (PNG, JPG, BMP, etc) to DS textures (PNG is still recommended over other formats, as it supports alpha better than other formats).
*Drop support for MD2 models (static or animated).
*Remove NDS Model Exporter, Nitro Texture Converter, md2_to_bin and md2_to_nea. The animation system has been refactored (but NEA files don't work anymore, so you need to update your code anyway).

General:
*Huge cleanup of code style of the codebase.
*Cleanup of all examples. Add the original assets and textures used in all examples to the repository, along scripts to convert them to the formats used by Nitro Engine.
*Implement a better way to have debug and release builds of the library.

Notes:
*You can still use textures converted with Nitro Texture Converter or NDS Model Exporter, and you can still use any model exported with NDS Model Exporter or md2_to_bin. However, support for NEA files has been removed (it had awful performance, and it was just a bad way to do things), so any file converted by md2_to_nea won't work anymore.
*The reason to replace most tools is that several people had issues building them. All the new tools are written in Python, so they don't need to be compiled.

'''0.7.0 2019/06/14'''
*Major cleanup of code.
*Clarify license.
*Reworked tools to build under Linux and Windows.

'''0.6.1 2011/09/01'''
* Fixed identation in all code. Now it isn't a pain to read it.
* A few warnings fixed (related to libnds new versions).

'''0.6.0 2009/06/30'''
* The functions used to modify textures and palettes now return a pointer to the data so that you can modify them easily.
* Each material can have different propierties (amient, diffuse...). You can set the default ones, the propierties each new material will have, and then you can set each material's propierties individually.
* New texture and palette allocation system, it is faster and better. * Defragmenting functions don't work now, will fix them for the next version.
* Added a debug system. You can compile Nitro Engine in "debug mode" and it will send error messages to the function you want. Once you have finished debugging or whatever, just recompile Nitro Engine without debug mode.
* Window system renamed to Sprite system. You can set a rotation and a scale for each one.
* The most important thing, the animation system has been improved, and now animated models are drawn using linear interpolation (you can disable it, anyway).
* As a result, the converters are modified, so you'll have to convert yout animated models again.

'''0.5.1 2009/01/28'''
* Minor bugfixes.

'''0.5.0 2009/01/05'''
* Text system and camera system optimized. New functions for the camera system.
* NE_TextPrintBox and NE_TextPrintBoxFree slightly changed. They can limit the text drawn to a number of characters set by the coder.
* Some functions made internal. Don't use them unless you know what you are doing.
* Fixed (?) at least the 2D projection.
* HBL effects fixed.
* Touch test functions.
* NE_UPDATE_INPUT removed.
* It now supports any BMP size, and BMP with 4 bits of depth.
* Arrays made pointers, so there is more memory free when you are not using Nitro Engine. You can also configure the number of objects of each systems you are going to use.
* NE_TextPalette replaced by NE_Palette.
* You can clone materials to use the same texture with different colors. This doesn't have the problems of cloning models.
* Added functions to remove all palettes and textures.
* Fixed NE_End().
* NE can free all memory used by it, and the coder can tell NE how much memory to use.
* Texture drawing system improved a bit.
* NE_PolyFormat simplified.
* Some bugfixes, code reorganized, define lists converted into enums.
* Clear bitmap supported, this is used to display an bitmap as rear plane. Each pixel can have different depth. This needs 2 VRAM banks to work.
* Solved some problems with 2D system and culling.
* Nomad NDS_Texture_Converter is no longer included, if you want it, look for it in google.
* Made and added Nitro Texture Converter. Open source, and it exports various levels of alpha in the textures that can handle it. It does only accept PNG files.
* NE now accepts any texture size. NE_SIZE_XXX defines removed as they are not needed now.
* Added a couple of examples.

'''0.4.2 2008/12/14'''
* Fixed 2D system (textures were displaying wrong on 2D quads) and text system (paletted textures sometimes were drawn without palette).
* Compiled MD2_2_NEA, MD2_2_BIN and bin2nea to work in linux. Thanks to nintendork32.
* Added a couple of examples.

'''0.4.1 2008/12/12'''
* LOTS OF BUGFIXES. Specially, UV coordinates swapping fixed.
* Added a function to draw on RGBA textures.
* Fixed MD2_2_NEA and MD2_2_BIN. You'll have to convert again your models.
* Updated to work with latest libnds. There is a define in case you want to use an older version.

'''0.4.0 2008/10/15'''
* Added MD2_2_NEA <converts an MD2 model into a NEA file that can used by Nitro Engine> and MD2_2_BIN <Converts the first frame of an MD2 model into a display list>. Display lists created are really optimized.
* Updated DisplayList_Fixer. Now it can remove normal commands too.
* Added a text system. It can use fonts of any size.
* Added some simple API functions (buttons, check boxes, radio buttons and slide bars).
* Fixed 2D projection.
* Removed some internal unused functions to save space, and made 'inline' some of the rest.
* Functions that used float parameters modified so they use integers now. You can still use some wrappers if you want to use floats. This will let the compiler try to optimize the code.
* Animated and static models are now the same. You can move, rotate, etc them with the same functions.
* Now, you can 'clone' models so you can save a lot of RAM if they are repeated.
* Renamed lots of model functions. Take a look at new examples or documentation.
* NE_Color struct removed (don't even know why it is created).
* Examples updated to work with last version and added examples of clonning models, API and text system.
* libnds' console is not inited with Nitro Engine. You will have to init it yourself with NE_InitConsole or libnds' functions.

'''0.3.0 2008/09/16'''
* Support for animated models (NEA format) and a program to make a new NEA file from many models (in bin format).
* 2D over 3D system. You can draw easily quads (with or without texture) as if they were drawn using 2D.
* Basic physics engine (gravity, friction and collitions). It does only support bounding boxes for now.
* Added a function to delete all models, animated or not.
* Window system, very simple. Will make some API functions in next versions.
* Nitro Engine compiled as a library to include it easier in projects and save space.
* Examples folder organized a bit and added some new examples.
* Nitro Engine is now licensed under the BSD license.

'''0.2.0 2008/08/31'''
* Added effects like fog and shading, functions to load bmp files and convert them in textures and more examples.

'''0.1 2008/08/24'''
* Released first version of Nitro Engine
* Includes 2 examples, documentation, tools to export models from the PC, the license and full source.

==Credits==
* Joat, Dovoto and WinterMute for libnds.
* WinterMute for devkitPro and devkitARM.
* Chishm for libfat and DLDI.
* The guys of gbadev for the help.
* Martin for No$gba and gbatek.
* Kasikiare for NDSModelExporter.
* PadrinatoR for NDS_Mesh_Converter.
* Ti-Ra-Nog for testing the engine.
* Judelco for the big logo.
* Serede for the small logo.

==External links==
* Author's website - http://www.skylyrac.net/old-site/index.html
* GitHub - https://github.com/AntonioND/nitro-engine

[[Category:DS homebrew games]]
[[Category:Homebrew game engines on DS]]

Front SD ELF Loader Wii

2023-03-16T10:57:05Z

SkyLyrac: /* Unofficial versions */

{{#seo:
|title=Wii Homebrew Loaders
(Loader) - GameBrew
|title_mode=append
|image=wii-logo.jpg
|image_alt=Front SD ELF Loader
}}
{{Infobox Wii Homebrews
|title=Front SD ELF Loader
|image=wii-logo.jpg
|description=Loads .elf and .dol files from front SD slot
|author=svpe
|lastupdated=2008/04/02
|type=Loader
|version=0.03b
|license=Mixed
|download=https://dlhb.gamebrew.org/wiihomebrews/frontsdelfloaderwii.7z
|website=
|source=
}}
This is just a small '''Front SD ELF loader''' with a menu, written by Sven Peter, svpe #wiidev@efnet/blitzed, svpe@gmx.net.

There are probably still some bugs so don't blame me if something goes wrong.

== Usage ==
Create an "elf" directory (all letters in lower-case, don't include quotes) on your SD card and put all your ELF files in there.
Load the tp-hack-loader.elf with the twilight hack or the trucha-disc-loader.dol with a trucha signed disc.

If you want to compile it yourself you just need to type 'make' in the root directory. Precompiled elf and dol binaries are included.

The miniloader/ is just a quick hack to make this work with trucha discs because the apploader i used didn't seem to support a non-standard entry point. The real loader with the front SD code is in the loader/ directory.

When using the homebrew channel you might need to use the trucha-disc-loader.dol or build the miniloader/miniloader.elf file yourself.

== Unofficial versions ==

'''MAG Loader'''' by MAG/PiratePila.<br>
Yet another Front SD Elf loader, this one uses the reset button.<br>
Current Version 0.2.

== ChangeLog ==
'''v0.4'''
*Some bugfixes

'''v0.2a'''
*Wiimote shutdown code from this wiki added

'''v0.2'''
*Video mode detection (should work on PAL TVs now)
*Faster ELF loading due to removed debug printfs

== Credits ==
*Internal SD stuff by Bushing, Marcan and maybe some more people. I just reversed the twilight hack elf loader.
*FatFs by [http://elm-chan.org/fsw/ff/00index_e.html elm-chan.org].
*ELF loading code taken from [[Geckoloader Wii]] by Dhewg, #wiidev at efnet. Written by Dhewg, Tmbinc and William L. Pitts
*People from #wiidev who helped me with a few problems ;)

== External links ==
* Wiibrew - https://wiibrew.org/wiki/Front_SD_ELF_Loader
* MAG Loader - https://www.elotrolado.net/hilo_mag-loader_998560