KanColle Cache Proxy

This is a local proxy meant to cache KC assets. It can be preloaded from a cache dump (linked below). This will improve loading of assets on top of browser built-in cache.

Setup

It's recommended that you start out from a cache dump. You can download the latest one from MEGA (should be a bit over ~4GB). If you just want the minimal files required for the gadget server block since 2020-02-25, you can download it from GitHub releases. The compiled builds automatically contain these files, but there's a seperate zip with just the minimum cache added.

If you're not sure what you're doing, use these instructions: Detailed setup instructions with screenshots

Setup using compiled versions

1. Go to Releases and download the latest one for your operating system.
2. Unzip this file somewhere, run the executable. Recommended to do this from command prompt/powershell/terminal so the output is visible after it finishes running.
3. Depending on browser/viewer used, set it up to use localhost:8081 as HTTP proxy. Below are some details) on how to do it for some viewers/chrome.

Setup using node

Otherwise, here's the general outline:

0. This proxy requires Node, and optionally git to clone this repository (or download zip at top right, unzip it somewhere).
1. Install dependencies with npm by running npm i in the folder with package.json.
2. (Optional) Extract the downloaded cache dump, so you'll have a folder cache with cached.json in it respectively to where you unzipped/cloned the repository (if there's a file ./proxy.js then there should be ./cache/cached.json).
3. You can start the proxy server with node proxy.
4. Depending on browser/viewer used, set it up to use localhost:8081 as HTTP proxy. Below are some details) on how to do it for some viewers/chrome.

Don't forget to start the proxy server each time you want to use it (or see auto start section).

NOTE for technical people: You can NOT run both the preloader and proxy server at the same time, unless you run the preloader via the proxy on startup.

Updating

Game/Cache

Game files should be automatically updated on the fly. No need to redownload a cache dump. Unless you need to update the IP block bypass, you can choose to either connect once with VPN, or replace some files from the minimum cache dump available in the GitHub releases. Note: do NOT replace cached.json with the one from minimum cache! Doing so will make the proxy forget about all other cached files.

Proxy

If you want to update the proxy and you installed it via node using git, just git pull. Otherwise redownload the zip and extract and replace all files. If you installed it via the compiled versions, you'll need to replace the executable from the zip in releases.

Browser/Viewer setup

Below are some instructions for some viewers/browsers available

• Chrome
• Electronic Observer
• Poi

Chrome proxy setup

1. To use this in chrome, an extension like Proxy SwitchyOmega
2. Add a new profile, set the HTTP proxy server to localhost and port to 8081 (this can be changed in the config.json). Preview.
3. In autoswitch, add two URL wildcard conditions that point to the profile created in the previous step. In the first condition put http://<your kc server ip>/kcs/* and in the second http://<your kc server ip>/kcs2/*. You can find your KC server ip in the network tab of devtools when playing the game, or check on wikia, or checking the output of the preloader. Preview
4. If you also want to go around the recent foreign IP block, add http://203.104.209.7/* as well.
5. Save your changes and enable the Auto Switch profile. Preview

Electronic Observer

1. Open settings via File -> Settings.
2. Go to Network tab (should be first tab) and check Use local proxy and enter port 8081 (this can be changed in the config.json). Preview
3. Save and restart EO to apply your settings. Preview

Poi

1. Open settings via the gear icon
2. Go to Network tab (should be fourth tab) set proxy to HTTP Proxy and change port to 8081 (this can be changed in the config.json). Preview
3. No refresh required, but it should help checking if it works by looking at the console window. Preview

Auto start on system startup (Windows)

1. Open the your startup folder by opening run (windows key + R) and running shell:startup
2. Drag and drop the start.bat file while holding down alt while releasing, this will create a shortcut.
3. The proxy can be shut down by pressing control+c, you can close the proxy created in "Installation" step 2 in this way. You can start it up again by double clicking the shortcut you just created.