# slanted-gamedev-toolz

> A slanted mix of tools for your brilliant ideas in game design.

Latest version **1.0.50** (published 2026-04-15) · ISC license · 0 weekly downloads

## Install

```sh
npm install slanted-gamedev-toolz
pnpm add slanted-gamedev-toolz
yarn add slanted-gamedev-toolz
bun add slanted-gamedev-toolz
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 1.0.50 |
| Published | 2026-04-15 |
| First published | 2023-11-08 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 6 |
| Unpacked size | 18.7 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | The Slanted Room |
| Maintainers | the_slanted_room |
| Keywords | dice, percentage, game utilities, chance, odds, outcome |

## Links

- npm: https://www.npmjs.com/package/slanted-gamedev-toolz
- Repository: https://github.com/theslantedroom/SlantedGameDevToolz
- Homepage: https://github.com/theslantedroom/SlantedGameDevToolz#readme
- Issues: https://github.com/theslantedroom/SlantedGameDevToolz/issues
- npm.io page: https://npm.io/package/slanted-gamedev-toolz

## Dependencies (6)

- [pako](https://npm.io/package/pako.md) ^2.1.0
- [zustand](https://npm.io/package/zustand.md) ^5.0.12
- [lorem-ipsum](https://npm.io/package/lorem-ipsum.md) ^2.0.8
- [react-toastify](https://npm.io/package/react-toastify.md) ^11.0.5
- [@fontsource/nova-cut](https://npm.io/package/@fontsource/nova-cut.md) ^5.2.8
- [@fontsource-variable/alegreya](https://npm.io/package/@fontsource-variable/alegreya.md) ^5.2.8

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 1.0.50 (latest) — 2026-04-15
- 1.0.49 — 2026-04-02
- 1.0.48 — 2026-04-02
- 1.0.47 — 2026-04-02
- 1.0.46 — 2026-01-15
- 1.0.45 — 2026-01-15
- 1.0.44 — 2025-11-28
- 1.0.43 — 2025-11-26
- 1.0.42 — 2025-11-20
- 1.0.41 — 2025-11-20
- 1.0.40 — 2025-10-05
- 1.0.39 — 2025-10-05
- 1.0.38 — 2025-10-05
- 1.0.37 — 2025-10-05
- 1.0.36 — 2025-10-05
- … 34 more at https://npm.io/package/slanted-gamedev-toolz/versions

## README

# SlantedGameToolz


SlantedGameToolz is a collection of tools designed to be used in games made with typescript. UI components are rendered with react. 
 

- These tools can be used in iOS and Android apps when built with [**Capacitor**](https://capacitorjs.com/)
- These tools can be used in PC and Mac apps when built with [**Electron**](https://www.electronjs.org/)


## Tools  

- dice
- weighted dice
- percentage
- React components

<br/> 

# Components

### ImportExportLocalStorage
- define `defaultData`

use the save manager
``` 
  <ImportExportLocalStorage defaultData={defaultData} />
```

access data stored in local storage
``` typescript 
const saveGameData2 = getDataFromLocalStorage(defaultData);
``` 

OR

``` typescript 
const isLoading = useIsLoadingLocalStorage();
const { setIsLoading, handleResetGame } =
		useImportExportLocalStorageActions();
const { saveLocalStorageData, clearLocalStorageData, saveGameData } =
		useLocalSaveData(defaultData);
```

### LocalizationSelect

saves the selected language in localstorage under key `lagCode`

- add `.png` images to `/public/flags/`
- required files `en.png, de.png, es.png, zh.png, ja.png, ko.png, fr.png, ru.png, it.png, pt.png, hi.png`
  

![LocalizationSelect](/public/marketingImages/LocalizationSelect.png)

```typescript 
import { LocalizationSelect } from "slanted-gamedev-toolz";

function App() {
	return (
	  <LocalizationSelect />
	);
}
export default App;
```

### HexBtn
todo
### SquareTileButton
todo

# ImportExportLocalStorage
todo

# Functions

## Dice Utils
 - `rollDice()` A fair dice roll.
 - `rollLowWeightedDice()` An unfair fair dice roll that is more likely to roll low.
 - `rollLowWeightedDice()` An unfair fair dice roll that is more likely to roll high.

## Array Utils
 - `removeObjectsWithSameName()` Removes objects from the first array if their `name` property matches any object's `name` in the second array.
 - `randomArrayItem()` Returns a random item from the provided array.

## Number Utils
- `numberWithCommas()` Formats a number with comma separators and optional suffixes for large values. Ex. 1,000,000(M)
- `isNumberTooLarge()` Checks if a number exceeds JavaScript's `Number.MAX_SAFE_INTEGER`.

#### Example Usage

```typescript 
import { rollDice } from "slanted-gamedev-toolz";

 const outcome = rollDice(6); // roll 6 sided dice
 console.log(`outcome:`, outcome)
```

| Parameter | Type | Description                     |
| - | - | - |
| diceSides | number | sides on the dice |

| Returns  | Type | Description                 |
| - |- | - |
|   | number | the result of the dice roll |

</br></br>

# Developer Instructions
To Publish:
- set version in package.json > `"version": "1.0.36"`
- run `npm publish`

You want to contribute to SlantedGameToolz?
- Install the repo dependencies
- Render components
  - storybook `yarn storybook`
  - or
  - Vite app `yarn dev`
- Make code changes
- Submit PR


From the root of the repo, open a terminal then run:

```
$ yarn install
```

</br></br>

### How to publish to NPM
- `npm login` (if fails do this first)
- `yarn build`
- bump version in package.json (ex: "version": "1.0.24") 
- `npm publish`



https://www.npmjs.com/package/slanted-gamedev-toolz

https://github.com/theslantedroom/SlantedGameDevToolz
### Examples

- [Idle Trillionaire](https://www.idletrillionaire.com/)
- [Turn Based Boxing](https://www.hbcboxing.online/)

---
_Source: https://npm.io/package/slanted-gamedev-toolz · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
