πŸ“š RNGsmith Documentation

🎲 What is RNGsmith?

RNGsmith is a probability distribution design and simulation tool. It helps developers, game designers, and data explorers create and test custom probability curves β€” especially useful for loot systems, gacha mechanics, or reward distributions.

βš™οΈ How It Works

  • Generator: Define a min, max, and target average to create a probability distribution.
  • Simulator: Run N-round trials using the distribution to evaluate how closely the output matches your expected average.
  • Exporter: View and copy the distribution in TypeScript or CSV formats for direct integration into your project.

πŸ“ How Is the Distribution Calculated?

RNGsmith uses an inverse-square weighting algorithm to bias values around the target average. This makes numbers closer to the average more likely, while still respecting the min and max bounds.

Example: Target average = 6 with range 1–10 will generate a curve where 5, 6, and 7 are more likely than 1 or 10.

πŸ’‘ Use Cases

  • Gacha and lootbox balancing
  • Daily rewards with increasing rarity
  • Game jam simulations and fair randomness
  • Behavioral reward design (education, gamification)

πŸ“Ž FAQ

Why doesn’t the chart always match the average exactly?

Because we're simulating randomness. Over many rounds (e.g., 100,000+), the actual average converges toward your target, but small sample sizes will vary due to chance.

Can I define my own probability manually?

Coming soon! You’ll be able to input raw weights or define fixed breakpoints for exact control.