Connect YUA's in-game events to XToys devices in real time.
# YUA × XToys Bridge
**把 YUA 大人在游戏中给予的「惩罚」，带到现实。**
**YUA様からゲームの中で与えられた「罰」を、そのまま現実へ。**
**Bring YUA's in-game punishments into the real world.**
---
## 🎀 YUA / よとぎ
🎮 Games / ゲーム
https://yotogi-chan.itch.io/
𝕏 X (Twitter)
https://x.com/yotogi_chan
♡ Ci-en
https://ci-en.dlsite.com/creator/40190
---
# 🇨🇳 中文
**YUA × XToys Bridge** 是为 YUA 的互动游戏制作的非官方 XToys 联动扩展。
YUA 的游戏将普通的对局与她独特的**诱惑、服从、选择和惩罚机制**结合在一起。
YUA 不只是你的对手。
她可能在对局中诱惑你改变选择、考验你是否愿意服从她，或通过特殊事件让你在「听从 YUA」与「违背 YUA」之间作出选择。
而 **YUA × XToys Bridge** 会把这些互动进一步延伸到现实：
**游戏内发生的事件，可以实时转换为 XToys 设备动作。**
目前支持：
- ⚫⚪ 黑白棋：失败时根据输掉的棋子数量计算处罚时间
- 🀄 麻将：失败时根据失点计算处罚时间
- 💜 Temptation：服从 YUA 不处罚；拒绝 YUA 触发处罚
- ⚠️ Cheat Challenge：错误揭发触发处罚
- 👅 Tongue Judgement：交给 YUA 不处罚；选择自己触发处罚
- 👆 Rapid Tap Temptation：每次点击实时触发 XToys Pulse
脚本安装后会自动检测游戏事件，无需每次打开开发者工具或手动执行代码。
本项目不会修改或重新分发 YUA 的游戏代码。它作为独立的浏览器扩展运行，只检测游戏运行过程中产生的状态与互动事件，并将对应信号发送给 XToys。
**如果你是通过这个项目第一次认识 YUA，非常推荐先去体验她的原作。**
这个 Bridge 所做的，只是把 YUA 已经创造出来的游戏体验，从屏幕继续延伸到现实。
---
# 🇯🇵 日本語
**YUA × XToys Bridge** は、YUA様のインタラクティブゲームとXToysを連携させるために制作された、非公式のファン拡張です。
YUA様のゲームでは、通常のゲームプレイに加えて、**誘惑・服従・選択・罰**といった独特のインタラクションを楽しむことができます。
YUA様は、ただの対戦相手ではありません。
対局中にあなたを誘惑したり、YUA様に従うかどうかを試したり、特殊イベントによって
**「YUA様に従うか、それとも逆らうか」**
という選択を迫ることもあります。
**YUA × XToys Bridge** は、その体験をゲーム画面の外へ拡張します。
**ゲーム内で発生したイベントをリアルタイムでXToysへ送り、対応するデバイスの動作へ変換します。**
現在対応しているイベント：
- ⚫⚪ オセロ：敗北時、失った石の数に応じて罰の時間を計算
- 🀄 麻雀：敗北時、失点に応じて罰の時間を計算
- 💜 Temptation：YUA様に従えば罰なし、拒否すると罰
- ⚠️ Cheat Challenge：誤った指摘をすると罰
- 👅 Tongue Judgement：YUA様に任せれば罰なし、自分で選ぶと罰
- 👆 Rapid Tap Temptation：クリックするたびにXToys Pulseをリアルタイム送信
インストール後はゲームイベントを自動的に検出します。毎回Developer Toolsを開いたり、コードを手動で実行したりする必要はありません。
本プロジェクトはYUA様のゲーム本体を改変・再配布するものではありません。独立したブラウザ拡張として動作し、ゲーム中に発生する状態やイベントを検出してXToysへ送信します。
**このプロジェクトをきっかけにYUA様を知った方は、ぜひYUA様の原作も遊んでみてください。**
このBridgeは、YUA様が作り上げた体験を、ゲームの世界から現実へもう一歩だけ広げるためのものです。
---
# 🇬🇧 English
**YUA × XToys Bridge** is an unofficial fan-made extension that connects YUA's interactive games with XToys.
YUA's games combine normal gameplay with her distinctive mechanics built around **temptation, obedience, choice, and punishment**.
YUA isn't simply your opponent.
She may tempt you into changing your move, test whether you're willing to obey her, or introduce special events that force you to choose between **following YUA or going your own way**.
**YUA × XToys Bridge** extends that experience beyond the screen.
**In-game events can be translated into real-time XToys device actions.**
Currently supported:
- ⚫⚪ Othello: punishment duration is calculated from the number of lost squares
- 🀄 Mahjong: punishment duration is calculated from points lost
- 💜 Temptation: follow YUA for no punishment; refuse YUA to trigger punishment
- ⚠️ Cheat Challenge: an incorrect accusation triggers punishment
- 👅 Tongue Judgement: leave the choice to YUA for no punishment; choose for yourself to trigger punishment
- 👆 Rapid Tap Temptation: every tap sends an XToys Pulse in real time
Once installed, the userscript automatically detects supported game events. There is no need to open Developer Tools or manually run code every time you play.
This project does **not** modify or redistribute YUA's game code. It runs independently in the browser, observes gameplay states and interaction events, and forwards the corresponding signals to XToys.
**If this project is your first introduction to YUA, please check out and support her original work.**
This Bridge simply takes the experience YUA created and extends it one step further—from the game world into the real world.
---
## ⚙️ Requirements / 必要环境 / 必要なもの
- Tampermonkey or another compatible userscript manager
- XToys
- XToys Webpage Monitor
- A compatible device configured in XToys
**XToys Script / preset is coming soon.**
For now, XToys Webpage Monitor must be configured manually.
---
## ⚠️ Safety
Please configure device intensity, duration, and limits according to your own equipment and personal limits.
Use connected devices only with informed consent and ensure that the experience can be stopped immediately when necessary.
---
## Credits
**Original game & characters / 原作 / ゲーム：YUA / よとぎ**
YUA × XToys Bridge is an unofficial fan-made integration.
