Paper Dog Dash

Description

Paper Dog Dash is a platformer game where the player takes control of a newspaper delivery dog who has to deliver the newspaper to the house before the timer runs out. The dog has to navigate through various obstacles, jump over hurdles, duck under low passages and crawl through narrow spaces to complete the delivery successfully.

Controls

The game can be played using the following keyboard controls:

Up arrow: Jump Left arrow: Move left Down arrow: Duck/Crawl Right arrow: Move right Space bar: Throw newspaper

How to Play

The objective of the game is to deliver the newspaper to the house before the timer runs out. The player must navigate through different levels filled with obstacles and enemies to reach the house. The player can jump over hurdles, duck under low passages and crawl through narrow spaces to avoid obstacles.

The game has multiple levels, each with increasing difficulty. The player must complete each level within a specific time limit to progress to the next level.

Screenshots

Video

Gameplay.mp4

First steps

This project requires Node.js and NPM.js. It is recommended that you learn the basics of ViteJS.

Install dependencies:
```
npm install
```
Run the development server:
```
npm run dev
```
Open the browser at http://localhost:3000.
Make a production build:
```
npm run build
```
It is generated in the /dist folder.

Run the editor

You can run the editor using the editor NPM script, defined in the package.json file:
```
$ npm install
$ npm run editor
```
If you are in a remote environment (like the Gitpod.io IDE), then run the editor like this:
```
$ npm run editor-remote
```
If you want to see all the editor options, run:
```
$ npx phasereditor2d-launcher -help
```
If Phaser Editor 2D Core is globally installed, you can run:
```
$ PhaserEditor2D -project .
```

Phaser Editor 2D considerations

Excluding files from the project

There are a lot of files present in the project that are not relevant to Phaser Editor 2D. For example, the whole node_modules folder should be excluded from the editor's project.

The /.skip file lists the folders and files to exclude from the editor's project.

Learn more about resource filtering in Phaser Editor 2D

Setting the root folder for the game's assets

The /static folder contains the assets (images, audio, atlases) used by the game. ViteJS copies it to the distribution folder and makes it available as a root path. For example, http://localhost:3000/assets points to the /static/assets folder.

By default, Phaser Editor 2D uses the project's root as the start path for the assets. You can change it by creating an empty publicroot file. That is the case of the /static/publicroot file, which allows adding files to the Asset Pack file (/static/assets/asset-pack.json) using correct URLs.

Asset Pack content hash

The NPM build script calls the phaser-asset-pack-hashing tool. It parses all pack files in the dist/ folder and transform the internal URL, adding the content-hash to the query string. It also parses files referenced by the pack. For example, a multi-atlas file is parsed and the name of the image's file will be changed to use a content-hash.

Learn more about the phaser-asset-pack-hashing tool.

Coding

The /src folder contains all the TypeScript code, including the scene and user component files, in addition to the Phaser Editor 2D compilers output.

We recommend using Visual Studio Code for editing the code files.

In many tutorials about Phaser Editor 2D, the JavaScript files are loaded using the Asset Pack editor. When using ViteJS this is not needed. Just use the Asset Pack editor for loading the art assets.

Scene and User Components configuration

The Scenes and User Components are configured to compile to TypeScript ES modules. Also, the compilers auto-import the classes used in the generated code.

gregwoodsfrontier / gamedevjs2023