客户操作指南Customer User Guide
游戏设置指南Game setup guide

Red Packet

限时红包雨游戏：玩家消耗 token 开始一局，在倒数结束前点击下落物件累积分数。掉落顺序与可点击时间由服务器预先生成，最终分数由服务器重新计算，再按 Score 门槛决定奖励。A timed red-packet rain game. The player spends tokens to start a round and taps falling items before time expires. The server pre-generates the drop sequence and catch windows, recomputes the final score, then selects a reward by Score threshold.

开始前先准备Before you start

先确认活动规则、奖励资料和图片，准备好再开始设置，过程会顺很多。Confirm the campaign rules, reward details and artwork before you begin so the setup goes smoothly.

奖励资料Reward details奖励名称、金额、概率/门槛、Promotion ID 或领取链接。Reward name, amount, probability/threshold, Promotion ID or claim link.
活动规则Campaign rules开始/结束时间、时区、每日次数、每人领取上限。Start/end time, timezone, daily plays and per-user claim limit.
桌面与手机素材Desktop and mobile assetsLogo、背景、按钮、结果图片及音效。Logo, backgrounds, buttons, result artwork and sounds.
设置前先确认CONFIRM BEFORE SETUP

Start Time

Start Time 决定系统从哪个时间开始计算玩家的 deposit。开始设置前，先确认活动要从哪一天、几点开始计算。Start Time decides when player deposits begin to count. Before setting up, confirm the exact date and time from which the campaign should calculate deposits.

  • 时间设得太早或太迟，计算到的 deposit 范围会不同，玩家可能拿到过多或过少的 token。If the time is too early or too late, a different deposit range may be counted and players may receive too many or too few tokens.
  • 第一次使用现有 Setting 前，也要先检查 Start Time 是否正确。Check Start Time before using an existing Setting for the first time as well.
  • Setting 已经开始使用后，不要随意修改；不确定时先向负责人确认。Do not change it casually after the Setting is already in use. Confirm with the person in charge when unsure.
日常修改ROUTINE CHANGES

现有 Setting 修改流程How to update an existing Setting

一般直接修改现有 Setting 就可以。Add Game Setting 只在建立新活动时使用，现有 Setting 的 Start Time 不要更改。In most cases, update the existing Setting. Use Add Game Setting only for a new campaign, and do not change the Start Time of an existing Setting.

  1. 开启 Maintenance ModeTurn on Maintenance Mode

    从左侧菜单进入 Maintenance Mode，把开关设为 ON。设置期间玩家会先看到维护页面。Open Maintenance Mode from the left menu and set it to ON. Players will see the maintenance page while changes are being made.

  2. 打开正在使用的 SettingOpen the Setting currently in use

    进入 Game Settings，按名称找到要修改的项目，再点击 Edit 或蓝色铅笔。确认 Name 正确，并保留原本的 Start Time。Open Game Settings, find the item by name, then click Edit or the blue pencil. Confirm the Name and keep the existing Start Time.

  3. 调整 Deposit 和 tokenAdjust Deposit and tokens

    按照活动要求调整 Deposit Calculation Method、Deposit Per Token、Min Deposit Threshold、Token Per Round 或免费 token。各字段的用途可参考下方“主要设置”。Adjust Deposit Calculation Method, Deposit Per Token, Min Deposit Threshold, Token Per Round or free tokens based on the campaign requirements. See Key settings below for field details.

    查看主要设置View Key settings
  4. 调整游戏规则和奖励Adjust game rules and rewards

    设置 Rain Duration、每日次数、Drop Items 的 Points / Probability，以及 Reward Rules 的 Score 门槛。Drop Item Probability 是掉落权重；Reward Rule Probability 是 Minimum Score，不要把 Reward Rule 数值加起来凑 100%。Set Rain Duration, daily plays, Drop Item Points / Probability and Reward Rule Score thresholds. Drop Item Probability is a drop weight; Reward Rule Probability is the Minimum Score. Do not total Red Packet Reward Rule values to 100%.

    查看配置例子View an example
  5. 保存后再检查一次Save and check again

    点击 Save，回到列表后再打开同一个 Setting，确认刚才填写的数值、奖励和图片都已保存。Click Save, return to the list and reopen the same Setting to confirm the values, rewards and images were saved.

  6. 关闭 Maintenance ModeTurn off Maintenance Mode

    确认正确的 Setting 已设为 Active，再关闭 Maintenance Mode。最后打开真实游戏链接，检查页面、用户资料和 token 是否正常。发现异常时，先重新开启 Maintenance Mode，再联系管理员。Confirm the correct Setting is Active, then turn off Maintenance Mode. Open the real game link and check the page, user details and tokens. If anything is wrong, turn Maintenance Mode back on and contact your administrator.

只有需要建立全新 Setting 时才打开这里Open this only when creating a new Setting展开查看View details收起Close

