Skip to content

➕ Baldi's Basics Plus mod that allows custom posters from plain images, and more

License

Notifications You must be signed in to change notification settings

uncertainluei/BaldiPlus-CustomPosters

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BB+ Custom Posters Mod

Version License BB+ version BepInEx version Json.NET version MTM101BMDE version

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.

Features provided by the mod

  • 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.
  • 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

Screenshots

Some posters (excluding the ones in the first and last screenshots) seen here are not included with the normal download. Custom Multi-Poster with Text Data Custom Multi-Poster in Classroom Custom Poster in Library Custom Poster in Clinic Custom Poster in Classroom Custom Multi-Poster in Hall

About

➕ Baldi's Basics Plus mod that allows custom posters from plain images, and more

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages