Modding French Bread Games
Can we mod Under Night In-Birth II: [sys:celes]?
Status at the moment: Yes? The game uses UNIST style compression; so everything is all set! UNIST Unpacker at the moment cannot extract files for UNI2. This can be partially fixed by modifying source and changing a single integer in the files(?). tbh just wait for u4 to update it lol
Initial Notes
- d file hex editing is still required for basically every file
- character data is structured like lumina rather than uniclr
Introduction
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.
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.
Contents Covered
Games covered here:
- Under Night In-Birth Exe:late [cl-r]
- MELTY BLOOD: TYPE LUMINA
Games Partially covered here
- Dengeki Bunko Fighting Climax
Games not covered here:
- Under Night In-Birth Exe:late / Under Night In-Birth
- Melty Blood Actress Again Current Code
Assumed Knowledge
- Basic understanding of navigating File Explorer
- Basic understanding of batch files
- Basic understanding of programming
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!
Tools, Other Guides & Useful Resources
Game Rips
- Melty Blood Type Lumina (outdated)
- UNICLR (incomplete) (Londrekia's sprites can be found here.)
Basic Tools
- Hantei-chan 2.165, a HA6 editor
- Hantei-chan with jonbin (DamienIsPoggers, can convert to BlazBlue files, optional)
- CGlib, .cg extractor by u4ick
- 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. 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
- MBTL Hitbox Viewer, injector
- MBTL BIN Tool, file extractor
- Current Cache for the MBTL BIN Tool as of 02/06/2023 courtesy of u4ick
UNICLR
- _English patch file, injector sort of
- Music patch file, use for ___English language
- UNIST Unpacker, file extractor
UNI2
- UNI2 Unist Unpacker by u4, edited by pixloen (does not fully work atm)
Written Guides & Documentation
- .pat Image Editing Guide by AyanamiRei0
- Detailed .pat documentation by DamienIsPoggers
- MBTL Music Modding Guide by Sera, Yvette & AyanamiRei0
- MBTL Unpacker Guide by koenji
- UNICLR Music Modding Guide by Sera
- 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)
UNICLR Color Modding Guide by Sera, AyanamiRei0
- 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)
- Melty Blood Server's #modding-tl
- MBTL Palette Gallery's Other Mods Category
- UNICLR Color Vault's #general 2
- Melty Blood Community Server's Type Lumina Modding thread (under #type-lumina)
- 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.)
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)
Contributors
- NerfNoobPls - MBTL section in HA6 Pattern Reference
Special Thanks
- Rion / u4ick - made basically all of the tools and programs and started the modding scene in general
- 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