Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rbergen/r136.net
.NET single-page WebAssembly and console versions of R136 that share the same game engine.
https://github.com/rbergen/r136.net
blazor bootstrap console csharp netcore serilog visual-studio webassembly
Last synced: 25 days ago
JSON representation
.NET single-page WebAssembly and console versions of R136 that share the same game engine.
- Host: GitHub
- URL: https://github.com/rbergen/r136.net
- Owner: rbergen
- Created: 2021-02-13T13:01:14.000Z (almost 4 years ago)
- Default Branch: staging
- Last Pushed: 2024-03-24T14:38:36.000Z (10 months ago)
- Last Synced: 2024-11-03T22:23:27.070Z (2 months ago)
- Topics: blazor, bootstrap, console, csharp, netcore, serilog, visual-studio, webassembly
- Language: C#
- Homepage: https://www.r136.net/
- Size: 924 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# R136.NET
[](https://github.com/rbergen/R136.NET/actions/workflows/dotnet.yml) [](https://github.com/rbergen/R136.NET/actions/workflows/azure-static-web-apps-red-glacier-092896803.yml) [](https://github.com/rbergen/R136.NET/actions/workflows/azure-static-web-apps-proud-sand-070C70F03.yml)
This is a .NET web and console version of a text adventure a friend and I created all the way back in 1998.
More information about the game and its history can be found in the README of the
[original C(++) version GitHub repo](https://github.com/rbergen/R136).
Since its resurrection, R136 has become a willing vehicle for me to try new things. This single-pager "static" web app,
console application and shared game engine blend, marks my first dabble with developing for/in/using:
* [.NET 5.0](https://dotnet.microsoft.com/download/dotnet/5.0), [.NET 6.0](https://dotnet.microsoft.com/download/dotnet/6.0) and [.NET 8.0](https://dotnet.microsoft.com/download/dotnet/8.0)
* Version 9.0 of C#. For one, I've quickly developed a liking for
[switch expressions](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/operators/switch-expression)
and [range operators](https://docs.microsoft.com/en-us/dotnet/csharp/tutorials/ranges-indexes).
* Web development using [Blazor](https://dotnet.microsoft.com/apps/aspnet/web-apps/blazor). The embedding of HTML
in code did bring back some memories of classic ASP and even ColdFusion, but my end conclusion is that the overall
implementation is in fact a lot more elegant, if used right. Particularly the ability to back razor files with
partial "pure C#" classes makes things a lot more manageable.
* [Blazor WebAssembly](https://docs.microsoft.com/en-gb/aspnet/core/blazor/?view=aspnetcore-5.0#blazor-webassembly),
and by extension, [WebAssembly](https://webassembly.org/) in general.
* .NET [configuration](https://docs.microsoft.com/en-us/dotnet/core/extensions/configuration-providers)
and [logging](https://docs.microsoft.com/en-us/dotnet/core/extensions/logging) extensions in both the web and console contexts.
* [Serilog](https://serilog.net/)
* [ASP.NET dependency injection](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection?view=aspnetcore-5.0)
* [Bootstrap 5.0](https://getbootstrap.com/docs/5.0/getting-started/introduction/)
* Browser local storage, via [Blazored LocalStorage](https://github.com/Blazored/LocalStorage).
* [TypeScript](https://www.typescriptlang.org/)
Concerning the game itself:
* It has been converted from a purely C-like procedural implementation to an object-oriented one.
* Much of it (including all visible texts) can now be configured through JSON files.
* It now runs in English as well as Dutch, and features on-the-spot switching between those two languages.
## Building
On any system that has a .NET 8.0 SDK and node.js (npm) installed, R136.NET can be built using Visual Studio 2022, the dotnet command line interface or another tool that uses the latter.
The Web project is a Blazor WebAssembly project with AOT compilation enabled. This means that the following command must be issued once before building it for the first time:
```
$ dotnet workload install wasm-tools
```
The Shell and Web projects have an optional build-time dependency on the BuildTool project; the latter takes care of processing the base .json files in the data directory structure to their production counterparts. The dependency is optional in the sense that the JSON processing is simply skipped if the BuildTool executable is not found when building the dependent projects.
When building the solution, this dependency is taken care of automatically. When building individual projects using the command-line, the BuildTool should be built first if JSON processing is desired. This can be done by running the following command from the src subdirectory before building a dependent project:
```
$ dotnet build R136.BuildTool/R136.BuildTool.csproj
```
The dependent project can then be built, after (Shell used as an example):
```
$ dotnet build R136.Shell/R136.Shell.csproj
```
I've successfully built the Shell project on Windows and Linux (Cloud9 Amazon Linux 2, to be precise), following these instructions.
_- Rutger van Bergen - [github.com/rbergen](https://github.com/rbergen)_