RNGenie.Picker 0.1.0-alpha.2

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher.
This is a prerelease version of RNGenie.Picker. 
dotnet add package RNGenie.Picker --version 0.1.0-alpha.2
                    


                    

                
NuGet\Install-Package RNGenie.Picker -Version 0.1.0-alpha.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="RNGenie.Picker" Version="0.1.0-alpha.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="RNGenie.Picker" Version="0.1.0-alpha.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="RNGenie.Picker" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add RNGenie.Picker --version 0.1.0-alpha.2
                    


                    

                
#r "nuget: RNGenie.Picker, 0.1.0-alpha.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package RNGenie.Picker@0.1.0-alpha.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=RNGenie.Picker&version=0.1.0-alpha.2&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=RNGenie.Picker&version=0.1.0-alpha.2&prerelease
                    


                            Install as a Cake Tool

🎩 RNGenie.Picker 🎯

Deterministic Uniform & Weighted Picks for Loot Tables and Simulations

RNGenie.Picker provides simple, reproducible selection utilities. Define rarity tables or equal-weight sets and pick items deterministically with a seeded RNG.

NuGet Downloads .NET CI style: editorconfig

✨ Features

  • Weighted selection with a fluent API (great for rarity tables).
  • Seeded determinism via RNGenie.Core RNG sources.
  • Works with any type (WeightedPicker<T>).
  • Minimal allocations, straightforward API.

📄 Documentation

See the Picker Docs for usage and API details.

🚀 Quick Start

Install Core + Picker:

dotnet add package RNGenie.Core
dotnet add package RNGenie.Picker

Basic usage:

using RNGenie.Core.Sources;
using RNGenie.Picker;

// Seedable RNG for reproducibility
var rng = new Pcg32Source(seed: 123);

// Weighted rarity table
var rarity = new WeightedPicker<string>()
	.Add("Common", 0.75)
	.Add("Rare", 0.20)
	.Add("Epic", 0.05)
	.One(rng);

Console.WriteLine($"You got a {rarity} item!");

Output:

You got a Rare item!

🧩 Extensibility

  • Layer pickers to build tiered loot tables (pick rarity → pick item from that bucket).
  • Use the same RNG across systems to keep simulation runs replayable.
  • Compose with distributions (e.g. roll counts, cooldowns).

📦 Roadmap

  • "Pick many" helpers (with/without replacement).
  • Alias-method sampler for large, static tables.
  • Policy hooks (e.g. pity timers).

👩‍💻 Contributing

Pull requests are welcome!

Good first issues:

  • Add helper APIs for "pick many"
  • Benchmarks for large tables

See CONTRIBUTING.md for guidance. Also, check here for existing picker issue writeups.

📜 License

RNGenie is licensed under the MIT License. This means you're free to use it in open source, commercial, or personal projects.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  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 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0-alpha.2 39 9/13/2025
0.1.0-alpha.1 143 8/31/2025