• Welcome to the Kancolle Wiki!
  • If you have any questions regarding site content, account registration, etc., please visit the KanColle Wiki Discord

Difference between revisions of "Tutorial: Connection"

From Kancolle Wiki
Jump to navigation Jump to search
(DMM no longer blocks foreign IP confirmed and tested myself in the UK)
m
 
(30 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{Tutorialportal}}
 
{{Tutorialportal}}
 +
Currently, the game is only available to people connecting with Japanese IP addresses. Thus, this page guides on how to bypass this restriction.
  
As of 2018, users are no longer required to have a Japanese VPN to play kancolle (Some countries may be still blocked though not US and EU)
+
There are two options to connect to the game:
 +
* Bypassing the existing blocks: [[#General DMM Cookie-based Block|general DMM cookie-based block]] and [[#KanColle Gadget Server Block|KanColle gadget server block]]. Bypassing methods are recommended, please try using them first.
 +
** In summary, using a viewer that supports both bypass options and enabling those options is enough. Such viewers include: [https://github.com/KC3Kai/KC3Kai KC3Kai], [https://github.com/poooi/poi Poi] ([https://nightly.poi.moe/ nightly] version with a [https://github.com/kcwiki/poi-plugin-let-me-in plugin]), [https://github.com/gre4bee/ElectronicObserver ElectronicObserver] (fork), [https://github.com/antest1/GotoBrowser GotoBrowser] (for Android).
 +
** Non-viewer solutions include: [https://github.com/Tibowl/KCCacheProxy KCCacheProxy], [https://github.com/kcwiki/chrome-extension-dmm DMM extension] (for Chrome), [https://github.com/einaregilsson/Redirector Redirector extension] (for other browsers, a [https://github.com/kcwiki/cache/blob/master/redirector.json custom config] should be imported, cookie fix should be applied [[#General DMM Cookie-based Block|manually]]).
 +
* Using a [[#VPN or Proxy|VPN or proxy]] (actually using a Japanese IP).
  
However, if you are one of those that required a Japanese VPN to play; thus, this page guides new users on bypassing this restriction.
+
'''Note that for creating a new game account, it is necessary to use a Japanese VPN, preferably with all other methods disabled.'''
  
Here's a link to a Quick Video OverView/Tutorial on the Provided Options (Mainly Option 3):
+
__TOC__
 +
==Bypassing Blocks==
 +
===KanColle Gadget Server Block===
 +
Since February 26, 2020, KanColle gadget server is blocking all non-Japanese IP addresses directly; thus, extra steps are required to load the game:
 +
* On Android [https://github.com/antest1/GotoBrowser GotoBrowser] can be used: a substitute gadget server will be used if the "alter gadget URL" option is enabled in settings. The substitute server will serve the login assets, allowing a user to log in without needing to access the actual gadget server. [https://antest1.github.io/GotoBrowser/howto.html Additional] connection options can be used as well. Clearing cache may be required.
 +
* [https://github.com/poooi/poi Poi] (latest [https://nightly.poi.moe/ nightly] version) can use a local cache folder, allowing to serve the [https://github.com/kcwiki/cache login assets] from a local folder, again, bypassing the need to connect to the real gadget server. The "3rd party cache" folder can be found in common settings (<code>%appdata%/poi/MyCache</code> be default on Windows), the path to login assets should be <code>3rd party cache folder/KanColle/gadget_html5</code> (<code>%appdata%/poi/MyCache/KanColle/gadget_html5</code> for Windows; technically, only <code>gadget_html5</code> folder is required to log in). Clearing cache in common settings and restarting the viewer may be required. A [https://github.com/kcwiki/poi-plugin-let-me-in plugin] can be used to automatically update the local cache.
 +
* Options for Chrome:
 +
** [https://github.com/KC3Kai/KC3Kai KC3Kai] has an option to use a substitute gadget server (such as https://kcwiki.github.io/cache/ or http://luckyjervis.com/).
 +
** [https://github.com/kcwiki/chrome-extension-dmm A minimal specialized extension] that handles both DMM cookie block and gadget server block.
 +
** [https://github.com/einaregilsson/Redirector Redirector extension] with a [https://github.com/kcwiki/cache/blob/master/redirector.json custom config] (supports other browsers as well).
 +
* [https://github.com/Tibowl/KCCacheProxy KCCacheProxy] can be used with browsers and viewers that support proxy connections. It serves assets from a local cache and so should also speed up asset loading.
  
https://www.youtube.com/watch?v=2EU9Oklro90
+
===General DMM Cookie-based Block===
 +
To ensure that region-restricted pages are accessed only from Japan DMM is using an IP check to [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie set] a region flag in its cookies every time a page is loaded. Then the flag is [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cookie used] to check if a region-restricted page can be accessed. It is possible to bypass this restriction by changing the flag right before loading each page or by setting a path-overriding cookie.
  
==Option 1: VPN Gate Client==
+
The following tools automatically override the necessary cookies when needed:
'''Windows'''
+
* [https://poi.moe/ Poi], the cookie setting should be enabled.
# Head over to [http://www.vpngate.net/en/ VPN Gate], an "Academic Experiment Project" by the University of Tsukuba.
+
* If you want to browse other DMM games, and not just play KanColle, on Chrome you can use one of the following extensions:
# Download, install and run the client.
+
** [https://github.com/KC3Kai/KC3Kai KC3Kai], the cookie setting should be enabled.
# Select a Japanese server in "VPN Gate Public VPN Relay Servers".
+
** [https://github.com/kcwiki/chrome-extension-dmm Minimal specialized extension].
'''Mac / UNIX-based'''
+
** Note that some games are using IP blocks, so those extensions will not work for them.
* There is L2TP VPN interface that has been pre-installed in your kernel system. You can directly set it up without needing to download any clients or using similar software to let you execute Windows-only clients. However, in case your network is blocking the usage of L2TP, you will still need to download VPN clients to let you use VPN with different protocols.
 
  
==Option 2: Creating an L2TP or STTP VPN connection (Windows 8)==
+
To override the cookies manually:
This method works for Windows 7 as well, but the wording of the settings might be different.
+
* Log into [https://www.dmm.com/ dmm.com] if not logged in already, choose an interface language if asked. Make sure the page is fully loaded once you logged in.
#Go to [http://www.vpngate.net/en/ VPN Gate], and find a Japanese server that supports either "L2TP/IPsec" or "MS-STTP" connections.
+
* [https://kb.mailster.co/how-can-i-open-the-browsers-console/ Open the developer tools].
#Copy the server's address (eg. '''<span style="font-size:9pt;">vg2036075803.opengw.net)</span>'''<span style="font-size:9pt;">. For STTP-supporting servers, copy the address plus the port number, shown in the MS-STTP column.</span>
+
* Copy-paste the following code into the '''console''':
#"Set up a new connection or network" in Network and Sharing Center.
+
<syntaxhighlight lang="javascript">
#"Connect to a workplace"
+
expires=new Date(+new Date()+31536e6).toUTCString()
#"Use my Internet connection (VPN)"
+
document.cookie=`ckcy=1;expires=${expires};path=/netgame;domain=.dmm.com`
#Paste the address (plus the port, for STTP), name the VPN connection as you wish and click on "Create".
+
</syntaxhighlight>
#(L2TP users skip to step 8 for now) The VPN connection should appear in "Network Connections" (or the sidebar that appears when you click on the network icon in the taskbar). When asked for Username and Password, input "vpn" for both.
+
<!--
#For L2TP users, you must find the network connection that was just created, and go to its "Properties" by right clicking on the just-created connection in "Network Connections". Go to the "Security" tab, select L2TP/IPsec as the "Type of VPN" and then click on "Advanced settings". Select "Use preshared key for authentication" and then input "vpn". Apply the settings. Connect to the VPN as per step 7.
+
** https://tools.ietf.org/html/rfc6265.
 +
** <code>path=/netgame</code> overrides <code>path=/</code> which is set by DMM.
 +
** <code>expires</code> date should be ahead of the current date by one year, although any future date will work.
 +
-->
 +
* Execute it by pressing '''Enter''' or '''Ctrl + Enter''' for Internet Explorer.
 +
* Then use the address bar or a bookmark to go directly to the [http://www.dmm.com/netgame/social/-/gadgets/=/app_id=854854/ KanColle play page], you will still need a [[#Gadget Server Block|KanColle gadget server block]] fix.
  
This method is for users of Mac and UNIX-based systems:
+
==VPN or Proxy==
#Open Network Preferences.
+
Different VPN and proxy server providers can be used, as long as they have Japanese locations. Refer to their documentation on how to use them.
#Click add connection, then select VPN (L2TP)
 
#Go to [http://www.vpngate.net/en/ VPN Gate], and find a Japanese server that supports either "L2TP/IPsec" connections.
 
#Copy the server's address (eg. '''<span style="font-size:9pt;">vg2036075803.opengw.net)</span>'''<span style="font-size:9pt;">. </span>
 
#Paste the address to the "Server Address", and type '''vpn''' as the "Account Name".
 
#Click "Authentication Setting", then type '''vpn''' for both available textboxes. You do not need to change anything else.
 
#Click "Advanced", and tick '''Send all traffic over VPN Connection'''.
 
#Click OK, then Apply, and test the connection using the "Connect" button.
 
#If the VPN fails, try to add the IP address to the "Server Address" instead of the full server name.<br />If this one fails too, you can try turning off your whole internet connection for 1-2 minutes before trying to connect to the VPN again. This issue sometimes occurs when you suddenly disconnect from the VPN due to a poor connection or incomplete request.
 
  
==Option 3: Editing DMM Cookie's Region Flag==
+
Note that VPN/Proxy is only required during login (the real gadget server will be accessed via a Japanese IP address) and can be disabled afterward (game servers do not require a Japanese IP).
  
===Usage===
+
One free option is [https://www.vpngate.net/en/ VPN Gate], an "Academic Experiment Project" by the University of Tsukuba. The site can also be used to check your apparent IP address and location. It is '''NOT''' recommended to be used when you are handling sensitive data such as when entering [[Shop/Purchasing|your card details]].
# Log into DMM.com
 
# Switch the language of the site from English to Japanese (日本語) at the top of the site.
 
# Open the Developer Bar (F12) and insert these lines into the console and execute (by pressing the [Enter] key).
 
<pre>
 
document.cookie = "ckcy=1;expires=Sun, 09 Feb 2019 09:00:09 GMT;domain=osapi.dmm.com;path=/";
 
document.cookie = "ckcy=1;expires=Sun, 09 Feb 2019 09:00:09 GMT;domain=203.104.209.7;path=/";
 
document.cookie = "ckcy=1;expires=Sun, 09 Feb 2019 09:00:09 GMT;domain=www.dmm.com;path=/netgame/";
 
document.cookie = "ckcy=1;expires=Sun, 09 Feb 2019 09:00:09 GMT;domain=log-netgame.dmm.com;path=/";
 
</pre>
 
  
===Advantages===
+
'''Windows'''
* Works for any OS or browser.
 
* You do not need to download or install any third-party software.
 
* You will have access until you specifically clear your browser cookies.
 
* It is fast, since you'll be using your direct internet connection.
 
 
 
===How it works===
 
[[File:Region_cookies_101.jpg|thumb]]
 
* You use the browser's dev tools console to write cookies on your computer. Nothing has been transmitted to the server at this point.
 
* Once you refresh DMM, it will check for the cookies. Your browser includes these cookies as a part of the HTTP header on your refresh.
 
* DMM will now see the new region flag on the cookies, (''which they do not know you faked since it was given by your browser'') and grant you access.
 
* Choose your netgame and play.
 
{{clr}}
 
 
 
==API Links==
 
===Introduction===
 
'''<span style="color:#f00">Getting an API link requires you to be able to view the game, thus you will need one of the three options on this article to initially connect to the game.</span>'''
 
* An API Link is a web address pointing directly to your KanColle account.
 
* If you acquire this, you can visit the link as a quick way to login.
 
* Since it is a direct link, it bypasses DMM, thus bypasses country restrictions as well.
 
* It is a safe method and is being used by the majority of the foreign community at this point.
 
 
 
{{Warning
 
|title = Security Considerations for API Links
 
|message = The API link bypasses login and opens your account directly. '''Be very careful not to let others see your link''' (e.g. when streaming or posting screenshots of the game). Anyone who obtains your API link can also access and control your account!
 
}}
 
 
 
===Obtain via Network Logs===
 
This is probably the easiest way to get an API link without third-party tools.
 
[[File:Api_link_via_network.jpg|thumb]]
 
# Open your browser DevTools by pressing F12.
 
# Open the game.
 
# Go to the '''Network''' tab.
 
# Filter/Search for: '''<code>Maind2</code>'''.
 
# Only one result will show; Right-click that, and ['''Copy link address'''].
 
''Note: This terminology is for Google Chrome. Other browsers may have their own counterparts.''
 
{{clr}}
 
 
 
===Obtain via Manual Search===
 
# Open the game.
 
# Type Ctrl+Shift+I (or F12) to inspect the elements of the page or use "Show resources list" through [https://getadblock.com Adblock], then search for '''api_token''' or '''mainD2.swf'''.
 
#* '''Example''': <nowiki>http://125.6.189.7/kcs/mainD2.swf?api_token=xxx&api_starttime=xxx</nowiki>.
 
#* '''Note''': The API link is unique for each server and session.
 
# Copy the API link.
 
# Turn off your proxy/VPN and open the link in your browser.
 
#* If the link doesn't work, you probably copied it incorrectly or missed part of it.
 
# If you find that the search function in the developer console is not working properly (in either Chrome or Firefox), you can also manually search for the API link by navigating the script in this order:
 
#* html > body > div#w > div#main-ntg > div#page > div#area-game > iframe#game_frame > html > body > div#flashWrap > embed#externalswf.
 
{{clr}}
 
 
 
===Important Notes===
 
* You will need to obtain a new API link (referred to as ''refreshing'') by repeating one of the processes above each month to reset the extra operation maps' boss gauges.
 
* Refreshing your API link every in-game update (after maintenance) is a good practice.
 
 
 
===Further Reading===
 
* Looking at the diagram under the Region Cookies section, we can see that DMM is connected to the developer's server through ''Embedded Flash with API Links''.
 
** DMM only shows you the game by embedding a flash object on their webpage. In this case, DMM is called the "'''publisher'''".
 
** This flash object points to Kadokawa's ('''the developers''') KanColle servers.
 
** The link to this flash object is the API Link.
 
* Once DMM's country restriction has been bypassed, DMM will embed a flash object, as explained, through the API link - which in turn becomes visible to us.
 
* The link DMM used to show us the game can be reused. You can save it on a file, or have it stickied on your computer, only to open it again, without the help of DMM this time around, and thus avoiding country restrictions indefinitely.
 
* If region cookies are used, API links seem to be useless since their original purpose, avoiding country restriction, has already been resolved. However, some people still prefer to use API links as they bypass loading the DMM webpage, saving you some network load.
 
  
==Tip==
+
* [https://www.vpngate.net/en/download.aspx Download] and [https://www.vpngate.net/en/howto_softether.aspx install] the client.
To avoid having to clear your browser cache everytime you want to connect to the game, you can use different Chrome-like web browser (i.e. [http://coolnovo.com CoolNovo], [http://www.chromium.org/Home Chromium], [http://www.comodo.com/home/browsers-toolbars/browser.php Comodo Dragon], [http://www.maxthon.com/ Maxthon], [http://www.srware.net/en/software_srware_iron_download.php SRWare Iron], [http://www.rockmelt.com/ RockMelt], etc.).<br />
+
* Select a Japanese server in it using "VPN Gate Public VPN Relay Servers".
* Only use this browser for KanColle and don't forget to connect to a Japanese proxy before opening it; In doing so, you won't have to wait for the game's data to download every time you need to connect to the game.
+
* Alternatively, [https://www.vpngate.net/en/howto_l2tp.aspx L2TP/IPsec], [https://www.vpngate.net/en/howto_openvpn.aspx OpenVPN], or [https://www.vpngate.net/en/howto_sstp.aspx MS-SSTP] options can be used.
  
==Troubleshooting==
+
'''Mac/Linux'''
''See main article: [[Tutorial: Troubleshooting]]''
 
  
[[File:Error_.png|thumb|right]]
+
* Simply import an OpenVPN config file of a Japanese server in your network manager.
* Have you cleared your cache? ''Try doing it again in Incognito''.
+
* Alternatively, there is L2TP/IPsec interface, which is usually pre-installed, so it is possible to set it up directly without installing any clients.
* Have you tried logging in again on DMM or obtaining a new API link?
 
* Have you tried running other sites? ''The problem might stem from your internet connection.''
 
* Were you using viewers? ''Try logging in normally on your browser.''
 
* Were you banned? ''Login to DMM to confirm whether or not you receive a black error message.''
 
** Banned accounts see the cat error-message through an API link and the black error message through DMM.
 
* Is your computer clock correct? ''Try switching to your correct timezone.''
 
** Issues stemming from your computer clock settings are common.
 
  
==Mobile Gameplay==
+
Other free options include:
  
The only officially supported ways to play are via the [[Kancolle Android Version]] or through a desktop flash client (e.g. Chrome, Firefox, or Internet Explorer). Any other implementations of flash, such as mobile flash imitations/emulations or even mobile versions of chrome are not supported. These are not recommend as your data may not be secure, and may also not send data to the KC servers in the same way as an officially supported method would, putting you at risk of getting banned.
+
* [https://protonvpn.com/ ProtonVPN].
{{clear}}
+
* Chrome extensions such as [https://chrome.google.com/webstore/detail/setupvpn-lifetime-free-vp/oofgbpoabipfcfjapgnbbjjaenockbdp SetupVPN]<!-- and ?--> can be used as well.
  
[[Category:Tutorial]]
+
=See Also=
[[Category:Help]]
+
{{Help}}

Latest revision as of 09:03, 9 July 2024

Basic Tutorial Portal
Setup and Registration (PC)  · Kancolle Android Version  · Connection  · Troubleshooting  · Basic Gameplay  · FAQ  · Glossary
Other Tutorials & Help pages

Currently, the game is only available to people connecting with Japanese IP addresses. Thus, this page guides on how to bypass this restriction.

There are two options to connect to the game:

Note that for creating a new game account, it is necessary to use a Japanese VPN, preferably with all other methods disabled.

Bypassing Blocks

KanColle Gadget Server Block

Since February 26, 2020, KanColle gadget server is blocking all non-Japanese IP addresses directly; thus, extra steps are required to load the game:

  • On Android GotoBrowser can be used: a substitute gadget server will be used if the "alter gadget URL" option is enabled in settings. The substitute server will serve the login assets, allowing a user to log in without needing to access the actual gadget server. Additional connection options can be used as well. Clearing cache may be required.
  • Poi (latest nightly version) can use a local cache folder, allowing to serve the login assets from a local folder, again, bypassing the need to connect to the real gadget server. The "3rd party cache" folder can be found in common settings (%appdata%/poi/MyCache be default on Windows), the path to login assets should be 3rd party cache folder/KanColle/gadget_html5 (%appdata%/poi/MyCache/KanColle/gadget_html5 for Windows; technically, only gadget_html5 folder is required to log in). Clearing cache in common settings and restarting the viewer may be required. A plugin can be used to automatically update the local cache.
  • Options for Chrome:
  • KCCacheProxy can be used with browsers and viewers that support proxy connections. It serves assets from a local cache and so should also speed up asset loading.

General DMM Cookie-based Block

To ensure that region-restricted pages are accessed only from Japan DMM is using an IP check to set a region flag in its cookies every time a page is loaded. Then the flag is used to check if a region-restricted page can be accessed. It is possible to bypass this restriction by changing the flag right before loading each page or by setting a path-overriding cookie.

The following tools automatically override the necessary cookies when needed:

  • Poi, the cookie setting should be enabled.
  • If you want to browse other DMM games, and not just play KanColle, on Chrome you can use one of the following extensions:

To override the cookies manually:

  • Log into dmm.com if not logged in already, choose an interface language if asked. Make sure the page is fully loaded once you logged in.
  • Open the developer tools.
  • Copy-paste the following code into the console:
expires=new Date(+new Date()+31536e6).toUTCString()
document.cookie=`ckcy=1;expires=${expires};path=/netgame;domain=.dmm.com`

VPN or Proxy

Different VPN and proxy server providers can be used, as long as they have Japanese locations. Refer to their documentation on how to use them.

Note that VPN/Proxy is only required during login (the real gadget server will be accessed via a Japanese IP address) and can be disabled afterward (game servers do not require a Japanese IP).

One free option is VPN Gate, an "Academic Experiment Project" by the University of Tsukuba. The site can also be used to check your apparent IP address and location. It is NOT recommended to be used when you are handling sensitive data such as when entering your card details.

Windows

Mac/Linux

  • Simply import an OpenVPN config file of a Japanese server in your network manager.
  • Alternatively, there is L2TP/IPsec interface, which is usually pre-installed, so it is possible to set it up directly without installing any clients.

Other free options include:

See Also