
FastTokenDraw
可快速批量抽取服饰币并开关动画,且保证数量正确不遗漏,珍惜生命 节省时间!Draw cosmetic tokens in bulk with one keypress. Animation skip is optional, and a reset switch aborts a running batch on demand. Token accounting stays exact: no token is ever created or lost.Fast Token Draw
Bulk-draw cosmetic tokens from the cosmetic shop machine, with an optional animation skip.
Every token is still consumed one by one — the mod only changes how fast the flow runs and how many tokens are queued, never the accounting.
Contact
- Email: [email protected]
- QQ: 670155978
中文说明
在服饰币抽奖机前按交互键,一次性抽完指定数量的服饰币;抽奖动画可关可留。
每一枚服饰币依然严格遵循原版规则:消耗一枚 → 判定一枚 → 结算一枚。模组只改变「流程跑多快」和「一次排多少个币」,不改动任何数值口径。
配置项
配置文件位于 BepInEx/config/com.fasttokendraw.repo.cfg。
| 配置项 | 默认值 | 说明 |
|---|---|---|
General.Enabled |
true |
模组总开关。关闭后完全恢复原版行为。 |
General.DisableDrawAnimation |
false |
true = 关闭抽奖动画,一次按下键即把全部结果结算完毕;false = 保留原版动画。 |
General.DrawCount |
1 |
一次性抽奖数量,最小 1,最大 999。若该值大于当前持有的服饰币数量,则按实际持有量抽取。 |
General.AbortDraw |
false |
重置按钮。切换为开启即立刻中止正在播放的抽奖动画与整批连抽,尚未抽取的服饰币不会被消耗;执行后本项自动变回 false。 |
Debug.VerboseLog |
false |
在控制台输出每一次抽取的稀有度与饰品名。 |
数值守恒(重点)
- 扣币只走一处:所有抽取结束后,按「实际消耗枚数」从
cosmeticTokens尾部一次性移除同等数量的元素,绝不多扣、绝不重复扣。 - 抽到饰品:写入解锁列表(与官方
CosmeticUnlock完全一致的口径),然后扣 1 枚币。 - 该稀有度饰品池已抽空:与原版逻辑一致,按稀有度折算金币(普通 2 / 优秀 4 / 稀有 8 / 传说 15)计入本局货币,然后扣 1 枚币——币不会凭空消失。
- 不是主机且需要折算金币:该枚币不结算、不消耗,流程立即停止,避免服饰币人间蒸发。
- 保留动画模式下玩家离开机器:自动连抽立刻中止,剩余未抽的币原样留在身上。
- 点「重置」(
General.AbortDraw):正在播放的抽奖动画被打断、剩余排队连抽被撤销,机器回到待机;尚未抽取的币一枚不少。已结算的那一枚(币已扣、饰品或金币已到账)保持有效,不会回滚。 - 不会凭空产生:本模组没有任何「加币」路径,
DrawCount只表示期望值,实际抽取数永远受min(DrawCount, 当前持有量)约束。
两种模式的行为差异
| 模式 | 触发 | 表现 |
|---|---|---|
关闭动画(true) |
按一次交互键 | 一帧内完成全部结算,不播放机器动画;币与饰品立刻到账。 |
保留动画(false) |
按一次交互键 | 先完整播放一次原版抽奖动画,机器回到待机后自动投下一枚,直到抽满或玩家离开。 |
中止正在进行的连抽
保留动画模式下抽很多枚时要等全套动画播完。想中途叫停,把配置项 General.AbortDraw 打开(即可视为「重置」按钮):
- 正在播放的抽奖动画立刻中断,机器回到待机;
- 后续排队的连抽全部撤销;
- 尚未抽取的服饰币不被消耗;
- 开关自身立刻弹回关闭状态,可再次点击。
用配置管理器(ConfigurationManager)时它就是一个勾选框,点一下即生效。
多人游戏
- 抽奖判定与共享金币统计沿用原版权限:需要主机裁决。非主机发起时由主机执行,与原版单抽一致。
- 主机侧的连抽同样受
DrawCount约束。
安装
- 已安装 BepInEx 5(
BepInEx-BepInExPack-5.4.2100)。 - 将
FastTokenDraw.dll放入BepInEx/plugins/目录(可建子文件夹)。 - 启动游戏,配置会在首次启动后生成。
卸载
删除 BepInEx/plugins/ 下的 FastTokenDraw.dll 即可,存档不受影响。
English
What it does
Stand in front of the cosmetic shop machine and press Interact once. Instead of a single draw, the mod performs DrawCount draws in a row — either with the original animation, or instantly if you disable it.
The accounting is intentionally boring: one token in, one result out, every single time.
Configuration
BepInEx/config/com.fasttokendraw.repo.cfg
| Key | Default | Meaning |
|---|---|---|
General.Enabled |
true |
Master switch. When off, the game behaves exactly like vanilla. |
General.DisableDrawAnimation |
false |
true resolves the whole batch in a single frame without the machine animation. |
General.DrawCount |
1 |
How many tokens to draw at once (min 1, max 999). Clamped to the amount you actually own. |
General.AbortDraw |
false |
Reset button. Flip it on to abort the running animation and the whole queued batch immediately; unspent tokens stay untouched. It flips itself back to false right after firing. |
Debug.VerboseLog |
false |
Logs the rarity and cosmetic name of every draw. |
Token accounting guarantees
- Tokens are removed from
cosmeticTokensin exactly one place, in a single batch, matching the number of draws that actually resolved. - A draw that unlocks a cosmetic writes to the unlock list the same way the vanilla
CosmeticUnlockdoes. - When a rarity pool is exhausted, the token is converted into run currency exactly like vanilla (Common 2 / Uncommon 4 / Rare 8 / UltraRare 15).
- On a non-host client, a token that would need currency conversion is left untouched and the batch stops — no silent loss.
- In animated mode, leaving the machine cancels the remaining draws and keeps the unspent tokens.
- Firing
General.AbortDrawbreaks the playing animation, drops the queued draws and puts the machine back to idle; unspent tokens are kept. The draw that already settled (token consumed, cosmetic or currency granted) stays settled and is never rolled back. - There is no code path that creates tokens.
DrawCountis a request, never a grant.
Aborting a running batch
With the animation kept on, a big DrawCount means waiting through every animation. Turn General.AbortDraw on (treat it as a reset button):
- the animation that is currently playing stops at once and the machine returns to idle;
- every queued draw is dropped;
- unspent tokens are not consumed;
- the switch flips itself back to
falseso it can be pressed again.
Under ConfigurationManager it shows up as a plain checkbox — one click is enough.
Multiplayer
Host authority is respected: the host resolves the draw and the shared currency, just like vanilla.
Install
Drop FastTokenDraw.dll into BepInEx/plugins/. Requires BepInEx 5 (BepInEx-BepInExPack-5.4.2100).