Luigi's Mansion 2 Modding Wiki - User contributions [en]

Texture Metadata File

2024-06-19T09:50:45Z

Feldright: Corrected the offset of the compression format and added details to it.

A '''Texture Metadata File''' is a file that can be extracted from a .data file, and contains information on textures that are stored in the [[Mixed Data File|Mixed Data File.]]

== Layout ==
A texture metadata file consists of texture metadata sections, with the number of them corresponding with the amount of textures stored in the [[Mixed Data File|Mixed Data File.]]

=== Texture Metadata Section ===
{| class="wikitable"
!Offset
!Byte Size
!Name
!Description
|-
|0x0-0x3
|4
|Identifier
|Magic address that identifies a texture metadata section. It's hex value is 0xE977D350.
|-
|0x4-0x7
|4
|Hash ID
|ID that identifies the texture.
|-
|0x8-0xb
|4
|Texture Size
|Size of the texture data in bytes.
|-
|0xc-0xf
|4
|Hash ID
|Same as the Hash ID before.
|-
|0x10-0x13
|4
|Padding
|
|-
|0x14-0x17
|4
|Unknown
|
|-
|0x18-0x19
|2
|Width
|Width of the image in pixels.
|-
|0x1a-0x1b
|2
|Height
|Height of the image in pixels.
|-
|0x1c-0x1e
|2
|Unknown
|
|-
|0x1f
|1
|Mipmap Level
|Mipmap Level of the texure.
|-
|0x20-0x33
|20
|Unknown
|
|-
|0x34
|1
|Compression Format
|The compression format of the texture, either ETC1 (0xC0) or ETC1A4 (0xD0).
|-
|0x35-0x37
|2
|Unknown
|
|}

Ghidra

2024-06-08T18:05:41Z

Feldright: disassemble -> Disassemble

In this guide, you will learn how to use ''Ghidra'' for viewing and editing '''Luigi's Mansion 2'''<nowiki/>'s code for rebuilding.

=== File — exefs.elf ===
''[Under construction.]''