新增 SettingCreate a new Setting

一般调整不需要按 Add Game Setting。只有管理员要求建立新的活动版本，或当前完全没有 setting 时才使用。Routine changes do not require Add Game Setting. Use it only when an administrator requests a new campaign version or when no setting exists.

  1. Add Game Setting

    进入 Game Settings 后点击 Add Game Setting。新项目先保持 Inactive，避免未完成的设置直接给玩家使用。Open Game Settings and click Add Game Setting. Keep the new item Inactive so players cannot use an unfinished setup.

  2. Basic Settings

    填写容易识别的 Name、完整 Homepage Link 和清楚的 Description。需要自定义外观时才填写 Custom CSS。Enter a recognisable Name, complete Homepage Link and clear Description. Use Custom CSS only when custom styling is required.

  3. 完成页面设置Complete the page setup

    再按照本页“主要设置”完成 Deposit、token、奖励规则、图片和音效。保存后重新打开检查。Then use Key settings on this page to complete Deposit, tokens, reward rules, images and sounds. Reopen the item after saving to check it.

主要设置Key settings

这里整理了平时最常用的字段。先确认活动要求，再按对应说明填写。These are the fields used most often. Confirm the campaign requirements before entering the values.

Token Per Round / Max RedPacket Per Day

怎样设置How to set it
  • Token Per Round 是每开始一局立即扣除的 token。
  • Max RedPacket Per Day 限制玩家每天最多开始多少局；每日计数按 round 计算，不论该局最后有没有中奖。
  • 填 0 或没有设置上限时不会执行每日次数限制。
  • Token Per Round is deducted when a round starts.
  • Max RedPacket Per Day caps the number of rounds a player may start each day.
  • The daily counter counts rounds whether or not they later win.
  • A zero/unset cap does not enforce the daily play limit.

Rain Duration

怎样设置How to set it
  • 控制一局红包雨持续多久。
  • Runtime 会把数值限制在 5 至 120 秒；没有有效设置时使用 20 秒。
  • 这个时间同时用于前台倒数、掉落节奏和服务器结算时间检查。
  • Controls the length of the rain round.
  • Runtime clamps the value to 5–120 seconds and defaults to 20 seconds.
  • The same duration drives the frontend countdown, drop schedule and server settlement timing.

Drop Items · Points / Probability

怎样设置How to set it
  • Drop Items 决定红包雨会掉什么。
  • Points 是点到该物件时加减的分数；正数加分，负数是 penalty。
  • 这里的 Probability 是该物件出现的掉落权重，不是最后奖励中奖率。
  • 没有自定义 Drop Items 时，系统使用 Red Packet +1（70）与 Bomb -3（30）的内建默认值。
  • 可为物件上传图片；没有图片时会显示内建红包或炸弹图案。
  • Drop Items define what falls.
  • Points add to or subtract from the score; negative values are penalties.
  • Probability here is the item’s drop weight, not the final reward probability.
  • Without custom Drop Items, the built-in defaults are Red Packet +1 at weight 70 and Bomb -3 at weight 30.
  • Uploaded artwork may replace the built-in packet/bomb face.

Reward Rules · Minimum Score

怎样设置How to set it
  • Red Packet 的 Reward Rules 与一般概率游戏不同。
  • 这里显示为 Probability 的字段实际上储存「最低 Score 门槛」，不要把这些数值加起来凑 100%。
  • 结算时系统选择玩家已达到的最高门槛。
  • 例如门槛 1、3、5，玩家最终 4 分会取得 3 分那一档；低于第一档时没有奖励。
  • Red Packet Reward Rules are different from probability-based games.
  • The field labelled Probability stores the minimum Score threshold and must not be totalled to 100%.
  • Settlement chooses the highest threshold the player has reached.
  • With tiers at 1, 3 and 5, a final score of 4 receives the 3-point tier; a score below the first tier receives no reward.

Server-side Round / Settlement

怎样设置How to set it
  • 开始游戏时服务器先固定本局的掉落顺序、每个物件的 fall time 和 item 分数，再把 round 保存为 pending。
  • 前端只回传实际点击的 drop index 与点击时间。
  • 结算时服务器会检查玩家、round ownership、完整游戏时间、重复 settle、掉落 index 和点击时间窗口，然后重新计算权威 Score，因此不能只相信前端显示分数。
  • When play starts, the server fixes the drop sequence, fall times and item score snapshot and stores the round as pending.
  • The client reports only caught drop indexes and tap times.
  • Settlement verifies the player, round ownership, elapsed duration, duplicate settlement, drop index and catch window before recomputing the authoritative Score.

Reward Delivery / Result

