Gift Rank（Gift Counter）

Gift Rank is a real-time gift voting progress widget, suitable for gift crowdfunding goal tracking, gift challenges, multi-gift progress comparisons, and other scenarios where "viewers can直观 see the progress of gifts sent".

Layout

The Gift Rank interface can be divided into 2 areas:

Widget Preview: Real-time preview of the widget display
Configuration: Set timer, display options, and gift list

The left side is the preview area. Any configuration changes are immediately reflected in the preview.

The right side is the configuration area, containing three sections: Timer, Display, and Gift List.

Configuration

Timer

Option	Purpose	When to change	Notes
`Off`	No countdown	When no time limit is needed (default)	-
`10min`	Fixed 10-minute countdown	Short-to-medium paced interactions	-
`30min`	Fixed 30-minute countdown	Longer interactions	-
`Custom`	Enter custom seconds	When non-standard durations are needed	Minimum `10` seconds

Countdown and Operations

The countdown only decrements when the counter is running. Pausing or resetting will pause or restore the countdown.

When the countdown reaches zero, the counter automatically ends and stops accumulating.

After Reaching Target

Set the action the counter automatically performs when a gift's count reaches its target value.

Option	Meaning
`Stop Counting`	Stop accumulating this gift's count after reaching the target
`Keep Counting`	Keep accumulating after reaching the target; the count may exceed the target
`Reset Counter`	Reset the counter after reaching the target
`Increase Target`	Automatically raise the target value after reaching the target to extend the challenge
`Double Target`	Automatically double the target value after reaching the target
`Hide`	Hide this gift in the widget after reaching the target

Cannot Be Modified While Running

This configuration cannot be modified while the counter is running. To adjust it, first Reset.

Display

Option	Purpose	When to change	Notes
`Progress Mode`	Choose the progress bar text format	-	Three modes: `Value + Percent` (e.g. 50/100 (50%)), `Value Only` (e.g. 50/100), `Percent Only` (e.g. 50%)
`Show Gift Name`	Display each gift's custom name in the widget	When there are many gifts and viewers need to distinguish them	Turning this off switches to compact layout, using less space
`Show Gift Value`	Display the diamond value of gifts in the widget	-	-
`Show Contributor Rank`	Display total progress and top 3 contributors' avatars at the bottom of the widget	When you want to encourage viewer competition	-

Gift List

Option	Purpose	When to change	Notes
`Gift Icon`	Click to change the gift for this row	-	Replacing a gift with existing count data requires confirmation
`Gift Name`	Set a custom display name for the gift (only visible when `Show Gift Name` is enabled)	-	Auto-saves when input loses focus
`Current / Target`	Shows the current accumulated value and target value for this gift	-	Click to manually adjust (see below)
`Show / Hide`	Control whether this gift is displayed in the widget	When you temporarily don't want a gift in the widget	Hiding only affects display; counting continues
`Delete`	Remove this gift row	-	Confirmation required before deletion
`Drag to Reorder`	Drag the `::` handle on the left to adjust display order in the widget	-	Only one drag operation at a time
`Add Gift`	Add a new gift row	-	Maximum `8` gifts; no duplicate gifts allowed

Maximum 8 Gifts

Each counter can have up to 8 gifts configured. If you need to track more gifts, consider splitting them across multiple presets.

Manual Value Adjustment

Click the Current / Target area of a gift row to open the value adjustment dialog:

Current Value: Enter a new current value directly, or use quick buttons +1, +10, +100
Target Value: Enter a new target value directly

When to Manually Adjust

Common scenario: A streamer promises "an extra 100 votes" during the live. You can manually adjust the current or target value without waiting for viewers to actually send the corresponding gifts.

Operations

After configuration, use the action buttons at the bottom to control the counter:

Action	Meaning	Description
`Start`	Start the counter, begin receiving gift data	If countdown is enabled, it starts simultaneously
`Pause`	Pause the counter, stop receiving gifts and countdown	Existing count data is preserved
`Reset`	Reset all gifts' current values to zero	Confirmation required before resetting

Broadcast Tool Setup

Copy the Gift Counter widget link via Copy URL and load it into your broadcast tool (OBS / Live Studio).

All configuration changes (adding/removing gifts, reordering, modifying target values, etc.) sync to the widget in real-time without needing to copy the link again.

Tips

Keep gift names short and clear, like "Group Dance", "Penalty", "Overtime", etc., so viewers can quickly understand each progress item
If you only need to track one gift's progress, just add one gift — the widget will display in a more compact format
Enabling Show Contributor Rank can effectively encourage competition among viewers