npm - littlejsengine - Versions diffs - 1.8.9 → 1.9.1 - Mend

littlejsengine 1.8.9 → 1.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (48) hide show

package/README.md +17 -17
package/build/littlejs.d.ts +352 -288
package/build/littlejs.esm.js +695 -658
package/build/littlejs.esm.min.js +1 -1
package/build/littlejs.js +694 -658
package/build/littlejs.min.js +1 -1
package/build/littlejs.release.js +629 -594
package/examples/breakout/game.js +4 -4
package/examples/breakout/index.html +3 -3
package/examples/breakoutTutorial/index.html +2 -2
package/examples/electron/game.js +1 -1
package/examples/electron/index.html +2 -2
package/examples/favicon.png +0 -0
package/examples/js13k/build.js +1 -1
package/examples/js13k/index.html +13 -13
package/examples/module/game.js +1 -1
package/examples/module/index.html +1 -1
package/examples/particles/index.html +1 -1
package/examples/platformer/game.js +6 -6
package/examples/platformer/gameCharacter.js +293 -0
package/examples/platformer/gameEffects.js +8 -5
package/examples/platformer/gameObjects.js +13 -13
package/examples/platformer/gamePlayer.js +9 -293
package/examples/platformer/index.html +7 -6
package/examples/puzzle/game.js +3 -2
package/examples/puzzle/index.html +2 -2
package/examples/starter/build.js +1 -1
package/examples/starter/game.js +2 -2
package/examples/starter/index.html +13 -13
package/examples/stress/index.html +35 -27
package/examples/typescript/index.html +1 -1
package/index.d.ts +2094 -0
package/package.json +1 -1
package/src/engine.js +28 -28
package/src/engineAudio.js +57 -57
package/src/engineDebug.js +66 -65
package/src/engineDraw.js +64 -73
package/src/engineExport.js +1 -0
package/src/engineInput.js +57 -40
package/src/engineMedals.js +32 -29
package/src/engineObject.js +42 -27
package/src/engineParticles.js +98 -72
package/src/engineRelease.js +1 -1
package/src/engineSettings.js +22 -22
package/src/engineTileLayer.js +66 -60
package/src/engineUtilities.js +49 -49
package/src/engineWebGL.js +112 -135
package/src/jsconfig.json +10 -0

package/examples/breakout/game.js CHANGED Viewed

@@ -9,7 +9,7 @@
 'use strict';
 // show the LittleJS splash screen
-showSplashScreen = 1;
+setShowSplashScreen(true);
 let levelSize, ball, paddle, score, brickCount;
@@ -71,11 +71,11 @@ function gameRenderPost()
 {
     // use built in image font for text
     const font = new FontImage;
-    font.drawText('Score: ' + score, cameraPos.add(vec2(0,9.6)), .15, 1);
+    font.drawText('Score: ' + score, cameraPos.add(vec2(0,9.6)), .15, true);
     if (!brickCount)
-        font.drawText('You Win!', cameraPos.add(vec2(0,-5)), .2, 1);
+        font.drawText('You Win!', cameraPos.add(vec2(0,-5)), .2, true);
     else if (!ball)
-        font.drawText('Click to Play', cameraPos.add(vec2(0,-5)), .2, 1);
+        font.drawText('Click to Play', cameraPos.add(vec2(0,-5)), .2, true);
 }
 ///////////////////////////////////////////////////////////////////////////////

package/examples/breakout/index.html CHANGED Viewed

@@ -5,6 +5,6 @@
 <link rel=icon type=image/png href=../favicon.png>
 </head><body>
-<script src=../../build/littlejs.js?188></script>
-<script src=gameObjects.js?188></script>
-<script src=game.js?188></script>
+<script src=../../build/littlejs.js?1812></script>
+<script src=gameObjects.js?1812></script>
+<script src=game.js?1812></script>

package/examples/breakoutTutorial/index.html CHANGED Viewed

@@ -5,5 +5,5 @@
 <link rel=icon type=image/png href=../favicon.png>
 </head><body>
