User:Pixloen/FPANModding: Difference between revisions

Latest revision as of 20:49, 9 June 2024

	Now, this is a surprise... This wiki is being rewritten from the ground up! If you're interested in helping, join the French Bread Modding Discord!

Welcome to the French Bread Modding Wiki! This wiki is meant to provide a comprehensive documentation of the engine used in modern French Bread games, as well as basic examples and tutorials.

Games covered include UNDER NIGHT IN-BIRTH II: Sys:Celes, UNDER NIGHT IN-BIRTH Exe:Late [cl-r], and MELTY BLOOD: TYPE LUMINA. Some minor information about Blazblue Cross Tag Battle and Dengeki Bunko Fighting Climax Ignition is included too!

Credits

pixloen - Lead writer, proofreader and formatter
_Bootysama - Proofreader and Known Gatekeeper
Blake - Writer on .pat and Audio sections

Contributors

NerfNoobPls - MBTL section in HA6 Pattern Reference

French Bread Modding Wiki
(FBModdingWiki)

Systems

Steam / PC Versions of Games Only

Community Channels

French Bread Modding Discord

UNICLR Color Vault

Melty Blood Server

MBTL Palette Gallery

Melty Blood Community Server

**Note**
The Under Night In-Birth Player Hub has a rule that bans discussion of modding any games. Don't go there expecting any help with mods!

For Beginners

File Formats & Software Guide

Engine Documentation

Guides & Tutorials

	Disclaimer: Better not die on me! This section of the wiki isn't ready yet. If you are knowledgeable enough in modding, please consider helping!

Navigation (old)

Modding French Bread Games
For Beginners	Getting Started File Structure Installing Mods Example Mods Glossary Links & Resources
File Formats & Software Guide	Hantei-chan CGTOOL & CGLIB .pat Effects Palettes DDS Images
Engine Documentation	Audio Backgrounds Classes and Methods Cutscenes D File Folder Functions Shaders

Old Navigation
Quick Start	Getting Started Installing Mods Mods List
Guides	Character File Setup Using Hantei-chan Character Scripts Miscellaneous Dialogue HUD and UI Stages Audio Battle Scripts CG & Patterns Editng Vectors Define
Documentation	Classes and Methods Functions HA6 Pattern Reference UNI2 Modding Notes

PIXL bg001.png

