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.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[4.0.4] - 2026-05-04

Fixed

• Fixed clients having posters from a previous lobby with the correct ones when rejoining

Removed

• Removed motion blur for poster prefabs

Changed

• Internal code cleanup and refactoring

[4.0.3] - 2026-01-21

Fixed

• mp4 posters always overriding image posters when both added for the same poster slot

[4.0.2] - 2025-11-04

Added

• Added compatibility with 2StoryShip Legacy ship layout.

Changed

• Slightly improved Poster5 rotation when using 2StoryShip.

[4.0.1] - 2025-10-25

Fixed

• Fixed clients not having host selected posters (maybe?).

[4.0.0] - 2025-10-24

Added

• Added vanilla meshes of Poster5 and Tips.
  • There's an option in the Settings section to use both of them, one of them or neither of them.
• Added keeping packs or posters per save slot in a new setting KeepPackFor.
• Added support for multiple poster packs within a single mod.
  • So, basically create multiple folders in your mod folder and place posters in them as shown in the README and they will count as poster packs.

Changed

• Replaced PerSession toggle option with KeepPackFor dropdown option to choose between Lobby, Session and SaveSlot.
• Poster positions and rotation of ShipWindows, TwoStoryShip, and WiderShipMod were improved to be closer to the vanilla.
• Reduced default volume of .mp4 posters from 20 to 10.
• Reduced default max distance of .mp4 posters from 4 to 3.5.

Fixed

• Fixed posters not randomizing with PerPoster mode.
• Fixed transparent image backgrounds being black.

[3.2.0] - 2025-10-15 - "Synchronization"

Added

• Added video playback synchronization. Hosts video playback time is synced with all clients.
• Added posters synchronization. Host now selects the active poster pack and syncs it across all clients.
• Added toggleable Networking option to config.
• Added LethalNetworkAPI as dependency.

[3.1.0] - 2025-10-12 - "Compatibility"

Added

• Added BiggerShip compatibility.

Fixed

• Fixed posters not being affected by games shaders.

[3.0.0] - 2025-10-11 - "The Overhaul"

Added

• Added .mp4 support.
  • Added a config option to enable or disable the audio of the poster mp4 [ default is false ]
  • Added a config option for each .mp4 poster to change the max volume distance of the video [ default is 4 ]
  • Added a config option for each .mp4 poster to change the aspect ratio of the video [ default is Stretch ]
  • Added a config option for each .mp4 poster to change the volume of the video [ default is false ]

Changed

• Replaced creating posters via code with AssetBundle.
• Config overhaul.
• Refactored and reorganized the entire codebase.

Fixed

• Fixed poster positions with 2StoryShipMod.
• Fixed poster packs disabled in a mod manager still showing up in the config.

[2.0.0] - 2025-06-09 - "Major update"

Added

• Added a setting to all posters in poster pack to disabled/enable them individually.
• Added a setting PerSession, which allows user to choose between randomizing posters on every lobby reload or on every game restart.
• Added Chance config options for PerPack and PerPosters randomization modes.
  • PerPack: if any pack has a Chance > 0, use weighted selection.
  • PerPoster: if poster has a Chance > 0, use weighted selection.
  • 0% chance means equal probability [ standard behavior ].
• Added support for .jpg, .jpeg, and .bmp.
• Added texture caching
  • Stores loaded textures in memory, reloading only when packs change. Clear cache on mod reload or game exit.

Changed

• Little more texture loading optimization.
• Improved configs.
• Improved and removed some logs.

Removed

• Removed ShipWindowsBeta compatibility as it was merged into the main ShipWindows mod.

Fixed

• Fixed vanilla posters not re-enabling if there were custom posters loaded.

[1.4.0] - 2025-05-13 - "Improvements"

Changed

• Improved compatibility with other mods.
• Changed recommended sizes in README.

[1.3.5] - 2025-02-18 - "Minor update"

Removed

• Removed 1 second delay before creating custom posters, as it was not fixing the intended issue.

[1.3.4] - 2025-02-18 "Compatibility"

Added

• Temporarily added ShipWindowsBeta compatibility.

[1.3.3] - 2025-02-15 "Optimization"

Changed

• Optimized custom poster creation, the game no longer freezes when loading posters.
• Removed unused code.

Fixed

• Fixed a texture memory leak.
• Added error handling for more robustness.

[1.3.2] - 2025- "Release"

Added

• Initial release!
• ShipWindows compatibility!
• WiderShipMod compatibility!
• 2 Story Ship compatibility!