https://github.com/laironcosta1994/pirate-panic
A sample game called Pirate Panic for Unity engine built with Nakama server.
https://github.com/laironcosta1994/pirate-panic
game-server nakama-server
Last synced: about 1 month ago
JSON representation
A sample game called Pirate Panic for Unity engine built with Nakama server.
- Host: GitHub
- URL: https://github.com/laironcosta1994/pirate-panic
- Owner: laironcosta1994
- License: apache-2.0
- Created: 2024-08-06T21:50:16.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2024-08-06T21:56:01.000Z (9 months ago)
- Last Synced: 2025-01-21T20:09:29.757Z (3 months ago)
- Topics: game-server, nakama-server
- Language: C#
- Homepage: https://heroiclabs.com/
- Size: 9.99 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Unity Sample Project
==================
## Welcome to "Pirate Panic" !
This Unity sample project demonstrates the features of the Nakama server by Heroic Labs.
[Nakama](https://github.com/heroiclabs/nakama) is an open-source server designed to power modern games and apps. Features include user accounts, chat, social, matchmaker, realtime multiplayer, and much [more](https://heroiclabs.com).
These docs provide everything you need to download the Unity game, run the Nakama server, and play "Pirate Panic".
## Table Of Contents
- [Nakama Docs](#nakama-docs)
- [Scenes](#scenes)
+ [Examples](#examples)
+ [Pirate Panic Game](#pirate-panic-game-1)
- [Getting Started](#getting-started)
+ [1. Setup Docker](#1-setup-docker)
+ [2. Setup Unity](#2-setup-unity)
+ [3. Play Against Yourself](#3-play-against-yourself)
## Nakama Docs
* **Nakama** (Docs) - High-level overview
* **Unity Client Guide** (Docs) - Unity setup
## Scenes
#### Pirate Panic Game
The repo includes these scenes for the sample game project.
* **Scene01MainMenu** (Source) - This is the main entry point for the game. **Play this scene first**.
* **Scene02Battle** (Source) - The core game loop.
## Constants & Configuration
#### Pirate Panic Game
The game centralizes some values which are intended for tweaking and experimentation by game developers.
* **GameConfiguration** (Source) - Stores commonly used values which may be changed at edit-time and runtime.
* **GameConstants** (Source) - Stores commonly used values which may be changed at edit-time.
## Getting Started
### 1. Setup Docker
The Docker Engine is required. Follow the Heroic Labs quickstart guide.
To start the game server and database once Docker is setup navigate to the `.\ServerModules` folder and run:
```
docker-compose up
```
### 2. Setup Unity
The Unity Editor is required. Download it from Unity3d.com/get-unity/download.
1. Open the Unity Project of `./PiratePanic/` in Unity Version **2020.3.7f1** or higher.
2. Open the Unity Console Window (Unity → Windows → General → Console). Confirm there are no warnings or errors.
3. By default, the game will attempt to communicate with port 7350 of localhost, which is the default Nakama HTTP port. If you'd like to change your host or IP, you can do so when constructing the client: https://github.com/heroiclabs/unity-sampleproject/blob/master/PiratePanic/Assets/PiratePanic/Scripts/Scene01MainMenuController.cs#L101
### 3. Play Against Yourself
**Standalone Build Play Session**
1. Open the project in the Unity Editor
2. Make a Unity Standalone Build (e.g. WindowsStandalone)
- Mac OS users will need to temporarily change the bundle identifier prior to building. On Mac OS, Unity shares .plist files between the editor and the standalone build.
3. Run the Standalone Build of Pirate Panic
4. Click "Battle"
**Unity Editor Play Session**
1. Open the project in the Unity Editor
2. Open the scene of `./PiratePanic/Assets/PiratePanic/Scenes/Scene01MainMenu.unity`
3. Run Unity Editor for Pirate Panic
4. Click "Battle"
Now the **Standalone** is playing against the **Unity Editor**. Enjoy!
## Contribute
GitHub issues and pull requests are welcome. If you're interested in enhancing the code please open an issue to discuss the changes or drop in and discuss it in the [community forum](https://forum.heroiclabs.com).
To modify the Typescript remote procedure calls (RPCs), install Node Package Manager (NPM), run `npm install` and `npx tsc` from the `ServerModules` folder, and restart the server.
More documentation on working with the Nakama Typescript runtime can be found here: https://heroiclabs.com/docs/runtime-code-typescript-setup/
### License
This project source code and documentation is licensed under the [Apache-2 License](https://github.com/heroiclabs/unity-sampleproject/blob/master/LICENSE). All images, graphics, and other non-code resources are licensed under [CC BY-NC-ND](https://creativecommons.org/licenses/by-nc-nd/4.0/). Please reach out on a GitHub issue if you have any questions.
All 3rd-party assets and libraries used in this project retain all rights under their respective licenses.