-<script src=../../build/littlejs.js?188></script>
-<script src=game.js?188></script>
+<script src=../../build/littlejs.js?1812></script>
+<script src=game.js?1812></script>

package/examples/electron/game.js CHANGED Viewed

@@ -17,7 +17,7 @@ medalsInit('Hello World');
 let particleEmiter;
 // show the LittleJS splash screen
-showSplashScreen = 1;
+setShowSplashScreen(true);
 ///////////////////////////////////////////////////////////////////////////////
 function gameInit()

package/examples/electron/index.html CHANGED Viewed

@@ -6,7 +6,7 @@
 </head><body>
 <!-- LittleJS Engine -->
-<script src=../../build/littlejs.js?188></script>
+<script src=../../build/littlejs.js?1812></script>
 <!-- Add your game scripts here -->
-<script src=game.js?188></script>
+<script src=game.js?1812></script>

package/examples/favicon.png CHANGED Viewed

Binary file

package/examples/js13k/build.js CHANGED Viewed

@@ -26,7 +26,7 @@ const fs = require('node:fs');
 const child_process = require('node:child_process');
 // rebuild engine
-child_process.execSync(`npm run build`, { stdio: 'inherit' });
+//child_process.execSync(`npm run build`, { stdio: 'inherit' });
 // remove old files and setup build folder
 fs.rmSync(BUILD_FOLDER, { recursive: true, force: true });

package/examples/js13k/index.html CHANGED Viewed

@@ -1,18 +1,18 @@
 <head><title>LittleJS JS13K Project</title></head><body>
 <!-- LittleJS Engine -->
-<script src=../../src/engineDebug.js?188></script>
-<script src=../../src/engineUtilities.js?188></script>
-<script src=../../src/engineSettings.js?188></script>
-<script src=../../src/engineObject.js?188></script>
-<script src=../../src/engineDraw.js?188></script>
-<script src=../../src/engineInput.js?188></script>
-<script src=../../src/engineAudio.js?188></script>
-<script src=../../src/engineTileLayer.js?188></script>
-<script src=../../src/engineParticles.js?188></script>
-<script src=../../src/engineMedals.js?188></script>
-<script src=../../src/engineWebGL.js?188></script>
-<script src=../../src/engine.js?188></script>
+<script src=../../src/engineDebug.js?1812></script>
+<script src=../../src/engineUtilities.js?1812></script>
+<script src=../../src/engineSettings.js?1812></script>
+<script src=../../src/engineObject.js?1812></script>
+<script src=../../src/engineDraw.js?1812></script>
+<script src=../../src/engineInput.js?1812></script>
+<script src=../../src/engineAudio.js?1812></script>
+<script src=../../src/engineTileLayer.js?1812></script>
+<script src=../../src/engineParticles.js?1812></script>
+<script src=../../src/engineMedals.js?1812></script>
+<script src=../../src/engineWebGL.js?1812></script>
+<script src=../../src/engine.js?1812></script>
 <!-- Add your game scripts here -->
-<script src=game.js?188></script>
+<script src=game.js?1812></script>

package/examples/module/game.js CHANGED Viewed

@@ -11,7 +11,7 @@ import * as LittleJS from '../../build/littlejs.esm.js';
 const {Vector2, Color, Timer, vec2, tile} = LittleJS;
 // show the LittleJS splash screen
-LittleJS.setShowSplashScreen(1);
+LittleJS.setShowSplashScreen(true);
 // sound effects
 const sound_click = new LittleJS.Sound([1,.5]);

package/examples/module/index.html CHANGED Viewed

@@ -6,4 +6,4 @@
 </head><body>
 <!-- Add your game scripts here -->
-<script src=game.js?188 type=module></script>
+<script src=game.js?1812 type=module></script>

package/examples/particles/index.html CHANGED Viewed

@@ -9,7 +9,7 @@ button { margin:1px; }
 </style>
 </head><body>
-<script src=../../build/littlejs.js?188></script>
+<script src=../../build/littlejs.js?1812></script>
 <script>
 'use strict';

package/examples/platformer/game.js CHANGED Viewed

