🎮 gamertag-forge

gamertag-forge is a simple, fast, and customizable gamertag generator with billions of unique combinations.
Supports fun presets like Xbox, PSN, Twitch, Animal, TikTok, and Bakery.
Beginner-friendly, works with require() (CommonJS).

✨ What This Package Does

• ✅ Generates random gamertags instantly
• 🎮 Preset styles for platforms like Xbox, PSN, Twitch, TikTok, etc.
• 🔢 Optional numbers at the end (e.g., ShadowWolf1234)
• 🎲 Seeded results → same seed always produces the same name
• 🛠️ Zero setup / Zero dependencies
• 📦 Ready to use in any Node.js project

📦 Install

Make sure you have Node.js installed. Then run:

npm install gamertag-forge

🚀 Quick Start (Beginner Example)

Create a file test.js:

const { generateGamertag } = require("gamertag-forge");

// Generate a random gamertag
console.log(generateGamertag()); 
// Example output: "Bravornova"

// Generate an Xbox-style gamertag
console.log(generateGamertag({ style: "xbox" }));
// Example output: "ShadowX420"

// Generate a Twitch-style gamertag with a fixed seed
console.log(generateGamertag({ style: "twitch", seed: 42 }));
// Example output: "LilPog_TTV"

Run it:

node test.js

🎨 Styles You Can Use

| Style | Description | Example Output | |-----------|----------------------------------------------|------------------| | default | Random syllables (billions of combos) | Bravornova | | xbox | Xbox gamer style | DarkSniper69 | | psn | PlayStation Network style | iTzSenpai99 | | twitch | Streamer tags with _TTV, Live, etc. | LilClutch_TTV | | animal | Fun animal mashups | FluffyWolf | | tiktok | Trendy TikTok handles | LilTrendz | | bakery | Sweet bakery-inspired names | ChocoMuffin |

⚙️ Options (API)

The main function is:

generateGamertag(options)

Options:

| Option | Type | Default | Description | |--------------|------------------|-------------|-------------| | style | string | "default" | Which theme to use (default, xbox, psn, twitch, animal, tiktok, bakery) | | seed | string / number | random | Same seed → same result (useful for consistency) | | minNumber | number | null | Minimum number suffix (e.g. 0) | | maxNumber | number | null | Maximum number suffix (e.g. 9999) |

Returns:
👉 A single string with your gamertag.

🔥 Advanced Examples

1. Deterministic (Seeded) Gamertags

Useful if you want repeatable names.

console.log(generateGamertag({ style: "psn", seed: 123 }));
// Always outputs the same tag for seed 123

2. Add Number Ranges

Add numbers to the end for more combinations.

console.log(generateGamertag({ style: "animal", minNumber: 0, maxNumber: 9999 }));
// => "CrazyTiger4821"

3. Generate a List of Gamertags

Perfect for generating multiple unique suggestions.

const { generateGamertag } = require("gamertag-forge");

const tags = Array.from({ length: 5 }, (_, i) =>
  generateGamertag({ style: "twitch", seed: "user" + i, minNumber: 0, maxNumber: 99 })
);

console.log(tags);
// Example: [ 'LilSweat_TTV24', 'ItsClutchLive07', 'BigPog_TTV51', ... ]

4. Mixing Styles

console.log(generateGamertag({ style: "default" })); // "Dravornova"
console.log(generateGamertag({ style: "bakery" }));  // "SugarMuffin"
console.log(generateGamertag({ style: "tiktok" }));  // "LilGlowzzz"

📊 How Many Names Can It Generate?

• Default mode: ~1.56 billion unique combinations
• With numbers (0–9999): ~15 trillion possible gamertags

➡️ You’ll never run out of unique names 🔥

🛣️ Roadmap

• [ ] Add CLI support (npx gamertag-forge --style twitch --count 10)
• [ ] More fun presets (Fantasy, Cyberpunk, Sports, Mythical)
• [ ] Allow custom wordlists

🤝 Contributing

Want to add new themes or features?

1. Fork this repo
2. Create a branch
3. Submit a pull request 🚀

📜 License

MIT © FeelSorrow