@@ Line 1: / Line 1: @@
-{{DISPLAYTITLE:Modding French Bread Games}}
+{{Disclaimer MFPG
+|border-color=#FF60B0
+|bg-color=
+|image=UNI2_resources_icon.png
+|text='''Now, this is a surprise...'''<br/>This wiki is being rewritten from the ground up! If you're interested in helping, join the [https://discord.gg/RP2mN3YJps French Bread Modding Discord]!
+}}
+{{DISPLAYTITLE:French Bread Modding Wiki}}
+{{2 Column Flex|flex1=7|flex2=3|reverse=yes
+|content1=
+{{Content Box|content=
+<center><div style="max-width:686px;">[[File:PIXL banner.png|class=flex-image|link=]]</div></center>
+Welcome to the '''French Bread Modding Wiki'''! This wiki is meant to provide a comprehensive documentation of the engine used in modern French Bread games, as well as basic examples and tutorials.
-==Can we mod Under Night In-Birth II: [sys:celes]?==
+Games covered include '''UNDER NIGHT IN-BIRTH II: Sys:Celes''', '''UNDER NIGHT IN-BIRTH Exe:Late [cl-r]''', and '''MELTY BLOOD: TYPE LUMINA'''. Some minor information about '''Blazblue Cross Tag Battle''' and '''Dengeki Bunko Fighting Climax Ignition''' is included too!
-'''Status at the moment: We're waiting!'''
+==Credits==
+*'''pixloen''' - Lead writer, proofreader and formatter
+*'''_Bootysama''' - Proofreader and Known Gatekeeper
+*'''Blake''' - Writer on .pat and Audio sections
-As of today, we're just waiting for UNI2 to release on steam. In terms of how fast we can setup modding, it depends on the type of compression / encryption the game uses.
+===Contributors===
+*'''NerfNoobPls''' - MBTL section in HA6 Pattern Reference
-*If it uses UNIST style compression, then modding will be an option very soon.
+}}
-*If it uses MBTL style encryption, we will have to wait for new tools and address finding to mod the game.
+|content2={{Infobox Game
-*If it uses something brand new, expect to wait a while before modding becomes possible.
+| gamename    = French Bread Modding Wiki
+| abbreviation = FBModdingWiki
-==Introduction==
+| image        = PIXL hyde.png
-<div style="max-width:800px;">[[File:PIXL_banner.png|class=flex-image|link=]]</div>
+| system      = Steam / PC Versions of Games Only
-'''Welcome to the French Bread Modding Wiki! This wiki is meant to provide a comprehensive documentation of the engine used in modern French Bread games, as well as basic examples and tutorials.'''
+| community    = [https://discord.gg/RP2mN3YJps French Bread Modding Discord]
+| community2    = [https://discord.gg/uPUtrySvYp UNICLR Color Vault]
-The guides and tutorials here should be considered a way to successfully make mods, but not '''the correct way'''. The techniques and methods used are simply what the author (pixloen) uses, but for others there may be better routes to suite the types of mods that you want to make.
+| community3  = [https://discord.gg/meltyblood Melty Blood Server]
+| community4  = [https://discord.gg/HDX7STnDyb MBTL Palette Gallery]
-===Contents Covered===
+| community5  = [https://discord.gg/melty-blood-community-server-851550129684086800 Melty Blood Community Server]
+| extra        =
-'''Games covered here:'''
+{{!}} colspan="2" {{!}}<!--
-*Under Night In-Birth Exe:late [cl-r]
+-->{{(!}} style="margin:auto;" cellpadding="1" cellspacing="0"
-*MELTY BLOOD: TYPE LUMINA
+{{!}}+ '''Note'''
+{{!}}-
-'''Games Partially covered here'''
+{{!}} The Under Night In-Birth Player Hub has a rule that bans discussion of modding any games. Don't go there expecting any help with mods!
-*Dengeki Bunko Fighting Climax
+{{!}}
+{{!)}}
-'''Games not covered here:'''
+}}}}
-*Under Night In-Birth Exe:late / Under Night In-Birth
+====<span class="invisible-header" style="font-size: 0em;">For Beginners</span>====
-*Melty Blood Actress Again Current Code
+{{Content Box|header=For Beginners|content=
+<div style="margin-left: auto; margin-right: auto; display: flex; flex-direction: row; flex-wrap: wrap; justify-content: center; max-width:1500px; align-items: center;">
-=== Assumed Knowledge ===
+{{PIXL FP Banner|image=started|name=Getting Started}}
+{{PIXL FP Banner|image=files|name=File Structure}}
-*Basic understanding of navigating File Explorer
+{{PIXL FP Banner|image=install|name=Installing Mods}}
-*Basic understanding of batch files
+{{PIXL FP Banner|image=list|name=Example Mods}}
-*Basic understanding of programming
+{{PIXL FP Banner|image=glossary|name=Glossary}}
+{{PIXL FP Banner|image=links|name=Links and Resources}}
-Note that French Bread uses Squirrel for most functions, but such code can be easily understood if you have JS, LUA, C and etc. experience. If others can do it, so can you!
+</div>
+}}
-== Tools, Other Guides & Useful Resources ==
+====<span class="invisible-header" style="font-size: 0em;">File Formats & Software Guide</span>====
+{{Content Box|header=File Formats & Software Guide|content=
-=== Game Rips ===
+<div width="fit-content" style="display: flex; flex-direction: row; flex-wrap: wrap; justify-content: center;">
+{{PIXL FP Bar|image=ha6|name=Hanteichan}}
-*[https://drive.google.com/drive/folders/16Ez4O_Dw6cD-KvZRILkY4_EonKjUkeOv Melty Blood Type Lumina] (outdated)
+{{PIXL FP Bar|image=cg|name=CG}}
-*[https://drive.google.com/drive/folders/1iJDh5pXszLjDcGp9XUUW5YMuRh-0vm57?usp=sharing UNICLR] (incomplete) (Londrekia's sprites can be found here.)
+{{PIXL FP Bar|image=pat|name=Pat Effects}}
+{{PIXL FP Bar|image=pal|name=Palettes}}
-*[https://www.spriters-resource.com/pc_computer/meltybloodtypelumina/ Lumina Spriters Resource]
+{{PIXL FP Bar|image=dds|name=DDS Images}}
-*[https://www.justnopoint.com/lbends/index.php?location=sprites&gallery=unist UNIST sprites from JustNoPoint]
-=== Basic Tools ===
-*[https://cdn.discordapp.com/attachments/891200226273161216/1132327122233466971/hanteichan2.165.exe Hantei-chan 2.165], a HA6 editor
-*[https://github.com/DamienIsPoggers/Hantei-chan Hantei-chan with jonbin] (DamienIsPoggers, can convert to BlazBlue files, optional)
-*[https://cdn.discordapp.com/attachments/348827363632480257/1025598958355099709/cglib.zip CGlib], .cg extractor by u4ick
-*[https://cdn.discordapp.com/attachments/348827363632480257/1025598958682251304/cgtool.zip CGTool], .cg compiler by u4ick
-*A basic text editor such as Notepad++. Regular Notepad is fine but may be harder to use.
-*A hex editor. [https://mh-nexus.de/en/hxd/ HxD] is used commonly.
-*.pat editor / visualizer. None are public, but you can use HA6 + hex editor as a close enough replacement.
-*DDS decomp/compression tool. Found in the .pat cut-ins guide.
-=== Game Specific Injectors / Extractors ===
-'''MBTL'''
-*[https://github.com/Eiton/MBTL-Hitbox-Viewer MBTL Hitbox Viewer], injector
-*[https://github.com/Ekey/MBTL.BIN.Tool/releases MBTL BIN Tool], file extractor
-*[https://cdn.discordapp.com/attachments/891200226273161216/1113822492688142357/cache_5_31_23.zip Current Cache for the MBTL BIN Tool] as of 02/06/2023 courtesy of u4ick
-'''UNICLR'''
-*[https://cdn.discordapp.com/attachments/564284968461795343/985510407080914954/Eng_Pal_lang_patch_extract_to_root_dir.7z _English patch file], injector sort of
-*[https://cdn.discordapp.com/attachments/513968503020191744/693268722718212096/Music_Mod_patch.zip Music patch file], use for ___English language
-*[https://github.com/ucuckic/unist-unpacker/releases/tag/3 UNIST Unpacker], file extractor
-=== Written Guides & Documentation ===
-*[https://docs.google.com/document/d/11hPfvxlvdkzkFEScYJzDKp2FsxCqpzWUOQ8bFQa3gxI/edit?usp=sharing .pat Image Editing Guide] by AyanamiRei0
-*[https://docs.google.com/document/d/1zjWYuGVWBbKd22YC_ZcIT6WuPbqjVaZ9pu96yng--6c/edit?usp=sharing Detailed .pat documentation] by DamienIsPoggers
-*[https://docs.google.com/document/d/1CsXdXQwz8rYQgO2W3XtGB0ycwJJxOXal9YooXfqd1nw/edit?usp=sharing MBTL Music Modding Guide] by Sera, Yvette & AyanamiRei0
-*[https://imgur.com/a/5GQ2JDO MBTL Unpacker Guide] by koenji
-*[https://docs.google.com/document/d/1YxiOS1V0VaWnvkn-LKABzEoMWTxDi1rJR4qCj_jzLAo/edit?usp=sharing UNICLR Music Modding Guide] by Sera
-*[https://docs.google.com/document/d/1Y8Xymash1fCR2h-2AQDQZcC7agqgKM7ujQW5q6GdDjQ/edit?usp=sharing UNICLR Old Palette Modding Guide] by Sera
-For the following guide:
-If you aren't tech-literate, it's recommended NOT to use Symlinks.bat as it creates Symlinks which can only be removed through command-line.
-Preferably, using Copying.bat or copy the files yourself by following these steps:
-*Find _English/data/csel and grab your character's palette (e.g. Aka.pal)
-*Copy and paste/replace over the same file found in _English/data/Character_0 (Aka_0 in this example)
-[https://docs.google.com/document/d/1ypJMX0bqzKgMG06KMtoNimPLxOTG6Ifkrp8YB23E73A/edit?usp=sharing UNICLR Color Modding Guide] by Sera, AyanamiRei0
-*[https://www.reddit.com/r/meltyblood/comments/widwxl/tl_performance_sucking_on_pc_use_dgvoodoo/ DGVoodoo Setup for Lumina (works with UNI too) ] by u/SK91_NO
-== Where can I get help? ==
-*Ask pixloen directly -- or head to the following (organised from most active to least active)
-*[https://discord.gg/meltyblood Melty Blood Server's #modding-tl]
-*[https://discord.gg/HDX7STnDyb MBTL Palette Gallery's Other Mods Category]
-*[https://discord.gg/uPUtrySvYp UNICLR Color Vault's #general 2]
-*[https://discord.gg/melty-blood-community-server-851550129684086800 Melty Blood Community Server's Type Lumina Modding thread (under #type-lumina)]
-*[https://www.reddit.com/r/UnderNightInBirth idk the under night reddit if you really must]
-Note: The community UNICLR server has a rule banning any discussion about modding due to French Bread (or just kamone)'s stance against it. While this makes the modding scene quite small, do respect the rule by not openly encouraging extensive mods of the game. (Pray that this rule gets lifted for UNI2. I'll make a bunch of QoL mods like subtitles and full 1440p support if it does.)
-== Navigation ==
+</div>
+}}
+====<span class="invisible-header" style="font-size: 0em;">Engine Documentation</span>====
+{{Content Box|header=Engine Documentation|content=
+<div width="fit-content" style="display: flex; flex-direction: row; flex-wrap: wrap; justify-content: center;">
+{{PIXL FP Bar|image=audio|name=Audio}}
+{{PIXL FP Bar|image=bg|name=Backgrounds}}
+{{PIXL FP Bar|image=class|name=Classes and Methods}}
+{{PIXL FP Bar|image=cutsc|name=Cutscenes}}
+{{PIXL FP Bar|image=dfile|name=D File}}
+{{PIXL FP Bar|image=func|name=Functions}}
+</div>
+}}
+====<span class="invisible-header" style="font-size: 0em;">Guides & Tutorials</span>====
+{{Content Box|header=Guides & Tutorials|content=
+<div width="fit-content" style="display: flex; flex-direction: row; flex-wrap: wrap; justify-content: center;">
+{{Disclaimer MFPG
+|border-color=#FF1060
+|bg-color=
+|image=PIXL hyde.png
+|text='''Disclaimer: Better not die on me!'''<br/>This section of the wiki isn't ready yet. If you are knowledgeable enough in modding, please consider helping!
+}}
+</div>
+}}
+==Navigation (old)==
 {{Navbox-MFPG}}
-[[Category:Modding French Bread Games]]
+[[Category: Modding French Bread Games]]
-== Credits ==
-=== Members ===
-*'''pixloen''' - lead writer, template creator, custom asset maker etc etc
-*'''Blake / Blakieboo''' - music and pat information writer
-*'''Bootysama''' - provided many of the assets that i used to study the engine and gave me useful advice or tips and might have written one or two things (general information checker too)
-<!-- Contributed to the wiki? Feel free to add yourself in this section! -->
-=== Contributors ===
-*'''NerfNoobPls''' - MBTL section in HA6 Pattern Reference
-=== Special Thanks ===
+<templatestyles src="Pixl/frontpage.css"/>
-*'''Rion / u4ick''' - made basically all of the tools and programs and started the modding scene in general
+<div style="position: fixed; bottom: 0; left: 0; z-index:-1;display:flex; width:100%;">
-*'''Melty Blood Discord''' - helped me mess around with .cg editing to port a singular satsuki sprite, starting my interest in modding french bread games, resulting in this mess of a wiki you're reading now
+[[File:PIXL bg001.png|10000px|class=image|link=]]
+</div>