litterEditor
Plugin for OpenRCT2 to modify litter properties.
OpenRCT2 Litter Editor
A specialized tool for OpenRCT2 that allows you to place, manipulate, and generate complex patterns using litter (vomit and trash). Move beyond simple cleanup and use litter as a creative medium for track detailing, custom signage, and image reproduction.
Features
1. Manual Litter Manipulation
- Precision Placement: Place specific types of litter (vomit or trash) exactly where you want them.
- Coordinate Control: Manually adjust the X, Y, and Z (height) coordinates of existing litter elements.
- Pipette Tool: Quickly select existing litter on the map to view and edit its properties.
- Multiplier Settings: Toggle between x1, x10, and x100 increments for rapid coordinate adjustments.
2. Track Distributor
- Ride Integration: Select any ride in your park and distribute litter along its track layout. It distributes litter by 32 unit increments, so it is consistent across any length of track piece.
- Custom Density: Control the number of litter items generated along the track.
- Vertical Offsets: Set height offsets to position litter above or below the track surface for unique effects.
3. Diagonal Text Tool
- Custom Signage: "Print" text strings onto the map using litter as pixels.
- Typography Controls: Adjust kerning (character spacing) and relative spacing across X, Y, and Z axes.
- Alignment and Bias: Fine-tune the positioning and slant of the generated text.
- Undo Support: Quickly remove the last generated text string if it needs adjustment.
4. Image Printer
- Pixel Art Generation: Convert image data into litter-based patterns.
- Web Integration: Use the companion web tool to convert your own images into the required format.
- Multi-Plane Support: Print images on different spatial planes to create 3D litter structures.
- Undo Support: Quickly remove the last generated bmp if it needs adjustment.
Image Conversion Web Tool
To use the Image Printer feature, you must first convert your images using the BMP webtool:
Address: https://thertyrct.github.io/litterEditor/
Follow the instructions on the webtool to generate the data string required by the in-game Image Printer tab.
Shortcut Defaults
The following keyboard shortcuts are configured by default. These can be customized in the OpenRCT2 Options menu under the "Shortcut Keys" tab.
- Open Litter Editor: CTRL+SHIFT+L
- Select Litter: CTRL+SHIFT+P (Activates pipette tool)
- Delete Litter: CTRL+SHIFT+D (Activates deletion tool)
- Toggle Multiplier: CTRL+SHIFT+M (Cycles x1, x10, x100)
- Place Litter: CTRL+SHIFT+B (Activates placement tool)
- Cycle Litter Type: CTRL+SHIFT+C (Cycles between vomit and trash)