Hive Developers

Crossplay Launcher installs the PC version of Hive mobile games on PC and enables it to update and run.

Crossplay Launcher

The following flowcharts show how Crossplay Launcher is installed until the game has run:

Flowchart
Running on Windows

Install Crossplay Launcher

In the withhive.com > Game menu, select a game you want to download.
Click Play Game > Play on PC.
Click Download Installation File in the If the Crossplay Launcher is not installed, click the button below to download the file and install the player manually. window to download the installation package of Crossplay Launcher.
Run the downloaded installation file to install the game. On Windows, install Crossplay Launcher through an installation package, and then run it.
Exit the installation wizard and load the launcher.
After running the Crossplay Launcher, check whether the game is installed. If the game is not installed, look up the latest released version of the game and install it. If the screen below is not displayed, go back to the corresponding game page on withhive.com and click Play on PC again.
Set the installation folder path.
Install Game.

Update Game

Update the game in order of the version from older to newer if not the latest version of the game installed on PC. For example, if v1 is currently installed and the latest version is v3, the game update proceeds from v1 to v2 and then from v2 to v3, not from v1 to v3 directly.

The necessity of game update is considered that only checking if the current game version recorded on a game settings file in local is the latest or not, and the changes exclude as the check item.

Once the game is installed, the shortcut file created on your Windows desktop screen will not change even after you update the game. If you want to change the icon image of the shortcut, you need to uninstall and re-install the game. If you want to change the file name of the shortcut, go to App Center > Game List and search your game and click it, and go to Icons and languages to modifty the file name, uninstall the game and re-install it.

Run Game

Once the game is installed, you can launch it by clicking on the game shortcut in Windows. If there is no shortcut, click Play Game > Play on PC on the corresponding game page on withhive.com. If a browser notification prompts you to run Crossplay Updater, click Open Crossplay Updater.

Game Settings File

The game settings file is named hive_game_{GAME_NAME}.info (e.g., hive_game_chronicles.info, hive_game_zenonia.info), and see the below to check the file’s path and the included contents in the settings file:

The game settings file’s path
- Windows: C:\Users\{user name}\AppData\Local\HIVE_Launcher\installedInfo
Included contents
- Game appid
- Current game version
- Whether completed installation
- Installation path
- Game name
- info file’s path

Error code

When errors occur, the error message will display as shown below:

For details about error codes, see the Error code guide.

Run Crossplay Launcher installation file from your self-hosted website

This guide is for running PC games on Windows using the Crossplay Launcher on a website created by your game studio. Check the Crossplay launcher installation flow and check the following conditions on the website to service the game. If the conditions are not satisfied, the error notification pop-ups should be displayed to the user.

The minimum supported OS version: Windows 10 or later
The AppID: Checking whether or not the AppID corresponds to the OS
The installation of Crossplay Launcher
- It is necessary to check if the Crossplay Launcher is installed in order to install and run the game with one button.
  - Crossplay Launcher not installed: Offer the download for the installation file
  - Crossplay Launcher installed: Run Crossplay Launcher and transfer the game information

When Crossplay Launcher is not installed

