BikininjasCustomPosters

Bikininjas Custom Posters

A content pack and intelligent pack generator for the CustomPosters mod in Lethal Company.

🎯 What's Included

• Custom Poster Pack: Pre-configured posters ready for the game
• Intelligent Pack Generator: Python script that automatically matches images to poster slots based on aspect ratio similarity

📦 Quick Start - Using the Poster Pack

• Download this repository
• Copy the BepInEx folder to your Lethal Company directory
• Launch the game and enjoy custom posters!

🛠️ Pack Generator Tool

✨ How It Works

The pack generator uses intelligent aspect ratio matching to automatically assign your images and videos to the best-fitting poster slots:

• Scans all images and videos in the input/ folder
• Calculates the aspect ratio of each file (width/height)
• Matches each file to the poster slot with the closest aspect ratio
• Generates a complete poster pack ready for the game
• Videos are automatically converted to MP4 format

📐 Poster Specifications

The mod supports exactly 6 slots per pack:

| Slot | Dimensions | Aspect Ratio | Orientation | Output Format |

|------|-----------|--------------|-------------|---------------|

| Poster1 | 639 × 488 | 1.31:1 | Landscape | PNG or MP4 |

| Poster2 | 730 × 490 | 1.49:1 | Landscape | PNG or MP4 |

| Poster3 | 749 × 1054 | 0.71:1 | Portrait | PNG or MP4 |

| Poster4 | 729 × 999 | 0.73:1 | Portrait | PNG or MP4 |

| Poster5 | 552 × 769 | 0.72:1 | Portrait | PNG or MP4 |

| CustomTips | 860 × 1219 | 0.71:1 | Portrait | PNG or MP4 |

Note:

• Images are saved as.png files
• Videos are converted to.mp4 files (H.264 video, AAC audio)
• All files are saved to posters/ or tips/ folders

� Intelligent Matching Example

If you have these images:

• landscape1.jpg (1920×1080, ratio 1.78:1)
• landscape2.jpg (1280×720, ratio 1.78:1)
• portrait1.jpg (1080×1920, ratio 0.56:1)
• portrait2.jpg (800×1200, ratio 0.67:1)
• portrait3.jpg (900×1400, ratio 0.64:1)
• portrait4.jpg (1000×1500, ratio 0.67:1)

The script will automatically match:

• landscape1.jpg → Poster2 (closest to 1.49:1)
• landscape2.jpg → Poster1 (closest to 1.31:1)
• portrait1.jpg → CustomTips (closest to 0.71:1)
• portrait2.jpg → Poster4 (closest to 0.73:1)
• portrait3.jpg → Poster5 (closest to 0.72:1)
• portrait4.jpg → Poster3 (closest to 0.71:1)

📋 Supported Formats.jpg.jpeg.png.bmp.gif.tiff.webp.avif

🚀 Installation & Setup

• Install Python (3.7+)
• Navigate to Image Resizer Directory

cd /path/to/lc_bikininjaPosters/image_resizer

• Create Virtual Environment (Recommended)

Create venv

python3 -m venv venv

Activate venv

source venv/bin/activate # Linux/Mac

venv\Scripts\activate # Windows

• Install Dependencies

pip install -r requirements.txt

This installs:

• Pillow - Image processing
• pillow-avif-plugin - AVIF format support
• moviepy - Video conversion and processing

💻 Usage

Basic Workflow

• Activate virtual environment

cd /path/to/lc_bikininjaPosters/image_resizer

source venv/bin/activate # Linux/Mac

• Add your images and videos to input/

cp ~/Pictures/*.jpg input/

cp ~/Videos/*.mp4 input/

• Run the generator

python poster_resizer.py

• The script will:
• Analyze all images and videos
• Match them to best-fitting slots
• Convert videos to MP4 format
• Create a complete poster pack
• Move processed files to done/

Example Session

$ python poster_resizer.py

======================================================================

🖼️ CUSTOMPOSTERS PACK GENERATOR

======================================================================

Intelligently matches images to poster slots based on aspect ratio

======================================================================

⚙️ Configuration:

Input: input

Output:../BepInEx/plugins

Pack: BikininjasPosters

Aspect: Maintained

🔍 Scanning for images...

✓ Found 6 file(s)

🎯 Matching images to poster slots...

======================================================================

📊 IMAGE-TO-SLOT MATCHING REPORT

===============================================