ScriptRunner — MTA Province Script Automation Tool

⚠️ Note: This tool was created as a temporary alternative to AutoHotkey (AHK), which currently does not work in MTA Province.

---

🌟 About

ScriptRunner is a simple GUI-based script automation tool designed for roleplay convenience in MTA:SA Province.
It allows you to store, manage, and paste predefined console commands quickly — especially useful for faction scenarios, documents, and dynamic dialogues.

I'm not a professional developer, so this project was built step-by-step with the help of AI (Qwen & ChatGPT).
I'm sharing it in hopes that others can use, improve, or contribute to it.

❗ I do NOT claim this code is perfect or worthy of "Best Code of the Year" — but I'm open to feedback, optimizations, and contributions!

---

🛠️ How It Works

1. Enter your script in the input field, e.g.:

   do Паспорт в кармане

   me берёт документы

2. Click "Start Script".

3. In MTA:SA, open the console with F8, type =, press Backspace, then paste with Ctrl+V.

4. Press Enter to execute — the next line will be ready for pasting.

5. Use "Skip Line" to skip a command (e.g., for conditional roleplay like "If / Else" scenarios in factions).

---

⚙️ Features

• ✅ Simple GUI for managing scripts
• ✅ Line-by-line pasting into MTA console
• ✅ Skip individual lines during playback
• ✅ Save/load scripts automatically
• 🔧 Easy to extend (feel free to contribute!)

---

⚠️ Known Issues

• ❌ Autosave is unstable — please always set it to Off.
  • Enabling autosave may corrupt your scripts.
• 💾 Scripts are saved in: %appdata%\ScriptRunner\scenarios.json

💡 You can manually back up or edit this file if needed.

---

💡 Want to Help?

I’d really appreciate your help improving this tool! Possible contributions:

• 🔤 Code optimization & refactoring
• 🐞 Bug fixes (especially for autosave)
• 🖼️ UI/UX improvements
• 🧪 Testing on different systems

👉 Open an Issue or Pull Request with suggestions, fixes, or enhancements!

---

📁 Project Origin

• Initial GUI concept generated via Qwen
• Code logic and debugging assisted by ChatGPT
• Iteratively developed for real-world use in MTA Province

---

📄 License

This project is licensed under the MIT License — feel free to use, modify, and distribute.

---

Made with ❤️ by a Province player who just wanted a working AHK alternative.
Let’s make roleplay smoother — together.