FastCosmeticGacha

COMPATIBLE WITH COSMETICS UPDATE V0.4.0.

FastCosmeticGacha

This mod is a client-only mod that speeds up cosmetic gacha animations and supports rapid queued gacha use.

Overview

FastCosmeticGacha shortens the cosmetic token gacha flow without changing reward contents, token consumption rules, or cosmetic unlock logic.

It can speed up token insertion, reward display, spin waits, confetti waits, return-to-idle timing, and repeated gacha use.

When only a participant has the mod, the main effect is local visual speed-up.

When the host has the mod, the gacha machine state itself can progress faster, and queued multi-use requests can be processed rapidly for the room.

Main Features

• Speeds up cosmetic gacha animations
• Supports SpeedMode values: Vanilla, Fast, VeryFast, Instant
• Shortens state timers without skipping reward-confirmation states
• Keeps cosmetic unlock and currency reward logic unchanged
• Supports queued gacha requests while the machine is busy
• Supports rapid E presses for repeated gacha reservations
• Supports multiple players pressing the gacha machine almost at the same time through a host-side queue
• Resets animator speed when the machine returns to idle
• Uses reflection-based patching to avoid compile-time dependency on cosmetic gacha class names

Client / Host Behavior

This is a client-only mod, but some behavior depends on who has it installed.

| Installed player | Behavior |

|---|---|

| Participant only | Local animation speed-up only. The actual machine return-to-idle timing remains host-dependent. |

| Host only | The machine state can progress faster for the whole room. Queued requests can also be processed by the host. |

| Host and participants | Best result. The room state progresses faster and each player also gets fast local visuals. |

Queued Multi-Use Behavior

The cosmetic gacha machine internally handles one active interaction at a time.

For that reason, this mod does not force true parallel reward processing.

Instead, when multiple players press the machine while it is busy, requests are stored in a queue and processed quickly after the machine becomes ready again.

This avoids reward desync, broken token consumption, and incorrect reward display targets.

Rapid E Press Behavior

If rapid input is enabled, pressing E repeatedly while the machine is busy can reserve additional gacha attempts.

The mod limits queued requests per player and total queue size to avoid accidental infinite reservation.

Configuration

The config file is generated at:

BepInEx/config/REPOJP.FastCosmeticGacha.cfg

General

| Setting | Description | Default | Min | Max |

|---|---|---:|---:|---:|

| Enable | Enables or disables the mod. | true | false | true |

| ShowDebugLog | Outputs debug logs to the BepInEx console. | false | false | true |

Speed

| Setting | Description | Default | Min | Max |

|---|---|---:|---:|---:|

| SpeedMode | Selects the speed profile. Valid values: Vanilla, Fast, VeryFast, Instant. | Fast | Vanilla | Instant |

| AnimatorSpeedMultiplier | Multiplies cosmetic gacha animator speed. | 3.0 | 1.0 | 20.0 |

| StateTimerMultiplier | Multiplies gacha state wait timers. Smaller values are faster. | 0.35 | 0.01 | 1.0 |

Skip

| Setting | Description | Default | Min | Max |

|---|---|---:|---:|---:|

| SkipTokenOutro | Shortens the token outro animation. | true | false | true |

| SkipSpinWait | Shortens spin-related wait states. | true | false | true |

| SkipSEWait | Shortens wait time caused by sound/effect event timing. | true | false | true |

| SkipConfettiWait | Shortens the cosmetic confetti wait. | false | false | true |

| InstantResult | Uses the fastest safe result display flow. | false | false | true |

Result

| Setting | Description | Default | Min | Max |

|---|---|---:|---:|---:|

| CosmeticResultDisplaySeconds | Cosmetic reward display time. | 1.0 | 0.05 | 10.0 |

| CurrencyResultDisplaySeconds | Currency reward display time. | 0.75 | 0.05 | 10.0 |

| ReturnToIdleSeconds | Delay before returning