---

CustomPosters

Replaces the default posters in the ship with custom posters. You can add your own images to create a personalized experience!

---

Features

• Override the default posters in the ship with your own custom images.
• Simply drop your images into the posters and tips folders.
• Adding multiple poster mods that are compatible with this mod will work, as said in Randomization Options section.
• If any custom poster fails to load, the mod will disable that poster at all.
  • If you have more than 2 poster mods and first poster don't load, it will try to load second poster instead.
• Randomization Options:
  • Poster Randomizer: Randomly select one pack for all posters or mix textures from multiple packs.
• Compatible with ShipWindows/Beta, 2 sToRy ShIp and WiderShipMod.
• Optimized to prevent texture leaking.
• Tool called PosterCropperTool which allows to crop posters from LethalPosters mod to be compatible with CustomPosters.
  • Sizes of the posters might be slightly be incorrect after cropping!

---

Adding Custom Posters

Requirements

• CustomPosters
• Supported formats - .png

Steps

This is how your mod folder structure should look like to work with CustomPosters:

Names of the poster image should be exactly like shown in structure

   BepInEx/
    ├── plugins/
    │   └──── YourModName/
    │          └── CustomPosters/
    │                ├── posters/
    │                │    └── Poster1.png, Poster2.png, Poster3.png, Poster4.png, Poster5.png
    │                └── tips/
    │                     └── CustomTips.png
    └── ...                  

Recommended Poster Sizes [ In pixels ]

• Poster1 - 639 Width, 488 Height
• Poster2 - 730 Width, 490 Height
• Poster3 - 749 Width, 1054 Height
• Poster4 - 729 Width, 999 Height
• Poster5 - 552 Width, 769 Height
• CustomTips - 860 Width, 1219 Height

---

Configuration

The mod automatically generates a configuration file (CustomPosters.cfg) in the BepInEx/config folder. You can use this file to customize the behavior of the mod

Configuration Options

Enable/Disable Packs:

• Each pack has an Enabled setting in the configuration file. Set it to true or false to enable or disable the pack.

PosterRandomizer:

• Enabled (Default): Randomly select one pack and use it for all posters.
• Disabled: Randomly select a pack for each poster individually.

---

FAQ

Q: Can I use multiple poster packs at the same time?

Yes! The mod supports multiple poster packs. You can enable or disable packs in the configuration file.

Q: Is this mod compatible with other ship mods?

Yes, the mod is compatible with ShipWindows, 2 sToRy ShIp, and WiderShipMod. Poster positions are automatically adjusted based on the installed mods.

Q: Can I use custom sizes for posters?

Yes, but for best results, use the recommended sizes listed in the Adding Custom Posters section.

---

Troubleshooting

My Posters Aren't Showing Up

1. Ensure your images are named correctly (e.g., Poster1.png, CustomTips.png).
2. Check the BepInEx/LogOutput.log file for errors related to texture loading.
3. Make sure the posters and tips folders are in the correct location as shown in Adding Custom Posters section.

The Default Poster (Plane.001) is Still Visible

• This happens if the mod fails to load any custom poster pack. Check the config and make sure you have at least 1 poster pack enabled, check log file for errors and ensure your images are valid.

---

Credits

• Developed by seeya.
• Was inspired by LethalPosters mod.

---

License

Distributed under the GPL v3 License. See LICENSE.txt for more information

---

💖 Support

If you enjoy my work, consider supporting us. Donations are optional but greatly appreciated.

---