If the Crossplay Launcher is not installed on the user’s PC when the game user clicks the game launch button on the game service site, you have to implement the solutions inducing the installation of the Crossplay Launcher or delivering an error message. First, here is the JavaScript code that calls a custom scheme on the web to install the Crossplay Launcher on the user’s PC.


	!function (b, a) {
		"object" == typeof exports && "object" == typeof module
			? module.exports = a()
			: "function" == typeof define && define.amd
				? define("customProtocolCheck", [], a)
				: "object" == typeof exports
					? exports.customProtocolCheck = a()
					: b.customProtocolCheck = a()
	}(window, function () {
		return function (b) {
			var c = {};
			function a(d) {
				if (c[d]) 
					return c[d].exports;
				var e = c[d] = {
					i: d,
					l: !1,
					exports: {}
				};
				return b[d].call(e.exports, e, e.exports, a),
				e.l = !0,
				e.exports
			}
			return a.m = b,
			a.c = c,
			a.d = function (b, c, d) {
				a.o(b, c) || Object.defineProperty(b, c, {
					enumerable: !0,
					get: d
				})
			},
			a.r = function (a) {
				"undefined" != typeof Symbol && Symbol.toStringTag && Object.defineProperty(
					a,
					Symbol.toStringTag,
					{value: "Module"}
				),
				Object.defineProperty(a, "__esModule", {
					value: !0
				})
			},
			a.t = function (b, c) {
				if (
					1 & c && (b = a(b)),
					8 & c || 4 & c && "object" == typeof b && b && b.__esModule
				) 
					return b;
				var d = Object.create(null);
				if (a.r(d), Object.defineProperty(d, "default", {
					enumerable: !0,
					value: b
				}), 2 & c && "string" != typeof b) 
					for (var e in b) 
						a.d(d, e, (function (a) {
							return b[a]
						}).bind(null, e));
			return d
			},
			a.n = function (c) {
				var b = c && c.__esModule
					? function () {
						return c.default
					}
					: function () {
						return c
					};
				return a.d(b, "a", b),
				b
			},
			a.o = function (a, b) {
				return Object
					.prototype
					.hasOwnProperty
					.call(a, b)
			},
			a.p = "",
			a(a.s = 0)
		}({
			"./index.js": function (module, exports) {
				eval(
					'var browser = {\n  getUserAgent: function getUserAgent() {\n    return window.' +
					'navigator.userAgent;\n  },\n  userAgentContains: function userAgentContains(br' +
					'owserName) {\n    browserName = browserName.toLowerCase();\n    return this.ge' +
					'tUserAgent().toLowerCase().indexOf(browserName) > -1;\n  },\n  isOSX: function' +
					' isOSX() {\n    return this.userAgentContains("Macintosh");\n  },\n  isFirefox' +
					': function isFirefox() {\n    return this.userAgentContains("firefox");\n  },' +
					'\n  isInternetExplorer: function isInternetExplorer() {\n    return this.userA' +
					'gentContains("trident");\n  },\n\n  /**\r\n   * Detects IE 11 and older\r\n   ' +
					'* @return {Boolean} Returns true when IE 11 and older\r\n   */\n  isIE: functi' +
					'on isIE() {\n    var ua = this.getUserAgent().toLowerCase(); // Test values.\n' +
					'    // Uncomment to check result\n    // IE 10\n    // ua = \'Mozilla/5.0 (com' +
					'patible; MSIE 10.0; Windows NT 6.2; Trident/6.0)\';\n    // IE 11\n    // ua =' +
					' \'Mozilla/5.0 (Windows NT 6.3; Trident/7.0; rv:11.0) like Gecko/20100101 Fire' +
					'fox/12.0\';\n\n    var msie = ua.indexOf("msie");\n\n    if (msie > 0) {\n    ' +
					'  // IE 10 or older\n      return true;\n    }\n\n    var trident = ua.indexOf' +
					'("trident/");\n\n    if (trident > 0) {\n      // IE 11\n      return true;\n ' +
					'   } // other browser\n\n\n    return false;\n  },\n  isEdge: function isEdge(' +
					') {\n    var ua = this.getUserAgent().toLowerCase(); // Test values.\n    // U' +
					'ncomment to check result\n    // Edge\n    // ua = \'Mozilla/5.0 (Windows NT 1' +
					'0.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.135 S' +
					'afari/537.36 Edge/12.10240\';\n\n    var edge = ua.indexOf("edge");\n\n    if ' +
					'(edge > 0) {\n      return true;\n    }\n\n    return false;\n  },\n  isChrome' +
					': function isChrome() {\n    // IE11 returns undefined for window.chrome\n    ' +
					'// and new Opera 30 outputs true for window.chrome\n    // but needs to check ' +
					'if window.opr is not undefined\n    // and new IE Edge outputs to true for win' +
					'dow.chrome\n    // and if not iOS Chrome check\n    var isChromium = window.ch' +
					'rome;\n    var winNav = window.navigator;\n    var vendorName = winNav.vendor;' +
					'\n    var isOpera = typeof window.opr !== "undefined";\n    var isIEedge = win' +
					'Nav.userAgent.indexOf("Edge") > -1;\n    var isIOSChrome = winNav.userAgent.ma' +
					'tch("CriOS");\n    return isChromium !== null && typeof isChromium !== "undefi' +
					'ned" && vendorName === "Google Inc." && isOpera === false && isIEedge === fals' +
					'e || isIOSChrome;\n  },\n  isWhale: function isWhale() {\n    // IE11 returns ' +
					'undefined for window.chrome\n    // and new Opera 30 outputs true for window.c' +
					'hrome\n    // but needs to check if window.opr is not undefined\n    // and ne' +
					'w IE Edge outputs to true for window.chrome\n    // and if not iOS Chrome chec' +
					'k\n    var isChromium = window.chrome;\n    var winNav = window.navigator;\n  ' +
					'  var vendorName = winNav.vendor;\n    var isOpera = typeof window.opr !== "un' +
					'defined";\n    var isIEedge = winNav.userAgent.indexOf("Edge") > -1;\n    var ' +
					'isIOSChrome = winNav.userAgent.match("CriOS");\n    return isChromium !== null' +
					' && typeof isChromium !== "undefined" && vendorName === "NAVER Corp." && isOpe' +
					'ra === false && isIEedge === false || isIOSChrome;\n  },\n  isOpera: function ' +
					'isOpera() {\n    return this.userAgentContains(" OPR/");\n  }\n};\nvar DEFAULT' +
					'_CUSTOM_PROTOCOL_FAIL_CALLBACK_TIMEOUT;\n\nvar registerEvent = function regist' +
					'erEvent(target, eventType, cb) {\n  if (target.addEventListener) {\n    target' +
					'.addEventListener(eventType, cb);\n    return {\n      remove: function remove' +
					'() {\n        target.removeEventListener(eventType, cb);\n      }\n    };\n  }' +
					' else {\n    target.attachEvent(eventType, cb);\n    return {\n      remove: f' +
					'unction remove() {\n        target.detachEvent(eventType, cb);\n      }\n    }' +
					';\n  }\n};\n\nvar createHiddenIframe = function createHiddenIframe(target, uri' +
					') {\n  var iframe = document.createElement("iframe");\n  iframe.src = uri;\n  ' +
					'iframe.id = "hiddenIframe";\n  iframe.style.display = "none";\n  target.append' +
					'Child(iframe);\n  return iframe;\n};\n\nvar openUriWithHiddenFrame = function ' +
					'openUriWithHiddenFrame(uri, failCb, successCb) {\n  var timeout = setTimeout(f' +
					'unction () {\n    failCb();\n    handler.remove();\n  }, DEFAULT_CUSTOM_PROTOC' +
					'OL_FAIL_CALLBACK_TIMEOUT);\n  var iframe = document.querySelector("#hiddenIfra' +
					'me");\n\n  if (!iframe) {\n    iframe = createHiddenIframe(document.body, "abo' +
					'ut:blank");\n  }\n\n  onBlur = function onBlur() {\n    clearTimeout(timeout);' +
					'\n    handler.remove();\n    successCb();\n  };\n\n  var handler = registerEve' +
					'nt(window, "blur", onBlur);\n  iframe.contentWindow.location.href = uri;\n};\n' +
					'\nvar openUriWithTimeoutHack = function openUriWithTimeoutHack(uri, failCb, su' +
					'ccessCb) {\n  var timeout = setTimeout(function () {\n    failCb();\n    handl' +
					'er.remove();\n  }, DEFAULT_CUSTOM_PROTOCOL_FAIL_CALLBACK_TIMEOUT); //handle pa' +
					'ge running in an iframe (blur must be registered with top level window)\n\n  v' +
					'ar target = window;\n\n  while (target.parent && target != target.parent) {\n ' +
					'   target = target.parent;\n  }\n\n  onBlur = function onBlur() {\n    clearTi' +
					'meout(timeout);\n    handler.remove();\n    successCb();\n  };\n\n  var handle' +
					'r = registerEvent(target, "blur", onBlur);\n  window.location = uri;\n};\n\nva' +
					'r openUriUsingFirefox = function openUriUsingFirefox(uri, failCb, successCb) {' +
					'\n  var iframe = document.querySelector("#hiddenIframe");\n\n  if (!iframe) {' +
					'\n    iframe = createHiddenIframe(document.body, "about:blank");\n  }\n\n  try' +
					' {\n    iframe.contentWindow.location.href = uri;\n    successCb();\n  } catch' +
					' (e) {\n    if (e.name == "NS_ERROR_UNKNOWN_PROTOCOL") {\n      failCb();\n   ' +
					' }\n  }\n};\n\nvar openUriWithMsLaunchUri = function openUriWithMsLaunchUri(ur' +
					'i, failCb, successCb) {\n  navigator.msLaunchUri(uri, successCb, failCb);\n};' +
					'\n\nvar getBrowserVersion = function getBrowserVersion() {\n  var ua = window.' +
					'navigator.userAgent;\n  var tem,\n      M = ua.match(/(opera|chrome|safari|fir' +
					'efox|msie|trident(?=\\/))\\/?\\s*(\\d+)/i) || [];\n\n  if (/trident/i.test(M[1' +
					'])) {\n    tem = /\\brv[ :]+(\\d+)/g.exec(ua) || [];\n    return parseFloat(te' +
					'm[1]) || "";\n  }\n\n  if (M[1] === "Chrome") {\n    tem = ua.match(/\\b(OPR|E' +
					'dge)\\/(\\d+)/);\n\n    if (tem != null) {\n      return parseFloat(tem[2]);\n' +
					'    }\n  }\n\n  M = M[2] ? [M[1], M[2]] : [window.navigator.appName, window.na' +
					'vigator.appVersion, "-?"];\n  if ((tem = ua.match(/version\\/(\\d+)/i)) != nul' +
					'l) M.splice(1, 1, tem[1]);\n  return parseFloat(M[1]);\n};\n\nvar protocolChec' +
					'k = function protocolCheck(uri, failCb, successCb) {\n  var timeout = argument' +
					's.length > 3 && arguments[3] !== undefined ? arguments[3] : 2000;\n  var unsup' +
					'portedCb = arguments.length > 4 ? arguments[4] : undefined;\n\n  var failCallb' +
					'ack = function failCallback() {\n    failCb && failCb();\n  };\n\n  var succes' +
					'sCallback = function successCallback() {\n    successCb && successCb();\n  };' +
					'\n\n  var unsupportedCallback = function unsupportedCallback() {\n    unsuppor' +
					'tedCb && unsupportedCb();\n  };\n\n  var openUri = function openUri() {\n    i' +
					'f (browser.isFirefox()) {\n      var browserVersion = getBrowserVersion();\n\n' +
					'      if (browserVersion >= 64) {\n        openUriWithHiddenFrame(uri, failCal' +
					'lback, successCallback);\n      } else {\n        openUriUsingFirefox(uri, fai' +
					'lCallback, successCallback);\n      }\n    } else if (browser.isWhale()) {\n  ' +
					'    openUriWithTimeoutHack(uri, failCallback, successCallback);\n    } else if' +
					' (browser.isChrome()) {\n      openUriWithTimeoutHack(uri, failCallback, succe' +
					'ssCallback);\n    } else if (browser.isOSX()) {\n      openUriWithHiddenFrame(' +
					'uri, failCallback, successCallback);\n    } else {\n      //not supported, imp' +
					'lement please\n      unsupportedCallback();\n    }\n  };\n\n  if (timeout) {\n' +
					'    DEFAULT_CUSTOM_PROTOCOL_FAIL_CALLBACK_TIMEOUT = timeout;\n  }\n\n  if (bro' +
					'wser.isEdge() || browser.isIE()) {\n    //for IE and Edge in Win 8 and Win 10' +
					'\n    openUriWithMsLaunchUri(uri, failCb, successCb);\n  } else {\n    if (doc' +
					'ument.hasFocus()) {\n      openUri();\n    } else {\n      var focusHandler = ' +
					'registerEvent(window, "focus", function () {\n        focusHandler.remove();\n' +
					'        openUri();\n      });\n    }\n  }\n};\n\nmodule.exports = protocolChec' +
					'k;\n\n//# sourceURL=webpack://customProtocolCheck/./index.js?'
				)
			},
			0: function (module, exports, __webpack_require__) {
				eval(
					'module.exports = __webpack_require__(/*! /Users/shahv/Viresh/work/rnd/custom-p' +
					'rotocol-check/index.js */"./index.js");\n\n\n//# sourceURL=webpack://customPro' +
					'tocolCheck/multi_./index.js?'
				)
			}
		})
	})

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

