Strazer's Player HEX

Custom HEX colours for both your player character and forklift, synchronised across all modded clients via Mirror networking.

Features

• HSV colour wheel picker
• RGB sliders
• HEX colour input (3 or 6 digit)
• Live colour preview
• Copy / Paste HEX from system clipboard
• Networked — other modded players see your custom colour
• Applies to both player model and forklift
• Configurable toggle key (default: F8)
• Colour persists between game sessions
• Use Default button to return to the game's normal colour

Installation

All players who want to see custom HEX colours must install the mod.

1. Copy PlayerHEX.dll into BepInEx/plugins.
2. Launch the game.

Usage

Press F8 to open the colour picker window.

• Drag on the colour wheel to pick hue and saturation.
• Adjust brightness with the V slider.
• Fine-tune with R, G, B sliders.
• Type any hex code in the HEX field and press Enter.
• Click Apply to save and synchronise the colour to the network.
• Click Reset to revert the preview to the saved colour.
• Click Use Default to clear your custom colour and return to the game's normal colour system.
• Use Copy HEX / Paste HEX to share colours outside the game.

Configuration

Config file is created at:

BepInEx/config/strazer.playerhex.cfg

Supported HEX Formats

Invalid values are silently rejected.

Multiplayer Behaviour

• Custom colours are synced using a custom Mirror NetworkMessage (NetMsgCustomPlayerColor).
• The colour is sent once when you click Apply; it is not sent every frame.
• The server validates that the sender owns the netId before propagating the colour.
• Vanilla clients (players without the mod) will see the game's default index-based colour, not your custom HEX colour.
• All players who wish to see custom HEX colours must have Strazer's Player HEX installed.

Known Limitations

• The colour picker uses Unity IMGUI. It disappears when the HUD is hidden (e.g. loading screens). Press F8 to reopen it.
• Colour wheel precision is limited by the 256x256 texture.
• Vanilla clients cannot see custom HEX colours.

Credits

• Strazer — Author
• Crashout Crew by kesomannen

Version History

Changelog

1.0.1 — 2026-08-08

Multiplayer & Networking

• Reworked custom HEX colour synchronization to be fully networked.
• Custom colours are now synchronized between all players running Strazer's Player HEX.
• Added server-side colour storage and validation.
• Players can only update their own custom colour.
• Custom colours are automatically synchronized when players join a lobby.
• Improved synchronization for both the host and joining players.
• Custom colours now persist correctly when transitioning from the lobby into gameplay.
• Improved handling of player network IDs changing between scenes.
• Player and forklift colours remain synchronized across multiplayer.

Colour Selection

• The colour picker is now available from the main menu before joining or hosting a lobby.
• The colour picker remains available in the lobby.
• Saved colours persist from the main menu into the lobby and gameplay.
• Colour editing is disabled during gameplay.
• F8 no longer opens the colour picker during gameplay.

Automatic Synchronization

• Players no longer need to press Apply again when another player joins.
• Existing players automatically synchronize their saved HEX colours with newly joined players.
• Joining players automatically send their saved HEX colour.
• Synchronization happens in the background without opening the colour picker or moving the mouse.
• Added automatic resynchronization support for multiplayer sessions.

Stability

• Fixed custom colours only appearing on the player who selected them.
• Fixed custom colours being lost when entering gameplay.
• Fixed host colours not being synchronized correctly to joining players.
• Fixed players needing to repeatedly press Apply for their colour to appear.
• Improved multiplayer colour persistence across lobby and gameplay transitions.
• Confirmed player and forklift colours use the same custom HEX colour.

Stable Release

• Version 1.0.1 is now the current stable release of Strazer's Player HEX.
• Multiplayer colour synchronization has been tested with multiple clients.
• Player colours, forklift colours, lobby synchronization, gameplay persistence, and automatic join synchronization are working as intended.

1.0.0 — 2026-08-08

Initial Release

• Custom HEX colour support for both player character and forklift.
• Networked colour synchronisation across all modded clients via Mirror NetworkMessage.
• Server-side validation — only the owning player can change their own colour.
• Colour sent only on Apply (not every frame) to minimise bandwidth.
• Use Default button to clear custom colour and return to game's normal colour index.
• HSV colour wheel picker with IMGUI.
• RGB sliders for fine colour adjustment.
• HEX input field with 3-digit and 6-digit shorthand support.
• Live colour preview in the picker window.
• Apply, Reset, and Use Default buttons.
• Copy HEX and Paste HEX via system clipboard.
• Persistent colour storage using BepInEx Config.Bind.
• Configurable toggle key (default: F8) for showing/hiding the UI.
• Single Harmony postfix patch on PlayerColorManager.UpdateRenderers.
• Cached FieldInfo accessors — zero per-frame reflection.
• Vanilla clients see default index-based colours; all players need the mod to see custom HEX colours.