Skip to content

Configuration

Tibo edited this page May 21, 2020 · 6 revisions

Settings

Some settings can be changed in UI, while some others (more advanced ones) are only in config.json

UI options

Port

Default: 8081.

Changes port at which proxy server is running. Change it if it conflicts with another application. Will also need to be changed in viewer/browser you are using. Changes apply after clicking on Save and restarting the application.

Hostname

Default: 127.0.0.1.

Changes hostname at which proxy server is running. Change if you know what you are doing. Changes apply after clicking on Save and restarting the application.

Cache location

Default: default, which should resolve to %appdata%/KCCacheProxy/ProxyData/cache/

Folder where cache is stored. Should be the folder containing cached.json. Changes apply after clicking on Save. If you changed cached.json while it was already loaded (by extracting a cache dump for example), you can use Reload cache.

Start in system tray

Default: off

Start application in system tray instead of showing window. Recommended to turn on, since otherwise it'll show up every system startup. Disabled by default to have some feedback that application started. Changes apply after clicking on Save, though, changes are only visible after restarting.

Automatically verify cache integrity

Default: off

Check if files have the correct length (and it didn't fail to write to disk) when sending an asset. Changes apply after clicking on Save. You can trigger a check on all assets in cache with Verify entire cache. Recommended to turn on, disable if you are using an old cache dump or want to change assets (not recommended). Disabled by default since it won't work (and think every file is invalid) with old caches.

Disable browser caching

Default: off

Prevent browser from caching files. This should reduce the impact of KC assets eating up cache size. Changes apply after clicking on Save. Recommended to keep it off, since browser is still faster to load stuff than have it go through the caching proxy. Turn it on if your browser is having issues with updating KC assets.

Bypass checking for gadget updates on gadget server

Default: off

Prevent proxy from checking gadget server to see if gadget files are up to date. Changes apply after clicking on Save. Recommended to keep it on if you are behind 403 wall. Keep it off to have these files updated automatically. You can temporarily turn it off if you need to update gadget files (via VPN), also turn off browser caching when you do, so certain files don't get stuck at current version in the browser cache.

Overwrite game version

Default: false
Possible values: false, to disable; kca, to use android version (which is stored on your server) every request; or it can be set to A.B.C.D with A, B, C and D numbers.

Overwrites game version in gadget file. Changes apply after clicking on Save, and are visible after refreshing the game. Should always be kept at false, unless you are having issues with game not updating correctly (for example; you can't login after maint/friend fleet button not appearing). This happens when browser got those files cached, even though proxy should tell browser not to cache those files if 403 got detected. This can happen when you used a VPN in the past, or recently gotten 403. This can be fixed by clearing browser cache, but that might be annoying to do in some viewers. Setting it to kca will fetch every refresh from a file containing android version, but not recommended for long term usage since it will slow down loading. Set to the latest version number (for example, 4.5.6.2) if false is causing issues. You can get same effect by using VPN and temporarily disabling Bypass checking for gadget updates on gadget server and Disable browser caching (don't forget to save).

Enable assets modifier

Default: off

Enables the Assets modifier settings. When disabled, no patching will be done.
NOTE: Enable on own risk.

config.json settings

Some of these are also in UI. You'll need to restart the proxy to apply these changes.

UI settings

port, see Port
hostname, see Hostname
cacheLocation, see Cache location
startHidden, see Start in system tray
disableBrowserCache, see Disable browser caching
verifyCache, see Automatically verify cache integrity
bypassGadgetUpdateCheck, see Bypass checking for gadget updates on gadget server
gameVersionOverwrite, see Overwrite game version
enableModder, see Enable assets modifier

Hidden settings

checkForUpdates, automatically check for updates
serverIP, server IP to be used when running gameVersionOverwrite on kca and when running preloader
preloadOnStart, automatically run preloader when starting proxy
showExtraButtons, show extra buttons to: run preloader on demand, create cache diff dumps
preloader, settings of preloader