rbfx.template.thirdperson 0.0.45

Rebel Framework Thrid Person Project Template

Install the Third-Person Project Template:

Open your terminal or command prompt.

Use the following command to install the rbfx.template.thirdperson template package from NuGet:

dotnet new install rbfx.template.thirdperson

This command will download and install the template package. If you want to install a specific version, you can specify it using the format rbfx.template.thirdperson::<package-version>.

Create a New Solution Using the Installed Template:

Navigate to the directory where you want to create your solution.

Run the following command to generate a new solution based on the installed template:

dotnet new rbfx.thirdperson -n MyAwesomeGame

Replace MyAwesomeGame with your desired solution name.

This command will create a new solution with the necessary project structure and files based on the Third-Person template.

Explore and Customize:

Inside the newly created solution folder (MyAwesomeGame in this example), you’ll find project files for the game, character, and other related components.

Customize the project files according to your requirements. You can add more game features, modify existing code, and create additional projects within the solution.

Build and Run:

Build the solution using the following command:

dotnet build

Run your game using:

dotnet run --project MyAwesomeGame.Desktop/MyAwesomeGame.Desktop.csproj

This will compile your solution and execute the game. Remember to adjust the commands and folder names based on your specific setup. Happy coding! 🚀🎮

For more information, you can refer to the official documentation on installing and managing SDK templates.

GitHub Actions Workflow Execution:

Whenever you push changes to the master branch, GitHub Actions will automatically trigger the workflow.

It will build your game, create a GitHub release, and upload the precompiled game artifact.

Verify the Release:

Visit the Releases section of your repository to verify that the release was created successfully.

Optional: itch.io Publishing:

If you want to publish to itch.io setup itch.io token. Go to your GitHub repository. Navigate to Settings > Secrets and variables. Add a new secret named BUTLER_API_KEY and set its value to your itch.io personal access token. Add new variable ITCH_PROJECT to the itch.io project id like rebelfork/rbfx-csharp-thirdperson

That's it! Your GitHub Actions workflow will now build your game and make it available for download via GitHub Releases. Optionally, it can also publish to itch.io if configured.

Optional: Google Play Publishing

To publish app to Google Play directly from the GitHub Action you need to define several secrets in the pipeline.

PLAY_KEYSTORE, PLAY_KEYSTORE_ALIAS and PLAY_KEYSTORE_PASS

First you need to generate Java Key Store file by running the following command:

keytool -v -genkey -v -keystore googleplay.jks -alias someKindOfName -keyalg RSA -validity 10000

Don't user quotes " as part of the password, it may mess up the GitHub action scripts!

Replace alias with a name related to you. Store the alias into PLAY_KEYSTORE_ALIAS secret of the GitHub pipeline. The password you set to the keystore should go into PLAY_KEYSTORE_PASS secret.

Also you need to store the whole content of the googleplay.jks file into the PLAY_KEYSTORE secret. The easy way of doing that is to encode the file content into base64 string and store the string value into the secret by running the following command on windows:

certutil -encodehex -f googleplay.jks googleplay.txt 0x40000001 1>nul

or using openssl elsewhere:

openssl base64 < googleplay.jks | tr -d '\n' | tee googleplay.txt

Upload the content of googleplay.txt to PLAY_KEYSTORE variable.

Dont' forget to delete googleplay.txt and keep the googleplay.jks in a safe place locally!

More on this: https://thewissen.io/making-maui-cd-pipeline/

PLAYSTORE_SERVICE_ACC

Configure access via service account

This step use https://github.com/r0adkll/upload-google-play for the publishing. Here is what you need to do:

1. Enable the Google Play Android Developer API.
   1. Go to https://console.cloud.google.com/apis/library/androidpublisher.googleapis.com.
   2. Click on Enable.
2. Create a new service account in Google Cloud Platform (docs).
   1. Navigate to https://cloud.google.com/gcp.
   2. Open Console > IAM & Admin > Credentials > Manage service accounts > Create service account.
   3. Pick a name for the new account. Do not grant the account any permissions.
   4. To use it from the GitHub Action use either:
      • Account key in GitHub secrets (simpler):
        1. Open the newly created service account, click on keys tab and add a new key, JSON type.
        2. When successful, a JSON file will be automatically downloaded on your machine.
        3. Store the content of this file to your GitHub secrets, e.g. PLAYSTORE_SERVICE_ACC.
3. Add the service account to Google Play Console.
   1. Open https://play.google.com/console and pick your developer account.
   2. Open Users and permissions.
   3. Click invite new user and add the email of the service account created in the previous step.
   4. Grant permissions to the app that you want the service account to deploy in app permissions.
4. Create new application via Google Play Console
   1. Open https://play.google.com/console and pick your developer account.
   2. Press Create App and create new application using the same ApplicationId as in your c# project
   3. Make sure you upload an apk or aab manually first by creating a release through the play console.