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.
• Support for multiple poster packs, with the ability to enable/disable poster packs or posters itself, change chances of the packs and posters via configuration.
• 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.
• Compatible with ShipWindows, 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, .jpg, .jpeg, .bmp.

Steps

1. Create a folder structure for your custom poster pack in the BepInEx/plugins directory as shown below.
2. Place your poster images in the posters and tips folders, ensuring filenames match exactly (e.g., Poster1.png, CustomTips.jpg).

Folder Structure:

Poster image names must match the structure below.

   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

• Randomier mode:
  • PerPack (default): Selects one pack randomly for all posters.
  • PerPoster: Randomizes textures for each poster from all enabled packs.
• Per session:
  • False (default): Randomizes posters only when the lobby reloads.
  • True: Randomized posters only when restarting the game.
• Enable/Disable Packs and Posters:
  • Each poster pack has an Enabled setting for poster pack and posters. Set to false to disable a pack or a poster.
• Per-Pack Chance:
  • Assign a Chance value (0–100) for each pack. If any pack has a Chance > 0, weighted random selection is used.
  • A Chance = 0 excludes the pack from selection, reverting to equal probability among enabled packs with non-zero chances.
• Per-Poster Chance:
  • For each poster in a pack, set a probability (0–100). If any poster has a Chance > 0, weighted selection applies.
  • Having 2 and more poster packs and one of the poster pack has (e.g. Poster2) Chance = 70 and second poster pack with same poster has Chance = 0 means that second poster pack poster is excluded from selection within that pack.
• TextureCaching:
  • Enabled (Default): Stores textures in memory for faster access, reducing disk reads.
  • Disabled: Loads textures from disk each time, which may slightly increase load times (based on image size).

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.

Q: What happens if a poster fails to load?

The mod disables that poster and falls back to the vanilla poster or another valid poster from an enabled pack.

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!