Skip to content
This repository has been archived by the owner on Apr 19, 2022. It is now read-only.
Minyoung Choi edited this page Dec 28, 2018 · 6 revisions

General Questions

• Can I get banned from Kantai Collection by using this tool?

Yes. It really depends on how you use it, but I make no guarantees either way. Please refer to the first section of the disclaimer in the README on the main page of the repo.

• Is it possible that I can lose a ship by using this tool?

Yes. Highly unlikely, but I make no guarantees either way. Please refer to the second section of the disclaimer in the README on the main page of the repo.

• Can I do other stuff on my machine while using kcauto?

Yes and no. The tooling used by kcauto works by taking control of the mouse and keyboard, meaning that most of the time, trying to use your machine while kcauto operates will interfere with its automation process. There are, however, specific safe periods when the user can interact with the game or machine while kcauto is running.

• What are the safe periods when the user can interact with the game or machine while kcauto is running?

The are two specific safe periods:

  • When kcauto is between cycles — a ~15 second window between when the stats are printed on the console and when kcauto begins its next cycle; this window will be longer if kcauto does not have anything to do the next cycle (no quest check, no combat sorties, no PvP, no incoming expeditions)
  • When kcauto is in the middle of combat — specifically post-formation select and pre-night battle select/results screen; during this window you cannot interact with the game much since it is already in the middle of combat but you can interact with your machine as much as you need until the night battle select or results screen becomes visible. You can buy additional time by occluding or hiding the game screen until you want the script to resume

General Usage Questions

• How do I run kcauto?

Assuming everything is installed correctly, refer to the last step in the Installation steps. If you're really lost, use the RunCmd tab of the web interface to help generate the command.

• How do I stop kcauto when it's running?

In most consoles and command prompts, pressing ctrl+c will stop the current running task.

• I get frequent catbombs while using kcauto, what do I do?

You probably botted too much and too aggressively and triggered the game's bot protection. Stop playing for a while and use the ScheduledSleep functionality when you do.

Problems running kcauto

kcauto is considered stable at this point. Issues starting kcauto typically has to do with your environment or setup.

• kcauto doesn't start and I don't know why

Please read the console output. It typically tells you the fix or at least why it is failing (see below).

• kcauto starts, but I immediately get an AttributeError or FindFailed error

Specific errors:

  • AttributeError: 'NoneType' object has no attribute 'mouseMove' or
  • FindFailed error looking for kc_reference_point.png)

99% of the time this error is due to a scaling issue in your browser/viewer or operating system. Set your browser/viewer scaling to 100% (1x) and your operating system scaling/DPI to 100% (1x) and try again. The Kantai Collection game screen should be 1200 pixels wide and 720 pixels tall. You can verify this by taking a screenshot. Different game screen dimensions or scaling is not compatible with kcauto and will cause it to fail on startup.

• kcauto runs but gets a FindFailed error in PvP/Expedition/ShipSwitcher and crashes

Since the HTML5 update, Kantai Collection has offloaded rendering of some of the text to the system. This means that some of the text in the game will be displayed differently on different machines, operating systems, and browsers, making it difficult for kcauto to match on these text-based regions.

This issue can be alleviated by turning on ClearType and/or Smooth Edges of Screen Fonts on Windows machines. If this fails or does not apply to you, you can try lowering the TEXT_SIMILARITY and/or SHIP_LIST_SIMILARITY values in kca_globals.py. If this also fails, you will have to re-generate the problematic assets and replace the ones that come with kcauto.

• kcauto runs but crashes once it gets to the repair or fleet composition screen

This is due to finicky OCR of the ship count. While UIs 2~5 should all be supported, UIs 4 and 5 seem to have the best compatibility with OCR of the ship count.

• kcauto starts, but I immediately get a SyntaxError

Specific error:

  • SyntaxError ( "mismatched input 'as' expecting COLON", )

Update Sikuli and/or Jython. Make sure to install Jython 2.7 or above. Lower versions will cause the above error.

• Sikuli won't install properly

This is not a kcauto issue and will not be addressed here. Please refer to the Sikuli docs and/or issue board.

Clone this wiki locally