Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
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.
By Aartyns
| Last updated | a day ago |
| Total downloads | 266 |
| Total rating | 0 |
| Categories | Tools Client-side Cosmetics AI Generated Quality Of Life |
| Dependency string | Aartyns-FastTokenDraw-1.0.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
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).