Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

CTRPluginFramework 3DS: Difference between revisions

From GameBrew
m (Text replacement - "Category:3DS homebrew rom hacks" to "")
 
(65 intermediate revisions by the same user not shown)
Line 3: Line 3:
|image=Ctrpluginframework2.png
|image=Ctrpluginframework2.png
|description=A blank CTRPF plugin for Luma3DS (with Action Replay).
|description=A blank CTRPF plugin for Luma3DS (with Action Replay).
|author=Nanquitas
|author=Nanquitas, PabloMK7
|lastupdated=2018/06/23
|lastupdated=2022/10/26
|type=Hack Utilities
|type=Plugins
|version=2018
|version=0.7.4
|license=Mixed
|license=Mixed
|download=https://dlhb.gamebrew.org/3dshomebrews/ctrpluginframework.7z
|downloadraw=[https://dlhb.gamebrew.org/3dshomebrews/ctrpluginframework.7z 0.5.1] - [https://github.com/PabloMK7/CTRPluginFramework-BlankTemplate/releases Latest Download]
|website=https://gbatemp.net/threads/ctrpluginframework-blank-plugin-now-with-action-replay.487729
|website=https://gbatemp.net/threads/ctrpluginframework-blank-plugin-now-with-action-replay.487729
|source=https://github.com/Nanquitas/CTRPluginFramework-BlankTemplate
|source=https://github.com/PabloMK7/CTRPluginFramework-BlankTemplate/releases
}}
}}
This is blank CTRPF plugin to be used by [[Luma3DS]] with plugin loader. It gives you a blank plugin so you can use the tools (search, guide and others) without being annoyed by builtin cheats.  
This is blank CTRPF plugin to be used with [[Luma3DS 3GX Loader Edition 3DS|Luma3DS plugin loader]]. It gives you a blank plugin so you can use the tools (search, guide and others) without being annoyed by builtin cheats.  


You can use 2 plugins (or more, but only 1 ctrpf plugin) at the same time, and so you can use this blank plugin with another plugin which will have your cheats. You can also change the hotkey in Tools/Settings to avoid any overlapping.
You can use 2 plugins (or more, but only 1 CTRPF plugin) at the same time, and so you can use this blank plugin with another plugin which will have your cheats. You can also change the hotkey in Tools/Settings to avoid any overlapping.


