Skip to content

QUICKSTART.md

Latest commit

 

History

History
167 lines (129 loc) · 4.63 KB

QUICKSTART.md

File metadata and controls

167 lines (129 loc) · 4.63 KB

Quick Start Guide - Slots And Daggers Accessibility Mod

⚡ Fast Setup (5 Steps)

1️⃣ Install MelonLoader

1. Download: https://github.com/LavaGang/MelonLoader/releases
2. Run installer → Point to: E:\Games\Slots.and.Daggers.v1.0.19\Slots and Daggers.exe
3. Wait for installation to complete

2️⃣ Update DLL References

Edit: E:\Game codes\Slots And Daggers\AccessibilityMod\SlotsAndDaggersAccessibilityMod.csproj

Change all <HintPath> entries to match your actual DLL locations.

Example:
<HintPath>E:\Games\Slots.and.Daggers.v1.0.19\MelonLoader\MelonLoader.dll</HintPath>

3️⃣ Build the Mod

cd "E:\Game codes\Slots And Daggers\AccessibilityMod"
dotnet build SlotsAndDaggersAccessibilityMod.csproj -c Release

Output will be at:

E:\Game codes\Slots And Daggers\AccessibilityMod\bin\Release\net6.0\SlotsAndDaggersAccessibilityMod.dll

4️⃣ Deploy Files

Copy mod to Mods folder:

SlotsAndDaggersAccessibilityMod.dll → E:\Games\Slots.and.Daggers.v1.0.19\Mods\

Copy TOLK dependencies to game root:

E:\Game codes\Slots And Daggers\Tolk.dll → E:\Games\Slots.and.Daggers.v1.0.19\
E:\Game codes\Slots And Daggers\nvdaControllerClient32.dll → E:\Games\Slots.and.Daggers.v1.0.19\
E:\Game codes\Slots And Daggers\nvdaControllerClient64.dll → E:\Games\Slots.and.Daggers.v1.0.19\

5️⃣ Install Screen Reader & Play

Get NVDA (free):

Download: https://www.nvaccess.org/download/
Install and start NVDA
Launch Slots and Daggers

You should hear: "Slots And Daggers Accessibility Mod loaded successfully"

🎮 How to Play

Menu Navigation

  • Tab/Arrow Keys - Move between menu items
  • Enter/Space - Activate button
  • Each button announces its name when focused

During Gameplay

  • Listen for state changes: "Your turn", "Enemy turn", etc.
  • Spin results are announced: Attack damage, healing, coins, shields
  • Health status announced: After combat, healing, or damage
  • Enemy info announced: Name, health, when defeated

Example Announcements

"Main Menu"
"New Game, button"
"Your turn. Spin the slots."
"Attack symbol. Physical damage: 45. Magical damage: 30. Critical hit, triple damage!"
"Took 20 damage. Health: 80 out of 100"
"Enemy defeated!"
"Victory! You won!"

❌ Troubleshooting

Build Fails

  • Check DLL paths in .csproj file
  • Make sure MelonLoader is installed
  • Verify .NET 6.0 SDK installed: dotnet --version

Mod Doesn't Load

  • Check: E:\Games\Slots.and.Daggers.v1.0.19\MelonLoader\Latest.log
  • Verify mod DLL is in Mods folder
  • Make sure MelonLoader console appears on game start

No Speech

  • Start screen reader BEFORE launching game
  • Check Tolk.dll is in game root (not Mods folder)
  • Try NVDA specifically (most compatible)
  • Verify Windows audio is working

Game Crashes

  • Check MelonLoader log for errors
  • Try removing mod temporarily
  • Verify game version is v1.0.19

📁 File Locations Checklist

E:\Games\Slots.and.Daggers.v1.0.19\
├── Slots and Daggers.exe
├── Tolk.dll                              ✅ Required here
├── nvdaControllerClient32.dll            ✅ Required here
├── nvdaControllerClient64.dll            ✅ Required here
├── MelonLoader\
│   ├── MelonLoader.dll
│   ├── 0Harmony.dll
│   ├── Latest.log                        📝 Check for errors
│   └── Managed\
│       ├── Assembly-CSharp.dll
│       ├── UnityEngine.dll
│       └── ... (other Unity DLLs)
└── Mods\
    └── SlotsAndDaggersAccessibilityMod.dll  ✅ Required here

🎯 What You Get

✅ Complete Menu Navigation ✅ All Game Phases Announced ✅ Combat Information (Damage, Health, Shields, Coins) ✅ Enemy Details ✅ Critical Hits & Special Events ✅ Level & Equipment Selection ✅ Power-ups ✅ Victory/Defeat Notifications

📚 More Help

  • Full Documentation: See README.md
  • Detailed Setup: See INSTALLATION_GUIDE.md
  • Technical Info: See PROJECT_SUMMARY.md

🔧 One-Command Build (if paths are correct)

cd "E:\Game codes\Slots And Daggers\AccessibilityMod"
dotnet build -c Release
Copy-Item "bin\Release\net6.0\SlotsAndDaggersAccessibilityMod.dll" "E:\Games\Slots.and.Daggers.v1.0.19\Mods\" -Force
Copy-Item "..\Tolk.dll" "E:\Games\Slots.and.Daggers.v1.0.19\" -Force
Copy-Item "..\nvdaControllerClient*.dll" "E:\Games\Slots.and.Daggers.v1.0.19\" -Force
Write-Host "Deployment complete!" -ForegroundColor Green

Ready to play? Start your screen reader and launch the game! 🎮🔊