Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bytebit-org/roblox-playerstatistics
A type-safe player statistics library meant to make it easy to post events and have those events automatically update any number of statistic values
https://github.com/bytebit-org/roblox-playerstatistics
game-development lua npm-package roblox roblox-ts
Last synced: 2 months ago
JSON representation
A type-safe player statistics library meant to make it easy to post events and have those events automatically update any number of statistic values
- Host: GitHub
- URL: https://github.com/bytebit-org/roblox-playerstatistics
- Owner: Bytebit-Org
- License: mit
- Created: 2021-02-20T21:54:09.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-03-21T19:56:20.000Z (almost 3 years ago)
- Last Synced: 2024-10-31T11:19:19.196Z (3 months ago)
- Topics: game-development, lua, npm-package, roblox, roblox-ts
- Language: TypeScript
- Homepage:
- Size: 172 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Player Statistics
Player Statistics is a package for Roblox game developers with built-in persistence that can be swapped modularly to fit into any game's persistence schemes.
Define your game's statistics for players and the events that cause updates with two simple definition files, then use one line of code to post events.
Statistics will be updated according to your definition files and automatically persisted upon player's leaving the game or the game closing.
## Installation
### roblox-ts
Simply install to your [roblox-ts](https://roblox-ts.com/) project as follows:
```
npm i @rbxts/player-statistics
```
### Wally
[Wally](https://github.com/UpliftGames/wally/) users can install this package by adding the following line to their `Wally.toml` under `[dependencies]`:
```
PlayerStatistics = "bytebit/[email protected]"
```
Then just run `wally install`.
### From model file
Model files are uploaded to every release as `.rbxmx` files. You can download the file from the [Releases page](https://github.com/Bytebit-Org/roblox-PlayerStatistics/releases) and load it into your project however you see fit.
### From model asset
New versions of the asset are uploaded with every release. The asset can be added to your Roblox Inventory and then inserted into your Place via Toolbox by getting it [here.](https://www.roblox.com/library/7881304458/Player-Statistics-Package)
## Documentation
Documentation can be found [here](https://github.com/Bytebit-Org/roblox-PlayerStatistics/tree/master/docs), is included in the TypeScript files directly, and was generated using [TypeDoc](https://typedoc.org/).
## Example
Let's create an example keeping track of a player's high score and their average score, which can be tracked using the total points and the number of times they've played. The first step is to define these statistics in a definition file like so:
```ts
import { StatisticDefinition, StandardStatisticUpdateFunctions } from "@rbxts/player-statistics";
export const PlayerStatisticsDefinition = {
highScore: identity({
defaultValue: 0,
updateFunction: math.max,
}),
numberOfGamesPlayed: identity({
defaultValue: 0,
updateFunction: StandardStatisticUpdateFunctions.increment,
}),
scoreSum: identity({
defaultValue: 0,
updateFunction: StandardStatisticUpdateFunctions.sum,
}),
};
```
And now we can define a single event which will be associated with all three of our statistics, as shown:
```ts
import { PlayerStatisticsDefinition } from "./PlayerStatisticsDefinition";
export const PlayerStatisticEventsDefinition = {
gameCompleted: identity>([
"highScore",
"numberOfGamesPlayed",
"scoreSum"
]),
};
```
And now we simply wire this up in our game's bootstrapping code, complete with persistence:
```ts
import { DataStoreService } from "@rbxts/services";
import { DataStorePlayerStatisticsPersistenceLayer, PlayerStatisticsProvider } from "@rbxts/player-statistics";
import { PlayerStatisticsDefinition } from "./data/PlayerStatisticsDefinition";
import { PlayerStatisticEventsDefinition } from "./data/PlayerStatisticEventsDefinition";
const playerStatisticsDataStore = DataStoreService.GetDataStore("PlayerStatistics");
const playerStatisticsPersistenceLayer = DataStorePlayerStatisticsPersistenceLayer.create(playerStatisticsDataStore);
const playerStatisticsProvider = PlayerStatisticsProvider.create(
PlayerStatisticEventsDefinition,
playerStatisticsPersistenceLayer,
PlayerStatisticsDefinition
);
```
Finally, after a game is completed, we call this one simple line of code:
```ts
playerStatisticsProvider.recordEvent(player, "gameCompleted", playerScore);
```
And suddenly all three of our statistics will be updated and persisted when the player leaves or the server closes!