OSK.Petra.Experiences
0.1.0
dotnet add package OSK.Petra.Experiences --version 0.1.0
NuGet\Install-Package OSK.Petra.Experiences -Version 0.1.0
<PackageReference Include="OSK.Petra.Experiences" Version="0.1.0" />
<PackageVersion Include="OSK.Petra.Experiences" Version="0.1.0" />
<PackageReference Include="OSK.Petra.Experiences" />
paket add OSK.Petra.Experiences --version 0.1.0
#r "nuget: OSK.Petra.Experiences, 0.1.0"
#:package OSK.Petra.Experiences@0.1.0
#addin nuget:?package=OSK.Petra.Experiences&version=0.1.0
#tool nuget:?package=OSK.Petra.Experiences&version=0.1.0
OSK.Petra.Experiences
Core logic for handling experiences for an application. Experiences can be a single quest, quest line, campaign, or any other type of narrative for the application that a user can engage with. Experiences are progressed through an experience enumerator, and the core services tracks various challenges and objectives for completion for each experience.
Experiences consist of challenges, which consist of objectives. Objectives are the goals or tasks for an experience that a user aims to complete. The service will track the state of each objective and determine whether it has been completed and process the completion of the challenge and experience. Each objective also has a capability to add quick access outputs that can be referenced by experience enumerators to determine the next step in the experience using previous decisions and outcomes.
Experience enumwerators are the focal point in determining what challenges are given to users and how experiences are navigated. The library provides a few implementations for enumerators:
Sequential- Each challenge in the experience will occur in a provided order without need for external outputs and decisions by a user. A linear narrative arc and progression.
Objectives can be created by implementing the IChallengeObjective interface and an IObjectiveTextFormatter can be used to format the text for each objective for UI display. Objectives can be configured
to have different expected outcomes, e.g. reaching a threshold value or not reaching a threshold value. For example, a counter objective can be defined to have a limit of 3 lives, meaning that once it hits the limit,
it is failed. The expected outcome would be to not be met in this case. Another example would be for a user to mine 10 ores, where the expected outcome would be to meet the threshold value. Additionally, objectives can
be configured to have different resolution behaviors - a resolution behavior defines how the objective manages completion. For example, a self resolution indicates to the system that the objective will
complete on its own, while a challenge resolution indicates that the challenge should resolve it when it is finished.
The library currently provides a few implementations of objectives:
CounterObjective- An objective that uses a counter to determine whether requirements are met. This can be constructed using theCounterParametersclass to specify the initial value, threshold value, comparison type, and other settings for the counter.TimerObjective- An objective that uses a timer to determine whether requirements are met. This can be constructed using theTimerParametersclass to specify the timer duration and other settings for the timer.
The library will track all experiences that are added, so it is important to add every experience to the service, especially if it is desired that outputs of other experiences will be used to progress active challenge objectives.
There are various statuses available for an experience, including 'Available', 'Active', etc. Users will need to start or stop experiences using the returned IExperienceContext and can pin or unpin experiences through it.
The expected flow for the library:
- Add the core dependencies using the
AddExperiencescall for the service collection - Add all experiences the user is able to use (at start, or during runtime). This can be configured to load previous saved states and progress.
- Use the context to start/stop and engage with the experience
- Trigger
IApplicationExperienceEventas needed and time ticks to theIExperienceService - Register event handlers to the experience service
OnExperienceEventhook, as the service will send update events through it
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.1 is compatible. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 11.0.0)
- OSK.Hexagonal.MetaData (>= 1.0.0)
- OSK.Messages.Abstractions (>= 0.5.1)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on OSK.Petra.Experiences:
| Package | Downloads |
|---|---|
|
OSK.Petra.Godot.Experiences
Provides an implementation for an game experience (quest, objective) tracking, configuration and setup for Godot within the Petra game framework. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0 | 88 | 11/15/2026 |