tricksterguy / 3ds-template Goto Github PK

Template Project for Code::Blocks for developing 3ds homebrew

License: MIT License

Makefile 96.75% C++ 3.25%

3ds-template devkitpro nintendo-3ds nintendo-3ds-homebrew codeblocks-ide

3ds-template's Introduction

3ds-template

A starter template for various 3DS homebrew applications. This template is geared specifically towards the Code::Blocks IDE. This template can also be used without Code::Blocks just use the Makefile and directory structure provided.

This is designed to be a simple and fairly minimal setup required to begin developing homebrew for the 3ds system. As such it doesn't include everything needed to build everything out of the box if you want to build 3ds or cia homebrew.

Usage

Targets	Action
3ds	Builds `<project name>.3ds`. ¹
3dsx	Builds `<project name>.3dsx` and `<project name>.smdh`.
cia	Builds `<project name>.cia`. ¹
citra	Builds and automatically runs `citra` for testing.²
elf	Builds `<project name>.elf`.
release	Release build, creates a `cia`, `3ds`, and a zip file containing the `smdh` and `3dsx`. ³

Notes:

¹ This requires having makerom and bannertool in your $PATH
² make citra requires having citra installed and in your $PATH
³ If you are on Windows you will need both of the following in your $PATH zip and libbz2.dll

Setting up devkitPro

Follow the steps installing devkitPro at the gbatemp wiki

If you want to build cia and 3ds then follow these extra steps:

Aquire makerom and bannertool binaries from buildtools, or compile them yourself from makerom and bannertool
Copy the makerom/bannertool to $DEVKITARM/bin or some other directory in your $PATH

Code::Blocks Setup

Simply open 3ds.cbp in Code::Blocks
Choose File > Save as user-template and enter a template name. The project setup is now a user template to create new projects.
When creating a new project select File > New > From template and follow the wizard's instructions.
Ensure you have the environment variables plugin installed (in linux you can install this by installing the codeblocks-contrib package)
Choose Settings > Environment and scroll down to the Environment Variables section.
Add DEVKITPRO and point it to where devkitpro is installed
Add DEVKITARM and point it to where devkitarm is.

To compile in Code::Blocks simply select your target from the list and click the Gear icon to automatically invoke the Makefile

Note Make sure you are using MSYS2's make (make.exe) and not MINGW's make (mingw32-make.exe)

Creating a new project

Make a new Code::Blocks project via a user-template you just created above. Or simply copy this directory.
(Only needed for cia/3ds builds) Edit the file resources/AppInfo
1. Edit those values and ensure you choose a unique id see unique_id_list.
2. Replace the existing files in the resources directory to suit your needs.

Note please ensure that no folder/directory used in the project contains spaces. Devkitpro's Makefiles apparently does not like this. That is, do not have it in a folder like C:/3DS Hacking/3ds-template rather C:/3DS_Hacking/3ds-template

Credits

All of this would not have been possible without the work of

Smealum
Steveice10 for the buildtools
amaredeus for various improvements to the template (such as the formatting in this README)

3ds-template's People

Contributors

Stargazers

Watchers

Forkers

slinkypotato bennyman123abc homeginga rocci1212 cocoamilka

3ds-template's Issues

I keep getting Makefile error 2 when I keep trying to build files on Code: Blocks

Hi, I'm really new to Homebrew development.I think I followed the steps to set it up but I feel like I arranged the files wrong or something. Every time I click on "Build" on Code: Blocks, it would give the error "error 2". It doesn't matter if I choose which file I want to build(ex. cia, 3dsx, etc.) Again, I'm not really sure I did the steps correctly as I don't know how to fix this issue. The file explorer image shows my project folder and how it's organized and the makefile one shows the issue itself. I haven't edited anything yet but wanted to build it to test it out. Can you please tell me what I did wrong to fix this issue? If you need more information, please let me know so I can give it to you.

Cleaning the project then running the citra target doesn't work

The makefile tries to immediately build the .elf file without first creating the build directory and actually compiling the files.

Workaround: Switch to the 3dsx target compile then switch back to citra and run it.

Error 2 while compiling to Citra

Hello,
Ive been trying to compile the "basic" main.cpp file, but i keep getting this error :

Checking if target is up-to-date: mingw32-make.exe -q -f Makefile citra
Running command: mingw32-make.exe -f Makefile citra
process_begin: CreateProcess(NULL, arm-none-eabi-g++ -MMD -MP -MF C:/Users/ajini/Desktop/moh/3DS/My3DSApp1/build/main.d -Wall -O2 -mword-relocations -fomit-frame-pointer -ffunction-sections -march=armv6k -mtune=mpcore -mfloat-abi=hard -mtp=soft -IC:/Users/ajini/Desktop/moh/3DS/My3DSApp1/include -IC:\devkitPro/portlibs/3ds/include -IC:\devkitPro/libctru/include -IC:/Users/ajini/Desktop/moh/3DS/My3DSApp1/build -DARM11 -D_3DS -fno-rtti -fno-exceptions -std=gnu++11 -c C:/Users/ajini/Desktop/moh/3DS/My3DSApp1/source/main.cpp -o main.o, ...) failed.
make (e=2): The specified file hasn't been found.
mingw32-make.exe[1]: *** [C:\devkitPro\devkitARM/base_rules:80: main.o] Error 2
mingw32-make.exe: *** [Makefile:173: citra] Error 2
main.cpp
Process terminated with status 2 (0 minute(s), 3 second(s))
2 error(s), 0 warning(s) (0 minute(s), 3 second(s))

I have no idea what this means :/
It also opens base_rules file on code::blocks but there is nothing in it

I tried compiling with cmd and opening citra manually and it worked ??????
Could someone please help ? (i really dont want to have to compile with cmd and open manually citra to test the file 💀)

Thank you in advance

Does this still working , and it's recomendable to use?

Hey, I justwas able to found this template for 3ds development on code blocks, but does this still work? Or should i keep using the devkitpro Makefile?

"C:\devkitPro\devkitARM\base_rules: recipe for target 'main.o' failed"

When the "Build" button is pressed, the following error appears in the console:

"
||=== Build: 3dsx in 3ds (compiler: GNU GCC Compiler) ===|
C:\devkitPro\devkitARM\base_rules|32|recipe for target 'main.o' failed|
Makefile|161|recipe for target '3dsx' failed|
||=== Build failed: 2 error(s), 0 warning(s) (0 minute(s), 2 second(s)) ===|
"

Readd support for targets to easily push to 3ds via hblauncher and FBI

Makefile|91|recipe for target 'all' failed|

hi, i have this problem, Makefile|91|recipe for target 'all' failed| can you help me?