@@ -9,7 +9,7 @@
 'use strict';
 // show the LittleJS splash screen
-showSplashScreen = 1;
+setShowSplashScreen(true);
 let score, deaths;
@@ -17,7 +17,7 @@ let score, deaths;
 function gameInit()
 {
     // enable touch gamepad on touch devices
-    touchGamepadEnable = 1;
+    touchGamepadEnable = true;
     // setup game
     score = deaths = 0;
@@ -44,19 +44,19 @@ function gameUpdate()
     cameraScale = clamp(cameraScale*(1-mouseWheel/10), 1, 1e3);
     // T = drop test crate
-    if (keyWasPressed(84))
+    if (keyWasPressed('KeyT'))
         new Crate(mousePos);
     // E = drop enemy
-    if (keyWasPressed(69))
+    if (keyWasPressed('KeyE'))
         new Enemy(mousePos);
     // X = make explosion
-    if (keyWasPressed(88))
+    if (keyWasPressed('KeyX'))
         explosion(mousePos);
     // M = move player to mouse
-    if (keyWasPressed(77))
+    if (keyWasPressed('KeyM'))
         player.pos = mousePos;
 }

package/examples/platformer/gameCharacter.js ADDED Viewed

@@ -0,0 +1,293 @@
+/*
+    LittleJS Platformer Example - Character
+    - Platform style character
+    - Handles animation and sound effects
+    - Uses special platforming physics system
+    - Characters can jump, shoot, roll, and throw grenades
+    - Characters can climb ladders and break blocks
+    - Characters also have a damage and can die
+    - Has a weapon which can be fired
+*/
+'use strict';
+class Character extends GameObject
+{
+    constructor(pos)
+    {
+        super(pos, vec2(.6,.95), tile());
+        this.weapon = new Weapon(pos, this);
+        this.lastPos = pos;
+        this.groundTimer        = new Timer;
+        this.jumpTimer          = new Timer;
+        this.pressedJumpTimer   = new Timer;
+        this.dodgeTimer         = new Timer;
+        this.dodgeRechargeTimer = new Timer;
+        this.deadTimer          = new Timer;
+        this.grendeThrowTimer   = new Timer;
+        this.drawSize = vec2(1);
+        this.color = (new Color).setHSLA(rand(),1,.7);
+        this.renderOrder = 10;
+        this.walkCyclePercent = 0;
+        this.health = 1;
+        this.setCollision(true,false);
+    }
+    update()
+    {
+        this.gravityScale = 1; // reset to default gravity
+        if (this.isDead())
+            return super.update();
+        const moveInput = this.moveInput.copy();
+        // jump
+        if (!this.holdingJump)
+            this.pressedJumpTimer.unset();
+        else if (!this.wasHoldingJump || this.climbingWall)
+            this.pressedJumpTimer.set(.3);
+        this.wasHoldingJump = this.holdingJump;
+        // wall climb
+        this.climbingWall = 0;
+        if (moveInput.x && !this.velocity.x && this.velocity.y < 0)
+        {
+            this.velocity.y *=.8;
+            this.climbingWall = 1;
+        }
+        if (this.dodgeTimer.active())
+        {
+            // update roll
+            this.angle = this.getMirrorSign()*2*PI*this.dodgeTimer.getPercent();
+            if (this.groundObject)
+                this.velocity.x += this.getMirrorSign()*.1;
+        }
+        else
+        {
+            // not rolling
+            this.angle = 0;
+            if (this.pressedDodge && !this.dodgeRechargeTimer.active())
+            {
+                // start dodge
+                this.dodgeTimer.set(.4);
+                this.dodgeRechargeTimer.set(2);
+                this.jumpTimer.unset();
+                sound_dodge.play(this.pos);
+                if (!this.groundObject && this.getAliveTime() > .2)
+                    this.velocity.y += .2;
+            }
+            if (this.pressingThrow && !this.wasPressingThrow && !this.grendeThrowTimer.active())
+            {
+                // throw greande
+                const grenade = new Grenade(this.pos);
+                grenade.velocity = this.velocity.add(vec2(this.getMirrorSign(),rand(.8,.7)).normalize(.2+rand(.02)));
+                grenade.angleVelocity = this.getMirrorSign() * rand(.8,.5);
+                sound_jump.play(this.pos);
+                this.grendeThrowTimer.set(1);
+            }
+            this.wasPressingThrow = this.pressingThrow;
+        }
+        // allow grabbing ladder at head or feet
+        let touchingLadder = 0;
+        for (let y=2;y--;)
+        {
+            const testPos = this.pos.add(vec2(0, y + .1*moveInput.y - this.size.y/2));
+            const collisionData = getTileCollisionData(testPos);
+            touchingLadder ||= collisionData == tileType_ladder;
+        }
+        if (!touchingLadder)
+            this.climbingLadder = 0;
+        else if (moveInput.y)
+            this.climbingLadder = 1;
+        if (this.weapon) // update weapon trigger
+            this.weapon.triggerIsDown = this.holdingShoot && !this.dodgeTimer.active();
+        if (this.climbingLadder)
+        {
+            // update ladder
+            this.gravityScale = this.climbingWall = this.groundObject = 0;
+            this.jumpTimer.unset();
+            this.groundTimer.unset();
+            this.velocity = this.velocity.multiply(vec2(.85)).add(vec2(0,.02*moveInput.y));
+            // pull towards ladder
+            const delta = (this.pos.x|0)+.5 - this.pos.x;
+            this.velocity.x += .02*delta*abs(moveInput.x ? 0:moveInput.y);
+            moveInput.x *= .2;
+            // exit ladder if ground is below
+            this.climbingLadder = moveInput.y >= 0 || getTileCollisionData(this.pos.subtract(vec2(0,1))) <= 0;
+        }
+        else
+        {
+            // update jumping and ground check
+            if (this.groundObject || this.climbingWall)
+            {
+                if (!this.groundTimer.isSet())
+                    sound_walk.play(this.pos); // land sound
+                this.groundTimer.set(.1);
+            }
+            if (this.groundTimer.active() && !this.dodgeTimer.active())
+            {
+                // is on ground
+                if (this.pressedJumpTimer.active() && !this.jumpTimer.active())
+                {
+                    // start jump
+                    if (this.climbingWall)
+                        this.velocity.y = .25;
+                    else
+                    {
+                        this.velocity.y = .15;
+                        this.jumpTimer.set(.2);
+                    }
+                    sound_jump.play(this.pos);
+                }
+            }
+            if (this.jumpTimer.active() && !this.climbingWall)
+            {
+                // update variable height jump
+                this.groundTimer.unset();
+                if (this.holdingJump && this.velocity.y > 0 && this.jumpTimer.active())
+                    this.velocity.y += .017;
+            }
+            if (!this.groundObject)
+            {
+                // air control
+                if (sign(moveInput.x) == sign(this.velocity.x))
+                    moveInput.x *= .1; // moving with velocity
+                else
+                    moveInput.x *= .2; // moving against velocity (stopping)
+                // slight extra gravity when moving down
+                if (this.velocity.y < 0)
+                    this.velocity.y += gravity*.2;
+            }
+        }
+        // apply movement acceleration and clamp
+        const maxCharacterSpeed = .2;
+        this.velocity.x = clamp(this.velocity.x + moveInput.x * .042, -maxCharacterSpeed, maxCharacterSpeed);
+        // track last pos for ladder collision code
+        this.lastPos = this.pos.copy();
+        // call parent and update physics
+        super.update();
+        // update walk cycle
+        const speed = this.velocity.length();
+        if (this.climbingLadder || this.groundTimer.active() && !this.dodgeTimer.active())
+        {
+            this.walkCyclePercent += speed * .5;
+            this.walkCyclePercent = speed > .01 ? mod(this.walkCyclePercent) : 0;
+        }
+        else
+            this.walkCyclePercent = 0;
+        // update walk sound
+        this.walkSoundTime += speed;
+        if (speed > .001 && ((this.climbingLadder || this.groundTimer.active()) && !this.dodgeTimer.active()))
+        {
+            if (this.walkSoundTime > 1)
+            {
+                this.walkSoundTime = this.walkSoundTime%1;
+                sound_walk.play(this.pos);
+            }
+        }
+        else
+            this.walkSoundTime = 0;
+        // update mirror
+        if (moveInput.x && !this.dodgeTimer.active())
+            this.mirror = moveInput.x < 0;
+        // set tile to use
+        const tile = this.isDead() ? 3 :
+            this.climbingLadder || this.groundTimer.active() ? 3 + 2*this.walkCyclePercent|0 : 4;
+        this.tileInfo.pos.x = tile * 16;
+    }
+    render()
+    {
+        let bodyPos = this.pos;
+        if (!this.isDead())
+        {
+            // bounce pos with walk cycle
+            bodyPos = bodyPos.add(vec2(0,.05*Math.sin(this.walkCyclePercent*PI)));
+            // make bottom flush
+            bodyPos = bodyPos.add(vec2(0,(this.drawSize.y-this.size.y)/2));
+        }
+        drawTile(bodyPos, this.drawSize, this.tileInfo, this.color, this.angle, this.mirror);
+    }
+    damage(damage, damagingObject)
+    {
+        if (this.isDead() || this.getAliveTime() < 1 || this.dodgeTimer.active())
+            return;
+        makeBlood(damagingObject ? damagingObject.pos : this.pos);
+        super.damage(damage, damagingObject);
+    }
+    kill(damagingObject)
+    {
+        if (this.isDead())
+            return;
+        makeBlood(this.pos, 300);
+        sound_die.play(this.pos);
+        this.health = 0;
+        if (this.weapon)
+            this.weapon.destroy();
+        this.deadTimer.set();
+        this.size = this.size.scale(.5);
+        const fallDirection = damagingObject ? sign(damagingObject.velocity.x) : randSign();
+        this.angleVelocity = fallDirection*rand(.22,.14);
+        this.angleDamping = .9;
+        this.renderOrder = -1;  // move to back layer
+    }
+    collideWithTile(data, pos)
+    {
+        if (!data)
+            return;
+        if (data == tileType_ladder)
+        {
+            // handle ladder collisions
+            if (pos.y + 1 > this.lastPos.y - this.size.y/2)
+                return;
+            if (getTileCollisionData(pos.add(vec2(0,1)))      // above
+                && !getTileCollisionData(pos.add(vec2(1,0)))  // left
+                && !getTileCollisionData(pos.add(vec2(1,0)))) // right
+                return; // dont collide if something above it and nothing to left or right
+            // allow standing on top of ladders
+            return !this.climbingLadder;
+        }
+        const d = pos.y - this.pos.y;
+        if (!this.climbingLadder && this.velocity.y > .1 && d > 0 && d < this.size.y/2)
+        if (destroyTile(pos))
+        {
+            // break blocks above
+            this.velocity.y = 0;
+            return;
+        }
+        return 1;
+    }
+}

