From 4994ecd8df372b383d552721d9a710dedc5e2ad1 Mon Sep 17 00:00:00 2001 From: Praveen Suluvai Date: Tue, 22 Aug 2023 20:24:58 +1000 Subject: [PATCH 1/4] DX-2223: Added changelog and readme --- 4.27/passport-features/README.md | 15 +++++++ 5.2/passport-features/README.md | 22 ++++++---- CHANGELOG.md | 14 ++++++ README.md | 74 +++++++++++++++++++++++++++++++- 4 files changed, 116 insertions(+), 9 deletions(-) create mode 100644 CHANGELOG.md diff --git a/4.27/passport-features/README.md b/4.27/passport-features/README.md index aaed61ef..34427c0a 100644 --- a/4.27/passport-features/README.md +++ b/4.27/passport-features/README.md @@ -1,3 +1,18 @@ +> [!WARNING] +> This sample game is in development and login functionality does not work yet. Please use Unreal Engine 5.2 working sample if you can. + +# passport-features + +This sample game demos the passport login/logout functionality using [unreal-immmutable-sdk](https://github.com/immutable/unreal-immutable-sdk) plugin + +## Quick Start + +### Pre-requisites + +* Unreal Engine 4.27 +* Visual Studio 2019 +* Jet brains Rider (Recommended) + ## MacOSX issues * The game does not compile using UE 4.27.2 on MacOS Ventura 13.4.1 due to engine source code errors. To fix this, we added additional compiler arguments to the game's `*.Target.cs` files ([file 1](blob/main/4.27/passport-features/Source/endlessrun.Target.cs) and [file 2](blob/main/4.27/passport-features/Source/endlessrunEditor.Target.cs)). diff --git a/5.2/passport-features/README.md b/5.2/passport-features/README.md index f065c84f..7856baee 100644 --- a/5.2/passport-features/README.md +++ b/5.2/passport-features/README.md @@ -1,22 +1,28 @@ # passport-features -This game demos the passport login/logout feature +This sample game demos the passport login/logout functionality using [unreal-immmutable-sdk](https://github.com/immutable/unreal-immutable-sdk) plugin -# Running the game +## Quick Start -## Pre-requisites +### Pre-requisites * Unreal Engine 5.2 * Visual Studio 2022 -* Rider (Recomended) +* Jet brains Rider (Recommended) -## Launch +### Run game * Open the project file `endlessrun.uproject` -* Build project using Jetbrains Rider or Visual Studio application -* Run the MainMenu for game +* Build project using Jetbrains Rider or Visual Studio IDE +* Open MainMenu at `5.2/passport-features/Content/ThirdPersonBP/UI/MainMenu/MainMenu.uasset` +* Press play button to run the game -To test passport login functionality +### Game Play Functionality + +* The game is to avoid blocking trees and collect coins. Once 10 or more coins are collected, the game will prompt to login with Passport to continue playing. +* Press `Continue with Passport` button to login, it will then launch a browser to authenticate with Passport login flow. Once authenticated, the game will continue. + +### Test passport login functionality provided by [unreal-immmutable-sdk](https://github.com/immutable/unreal-immutable-sdk) plugin * Navigate to Content Browser -> Plugins -> Blueprints -> PassportBlueprintSample * Play game (should launch browser for authentication) diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 00000000..a1e4d2d4 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,14 @@ +# Changelog + +All notable changes to this project will be documented in this file. + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +## [0.1.0] - 2023-08-23 + +### Added + +- Initial sample game (passport-features) for Unreal Engine 5.2 +- UE 5.2 passport-features: Passport login/logout functionality implemented +- UE 4.27 passport-features: Fix for compile errors on MacOS diff --git a/README.md b/README.md index 79005a2d..713c2808 100644 --- a/README.md +++ b/README.md @@ -24,4 +24,76 @@ git pull --recurse-submodules ## Running the Game -See corresponding game folder README.md for instructions on how to run the game. \ No newline at end of file +See corresponding game folder README.md for instructions on how to run the game. + +## Changelog Management + +The following headings should be used as appropriate. + +- Added +- Changed +- Deprecated +- Removed +- Fixed + +What follows is an example with all the change headings, for real world use only use headings when appropriate. +This goes at the top of the CHANGELOG.md above the most recent release. + +```markdown +... + +## [Unreleased] + +### Added + +for new features. + +### Changed + +for changes in existing functionality. + +### Deprecated + +for soon-to-be removed features. + +### Removed + +for now removed features. + +### Fixed + +for any bug fixes. + +... +``` + +## Contributing + +If you would like to contribute, please read the following: + +- We use the [Conventional Commits specification](https://www.conventionalcommits.org/en/v1.0.0/#specification) when writing our commit messages. Why use Conventional Commits? Read [here](https://www.conventionalcommits.org/en/v1.0.0/#why-use-conventional-commits). + +## Getting Help + +Immutable X is open to all to build on, with no approvals required. If you want to talk to us to learn more, or apply for developer grants, click below: + +[Contact us](https://www.immutable.com/contact) + +### Project Support + +To get help from other developers, discuss ideas, and stay up-to-date on what's happening, become a part of our community on Discord. + +[Join us on Discord](https://discord.gg/TkVumkJ9D6) + +You can also join the conversation, connect with other projects, and ask questions in our Immutable X Discourse forum. + +[Visit the forum](https://forum.immutable.com/) + +#### Still need help? + +You can also apply for marketing support for your project. Or, if you need help with an issue related to what you're building with Immutable X, click below to submit an issue. Select _I have a question_ or _issue related to building on Immutable X_ as your issue type. + +[Contact support](https://support.immutable.com/hc/en-us/requests/new) + +## License +Immutable Unity SDK repository is distributed under the terms of the [Apache License (Version 2.0)](LICENSE). \ No newline at end of file From f4ca3dd129ea0bae612376539ed4345fb211b525 Mon Sep 17 00:00:00 2001 From: Praveen Suluvai Date: Tue, 22 Aug 2023 20:27:12 +1000 Subject: [PATCH 2/4] DX-2223: Added Immutable logo --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 713c2808..802b79ce 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,13 @@ +
+

