logo
0
0
WeChat Login
233dada<233dada@gmail.com>
docs: 更新 readme.md

image


AhabAssistantLimbusCompany

FACE THE SIN,SAVE THE E.G.O



version download
language platform

简体中文 | English

Encountering problems? Please check the FAQ before asking questions.


This project is the brainchild of a non-computer professional.

It is a third-party project based on image recognition and text recognition technology

A PC assistant for the mobile game Limbus Company

It can help players automatically complete daily tasks, mirror dungeon challenges and other operations, one-click liver protection

This project aims to help you reduce the repetitive and boring parts of Limbus's gameplay, so that you can better enjoy the exciting story, performances, and mechanics inside


Function Introduction

  • Automatic Daily: Automatically swipe experience books, new books, receive daily/weekly rewards, and receive emails

  • LUNACY to physical: Automatically identify and use LUNACY for physical strength, and automatically synthesize enkephalin module (cake)

  • Automatic Mirror Dungeons: fully automatic Dungeons time

    • Support multi-team rotation and round-robin battles
    • Supports custom team accessories system selection
    • Support mirror dungeon theme pack to automatically identify and filter based on weight
    • Configure intelligent route planning (prioritize event nodes)
  • Imitation of MAA style GUI

  • Automatic version update

    • Automatically download the latest version
    • Automatically execute update operations
  • What You See Is What You Get.

  • Supports multi-resolution window execution.

  • Supports automatically closing the game or shutting down the computer after the task is completed

Special Features

  • Automatic team selection, there are two modes:
    • Select a team based on get a team name from OCR (the initial team name must be maintained, e.g. [TEAM #1])
    • Select a team based on their serial number
  • The Mirror Dungeon automatically selects theme packs based on weights
  • Supports running with English (EN) and Chinese Simplified (zh_cn) as the game language
  • Customized Mirror Dungeon experience

For custom settings and process acceleration for Mirror Dungeon team composition, please see AALC Advance Team Setting


How to download

Click Releases and download the file called 【AALC-Vx.x.x】 in the latest version, unzip it and run AALC.exe.

Because of the lack of technical power, I also engaged in GUI and used third-party OCR, so the file size is relatively large


Instructions for use

Other Notes

During script execution you can use CTRL+Q keys to terminate the script process (this may cause problems when the script is restarted, which can be solved by restarting the script program).

At the same time ALT+P can pause the script, ALT+R can resume the script

The above shortcuts can all be modified in the Shortcut Settings tab within the settings interface.

There is nothing to explain, what you see is what you get.

If you find any problems (except for the team numbering problem below), you can report them to Issue.

Of course, you are also welcome to submit Pull Request

Theme package weight setting

When the script is run once, a "theme_pack_list.yaml" file is automatically created, which is used to set the weight of the theme package
After opening it with Notepad or other text editors, you can configure the weight of the theme package according to the format, or add the theme package to recognize the text

Modify the process

  • Run the AALC.exe once first (for new users)
  • A theme_pack_list.yaml file appears in the AALC folder
  • Modify theme_pack_list.yaml file
  • Restart AALC after modification

The file format is shown in the following picture.

image

Running in the background

Attention

  • It is recommended to run with resolutions of 1920 * 1080 and 2160 * 1440
    The screen is less than 1920 * 1080 is not tested, it is not recommended to use it at resolutions less than that
  • Please set Material Quality and Render Ratio in Settings-Image to High, Normal FPS and Combat FPS to 60, and Post-Processing to Off to facilitate software recognition. If the performance of the device cannot be met, please also try to set the rendering ratio to high, otherwise the software may have difficulty in recognizing it.
  • The game program will be set to window mode after the script starts, and if there is a behavior of switching to the full screen and then exiting in the middle, it is normal behavior, so there is no need to worry
  • If you have enabled the performance display feature of Steam or other software, you should try not to obscure the game screen, as this may cause problems with the scripting process

Declaration

This software is open source, free of charge, for learning and communication purposes only.

If you encounter merchants use this software to practice on behalf of and charge, may be equipment and time and other costs, problems and consequences have nothing to do with this software.

The code to get administrator privileges is configured to ensure smooth operation

In addition to checking updates and displaying announcements, the project runs purely offline

Software icon material from the source of network graphics, does not belong to the AGPL v3 agreement open source content, if any infringement, please contact the author to delete in a timely manner

Some images and audio materials are from Limbus Company Chinese WIKI and Yue Helena, and are disclosed upon request

Users are required to comply with the rules of use and terms of service of the relevant platform in the process of use. Due to the use of this software may lead to the game account ban, illegal behavior and all the consequences, the author is not responsible. Users are responsible for their own behavior and bear all risks that may be brought about by the use of this software.


Sample Diagrams

(The picture is for reference only, please refer to the example)

Start screen

image

The Mirror Dungeon team setup screen

image


Acknowledgements

Individual acknowledgements

The AALC project could not have been possible without the help of the following open source projects

projectslinksintroduction
LALCLixAssistantLimbusCompanyThanks to the big guy's open source, so I can learn and start my own project by rewriting the big guy's project with step-by-step follow-up
OCR Text RecognitionPaddleOCR-jsonWithout it there would be no auto-recognition of teams, auto-recognition of Mirror Jail theme packs
Graphical Interface Component LibraryPyQt-Fluent-WidgetsAlthough only used the basic components, not much development potential, but the basic components have made the GUI aesthetics UP
March7thAssistantMarch7thAssistantLearned quite a bit from the big guy here
BAASblue_archive_auto_scriptI learned the simulator-related code from the big guy here

The file ChineseFont.ttf is sourced from LocalizeLimbusCompany. This portion of the code adheres to the CC BY-NC-SA 4.0 license. Copyright belongs to LocalizeLimbusCompany.

Uniform acknowledgements

All the people who are directly or indirectly involved in the development of this software

Including the people who shared their tutorials on the web.

And the giants who open-sourced their own code!


Contributors

Thanks to the following developers for their outstanding contributions to AALC:

Future plans

  • Count the number of pass levels after the run.
  • Adapt more window position.
  • Generate excel file or chart for stats during runtime to improve readability.
  • Improve the code function commentation documentation
  • Provides a GUI for theme package configuration
  • Continuously fix bugs
  • ......

Run the source code

If you don't understand it at all, please download and install it through the above method, and you don't have to look down.

Using uv (Recommended)

# Clone the repository git clone https://github.com/KIYI671/AhabAssistantLimbusCompany cd AhabAssistantLimbusCompany # Download dependencies via uv (uv tool needs to be installed separately) uv sync --frozen uv run main.py # Update git pull

Using pip (Excludes dev packages)

# Clone the repository git clone https://github.com/KIYI671/AhabAssistantLimbusCompany cd AhabAssistantLimbusCompany # Please use a Python binary with version higher than 3.13 (with GIL) pip install -r requirements.txt python main.py # Update git pull

Build guide


Join Us

  • Development Participation(Document Under Construction)
  • Translation Support: Refer to Translation Guide

At last

If you found the software helpful, please click Star.

I hope that there will be a big guy to guide or optimize this project, or further improve this project together.

Hopefully, this app will help you reduce the tedious part of playing Limbus and enjoy the wonderful story, performances, and mechanics inside.