=== Opening Files in Ghidra ===
First, you need to download [https://github.com/NationalSecurityAgency/ghidra ''Ghidra'']. Once downloaded, run the ''ghidra_run.bat'' file and choose "New Project".

[[File:ScreenGhidra0.png|frameless|337x337px]]

Choose a non-shared project and whatever name you want, when the project is created, drag and drop the ''exefs.elf'' into Ghidra and choose the settings below.

[[File:ScreenGhidra1.png|frameless]]

Double-click ''exefs.elf'' and Ghidra will proceed to open a new window, and propose to analyze the file. Click "Yes".

[[File:ScreenGhidra2.png|frameless]]

Then press Ctrl+A in the code editor window, right-click, and choose "Disassemble - ARM". Right-click a second time and choose "Disassemble - THUMB". These processes will take about 10 minutes.

When complete, feel free to edit the code however you like!

=== Rebuild code.bin ===

To use the file in-game, you must rebuild it. To initiate this process, press O in the code editor window and choose the settings below.

[[File:ScreenGhidra3.png|frameless]]

Ghidra

2024-06-08T15:28:40Z

Feldright: changed "dark moon" to "2" and corrected minor typos

In this guide you will see how to use ghidra to view and edit luigi mansion 2 code and then rebuild it.

== Exefs.elf file ==
''In construction''

== Opening the file in ghidra ==
First you need to download ghidra on this page https://github.com/NationalSecurityAgency/ghidra when its download run the file "ghidra_run.bat" then click on file and choose "New project" like on this screenshot:
[[File:ScreenGhidra0.png|center|thumb|337x337px]]
Choose non shared project and whatever name you want, when the project is created slide the exefs.elf in ghidra and choose those settings:
[[File:ScreenGhidra1.png|thumb|center]]
Double click on the exefs.elf and ghidra will open a new window and propose to analyse the file, click yes and then analyse:
[[File:ScreenGhidra2.png|thumb|center]]Then press ctrl+a on the code, right click and choose dissasemble - ARM, right click another time and choose dissasemble - THUMB, these processes will take something like 10 minutes so wait.

When all of this is done modify code and enjoy!

== Rebuild code.bin ==
In order to use the file ingame you have to rebuild it to do this press O in the code editor and choose these settings.[[File:ScreenGhidra3.png|thumb|center]]

Mod Vault

2024-06-07T17:56:05Z

Feldright: /* Luigi's Mansion 2 (3DS) */ added a precision about the mod type

This page contains every mod made for '''Luigi's Mansion 2''' for the ''Nintendo 3DS'' and eventually '''Luigi's Mansion 2 HD''' for the ''Nintendo Switch''.

== Luigi's Mansion 2 ''(3DS)'' ==
{| class="wikitable"
|+Model/Texture Replacement
!Title
!Description
!Type
!Region
!File Size
!Creator
!Download
|-
|[[File:Mario's_Mansion_Dark_Moon_(With_Drop_Shadow).png|alt=The logo for the (currently) texture replacement mod, Mario's Mansion: Dark Moon.|center|frameless|212x212px|Mario's Mansion: Dark Moon]]Mario's Mansion: Dark Moon
|This mod consists of a texture replacement for Luigi to give him the appearance of Mario and a logo replacement that says "Mario's Mansion".
|Citra Texture Replacement
|''TBA''
|''TBA''
|'''mbf'''
|[https://gamebanana.com/mods/495362 '''GameBanana''']
|-
|''N/A''
|''N/A''
|''N/A''
|''N/A''
|''N/A''
|'''''N/A'''''
|'''''N/A'''''
|}
{| class="wikitable"
|+''N/A''
!Title
!Description
!N/A
!File Size
!Creator
!Download
|-
|''N/A''
|''N/A''
|''N/A''
|''N/A''
|'''''N/A'''''
|'''''N/A'''''
|}

== Luigi's Mansion 2 HD ''(Switch)'' ==
{| class="wikitable"
|+''N/A''
!Title
!Description
!Type
!Region*
!File Size
!Creator
!Download
|-
|''N/A''
|''N/A''
|''N/A''
|''N/A''
|''N/A''
|'''''N/A'''''
|'''''N/A'''''
|}

=== [Page under construction.] ===

Code.bin

2024-06-07T17:50:19Z

Feldright: added page

Code.bin is the file who contains luigi mansion dark moon compiled code for the 3ds in order to edit it or view comprehensible code you need an reverse engineering software like [[Ghidra|Ghidra.]]

Ghidra

2024-06-07T17:46:20Z

Feldright: small adjustements abouts screenshots and page organisation

In this guide you will see how to use ghidra to view and edit luigi mansion dark moon code and then rebuild it.

== Exefs.elf file ==
''In construction''

== Opening the file in ghidra ==
First you need to download ghidra on this page https://github.com/NationalSecurityAgency/ghidra when its download run the file "ghidra_run.bat" then click on file and choose "New project" like on this screenshot:
[[File:ScreenGhidra0.png|center|thumb|337x337px]]
Choose non shared project and whatever name you want, when the project is created slide the exefs.elf in ghidra and choose those settings:
[[File:ScreenGhidra1.png|thumb|center]]
Double click on the exefs.elf and ghidra will open a new window and propose to analyse the file, click yes and then analyse:
[[File:ScreenGhidra2.png|thumb|center]]Then press ctrl+a on the code, right click and choose dissasemble - ARM right click another and dissasemble - THUMB, these process will take something like 10 minutes so wait.

When all of this is done modify code and enjoy!

== Rebuild code.bin ==
In order to use the file ingame you have to rebuild it to do this press O in the code editor and choose those settings.[[File:ScreenGhidra3.png|thumb|center]]

Ghidra

2024-06-06T19:30:24Z

Feldright: corrected an mistake with subheaders

In this guide you will see how to use ghidra to view and edit luigi mansion dark moon code and then rebuild it.

== Exefs.elf file ==
''In construction''

== Opening the file in ghidra ==
First you need to download ghidra on this page https://github.com/NationalSecurityAgency/ghidra when its download run the file "ghidra_run.bat" then click on file and choose "New project" like on this screenshot:

[[File:ScreenGhidra1.png|thumb]]

, choose non shared project and whatever name you want, when the project is created slide the exefs.elf in ghidra and choose those settings:

[[File:ScreenGhidra2.png|thumb]]
Double click on the exefs.elf and ghiadra will open a new window and purpose to analyse the file say:

Then press ctrl+a on the code, right click and choose dissasemble - ARM right click another and dissasemble - THUMB, these process will take something like 10 minutes so wait.

When all of this is done modify code and enjoy!

== Rebuild code.bin ==
[[File:ScreenGhidra3.png|thumb]]
In order to use the file ingame you have to rebuild it to do this press O in the code editor and choose those settings.

Ghidra

2024-06-06T19:27:38Z

Feldright: Added ghidra guide(unfinished)

In this guide you will see how to use ghidra to view and edit luigi mansion dark moon code and then rebuild it.

=== Exefs.elf file ===
''In construction''

=== Opening the file in ghidra ===
First you need to download ghidra on this page https://github.com/NationalSecurityAgency/ghidra when its download run the file "ghidra_run.bat" then click on file and choose "New project" like on this screenshot :

[[File:ScreenGhidra1.png|thumb]]

, choose non shared project and whatever name you want, when the project is created slide the exefs.elf in ghidra and choose those settings :

[[File:ScreenGhidra2.png|thumb]]
Double click on the exefs.elf and ghiadra will open a new window and purpose to analyse the file say :

Then press ctrl+a on the code, right click and choose dissasemble - ARM right click another and dissasemble - THUMB, these process will take something like 10 minutes so wait.

When all of this is done modify code and enjoy!

== Rebuild code.bin ==
[[File:ScreenGhidra3.png|thumb]]
In order to use the file ingame you have to rebuild it to do this press O in the code editor and choose those settings.

File:ScreenGhidra3.png

2024-06-06T19:26:54Z

Feldright:

Rebuild a code.bin file

File:ScreenGhidra2.png

2024-06-06T19:21:04Z

Feldright:

Analyse file

File:ScreenGhidra1.png

2024-06-06T19:16:52Z

Feldright:

Settings to choose to import exefs.elf

File:ScreenGhidra0.png

2024-06-06T19:13:14Z

Feldright:

Create a project

Tools

2024-06-06T19:05:13Z

Feldright: added ghidra github

== File Editing ==
These are current tools, through which the contents of a [[DATA|.data]] file can be extracted with a [[DICT|.dict]] file.

=== [[File:Switch Toolbox Reborn.png|frameless|42x42px]] Toolbox.Reborn '''''(Recommended)''''' ===
'''Toolbox.Reborn''' was created by ''KillzXGaming'' and is the most advanced tool for working with [[DICT|.dict]] and [[DATA|.data]] files. It can extract textures, models, as well as general data chunks.

GitHub repository: https://github.com/KillzXGaming/Toolbox.Reborn

=== NLG-File-Editor-Tool ''(In-development)'' ===
'''NGL-File-Editor-Tool''' was created by ''KillzXGaming'' and is a simple tool to extract/edit files from [[DICT|.dict]]/[[DATA|data]].

GitHub repository: https://github.com/KillzXGaming/NLG-File-Editor-Tool

=== [[File:CTR Studio Icon.png|frameless|42x42px]] CTR Studio ===
'''CTR Studio''' was developed by the ''Map Studio Project'', with the primary contributor, again, being ''KillzXGaming'', and is a culmination of previous tools developed for modding applications, like [https://github.com/KillzXGaming/Toolbox.Core ''Toolbox.Core''] and, most importantly for Luigi's Mansion 2 modding, the [https://github.com/KillzXGaming/NextLevelLibrary/ ''NextLevelLibrary'']. The tool allows you to edit files and visualize 3D objects. It is still very much a W.i.P.

GitHub repository: [https://github.com/MapStudioProject/CTR-Studio/releases https://github.com/MapStudioProject/CTR-Studio]

=== LM2L ===
'''LM2L''' was created by ''hadashisora'' and is presumably the first-ever tool that was able to extract data from ''Next Level Games''<nowiki/>' [[DICT|.dict]] and [[DATA|.data]] file formats. The tool can extract files from a [[DATA|.data]] file, as well as the textures contained in it.

GitHub repository: https://github.com/hadashisora/LM2L

=== [[File:D.E.a.R. Icon.png|frameless|42x42px]] Data Extractor and Repacker ''(In-development)'' ===
'''Data Extractor and Repacker (or D.E.a.R.)''' was created by ''Schweini07'' as a research project to understand the structures of [[DICT|.dict]] and [[DATA|.data]] files. It can currently extract files from a [[DATA|.data]] file but is planned to be comparable to the ability of ''CTR Studio''.

GitHub repository: https://github.com/Schweini07/DEAR

=== '''LM2_SaveEditor''' ===
'''LM2_SaveEditor''' was created by ''TollyH'' and is a save editor for the 3DS version of ''Luigi's Mansion 2,'' in order to use this tool you need to provide a .sav file from the game.

GitHub repository: https://github.com/TollyH/LM2_SaveEditor

== Graphic Designing ==
These tools are one of the best when it comes to graphic design. From vector to raster, here are the tools you need to make visual edits in your '''Luigi's Mansion 2''' mods.

=== [[File:Inkscape.png|frameless|42x42px]] Inkscape ===
'''Inkscape''' is an open-source vector graphics editor. Vector graphics are a form of computer graphics that are made from geometric shapes with points, lines, curves, and polygons. Before rasterization, you can zoom in as far as you want, but you will not find a single pixel. They technically have an infinite resolution.

Download page: https://inkscape.org/release/inkscape-1.3.2

=== [[File:Paint.net.png|frameless|42x42px]] paint.net ===
'''paint.net''' is a raster graphics editor. Raster graphics are a form of computer graphics that represents a two-dimensional picture via a grid of pixels.

Download page: https://www.dotpdn.com/downloads/pdn.html

== Code Browsing/Editing ==
These tools are used to browse and edit code in not only '''Luigi's Mansion 2''', but also other ''Nintendo'' games too!

=== [[File:Ghidra.png|frameless|42x42px]] Ghidra ===
'''[[Ghidra]]''' is a reverse engineering suite that can reverse engineer the code of Luigi's Mansion 2. For this, you will need to convert [[code.bin]] to an ELF executable file.<ref>If you know more about how exactly one can reverse engineer '''Luigi's Mansion 2''' with ''Ghidra'', please consider becoming a Wiki dev or Wiki contributor on the '''[https://discord.gg/7VfdSTXvvg Luigi's Mansion 2 Modding]''' ''Discord'' server and adding this information to this page.</ref>

Download page: https://github.com/NationalSecurityAgency/ghidra

=== ''[TBA]'' ===

== [Page under construction.] ==

Tools

2024-05-31T17:36:34Z

Feldright: added LM2_SaveEditor to the file editing tools

== File Editing ==
These are current tools, through which the contents of a [[DATA|.data]] file can be extracted with a [[DICT|.dict]] file.

=== [[File:Switch Toolbox Reborn.png|frameless|42x42px]] Toolbox.Reborn '''''(Recommended)''''' ===
'''Toolbox.Reborn''' was created by ''KillzXGaming'' and is the most advanced tool for working with [[DICT|.dict]] and [[DATA|.data]] files. It can extract textures, models, as well as general data chunks.

GitHub repository: https://github.com/KillzXGaming/Toolbox.Reborn

=== NLG-File-Editor-Tool ''(In-development)'' ===
'''NGL-File-Editor-Tool''' was created by ''KillzXGaming'' and is a simple tool to extract/edit files from [[DICT|.dict]]/[[DATA|data]].

GitHub repository: https://github.com/KillzXGaming/NLG-File-Editor-Tool

=== [[File:CTR Studio Icon.png|frameless|42x42px]] CTR Studio ===
'''CTR Studio''' was developed by the ''Map Studio Project'', with the primary contributor, again, being ''KillzXGaming'', and is a culmination of previous tools developed for modding applications, like [https://github.com/KillzXGaming/Toolbox.Core ''Toolbox.Core''] and, most importantly for Luigi's Mansion 2 modding, the [https://github.com/KillzXGaming/NextLevelLibrary/ ''NextLevelLibrary'']. The tool allows you to edit files and visualize 3D objects. It is still very much a W.i.P.

GitHub repository: [https://github.com/MapStudioProject/CTR-Studio/releases https://github.com/MapStudioProject/CTR-Studio]

=== LM2L ===
'''LM2L''' was created by ''hadashisora'' and is presumably the first-ever tool that was able to extract data from ''Next Level Games''<nowiki/>' [[DICT|.dict]] and [[DATA|.data]] file formats. The tool can extract files from a [[DATA|.data]] file, as well as the textures contained in it.

GitHub repository: https://github.com/hadashisora/LM2L

=== [[File:D.E.a.R. Icon.png|frameless|42x42px]] Data Extractor and Repacker ''(In-development)'' ===
'''Data Extractor and Repacker (or D.E.a.R.)''' was created by ''Schweini07'' as a research project to understand the structures of [[DICT|.dict]] and [[DATA|.data]] files. It can currently extract files from a [[DATA|.data]] file but is planned to be comparable to the ability of ''CTR Studio''.

GitHub repository: https://github.com/Schweini07/DEAR

=== '''LM2_SaveEditor''' ===
'''LM2_SaveEditor''' was created by ''TollyH'' and is a save editor for the 3DS version of ''Luigi's Mansion 2,'' in order to use this tool you need to provide a .sav file from the game.

GitHub repository: https://github.com/TollyH/LM2_SaveEditor

== Graphic Designing ==
These tools are one of the best when it comes to graphic design. From vector to raster, here are the tools you need to make visual edits in your '''Luigi's Mansion 2''' mods.

=== [[File:Inkscape.png|frameless|42x42px]] Inkscape ===
'''Inkscape''' is an open-source vector graphics editor. Vector graphics are a form of computer graphics that are made from geometric shapes with points, lines, curves, and polygons. Before rasterization, you can zoom in as far as you want, but you will not find a single pixel. They technically have an infinite resolution.

Download page: https://inkscape.org/release/inkscape-1.3.2

=== [[File:Paint.net.png|frameless|42x42px]] paint.net ===
'''paint.net''' is a raster graphics editor. Raster graphics are a form of computer graphics that represents a two-dimensional picture via a grid of pixels.

Download page: https://www.dotpdn.com/downloads/pdn.html

== Code Browsing/Editing ==
These tools are used to browse and edit code in not only '''Luigi's Mansion 2''', but also other ''Nintendo'' games too!

=== [[File:Ghidra.png|frameless|42x42px]] Ghidra ===
'''Ghidra''' is a reverse engineering suite that can reverse engineer the code of Luigi's Mansion 2. For this, you will need to convert [[code.bin]] to an ELF executable file.<ref>If you have any more knowledge on how exactly one is able to reverse engineer LM2 with Ghidra, please consider adding this information to the wiki.</ref>
=== ''[TBA]'' ===

== [Page under construction.] ==

File System

2024-05-28T16:50:39Z

Feldright: /* Folders */

The following subpages below document the files and folders of the extracted file system of '''''Luigi's Mansion 2'''''.

== Folders ==
* [[exefs]]
* [[ExtracedWWiseAudio|ExtractedWWiseAudio]]
* [[File System/romfs|romfs]]

== Files ==
{| class="wikitable"
|+
!Filename !! Format !! Description
|-
| exefs.bin || BIN ||
|-
| extheader.bin || BIN ||
|-
| ncch.bin || BIN ||
|-
| plain.bin || BIN ||
|-
| romfs.bin || BIN ||
|}