If Body.customSeparateX or customSeparateY is true then the Body will no longer be automatically separated from a **Tilemap** collision or exchange any velocity. The amount of pixels that the Body has intersected the tile is available in Body.overlapX and overlapY, so you can use these values to perform your own separation in your collision callback (phaserjs#992)

Author: photonstorm

README.md

@@ -116,6 +116,7 @@ Thanks to @pnstickne for vast majority of this update.
 * Device.touch checks if `window.navigator.maxTouchPoints` is `>= 1` rather than > 1, which now allows touch events to work properly in Chrome mobile emulation.
 * Loader.XDomainRequest wasn't used for atlas json loading. It has now been moved to the `xhrLoad` method to ensure it's used for all request if required (thanks @draconisNoctis #1601)
 * Loader.reset has a new optional 2nd parameter `clearEvents` which if set to `true` (the default is false) will reset all event listeners bound to the Loader.
+* If `Body.customSeparateX` or `customSeparateY` is `true` then the Body will no longer be automatically separated from a **Tilemap** collision or exchange any velocity. The amount of pixels that the Body has intersected the tile is available in `Body.overlapX` and `overlapY`, so you can use these values to perform your own separation in your collision callback (#992)
 
 ### Bug Fixes
 

src/physics/arcade/World.js

@@ -1284,7 +1284,14 @@ Phaser.Physics.Arcade.prototype = {
 
         if (ox !== 0)
         {
-            this.processTileSeparationX(body, ox);
+            if (body.customSeparateX)
+            {
+                body.overlapX = ox;
+            }
+            else
+            {
+                this.processTileSeparationX(body, ox);
+            }
         }
 
         return ox;
@@ -1333,7 +1340,14 @@ Phaser.Physics.Arcade.prototype = {
 
         if (oy !== 0)
         {
-            this.processTileSeparationY(body, oy);
+            if (body.customSeparateY)
+            {
+                body.overlapY = oy;
+            }
+            else
+            {
+                this.processTileSeparationY(body, oy);
+            }
         }
 
         return oy;
@@ -1347,7 +1361,6 @@ Phaser.Physics.Arcade.prototype = {
     * @method Phaser.Physics.Arcade#processTileSeparationX
     * @param {Phaser.Physics.Arcade.Body} body - The Body object to separate.
     * @param {number} x - The x separation amount.
-    * @return {boolean} Returns true as a pass-thru to the separateTile method.
     */
     processTileSeparationX: function (body, x) {