Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/decentraland-scenes/Land-Flipper-Game
A multiplayer game with websockets
https://github.com/decentraland-scenes/Land-Flipper-Game
decentraland
Last synced: about 1 month ago
JSON representation
A multiplayer game with websockets
- Host: GitHub
- URL: https://github.com/decentraland-scenes/Land-Flipper-Game
- Owner: decentraland-scenes
- Created: 2020-07-20T20:18:23.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-12-30T16:46:52.000Z (almost 2 years ago)
- Last Synced: 2024-08-05T15:05:00.067Z (5 months ago)
- Topics: decentraland
- Language: TypeScript
- Homepage:
- Size: 19.5 MB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- Awesome-Repository - Land Flipper Game - flipper-game.gif" width="200"> | A team game for 2 players or more, where tiles switch colors when walked on. The server keeps track of the game's state, and has the final word about when the game ends and who won. | (Examples / Multiplayer and APIs)
README
# Land Flipper Game
A multiplayer game with [Colyseus](https://www.colyseus.io/) for websockets multiplayer messaging. The game logic is carried out server-side.
This scene shows you:
- How to support [Colyseus](https://www.colyseus.io) in a Decentraland scene
- How to set up a simple game logic in Colyseus
- How to handle game state changes from the server in your scene
- How to fetch a player's realm
- How to keep track of the state of each realm as a separate room in your game
- How to handle team formation, scoring and time limits from the server
The server takes care of organizing players into teams and only starting a match when there are players on both sides.
Each scene runs its own calculations of the current remaining time and the scores of each team, but so does the server. In the end, the server has the final word about when the match is over and what is the final result.
## Try it out
**Install the CLI**
Download and install the Decentraland CLI by running the following command:
```
$ npm i -g decentraland
```
**Run the server locally**
```
$ cd server
$ npm run build
$ npm run start
```
NOTE: If this is your first time running the scene then you need to run `npm install` before `npm start`
**Run the scene**
Keep the server running, run the scene on a separate command line window:
```
$ cd scene
$ dcl start
```
**Scene Usage**
Open two separate browser windows, and direct one player to the Blue tile and another to the Red tile, so that there are players in both teams.
## Using Colyseus SDK with Decentraland
Install `colyseus.js`:
```
npm install --save colyseus.js
```
Add `colyseus.js` to your `"bundleDependencies"` in your `package.json`:
```json
"bundleDependencies": [
"colyseus.js"
]
```
To avoid TypeScript compilation errors you'll need to edit `tsconfig.json`, and include a few `///
///
///
///
import { Client } from "colyseus.js";
```
> The Colyseus SDK requires a few TypeScript libraries that are excluded by default by Decentraland.
---
## Creating a Colyseus server:
```
npm init colyseus-app ./server
```
## Deploying to [Colyseus Arena](https://www.colyseus.io/arena)
```
npm run build
```
Upload the `lib` folder from the Arena control panel.
## More
Learn more about how to build your own scenes in our [documentation](https://docs.decentraland.org/) site.
If something doesn’t work, please [file an issue](https://github.com/decentraland-scenes/Awesome-Repository/issues/new).
## Copyright info
This scene is protected with a standard Apache 2 licence. See the terms and conditions in the [LICENSE](/LICENSE) file.