Nothing is improbable.*
* tagline was chosen randomly (ofc)
Overview
RNGNeeds is a plugin that lets you effortlessly design and manage probability lists for any value, type, or custom object directly within the Unity Inspector. Take control of your dice rolls, monster spawns, card decks, item drops, damage modifiers, or even organic animations using probability distribution with unparalleled simplicity and ease-of-use.
Design your lists with probabilities, variable pick counts, and seeding right in the inspector, or harness the powerful API to control everything from code. Experience lightning-fast performance with burst-compiled selection methods, extensibility, seeding options, repeat prevention, pick history, and much more.
Unlock endless possibilities with the innovative concept of Probability Influence Provider. Need to raise the odds of a critical strike based on player stats? Want to increase the chance of spawning that elite monster when it's close to midnight? Perhaps you need to make the battle more intense when the music volume is loud. RNGNeeds is here for - probably - all your random needs.
Features
POWERFUL & ACCESSIBLE
Generic
Use with any value or reference type, be it Unity's or your own. No restrictions.
For Coders & Designers
All features are accessible via the Inspector and an easy-to-use API.
Wide Editor Support
Supports all LTS versions. Developed in 2020 LTS and tested up to 2023 Alpha.
Selection Methods
Pick multiple items at once using various probability methods, including pure random selection.
Lighting-fast
Choose burst-compiled variants of selection methods to pick millions of items in milliseconds.
Seeding Options
Retain a preferred seed, set a custom one, or implement your own Seed Provider.
Extensible
Easily implement and register your custom Selection Methods or seeding options.
USER FRIENDLY
The Stripe
Visually author probabilities using the Stripe widget directly within the Inspector.
Direct Probability Input
Type in exact probability values for any item with precision up to 0.00001 %.
Lock Probabilities
Lock items to preserve their odds when other probabilities are adjusted or recalculated.
Disable Items
Exclude Items from selection while keeping them in the list by simply disabling them.
Fully Customizable
Customize themes, info displays, and appearance options individually for each drawer.
Color Themes
Choose from a variety of color themes, create your own, or use monochrome mode to visualize variances effectively.
Color Dimming
Use color dimming based on probability to easily identify even subtle differences.
DYNAMIC & ADAPTABLE
Probability Influence
Design Influence Providers to dynamically modify probabilities based on external factors.
Proportional Normalization
Item probabilities are automatically recalculated, maintaining their original ratios.
Flexible Pick Counts
Choose a fixed pick count, or select a random range with an adjustable curve to control bias.
Repeat Prevention
Avoid consecutive item selections with multiple repeat prevention techniques.
Pick History
Track previous item picks for each list separately and employ history to mimic deterministic probability behavior.
Selection Testing
Test the outcome of your settings in the Inspector, with color-coded results for evaluating variations.
ON THE ROADMAP
Dynamic Modification
Utilize multiple Mod Providers for items to dynamically manage probability adjustments and multipliers.
(ie. crit chance +1.5% and/or *0.95)
Card Deck Extensions
A collection of handy methods to treat lists like card decks. Draw from the top/bottom, add cards, peek, cut decks, deal hands, or shuffle.
Depletable List
Assign units to items in the list and allow picks to deplete them. Depleted items won't be selected, while the probability distribution of others remains unchanged.
Usage examples
The Probability List
The generic ProbabilityList lies at the heart of RNGNeeds. This versatile tool is compatible with any value or reference type—be it int, float, bool, Vector3, Color, Scriptable Object, MonoBehaviour, GameObject, Enum, or your custom classes. Simply ask ProbabilityList to "Pick Value," and you're good to go.
Let’s spawn a random monster type with random level at a random spawn location. Set up the logic and leave the rest to your designers.
public class Monster : ScriptableObject
{
public GameObject monsterPrefab;
}
public class SpawnLocation : MonoBehaviour
{
public Vector3 coordinates;
}
public class MonsterSpawner : MonoBehaviour
{
public ProbabilityList<Monster> monsterTypes;
public ProbabilityList<int> monsterLevels;
public ProbabilityList<SpawnLocation> spawnLocations;
public void SpawnMonster()
{
Monster monster = monsterTypes.PickValue();
Vector3 position = spawnLocations.PickValue().coordinates;
GameObject monsterObject = Instantiate(monster.monsterPrefab, position, rotation);
monsterObject.GetComponent<MonsterStats>().SetStatsByLevel(monsterLevels.PickValue());
}
}
Custom Drawer & The Stripe
Leave the logic to the coders and take it from there. Effortlessly design your lists within the Inspector. Use The Stripe to adjust probabilities by dragging, fine-tuning values with the scroll wheel, or entering them directly. Lock items to preserve their odds while making adjustments, and disable items to prevent selection.
Customizable Drawers
Stay organized and focused with customizable drawers tailored to your needs. Select from a wide range of color themes or create your own. Modify preview bars, appearance options, or info displays. Dim colors based on probability to easily identify variances, or let your items bring their distinct colors to the list. RNGNeeds remembers your preferences for each individual drawer.
public class CardRarity : ScriptableObject
{
public Color rarityColor;
}
public class Card : ScriptableObject, IProbabilityItemColorProvider
{
public CardRarity cardRarity;
public Color ItemColor => cardRarity.rarityColor;
}
public class CardDeck : ScriptableObject
{
public ProbabilityList<CardRarity> cardRarities;
public ProbabilityList<Card> cards;
}
Probability Influence
Enhance your distinct game mechanics with dynamic probability adjustments based on external factors. Assign a Probability Influence Provider to any item and fine-tune the degree to which factors alter its odds.
Want to drop health potions more often in tutorial scenarios? Increase storm frequency as the player progresses through the story? Make it less likely for this NPC to approach the player at night? Or perhaps speed up this animation as the player gets closer? With Probability Influence, the possibilities are endless.
public enum DamageType
{
Normal,
CriticalStrike,
CrushingBlow,
Piercing,
Stun,
SplashDamage
}
public class PlayerAttack : MonoBehaviour
{
public ProbabilityList<DamageType> damageType;
[Header("Odds of Idle Dance Pose")]
public ProbabilityList<bool> oddsOfIdleDancing;
}
public class PlayerManager : MonoBehaviour, IProbabilityInfluenceProvider
{
public int playerLevel;
public string InfluenceInfo => $"Increased based on player level. Current: {playerLevel}";
public float ProbabilityInfluence => ((float)playerLevel).Remap(1, 20, -1f, 1f);
}
public class AudioManager : MonoBehaviour, IProbabilityInfluenceProvider
{
public float musicLevel;
public string InfluenceInfo => $"Higher chance if music over 75%. Current: {musicLevel}";
public float ProbabilityInfluence => musicLevel.Remap(.75f, 1f, 0f, 1f);
}