怎样设置How to set it
  • 达到门槛后，Reward Type 决定实际发放内容，例如 Link、Promotion ID、Token Reward、其他 Mini Game Token 或会员 Coupon。
  • 系统会先写入 Game Results，并在结算流程中立即尝试兑换；Reward Popup、延迟、Win/Lose Sound 只影响玩家看到的结果体验，不会改变最终 Score。
  • After a threshold is reached, Reward Type controls delivery, such as Link, Promotion ID, Token Reward, another Mini Game token or membership coupon.
  • The result is written to Game Results and redemption is attempted during settlement.
  • Reward Popup, delay and win/lose sounds affect presentation only and do not change the final Score.

Images / Colours / Lists / Sounds

怎样设置How to set it
  • Logo、Desktop/Mobile Background、Background/Font/Primary/Secondary/Accent Color 控制前台外观。
  • Tap、Win、Lose Sound 控制音效。
  • Prize List 显示可领取奖励，Winner List 显示近期中奖记录；这些显示设置不会改变掉落权重、Score 或 Reward Rule 门槛。
  • Logo, desktop/mobile backgrounds and Background/Font/Primary/Secondary/Accent colours control appearance.
  • Tap, Win and Lose sounds control audio.
  • Prize List shows available rewards and Winner List shows recent wins.
  • These presentation settings do not alter drop weights, Score or Reward Rule thresholds.

配置例子Worked example

例子 1：设置方式Example 1: setup

  • 例：Token Per Round 1、Max RedPacket Per Day 10、Rain Duration 20 秒。
  • Drop Items 使用 Red Packet +1 / weight 70 与 Bomb -3 / weight 30。
  • Reward Rules 设 Score 1 = 小奖、Score 3 = 中奖、Score 5 = 大奖。
  • 玩家最终 4 分时取得 Score 3 的中奖；这些 1、3、5 是门槛，不是 1%+3%+5%。
  • Example: Token Per Round 1, Max RedPacket Per Day 10 and Rain Duration 20 seconds.
  • Use Red Packet +1 at weight 70 and Bomb -3 at weight 30.
  • Set reward tiers at Score 1 for a small reward, Score 3 for a medium reward and Score 5 for a large reward.
  • A final score of 4 receives the Score-3 tier.
  • The values 1, 3 and 5 are thresholds, not percentages.

例子 2：实际检查Example 2: practical check

  • 先记录测试用户目前的 token，再开始一局。
  • 确认开始后只扣一次 Token Per Round。
  • 游戏结束时记下最终 Score，并到 Game Results 对照奖励名称。
  • 再测试一个低于第一档门槛的 Score，确认不会错误发奖。
  • Note the test user’s current token balance before starting a round.
  • Confirm Token Per Round is deducted exactly once when the round starts.
  • At the end, note the final Score and compare the reward name with Game Results.
  • Also test a score below the first tier and confirm that no reward is issued incorrectly.

Auto Reset Setting · 自动重置Auto Reset Setting

需要定期把玩家 token 或尚未转换的存款归零时，才开启 Auto Reset。只选择需要重置的项目即可。Use Auto Reset only when player tokens or unconverted deposits need to return to zero on a schedule. Select only the items that should be reset.

Auto Reset Setting

Enable Auto Reset

打开后，重置项目、周期和开始时间才会出现。关闭时系统不会执行自动重置。

Turn this on to reveal the reset options, frequency and start time. When it is off, no automatic reset runs.

Reset Token

开启后，每次到达重置时间，系统会把玩家在这个游戏里的 Token／游玩计数归零。若您要保留玩家现有 Token，请保持关闭。

When enabled, the player’s token/play count for this game is set to zero at each reset. Leave it off if current tokens must be retained.

Reset Remaining Deposit

开启后，每次重置会把玩家尚未转换成 Token 的 Remaining Deposit 归零。已经转换或已经领取的记录不会因为这个开关重新计算。

When enabled, any Remaining Deposit not yet converted into tokens is cleared at each reset. Previously converted or claimed records are not recalculated by this option.

Reset Frequency

Daily 每 1 天、Weekly 每 7 天、Monthly 每 1 个月执行一次。周期从您填写的 Recorded Start Time 开始计算。

Daily runs every day, Weekly every seven days and Monthly every month. The schedule is calculated from the Recorded Start Time.

Reset Recorded Start Time

填写自动重置周期的起点。开启 Auto Reset 后，这个时间与 Reset Frequency 都是必填；Next Reset Time 会显示下一次执行时间。

Set the starting point of the reset schedule. When Auto Reset is enabled, this field and Reset Frequency are required. Next Reset Time shows the next scheduled run.

怎样选择Which options to choose

只想定期清除 Token：仅开启 Reset Token。只想清除未转换存款：仅开启 Reset Remaining Deposit。两项都需要清除时才同时开启。

For token clearing only, enable Reset Token. For unconverted deposits only, enable Reset Remaining Deposit. Enable both only when both values should be cleared.