+ + + +

+
+ +--- + # sample-unreal-game Sample Unreal Game using Unified SDK features provided by plugin. From f0a03a4d5b1a7fd1db05f75a019bb829865d81a0 Mon Sep 17 00:00:00 2001 From: suluvai Date: Wed, 23 Aug 2023 09:19:19 +1000 Subject: [PATCH 3/4] DX-2223: Game Demo --- .gitattributes | 1 + 5.2/passport-features/README.md | 4 ++++ 5.2/passport-features/Sample UE5 Game Demo.mp4 | 3 +++ 3 files changed, 8 insertions(+) create mode 100644 5.2/passport-features/Sample UE5 Game Demo.mp4 diff --git a/.gitattributes b/.gitattributes index f1833f71..b2b67e40 100644 --- a/.gitattributes +++ b/.gitattributes @@ -1 +1,2 @@ *.uasset filter=lfs diff=lfs merge=lfs -text +*.mp4 filter=lfs diff=lfs merge=lfs -text diff --git a/5.2/passport-features/README.md b/5.2/passport-features/README.md index 7856baee..378b6693 100644 --- a/5.2/passport-features/README.md +++ b/5.2/passport-features/README.md @@ -26,3 +26,7 @@ This sample game demos the passport login/logout functionality using [unreal-imm * Navigate to Content Browser -> Plugins -> Blueprints -> PassportBlueprintSample * Play game (should launch browser for authentication) + +### Demo + + \ No newline at end of file diff --git a/5.2/passport-features/Sample UE5 Game Demo.mp4 b/5.2/passport-features/Sample UE5 Game Demo.mp4 new file mode 100644 index 00000000..87afd8aa --- /dev/null +++ b/5.2/passport-features/Sample UE5 Game Demo.mp4 @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:23ba676ce049dfc5f858ab98c1cb8f66e60ae71978147bdcf280096e263bc50b +size 14181595 From f2711696c60ae1de85feedb3e97be97d87182102 Mon Sep 17 00:00:00 2001 From: Praveen Suluvai Date: Wed, 23 Aug 2023 09:32:36 +1000 Subject: [PATCH 4/4] Added links to corresponding game readme's --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 802b79ce..19fd367b 100644 --- a/README.md +++ b/README.md @@ -36,6 +36,9 @@ git pull --recurse-submodules See corresponding game folder README.md for instructions on how to run the game. +- [UE5.2 Passport Features Demo](5.2/passport-features/README.md) +- [UE4.27 Passport Features Demo](4.27/passport-features/README.md) + ## Changelog Management The following headings should be used as appropriate.