A mod for Baldi's Basics Plus v0.8+, powered by BepInEx, Json.NET and the Baldi's Basics Plus Dev API, that allows the creation of custom wall posters by using user-provided images.
Requires BepInEx v5.4.23 and above and Baldi's Basics Plus Dev API v6.0.0.0 and above.
Json.NET is bunded with the download, and is licensed under MIT.
- Creation of single-wall posters by providing either only a .PNG image or also a .JSON definition file
- Custom posters should be added in
[BB+ INSTALL PATH]/BALDI_Data/StreamingAssets/Modded/io.github.uncertainluei.baldiplus.customposters/Posters
, and definition files must have the extension.png.json
. - Other mods can depend on this and have their own poster paths read using the
CustomPostersPlugin.AddBuiltInPackFromMod
and/or 'CustomPostersPlugin.AddBuiltInPackFromDirectory
helper methods.
- Custom posters should be added in
- Setting custom properties to any created poster, such as:
- The poster's 'weight' probability in the generator
The width of the poster (allowing for 'multi-posters')(This is now automatically set.)- Floors the poster can/cannot appear on, based on level name
- Poster Text Data support (for both single and 'multi' posters)
- The poster's spawning mode, whether it can spawn anywhere, what rooms it can spawn in, or if it spawns as a chalkboard
- Examples can be seen in the repository's
Examples
folder.
- The following configuration options, which can be accessed from
[BB+ INSTALL PATH]/BepInEx/config/io.github.uncertainluei.baldiplus.customposters.cfg
:- Default weight of created posters if not specifically set
- White/blacklist of posters added by either the base game or other mods
- Debug option to log (almost) all posters in the floor to the console, useful for balancing created poster weights
- Runtime-created text poster textures are now named for easier debugging using tools such as UnityExplorer
Planned features for future versions:
- Better configuration system that accepts arrays (maybe)
- Documentation on how to use the mod (IMPORTANT!!)
Support for possible "poster packs" (.zip archives)- A menu to toggle poster packs
Some posters (excluding the ones in the first and last screenshots) seen here are not included with the normal download.