package/examples/platformer/gameEffects.js CHANGED Viewed

@@ -18,7 +18,7 @@ const sound_destroyObject =new Sound([.5,,1e3,.02,,.2,1,3,.1,,,,,1,-30,.5,,.5]);
 const sound_die =          new Sound([.5,.4,126,.05,,.2,1,2.09,,-4,,,1,1,1,.4,.03]);
 const sound_jump =         new Sound([.4,.2,250,.04,,.04,,,1,,,,,3]);
 const sound_dodge =        new Sound([.4,.2,150,.05,,.05,,,-1,,,,,4,,,,,.02]);
-const sound_walk =         new Sound([.3,.1,200,,,.01,4,,,,-9,.1,,,,,,.5]);
+const sound_walk =         new Sound([.3,.1,50,.005,,.01,4,,,,,,,,10,,,.5]);
 const sound_explosion =    new Sound([2,.2,72,.01,.01,.2,4,,,,,,,1,,.5,.1,.5,.02]);
 const sound_grenade =      new Sound([.5,.01,300,,,.02,3,.22,,,-9,.2,,,,,,.5]);
 const sound_killEnemy =    new Sound([,,783,,.03,.02,1,2,,,940,.03,,,,,.2,.6,,.06]);
@@ -29,7 +29,7 @@ const sound_killEnemy =    new Sound([,,783,,.03,.02,1,2,,,940,.03,,,,,.2,.6,,.0
 const persistentParticleDestroyCallback = (particle)=>
 {
     // copy particle to tile layer on death
-    ASSERT(!particle.tileInfo); // quick draw to tile layer uses canvas 2d so must be untextured
+    ASSERT(!particle.tileInfo, 'quick draw to tile layer uses canvas 2d so must be untextured');
     if (particle.groundObject)
         tileLayer.drawTile(particle.pos, particle.size, particle.tileInfo, particle.color, particle.angle, particle.mirror);
 }
@@ -237,8 +237,7 @@ function drawSky()
 function drawStars()
 {
     // draw stars and planets
-    const random = new RandomGenerator;
-    random.seed = skySeed;
+    const random = new RandomGenerator(skySeed);
     const largeStarCount = 9;
     for (let i = 1e3; i--;)
     {
@@ -263,7 +262,11 @@ function drawStars()
         if (size < 9)
             mainContext.fillRect(screenPos.x, screenPos.y, size, size);
         else
-            mainContext.beginPath(mainContext.fill(mainContext.arc(screenPos.x, screenPos.y, size, 0, 9)));
+        {
+            mainContext.arc(screenPos.x, screenPos.y, size, 0, 9);
+            mainContext.fill();
+            mainContext.beginPath();
+        }
     }
 }

package/examples/platformer/gameObjects.js CHANGED Viewed

@@ -1,9 +1,9 @@
 /*
     LittleJS Platformer Example - Objects
     - Base GameObject class for objects with health
-    - Crate object collides with player, can be destroyed.
-    - Weapon is held by player and fires bullets with some settings.
-    - Bullet is the projectile launched by a weapon.
+    - Crate object collides with player, can be destroyed
+    - Weapon is held and fires bullets with some settings
+    - Bullet is the projectile launched by a weapon
 */
 'use strict';
@@ -77,7 +77,7 @@ class Crate extends GameObject
     kill()
     {
-        if (this.isDestroyed)
+        if (this.destroyed)
             return;
         sound_destroyObject.play(this.pos);
@@ -98,7 +98,7 @@ class Enemy extends GameObject
         this.color = (new Color).setHSLA(rand(), 1, .7);
         this.health = 5;
         this.bounceTime = new Timer(rand(1e3));
-        this.setCollision(1,0);
+        this.setCollision(true, false);
     }
     update()
@@ -122,7 +122,7 @@ class Enemy extends GameObject
     kill()
     {
-        if (this.isDestroyed)
+        if (this.destroyed)
             return;
         ++score;
@@ -157,7 +157,7 @@ class Grenade extends GameObject
         this.friction     = .9;
         this.angleDamping = .96;
         this.renderOrder  = 1e8;
-        this.setCollision(1,0);
+        this.setCollision(true,false);
     }
     update()
@@ -181,10 +181,10 @@ class Grenade extends GameObject
         drawTile(this.pos, vec2(.5), this.tileInfo, this.color, this.angle);
         // draw additive flash when damaged
-        setBlendMode(1);
+        setBlendMode(true);
         const flash = Math.cos(this.getAliveTime()*2*PI);
         drawTile(this.pos, vec2(2), tile(0, 16), new Color(1,0,0,.2-.2*flash));
-        setBlendMode(0);
+        setBlendMode(false);
     }
 }
@@ -197,10 +197,10 @@ class Weapon extends EngineObject
         super(pos, vec2(.6), tile(2,8));
         // weapon settings
-        this.fireRate     = 8;
-        this.bulletSpeed  = .5;
-        this.bulletSpread = .1;
-        this.damage       = 1;
+        this.fireRate      = 8;
+        this.bulletSpeed   = .5;
+        this.bulletSpread  = .1;
+        this.damage        = 1;
         // prepare to fire
         this.renderOrder = parent.renderOrder + 1;