ArkLights: Lightning‑Fast Arknights Helper App (Open‑Source)
ArkLights: The Ultimate Open‑Source Companion for Arknights
Arknights—a rising mobile strategy title set in a dystopian world—has a vast roster of operators, skills, and missions. For players who crave efficiency, ArkLights offers a fully‑managed, lightning‑fast helper that removes repetitive manual steps and delivers data‑driven insights. Written primarily in Lua with supplementary Python utilities, ArkLights runs on Windows, macOS, and Linux, and can be self‑hosted or used via its public web front‑end.
What Does ArkLights Do?
| Core Feature | What It Saves You | How It Works |
|---|---|---|
| Skill Tracking | Track and analyze skill usage and cooldowns | Parses game data files and logs usage via Lua scripts |
| Recruitment Calculator | Predict guaranteed operator drops | Uses the official recruit data and applies the 100‑point guarantee logic |
| Mission Planner | Plan optimal paths for missions | Combines building icons and coordinates extracted with ArkAssetsTool |
| Automation UI | Automate repetitive UI tasks | Uses Lazy Man Spirit IDE scripting and hot‑keys |
| Cloud Sync | Keep your data online | Optional HTTPS endpoint that uploads metrics |
The repository hosts all the logic, a web UI, and a set of helper scripts for asset extraction. Because the tool’s core is open‑source, you can audit the logic, tweak scripts for personal preferences, or propose new features via pull requests.
Getting Started
1. Prerequisites
- Windows/Linux/macOS with Python 3.9+ installed.
- Git for cloning the repository.
- (Optional) Node.js if you plan to run the web front‑end locally.
Tip: ArkLights ships with a small installer bundle for Windows (
ArkLights.Setup.exe). Skip manual installation if you prefer.
2. Clone the Repository
git clone https://github.com/AegirTech/ArkLights.git
cd ArkLights
3. Install Dependencies
python -m pip install -r requirements.txt
Dependencies include requests, flask, and a few Lua‑binding packages.
4. Run the Application
python main.py
The API starts on http://127.0.0.1:5000. Open the provided main.ui or navigate to https://arklights.enlysure.com/ for a pre‑hosted instance.
Using ArkLights
- Data Extraction – Before the UI can offer insights, you must extract the game’s assets:
- Install the external tool ArkAssetsTool (link in the repo).
- Run
./0.sh buildingskillto gather building icons. - Run
./0.sh recruitfor recruit data. -
For mission coordinates, run
python extract.py screencap 1,2,3. -
Logging In – Connect your device via Lazy Man Spirit or use the web UI’s mobile API. The scripts automatically capture skill usage and mission data.
-
Planning Your Build – Open the planner in the UI, drag operators, assign skills, and let ArkLights compute the most efficient path based on your constraints.
-
Monitoring – The dashboard visualizes real‑time skill cooldowns, mission timers, and recommended action lists.
Contributing to ArkLights
ArkLights is a community project. Here’s how you can help:
- Pull Requests – Fix bugs, add operators, or improve UI components.
- Issue Reports – Submit detailed bug reports on the GitHub Issues page.
- Documentation – Enhance the README or create tutorial videos.
- Localization – Translate the UI into other languages.
The repository follows standard Open‑Source contributions: use git flow branches, run the unit tests pytest, and reference issues in your PR.
Roadmap Highlights
| Milestone | Description |
|---|---|
| 1.0 | Finalized feature set – core planning, skill tracking, cloud sync. |
| 2.0 | Community‑driven UI enhancements, multi‑device support. |
| 3.0 | Cross‑platform native app via Tauri/Electron. |
| Future | Integration with other mobile game helpers and AI‑driven suggestions. |
The project is free, MIT‑licensed, and hosted on GitHub‑Pages for easy deployment.
Final Thoughts
ArkLights proves that open‑source can dramatically elevate your gaming experience. By combining lightweight scripting with powerful data analysis, it turns hours of manual management into a few clicks of a button. Whether you’re planning a massive base‑building operation or simply managing a quick mission, ArkLights’s intuitive interface and extensible architecture make it the go‑to tool for any Arknights enthusiast.
Ready to level up? Clone the repo, run the setup, and let the light of ArkLights guide your path to victory. Happy hacking—on the field and in the code!