==Installation==
==Installation==
Download contains the following:
The .7z contains version 0.5.1 (from the original release thread):
* CTRPluginFramework.3gx - CTRPF plugin.
* CTRPluginFramework.3gx - Plugin v0.5.1 (please use [https://github.com/PabloMK7/CTRPluginFramework-BlankTemplate/releases the latest version]).
* CTRPluginFramework-UserGuide.pdf/docx - Official user guides in [https://www.docdroid.net/Sp0K2Xe/ctrpluginframework-userguide-pdf .pdf] and [https://drive.google.com/file/d/0B-JJmt53_KWgd0FtWFF6RWhjcXM/view?usp=sharing .docx].
* UserGuide.pdf/docx - CTRPF Manual ([https://www.docdroid.net/Sp0K2Xe/ctrpluginframework-userguide-pdf online version]).
* ActionReplay.7z - ActionReplay plugin (in .plg).
* ActionReplay.7z - ActionReplay.plg.
* ActionReplayCodeTypes.txt - ActionReplay supported code types (from [https://gist.github.com/Nanquitas/d6c920a59c757cf7917c2bffa76de860 here]).
* ActionReplayCodeTypes.txt - ActionReplay supported code types/template (from [https://gist.github.com/Nanquitas/d6c920a59c757cf7917c2bffa76de860 here]).
* Fort42_GateShark_22-12-2017.zip - Archive of all GateShark cheat codes ([https://filetrip.net/dl?bFxBtXHND0 Fort42 cheats code]).
* Fort42_GateShark_22-12-2017.zip - Archive of all GateShark cheat codes (from [https://filetrip.net/dl?bFxBtXHND0 Fort42 Cheat Codes]).
* Luma3DS Mod.zip - Edited version of Luma3DS with Plugin Loader merged into it ([https://gitlab.com/Nanquitas/Luma3DS-PluginLoader source]).
* Luma3DS Mod.zip - Edited version of Luma3DS for CTRPF (please use [[Luma3DS]]).


==User guide==
Quick install guide for the [https://github.com/PabloMK7/CTRPluginFramework-BlankTemplate/releases latest version]:
===Action Replay===
* Make sure you are using [[Luma3DS]].
CTRPF now have it's own Action Replay system:
* Rename BlankTemplate.3gx to default.3gx to use by itself, or with [[CTRPluginFramework_3DS#Action_Replay.2FGateshark_cheats|SharkGate/AR cheats codes]].
* It can now load your cheats from a text file (no longer require any converter or compilation).
* sd:/luma/plugins/default.3gx - Location for default.3gx (would be loaded for all games).
* It support Folder and note managing and also have it's own editor (able to edit/create/delete the codes at runtime).
* sd:/cheats/<tid>.txt - Location for SharkGate/AR cheats codes, can be loaded with the blank plugin (replace <tid> by the title id of the game).
* CTRPF supports all Gateshark code types and even some custom code types ([https://gist.github.com/Nanquitas/d6c920a59c757cf7917c2bffa76de860 List of all supported codetype]).


The cheats files can be at 2 locations:
Notes on Luma3DS (N3DS/O3DS):
* cheats.txt in the same folder of the plugin.
* The plugin loader is automatically enabled on Old3DS because Mode3 games needs it.  
* sd:/cheats/<tid>.txt - Replace <tid> by the title id of the game.
* So on N3DS, you have to enable the plugin loader from Rosalina (L+Down+Select), and you can disable it too.  
* To use, unzip ActionReplay.7z and put it on your SD card (see the Luma3DS section below to use the ame plugin for all games).
* You can't disable it for Mode3 games though (O3DS only).


===Gateshark cheats===
==User guide==
Gateshark cheats should be supported at 100% by the Action Replay:
===Action Replay/Gateshark cheats===
* Just unzip and copy the cheats folder at the root of your SD card.
CTRPF now have it's own Action Replay system and can load your cheats from a text file, it supports:
* Note that no all cheats work.
* All Gateshark code types and some custom code types ([https://gist.github.com/Nanquitas/d6c920a59c757cf7917c2bffa76de860 list of all supported codetype]).
* If a cheat is not working, it just means that the cheat is wrong: no support will be done for cheats not working.  
* Folder, note managing and also have it's own editor (able to edit/create/delete the codes at runtime).  
* Simply place the cheat files at sd:/cheats/<tid>.txt. Replace <tid> by the title id of the game.


You can also find codes here:
It should work with the Fort42 GateShark cheat archive in the download. Note that some cheats might not work, and it just means the cheat is wrong. You can also find codes here:
* [https://gbatemp.net/threads/gateway-cheats.402900 Gateway cheats thread] (since all codes are supported).
* [https://gbatemp.net/threads/gateway-cheats.402900 Gateway cheats thread] (since all codes are supported).
* [https://gbatemp.net/threads/database-ctrpf-ar-cheat-codes.493220 Database thread] started by Vermil.
* [https://gbatemp.net/threads/database-ctrpf-ar-cheat-codes.493220 Database thread] started by Vermil.
* [https://github.com/JourneyOver/CTRPF-AR-CHEAT-CODES Github repo] by HollowedFear.
* [https://github.com/iSharingan/CTRPF-AR-CHEAT-CODES Database] by iSharingan ([https://github.com/JourneyOver/CTRPF-AR-CHEAT-CODES old repo] by HollowedFear).
 
===Notes on plugin types===
3GX plugins can be placed in 2 locations:
* sd:/luma/plugins/<TITLEID>/<filename>.3gx - This sets a plugin for a specified title (higher priority).
* sd:/luma/plugins/default.3gx - This set a plugin which would be loaded for all games (lower priority).
 
PLG plugins require [[BootNTR Selector 3DS|BootNTR Selector]] to use:
*sd:/plugin/<TITLEID>/cheat.plg - Location for .plg file.
*Turn on your 3DS and make sure NTR CFW is running, you can check by pressing X+Y and if it is running a menu will pop up on the bottom screen.
*If it is not running, open Boot NTR Selector, select 3.6 and wait for the blue flash.


===Other projects using CTRPF===
===Projects using CTRPF===
* [https://gbatemp.net/threads/release-animal-crossing-new-leaf-multi-cheat-ntr-plugin.428522 Animal Crossing - New Leaf Multi Cheats plugin] - A plugin with various cheats and fun mods by RyDog.
* [[ACNL-NTR-Cheats 3DS|Animal Crossing - New Leaf Multi Cheats plugin]] - A plugin with various cheats and fun mods by RyDog.
* [[Mario Kart 7 - Custom Track Grand Prix 7 3DS|CTGP7]] - An MK7 mods with a lot of custom track and other things by PabloMK7.
* [[Mario Kart 7 - Custom Track Grand Prix 7 3DS|CTGP7]] - An MK7 mods with a lot of custom track and other things by PabloMK7.
* [https://gbatemp.net/threads/release-ntr-plugin-fantasy-life.456458 Fantasy Life Cheat plugin] - A plugin with various cheats for the game Fantasy Life.
* [https://gbatemp.net/threads/release-ntr-plugin-fantasy-life.456458 Fantasy Life Cheat plugin] - A plugin with various cheats for the game Fantasy Life.
Line 55: Line 65:
* [https://gbatemp.net/threads/release-new-pokemon-xy-oras-ntr-cheat-plugin.477974 Pokemon XY & ORAS Cheat plugin] - A plugin with various cheats for the Pokemons games by Mega-Mew.
* [https://gbatemp.net/threads/release-new-pokemon-xy-oras-ntr-cheat-plugin.477974 Pokemon XY & ORAS Cheat plugin] - A plugin with various cheats for the Pokemons games by Mega-Mew.
* [https://gbatemp.net/threads/release-ultrasumoframework-ntr-plugin-for-ultra-sumo.489098 UltraSuMoFramework - NTR Plugin for Ultra SuMo] - A plugin with various cheats for Pokemon USUMO by AnalogMan.
* [https://gbatemp.net/threads/release-ultrasumoframework-ntr-plugin-for-ultra-sumo.489098 UltraSuMoFramework - NTR Plugin for Ultra SuMo] - A plugin with various cheats for Pokemon USUMO by AnalogMan.
* [https://gbatemp.net/threads/zelda-oot-cheats-plugin.422574 Zelda Ocarina Of Time 3D Cheat plugin] - A plugin with various cheats for Zelda OOT.
* [[Zelda_Ocarina_Of_Time_3D_Plugin_3DS|Zelda Ocarina Of Time 3D Cheat plugin]] - A plugin with various cheats for Zelda OOT.
 
===Luma3DS with Plugin Loader===
An edited version of plugin loader is also provided (from NTR into Luma3DS):
* The goal was to be able to launch plugins from Luma3DS without the need to use BootNTR Selector.
* So, this is possible, but know that only CTRPF plugins can be loaded from this plugin loader.
* Unzip boot.7z then put it on your SD card (rename any existing boot.firm to boot.firm.bak in case you want to go back).
 
The plugins can be set at 2 places:
* sd:/luma/plugins/<tid>/plugin.plg - Name of the plugin must be plugin.plg and you have to replace <tid> by the title id of your game.
* If a plugin isn't found in the tid folder, Luma3DS will search for ActionReplay.plg in sd:/luma/plugins/ActionReplay/ActionReplay.plg.
 
For N3DS/O3DS:
* The plugin loader is automatically enabled on Old3DS because Mode3 games needs it.
* So on N3DS, you have to enable the plugin loader from Rosalina (L+D-Pad Down+Select), and you can disable it too.
* You can't disable it for Mode3 games though (O3DS only).


'''Note:''' See [https://gbatemp.net/threads/ctrpluginframework-in-combination-with-luma3ds.582335 here] for more info.
===Useful links===
* [https://3ds.eiphax.tech/ntrplugins NTR Plugin Guide].
* [https://3ds.eiphax.tech/lumaplugins Luma3ds Plugin Loader Guide].


==Screenshots==
==Screenshots==
Line 118: Line 115:


==External links==
==External links==
* GitHub - https://github.com/Nanquitas/CTRPluginFramework-BlankTemplate
* GHitLab - https://gitlab.com/thepixellizeross/ctrpluginframework
* GitHub (Nanquitas) - https://github.com/Nanquitas/CTRPluginFramework-BlankTemplate
* GitHub (PabloMK7) - https://github.com/PabloMK7/CTRPluginFramework-BlankTemplate
* GBAtemp - https://gbatemp.net/threads/ctrpluginframework-blank-plugin-now-with-action-replay.487729
* GBAtemp - https://gbatemp.net/threads/ctrpluginframework-blank-plugin-now-with-action-replay.487729
 
* Discord - https://discord.gg/z4ZMh27
[[Category:3DS homebrew applications]]
[[Category:Homebrew hack utility for 3DS games]]

Latest revision as of 06:16, 6 Mayıs 2024

CTRPluginFramework
Ctrpluginframework2.png
General
AuthorNanquitas, PabloMK7
TypePlugins
Version0.7.4
LicenseMixed
Last Updated2022/10/26
Links
0.5.1 - Latest Download
Website
Source

This is blank CTRPF plugin to be used with Luma3DS plugin loader. It gives you a blank plugin so you can use the tools (search, guide and others) without being annoyed by builtin cheats.

You can use 2 plugins (or more, but only 1 CTRPF plugin) at the same time, and so you can use this blank plugin with another plugin which will have your cheats. You can also change the hotkey in Tools/Settings to avoid any overlapping.

Installation

The .7z contains version 0.5.1 (from the original release thread):

  • CTRPluginFramework.3gx - Plugin v0.5.1 (please use the latest version).
  • UserGuide.pdf/docx - CTRPF Manual (online version).
  • ActionReplay.7z - ActionReplay.plg.
  • ActionReplayCodeTypes.txt - ActionReplay supported code types/template (from here).
  • Fort42_GateShark_22-12-2017.zip - Archive of all GateShark cheat codes (from Fort42 Cheat Codes).
  • Luma3DS Mod.zip - Edited version of Luma3DS for CTRPF (please use Luma3DS).

Quick install guide for the latest version:

  • Make sure you are using Luma3DS.
  • Rename BlankTemplate.3gx to default.3gx to use by itself, or with SharkGate/AR cheats codes.
  • sd:/luma/plugins/default.3gx - Location for default.3gx (would be loaded for all games).
  • sd:/cheats/<tid>.txt - Location for SharkGate/AR cheats codes, can be loaded with the blank plugin (replace <tid> by the title id of the game).

Notes on Luma3DS (N3DS/O3DS):

  • The plugin loader is automatically enabled on Old3DS because Mode3 games needs it.
  • So on N3DS, you have to enable the plugin loader from Rosalina (L+Down+Select), and you can disable it too.
  • You can't disable it for Mode3 games though (O3DS only).

User guide

Action Replay/Gateshark cheats

CTRPF now have it's own Action Replay system and can load your cheats from a text file, it supports:

  • All Gateshark code types and some custom code types (list of all supported codetype).
  • Folder, note managing and also have it's own editor (able to edit/create/delete the codes at runtime).
  • Simply place the cheat files at sd:/cheats/<tid>.txt. Replace <tid> by the title id of the game.

It should work with the Fort42 GateShark cheat archive in the download. Note that some cheats might not work, and it just means the cheat is wrong. You can also find codes here:

Notes on plugin types

3GX plugins can be placed in 2 locations:

  • sd:/luma/plugins/<TITLEID>/<filename>.3gx - This sets a plugin for a specified title (higher priority).
  • sd:/luma/plugins/default.3gx - This set a plugin which would be loaded for all games (lower priority).

PLG plugins require BootNTR Selector to use:

  • sd:/plugin/<TITLEID>/cheat.plg - Location for .plg file.
  • Turn on your 3DS and make sure NTR CFW is running, you can check by pressing X+Y and if it is running a menu will pop up on the bottom screen.
  • If it is not running, open Boot NTR Selector, select 3.6 and wait for the blue flash.

Projects using CTRPF

Useful links

Screenshots

ctrpluginframework3.png ctrpluginframework4.png

ctrpluginframework11.png ctrpluginframework6.png

ctrpluginframework12.png ctrpluginframework13.png

ctrpluginframework9.png ctrpluginframework10.png

Media

[CTRPF] Action Replay - Code Creator (Nanquitas Videos)

[CTRPF] - Action Replay - File picker (Nanquitas Videos)

Known issues

On N3DS, if the game uses the N3DS's HID (cstick, zl & zr), it won't work. Easy fix:

  • Open Rosalina.
  • Go in the Miscellaneous options menu.
  • Start the Input Redirection.
  • That's it, go back to your game, it should work now.

Credits

A huge thanks to:

  • AnalogMan - Alpha tester.
  • cell9 - NTR CFW and some ideas/code.
  • Anto726 - Alpha tester.
  • Mega-Mew - Alpha tester.
  • ObsidianX - Learnt how to untile the sysfont from one of his python tool.
  • PabloMK7 - Alpha tester.
  • Project CPP3DS - First c++ project, and reading the sources of CPP3DS gave me a starting point on how to structure my code.
  • RyDog - Alpha tester.
  • Slattz - Alpha tester.
  • Sc0tline - Action Replay tester.
  • Vermil - Action Replay tester.
  • Stackoverflow - A lot of code debugging/improvments took from random post here.
  • Ctrulib and it's contibuter - For all the work done.

External links

Advertising: