CustomPosters

CustomPosters

Replaces the vanilla posters in the ship with custom posters added by user.

Features

• Overrides the vanilla posters in the ship with your own images
• Supports multiple poster pack mods at once
• Supports multiple poster packs in a single mod
• Supports most of the image formats and.mp4 video format
• Ability to enable/disable packs and posters, change chances of the packs and posters, toggleable networking, change volume, max distance and aspect ratio of.mp4 posters via config file
• Compatible with ShipWindows, 2 sToRy ShIp, BiggerShip, and WiderShipMod
• Posters and video playback is synchronized with clients
• PosterCropperTool allows to crop posters that are made for LethalPosters so they can be compatible with CustomPosters
• _Sizes of the posters will be slightly incorrect after cropping!_

Adding Custom Posters

Supported formats

-.png,.jpg,.jpeg,.bmp,.mp4

Steps

• Create a folder structure for your custom poster pack in the BepInEx/plugins directory as shown below
• Place your poster images in the posters and tips folders, ensuring filenames match exactly - _Poster1.png, Poster2.mp4, Poster3.bmp, Poster4.jpeg, Poster5.png_ and _CustomTips.jpg_

Single Pack Folder Structure:

_Poster image names must match the structure below

_

BepInEx/

├── plugins/

│ └──── YourPosterModName/

│ └── CustomPosters/

│ ├── posters/

│ │ └── Poster1.png, Poster2.png, Poster3.png, Poster4.png, Poster5.png

│ └── tips/

│ └── CustomTips.png

└──...

Mutliple Pack Folder Structure:

_Poster image names must match the structure below

_

BepInEx/

├── plugins/

│ └──── YourPosterModName/

│ ├── PosterPack1/

│ │ ├── posters/

│ │ │ └── Poster1.png, Poster2.png, Poster3.png, Poster4.png, Poster5.png

│ │ └── tips/

│ │ └── CustomTips.png

│ │

│ └── PosterPack2/

│ ├── 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 Options

• Enable Networking:
• If true (default), posters are synced with all players. If false, the mod is client-side only, allowing to play vanilla lobby
• Randomier mode:
• _PerPack (default)_: Selects one pack randomly for all posters
• _PerPoster_: Randomizes textures for each poster from all enabled packs
• Keep Pack For:
• _Lobby (default)_: Randomized posters only when the lobby reloads
• _Session_: Randomized posters only when restarting the game
• _SaveSlot_: Randomized posters only when creating a new save slot
• Vanilla model:
• _Both (default)_: Uses both _Poster5_ and _Tips_ vanilla meshes
• _Poster5_: Uses only _Poster5_ vanilla mesh
• _Tips_: Uses only _Tips_ vanilla mesh
• _None_: Uses none of the vanilla meshes and uses quads
• Toggle 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
• Global Chance:
• Assign a Global Chance value (0–100) for each pack. If any pack has a Global 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
• Volume:
• Configure volume of.mp4 posters
• Max distance:
• Configure maximum audio distance of.mp4 posters
• Aspect ratio:
• Choose aspect ratio of.mp4 posters _[ Stretch 'X', FitInside, FitOutside, NoScaling ]_
• TextureCaching:
• _Enabled_: Store