{"__v":4,"_id":"57570992bb92962900db0a0b","category":{"__v":0,"_id":"575709000fd6a3200010dded","project":"56abbf55f25f160d00e17f4e","version":"56abbf55f25f160d00e17f51","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-06-07T17:48:48.065Z","from_sync":false,"order":0,"slug":"test","title":"Platform Overview"},"parentDoc":null,"project":"56abbf55f25f160d00e17f4e","user":"56bcdc8ae0b1580d00b5d149","version":{"__v":12,"_id":"56abbf55f25f160d00e17f51","project":"56abbf55f25f160d00e17f4e","createdAt":"2016-01-29T19:36:53.665Z","releaseDate":"2016-01-29T19:36:53.665Z","categories":["56abbf56f25f160d00e17f52","56abca6bf9757e0d007c6650","56acddfa0ab3c00d00ce3332","56af65da9d32e30d0006d30f","56af66cab34d210d003d9ad0","56af6afcd21e9c0d00b628d1","56af6d6ecc4cbd0d00ce2c88","5705b12221cfed0e00e8c580","570a5676ade45d0e00c1ad33","570d7d25d1e4b82000d9e385","570eac3c3160d10e0041df0e","575709000fd6a3200010dded"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-07T17:51:14.545Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"To create your game, go to the [game upload page](http://www.kongregate.com/games/new). Here you'll input basic information, like the game title, description, etc.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4c375dd-2016-07-21_16-23-18.png\",\n        \"2016-07-21_16-23-18.png\",\n        1456,\n        680,\n        \"#ececec\"\n      ]\n    }\n  ]\n}\n[/block]\nBelow that are a few specialized sections.\n- **Collaborators**: You can designate up to 3 additional Kongregate usernames to be \"collaborators\". These users will have access to the unpublished (_preview) version of the game, will be able to make free purchases for testing, and will show up in the game details as a collaborator.\n- **API Callback URL**: If your game is going to be utilizing one of our server APIs that requires a callback URL this is will you will enter it.\n- **Bug Reports**: We can add a \"report a bug\" button next to your game and send them via email to you. If you select this you will have the option to specify the target email address. \n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7d244ad-2016-07-21_16-12-58.png\",\n        \"2016-07-21_16-12-58.png\",\n        1404,\n        558,\n        \"#ebebeb\"\n      ]\n    }\n  ]\n}\n[/block]\nOn the following page you will first select the type of game upload. \n- **Flash/HTML5/WebGL**: In these cases you'll upload your files directly to our server and we'll take care of hosting them.\n- **Unity Web Player**: This is a special case in which we will host a .unity3d file and optionally also a WebGL version for players using NPAPI-disabled browsers. By the end of the 2016 nearly all browsers will be NPAPI-disabled, so we don't recommend this option if you can help it.\n- **Iframe**: In this case you'll give us a URL to point to and you will be able to host and serve the game files on your own server.\n\n**Additional Files** is an option to upload a .zip with supplemental files to your base .html or .swf loader.\n\n**Disable scaling** allows you to turn off auto-scaling when players view the game in Kongregate's larger \"Cinematic Mode\". This may be necessary depending on how your game handles scaling.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e268f86-2016-07-21_16-27-31.png\",\n        \"2016-07-21_16-27-31.png\",\n        1624,\n        538,\n        \"#eaeaea\"\n      ]\n    }\n  ]\n}\n[/block]\nBelow that you'll be able to submit some art, request access to our Virtual Goods Payments API, and confirm a few basic assertions. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/efe5dce-2016-07-21_16-42-01.png\",\n        \"2016-07-21_16-42-01.png\",\n        1790,\n        1378,\n        \"#ededed\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"If have an iframe game and you use cookies, you’ll need to be careful to set your P3P headers for Internet Explorer and have a security workaround in Safari. Without these the games won't function in those browsers. Safari is optional as it's a very small percentage of users, but we ask that if you don't support it that you detect the browser and suggest switching to Firefox or Chrome.\",\n  \"title\": \"Cross-Domain Cookies\"\n}\n[/block]\nIf you select \"iframe\", a few more options will be made available.\n- **Required Plugin**: This option will be removed soon due to NPAPI deprecation, but it allows you to identify any special requirements to play the game.\n- **Min Width/Height**: Specify the minimum frame size that your game can operate in.\n- **Max Width/Height**: If you leave these blank, the game frame will always be the minimum set above. If however you specify maxima, the game's frame will automatically, dynamically size to appropriately match the player's browser window. You can then ensure your game matches the dimensions of the Parent frame in order to take advantage of this resizing.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/cce924b-2016-07-21_19-43-24.png\",\n        \"2016-07-21_19-43-24.png\",\n        644,\n        538,\n        \"#ebebeb\"\n      ],\n      \"border\": false\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"(*Nope, that's not a typo!*)\\n\\nThe minimum game frame should try to stay under 1100x700px to account for shorter laptop screens that make up a fair amount of our audience. We have a fairly hard line at 1150x750px as the maximum required size if at all possible.\",\n  \"title\": \"Maximum Minimum Game Dimensions\"\n}\n[/block]\nFinally, you'll have the option to specify some [statistics for your game](doc:concepts-statistics) and add some tags that help users locate your game based on interests.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/faec1be-2016-07-21_16-46-34.png\",\n        \"2016-07-21_16-46-34.png\",\n        1878,\n        1054,\n        \"#323435\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nNow that the game is created, you can preview it with full access to our APIs in a sandboxed environment. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/rptNt4xRDmoaEChdnjAU_dev-preview.png\",\n        \"dev-preview.png\",\n        \"683\",\n        \"345\",\n        \"#9f1420\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"uploading-your-game","type":"basic","title":"Uploading Your Game"}

Uploading Your Game


To create your game, go to the [game upload page](http://www.kongregate.com/games/new). Here you'll input basic information, like the game title, description, etc. [block:image] { "images": [ { "image": [ "https://files.readme.io/4c375dd-2016-07-21_16-23-18.png", "2016-07-21_16-23-18.png", 1456, 680, "#ececec" ] } ] } [/block] Below that are a few specialized sections. - **Collaborators**: You can designate up to 3 additional Kongregate usernames to be "collaborators". These users will have access to the unpublished (_preview) version of the game, will be able to make free purchases for testing, and will show up in the game details as a collaborator. - **API Callback URL**: If your game is going to be utilizing one of our server APIs that requires a callback URL this is will you will enter it. - **Bug Reports**: We can add a "report a bug" button next to your game and send them via email to you. If you select this you will have the option to specify the target email address. [block:image] { "images": [ { "image": [ "https://files.readme.io/7d244ad-2016-07-21_16-12-58.png", "2016-07-21_16-12-58.png", 1404, 558, "#ebebeb" ] } ] } [/block] On the following page you will first select the type of game upload. - **Flash/HTML5/WebGL**: In these cases you'll upload your files directly to our server and we'll take care of hosting them. - **Unity Web Player**: This is a special case in which we will host a .unity3d file and optionally also a WebGL version for players using NPAPI-disabled browsers. By the end of the 2016 nearly all browsers will be NPAPI-disabled, so we don't recommend this option if you can help it. - **Iframe**: In this case you'll give us a URL to point to and you will be able to host and serve the game files on your own server. **Additional Files** is an option to upload a .zip with supplemental files to your base .html or .swf loader. **Disable scaling** allows you to turn off auto-scaling when players view the game in Kongregate's larger "Cinematic Mode". This may be necessary depending on how your game handles scaling. [block:image] { "images": [ { "image": [ "https://files.readme.io/e268f86-2016-07-21_16-27-31.png", "2016-07-21_16-27-31.png", 1624, 538, "#eaeaea" ] } ] } [/block] Below that you'll be able to submit some art, request access to our Virtual Goods Payments API, and confirm a few basic assertions. [block:image] { "images": [ { "image": [ "https://files.readme.io/efe5dce-2016-07-21_16-42-01.png", "2016-07-21_16-42-01.png", 1790, 1378, "#ededed" ], "sizing": "full" } ] } [/block] [block:callout] { "type": "warning", "body": "If have an iframe game and you use cookies, you’ll need to be careful to set your P3P headers for Internet Explorer and have a security workaround in Safari. Without these the games won't function in those browsers. Safari is optional as it's a very small percentage of users, but we ask that if you don't support it that you detect the browser and suggest switching to Firefox or Chrome.", "title": "Cross-Domain Cookies" } [/block] If you select "iframe", a few more options will be made available. - **Required Plugin**: This option will be removed soon due to NPAPI deprecation, but it allows you to identify any special requirements to play the game. - **Min Width/Height**: Specify the minimum frame size that your game can operate in. - **Max Width/Height**: If you leave these blank, the game frame will always be the minimum set above. If however you specify maxima, the game's frame will automatically, dynamically size to appropriately match the player's browser window. You can then ensure your game matches the dimensions of the Parent frame in order to take advantage of this resizing. [block:image] { "images": [ { "image": [ "https://files.readme.io/cce924b-2016-07-21_19-43-24.png", "2016-07-21_19-43-24.png", 644, 538, "#ebebeb" ], "border": false } ] } [/block] [block:callout] { "type": "info", "body": "(*Nope, that's not a typo!*)\n\nThe minimum game frame should try to stay under 1100x700px to account for shorter laptop screens that make up a fair amount of our audience. We have a fairly hard line at 1150x750px as the maximum required size if at all possible.", "title": "Maximum Minimum Game Dimensions" } [/block] Finally, you'll have the option to specify some [statistics for your game](doc:concepts-statistics) and add some tags that help users locate your game based on interests. [block:image] { "images": [ { "image": [ "https://files.readme.io/faec1be-2016-07-21_16-46-34.png", "2016-07-21_16-46-34.png", 1878, 1054, "#323435" ], "sizing": "full" } ] } [/block] Now that the game is created, you can preview it with full access to our APIs in a sandboxed environment. [block:image] { "images": [ { "image": [ "https://files.readme.io/rptNt4xRDmoaEChdnjAU_dev-preview.png", "dev-preview.png", "683", "345", "#9f1420", "" ], "sizing": "full" } ] } [/block]