!function (b, a) {

"object" == typeof exports && "object" == typeof module

? module.exports = a()

: "function" == typeof define && define.amd

? define("customProtocolCheck", [], a)

: "object" == typeof exports

? exports.customProtocolCheck = a()

: b.customProtocolCheck = a()

}(window, function () {

return function (b) {

var c = {};

function a(d) {

if (c[d])

return c[d].exports;

var e = c[d] = {

i: d,

l: !1,

exports: {}

};

return b[d].call(e.exports, e, e.exports, a),

e.l = !0,

e.exports

}

return a.m = b,

a.c = c,

a.d = function (b, c, d) {

a.o(b, c) || Object.defineProperty(b, c, {

enumerable: !0,

get: d

})

a.r = function (a) {

"undefined" != typeof Symbol && Symbol.toStringTag && Object.defineProperty(

Symbol.toStringTag,

{value: "Module"}

Object.defineProperty(a, "__esModule", {

value: !0

})

a.t = function (b, c) {

if (

1 & c && (b = a(b)),

8 & c || 4 & c && "object" == typeof b && b && b.__esModule

)

return b;

var d = Object.create(null);

if (a.r(d), Object.defineProperty(d, "default", {

enumerable: !0,

value: b

}), 2 & c && "string" != typeof b)

for (var e in b)

a.d(d, e, (function (a) {

return b[a]

}).bind(null, e));

return d

a.n = function (c) {

var b = c && c.__esModule

? function () {

return c.default

}

: function () {

return c

};

return a.d(b, "a", b),

a.o = function (a, b) {

return Object

.prototype

.hasOwnProperty

.call(a, b)

a.p = "",

a(a.s = 0)

}({

"./index.js": function (module, exports) {

eval(

'var browser = {\n getUserAgent: function getUserAgent() {\n return window.' +

'navigator.userAgent;\n },\n userAgentContains: function userAgentContains(br' +

'owserName) {\n browserName = browserName.toLowerCase();\n return this.ge' +

'tUserAgent().toLowerCase().indexOf(browserName) > -1;\n },\n isOSX: function' +

' isOSX() {\n return this.userAgentContains("Macintosh");\n },\n isFirefox' +

': function isFirefox() {\n return this.userAgentContains("firefox");\n },' +

'\n isInternetExplorer: function isInternetExplorer() {\n return this.userA' +

'gentContains("trident");\n },\n\n /**\r\n * Detects IE 11 and older\r\n ' +

'* @return {Boolean} Returns true when IE 11 and older\r\n */\n isIE: functi' +

'on isIE() {\n var ua = this.getUserAgent().toLowerCase(); // Test values.\n' +

' // Uncomment to check result\n // IE 10\n // ua = \'Mozilla/5.0 (com' +

'patible; MSIE 10.0; Windows NT 6.2; Trident/6.0)\';\n // IE 11\n // ua =' +

' \'Mozilla/5.0 (Windows NT 6.3; Trident/7.0; rv:11.0) like Gecko/20100101 Fire' +

'fox/12.0\';\n\n var msie = ua.indexOf("msie");\n\n if (msie > 0) {\n ' +

' // IE 10 or older\n return true;\n }\n\n var trident = ua.indexOf' +

'("trident/");\n\n if (trident > 0) {\n // IE 11\n return true;\n ' +

' } // other browser\n\n\n return false;\n },\n isEdge: function isEdge(' +

') {\n var ua = this.getUserAgent().toLowerCase(); // Test values.\n // U' +

'ncomment to check result\n // Edge\n // ua = \'Mozilla/5.0 (Windows NT 1' +

'0.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.135 S' +

'afari/537.36 Edge/12.10240\';\n\n var edge = ua.indexOf("edge");\n\n if ' +

'(edge > 0) {\n return true;\n }\n\n return false;\n },\n isChrome' +

': function isChrome() {\n // IE11 returns undefined for window.chrome\n ' +

'// and new Opera 30 outputs true for window.chrome\n // but needs to check ' +

'if window.opr is not undefined\n // and new IE Edge outputs to true for win' +

'dow.chrome\n // and if not iOS Chrome check\n var isChromium = window.ch' +

'rome;\n var winNav = window.navigator;\n var vendorName = winNav.vendor;' +

'\n var isOpera = typeof window.opr !== "undefined";\n var isIEedge = win' +

'Nav.userAgent.indexOf("Edge") > -1;\n var isIOSChrome = winNav.userAgent.ma' +

'tch("CriOS");\n return isChromium !== null && typeof isChromium !== "undefi' +

'ned" && vendorName === "Google Inc." && isOpera === false && isIEedge === fals' +

'e || isIOSChrome;\n },\n isWhale: function isWhale() {\n // IE11 returns ' +

'undefined for window.chrome\n // and new Opera 30 outputs true for window.c' +

'hrome\n // but needs to check if window.opr is not undefined\n // and ne' +

'w IE Edge outputs to true for window.chrome\n // and if not iOS Chrome chec' +

'k\n var isChromium = window.chrome;\n var winNav = window.navigator;\n ' +

' var vendorName = winNav.vendor;\n var isOpera = typeof window.opr !== "un' +

'defined";\n var isIEedge = winNav.userAgent.indexOf("Edge") > -1;\n var ' +

'isIOSChrome = winNav.userAgent.match("CriOS");\n return isChromium !== null' +

' && typeof isChromium !== "undefined" && vendorName === "NAVER Corp." && isOpe' +

'ra === false && isIEedge === false || isIOSChrome;\n },\n isOpera: function ' +

'isOpera() {\n return this.userAgentContains(" OPR/");\n }\n};\nvar DEFAULT' +

'_CUSTOM_PROTOCOL_FAIL_CALLBACK_TIMEOUT;\n\nvar registerEvent = function regist' +

'erEvent(target, eventType, cb) {\n if (target.addEventListener) {\n target' +

'.addEventListener(eventType, cb);\n return {\n remove: function remove' +

'() {\n target.removeEventListener(eventType, cb);\n }\n };\n }' +

' else {\n target.attachEvent(eventType, cb);\n return {\n remove: f' +

'unction remove() {\n target.detachEvent(eventType, cb);\n }\n }' +

';\n }\n};\n\nvar createHiddenIframe = function createHiddenIframe(target, uri' +

') {\n var iframe = document.createElement("iframe");\n iframe.src = uri;\n ' +

'iframe.id = "hiddenIframe";\n iframe.style.display = "none";\n target.append' +

'Child(iframe);\n return iframe;\n};\n\nvar openUriWithHiddenFrame = function ' +

'openUriWithHiddenFrame(uri, failCb, successCb) {\n var timeout = setTimeout(f' +

'unction () {\n failCb();\n handler.remove();\n }, DEFAULT_CUSTOM_PROTOC' +

'OL_FAIL_CALLBACK_TIMEOUT);\n var iframe = document.querySelector("#hiddenIfra' +

'me");\n\n if (!iframe) {\n iframe = createHiddenIframe(document.body, "abo' +

'ut:blank");\n }\n\n onBlur = function onBlur() {\n clearTimeout(timeout);' +

'\n handler.remove();\n successCb();\n };\n\n var handler = registerEve' +

'nt(window, "blur", onBlur);\n iframe.contentWindow.location.href = uri;\n};\n' +

'\nvar openUriWithTimeoutHack = function openUriWithTimeoutHack(uri, failCb, su' +

'ccessCb) {\n var timeout = setTimeout(function () {\n failCb();\n handl' +

'er.remove();\n }, DEFAULT_CUSTOM_PROTOCOL_FAIL_CALLBACK_TIMEOUT); //handle pa' +

'ge running in an iframe (blur must be registered with top level window)\n\n v' +

'ar target = window;\n\n while (target.parent && target != target.parent) {\n ' +

' target = target.parent;\n }\n\n onBlur = function onBlur() {\n clearTi' +

'meout(timeout);\n handler.remove();\n successCb();\n };\n\n var handle' +

'r = registerEvent(target, "blur", onBlur);\n window.location = uri;\n};\n\nva' +

'r openUriUsingFirefox = function openUriUsingFirefox(uri, failCb, successCb) {' +

'\n var iframe = document.querySelector("#hiddenIframe");\n\n if (!iframe) {' +

'\n iframe = createHiddenIframe(document.body, "about:blank");\n }\n\n try' +

' {\n iframe.contentWindow.location.href = uri;\n successCb();\n } catch' +

' (e) {\n if (e.name == "NS_ERROR_UNKNOWN_PROTOCOL") {\n failCb();\n ' +

' }\n }\n};\n\nvar openUriWithMsLaunchUri = function openUriWithMsLaunchUri(ur' +

'i, failCb, successCb) {\n navigator.msLaunchUri(uri, successCb, failCb);\n};' +

'\n\nvar getBrowserVersion = function getBrowserVersion() {\n var ua = window.' +

'navigator.userAgent;\n var tem,\n M = ua.match(/(opera|chrome|safari|fir' +

'efox|msie|trident(?=\\/))\\/?\\s*(\\d+)/i) || [];\n\n if (/trident/i.test(M[1' +

'])) {\n tem = /\\brv[ :]+(\\d+)/g.exec(ua) || [];\n return parseFloat(te' +

'm[1]) || "";\n }\n\n if (M[1] === "Chrome") {\n tem = ua.match(/\\b(OPR|E' +

'dge)\\/(\\d+)/);\n\n if (tem != null) {\n return parseFloat(tem[2]);\n' +

' }\n }\n\n M = M[2] ? [M[1], M[2]] : [window.navigator.appName, window.na' +

'vigator.appVersion, "-?"];\n if ((tem = ua.match(/version\\/(\\d+)/i)) != nul' +

'l) M.splice(1, 1, tem[1]);\n return parseFloat(M[1]);\n};\n\nvar protocolChec' +

'k = function protocolCheck(uri, failCb, successCb) {\n var timeout = argument' +

's.length > 3 && arguments[3] !== undefined ? arguments[3] : 2000;\n var unsup' +

'portedCb = arguments.length > 4 ? arguments[4] : undefined;\n\n var failCallb' +

'ack = function failCallback() {\n failCb && failCb();\n };\n\n var succes' +

'sCallback = function successCallback() {\n successCb && successCb();\n };' +

'\n\n var unsupportedCallback = function unsupportedCallback() {\n unsuppor' +

'tedCb && unsupportedCb();\n };\n\n var openUri = function openUri() {\n i' +

'f (browser.isFirefox()) {\n var browserVersion = getBrowserVersion();\n\n' +

' if (browserVersion >= 64) {\n openUriWithHiddenFrame(uri, failCal' +

'lback, successCallback);\n } else {\n openUriUsingFirefox(uri, fai' +

'lCallback, successCallback);\n }\n } else if (browser.isWhale()) {\n ' +

' openUriWithTimeoutHack(uri, failCallback, successCallback);\n } else if' +

' (browser.isChrome()) {\n openUriWithTimeoutHack(uri, failCallback, succe' +

'ssCallback);\n } else if (browser.isOSX()) {\n openUriWithHiddenFrame(' +

'uri, failCallback, successCallback);\n } else {\n //not supported, imp' +

'lement please\n unsupportedCallback();\n }\n };\n\n if (timeout) {\n' +

' DEFAULT_CUSTOM_PROTOCOL_FAIL_CALLBACK_TIMEOUT = timeout;\n }\n\n if (bro' +

'wser.isEdge() || browser.isIE()) {\n //for IE and Edge in Win 8 and Win 10' +

'\n openUriWithMsLaunchUri(uri, failCb, successCb);\n } else {\n if (doc' +

'ument.hasFocus()) {\n openUri();\n } else {\n var focusHandler = ' +

'registerEvent(window, "focus", function () {\n focusHandler.remove();\n' +

' openUri();\n });\n }\n }\n};\n\nmodule.exports = protocolChec' +

'k;\n\n//# sourceURL=webpack://customProtocolCheck/./index.js?'

)

0: function (module, exports, __webpack_require__) {

eval(

'module.exports = __webpack_require__(/*! /Users/shahv/Viresh/work/rnd/custom-p' +

'rotocol-check/index.js */"./index.js");\n\n\n//# sourceURL=webpack://customPro' +

'tocolCheck/multi_./index.js?'

)

}

})

When calling a custom scheme (Example: hivelauncher:?app_id=com.com2us.hivesdk.windows.steam.global.normal&start_point=9) that runs the Crossplay Launcher on the web, here’s the JavaScript code that runs the launcher if it has been already installed or handles the situation if it’s not been installed.


event.preventDefault
     ? event.preventDefault()
     :(event.returnValue = false);
window.customProtocolCheck({
     # Crossplay Launcher Execution URI (Custom Scheme)
}, function(e) {
     console.log("FAIL");
     {
         # Handling when the Crossplay Launcher fails to be executed
     }
}, function(e) {
     console.log("SUCCESS");
}, 2500, function (e) {
     console.log("Not Supported");
     {
         # Handling when there is no response for more than 2500 ms after requesting running the Crossplay Launcher
     }
});

event.preventDefault

? event.preventDefault()

:(event.returnValue = false);

window.customProtocolCheck({

# Crossplay Launcher Execution URI (Custom Scheme)

}, function(e) {

console.log("FAIL");

{

# Handling when the Crossplay Launcher fails to be executed

}

}, function(e) {

console.log("SUCCESS");

}, 2500, function (e) {

console.log("Not Supported");

{

# Handling when there is no response for more than 2500 ms after requesting running the Crossplay Launcher

}

});

Install Crossplay Launcher and Game All At Once

Since the game is installed and run using the Crossplay Launcher, you should implement to first install the Crossplay Launcher.

Install Crossplay Launcher: Given that the CrossPlay Launcher was not installed on the user’s PC, connect hivecrossplay-fn.qpyou.cn/hivecrossplay/p/w/Installer.exe to the CrossPlay Launcher installation file download button. The below is an example of linking to the “Download installation file” button.
Install Game: Go to Hive Console AppCenter > AppID Management > AppID List > Basic Info > Crossplay Info and develop your codes to copy the Game Auto Installation URI onto the user’s PC clipboard. After installing the Crossplay Launcher, the URI copied to the clipboard is used to install the game on the user’s PC when running the Crossplay Launcher.

When distributing your game through a customized page in a sandbox environment, here’s how to create the Game Auto Installation URI. For example, if the Game Auto Installation URI in AppCenter is “hivelauncher:?app_id=hivesdk.windows&start_point=9”

add the sandbox environment variable envi to the URI as a query string as follows.
- hivelauncher:?app_id=hivesdk.windows&envi=SANDBOX&start_point=9
Add the sha1 hashed value (lowercase) of the modified URI to the location after inserting a space. Then this URI can be used for distribution in a sandbox environment.
- hivelauncher:?app_id=hivesdk.windows&envi=SANDBOX&start_point=9 f3a426e2a65d6e0f6b61129905f15a2209b9746e

Running Game with Crossplay Launcher Installed

Go to Hive Console AppCenter > AppID Management > AppID List > Basic Info > Crossplay Info, and copy and link the Game Launch URI to the game play button. The below is an example linked to the “Play on PC” button.
Due to the difference between JAVA’s URLEncoder.encode() and JavaScript’s encodeURIComponent(), replaceAll(“\\+”, “%20”) is additionally required when processing in JAVA.

In a sandbox environment, you must add the environment (envi) to the Game Launch URI obtained from AppCenter as shown below. It is added in query string format as below, and you don’t need to add it for the commercial environment.

hivelauncher:?app_id=hivesdk.windows&envi=SANDBOX&start_point=9

Game upload

To install and update a game through Crossplay Launcher on a user’s PC, you need to upload your game data to the server in advance. For details about uploading the game data, see the Crossplay Launcher Tool guide.

Precautions

About Game

The meta.json file needs to locate in the top-level path of the game and include the relative paths of a game shortcut’s icon file(.ico) and a game executable(.exe). Refer to the Create a game icon file guide to create a game icon file in advance. (The shortcut file is used on Windows only so that games for Mac can omit the icon field.)

Example of meta.json

{"launch":"game/game.exe", "icon":"game/icon.ico", "delete":[{"type":"CSIDL", "path":"0x0023/test_delete"},  {"type":"general", "path":"C:/test_delete"},
{"type":"registrykey","root": "0x80000001","path" : "SOFTWARE\\{companyName}\\{productName}"}]}

1 2	{"launch":"game/game.exe", "icon":"game/icon.ico", "delete":[{"type":"CSIDL", "path":"0x0023/test_delete"}, {"type":"general", "path":"C:/test_delete"}, {"type":"registrykey","root": "0x80000001","path" : "SOFTWARE\\{companyName}\\{productName}"}]}

Refer to the [Crossplay Launcher Tool] guide. (Link: 3. HIVE_Launcher_Uploader > Example of application > step 1)

Delete files
The table below explains the delete parameter that deletes files additionally when removing a game.

Type	CSIDL (when each user’s path is different)	general	registrykey
Structure of path	CSIDL value + rest of the path	path	root + rest of the path
Examples	In destination path(C:\Users\username\AppData\Roaming), `C:\Users\username\AppData\Local` becomes 0x1C/../Roaming as it is a common path of CSIDL_LOCAL_APPDATA.	…	The destination path(HKEY_CURRENT_USER\SOFTWARE\Com2uS\regkey) consists of root `HKEY_CURRENT_USER(0x80000001)` and the rest of the path `SOFTWARE\\Com2uS\\regkey`. Note: The registry key to get rid of must not have subkeys.

[Reference guides]

CSIDL by Microsoft
CSIDL values
Recognized Environment Variables by Microsoft

The game shortcut generates on the user’s PC after installing the game. After then, the game shortcut is unable to change through game updates.
Unsupported when the game includes an empty folder. (Empty folder is unsupported.)
When you are developing your game, it is recommended to implement the function to avoid the duplication running of a game to run one game on one PC.
The path to the game installation
- If the path to the Crossplay Launcher installation includes the # or ; character, Crossplay Launcher does not expose the screen successfully or displays a file index screen.
- If the path to the game installation installed via Crossplay Launcher includes the # or ; character, the game displays a file index screen on the game screen or exposes the game screen only; because of not displaying the UI of the Hive SDK Windows as expected.
- The name of in-game folders also must not include the # or ; character.
After uploading a game build for the first time and if you want to upload the next version of your game build, the previous game build should be in “Distributing” status at Hive Console > Crossplay Launcher > Game management > Download Setting.

Checking Review State (Required)

Refer to the Crossplay Launcher Tool guide(Crossplay Launcher Uploader > Example > step 5).
Check the file deletion(delete) executes as expected.

Create a game icon file

Your game’s shortcut is created on the user’s PC and start menu after installing the game through Crossplay Launcher. This section describes how to create a game icon file for the shortcut by using ICO CONVERT.

Prepare an image file that you are using. (File format: PNG, JPG, or BMP)
Go to ICO CONVERT (https://icoconvert.com/).
Click Choose File to select an image file you prepared, then click Upload.
Choose the size you want to create. (16 x 16, 32 x 32, 48 x 48, 64 x 64, 128 x 128, 256 x 256)
Click Convert ICO, and download the icon file by clicking Download your icon(s).