Skip to content

Commit

Permalink
Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
gleblebedev committed Feb 19, 2024
1 parent cb02b48 commit 449b138
Show file tree
Hide file tree
Showing 2 changed files with 75 additions and 1 deletion.
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -264,3 +264,5 @@ Shaders.Generated

# RBFX Editor sattelite files
*.user.json

RbfxTemplate/Content/Common
74 changes: 73 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,73 @@
Rebel Framework Casual Game Project Template
# Rebel Framework Casual Game Project Template

[![IMAGE ALT TEXT HERE](https://img.youtube.com/vi/Iq5Yz11lUEE/0.jpg)](https://www.youtube.com/watch?v=Iq5Yz11lUEE)

## Install the Casual Project Template:

Open your terminal or command prompt.

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

```
dotnet new install rbfx.template.casual
```

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.casual::<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-casual -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 Casual 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](https://learn.microsoft.com/en-us/dotnet/core/install/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](https://github.com/rbfx/rbfx-csharp-casual/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-casual](https://rebelfork.itch.io/rbfx-csharp-casual)

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. 🚀🎮

0 comments on commit 449b138

Please sign in to comment.