PHPackages                             trismegiste/rpg-name-generator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. trismegiste/rpg-name-generator

ActiveLibrary[Utility & Helpers](/categories/utility)

trismegiste/rpg-name-generator
==============================

Library for generating random names (for table-top roleplaying games)

v1.3(2y ago)3275↑37.5%MITPHPPHP >7.3

Since Nov 24Pushed 2y ago1 watchersCompare

[ Source](https://github.com/Trismegiste/rpg-name-generator)[ Packagist](https://packagist.org/packages/trismegiste/rpg-name-generator)[ RSS](/packages/trismegiste-rpg-name-generator/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (3)Versions (5)Used By (0)

RPG-Name-Generator
==================

[](#rpg-name-generator)

The RPG character name generator library is designed to create list of random names used for table-top role-playing games.

This library was extracted from the website [PHP-Character-Name-Generator](https://github.com/mark-tasaka/PHP-Character-Name-Generator)from [Mark Tasaka](https://github.com/mark-tasaka) after a heavy overhaul and with the help of [nikic/PHP-Parser](https://github.com/nikic/PHP-Parser)(by the way, this tool is awesome)

This library is fully tested with PhpUnit, 100% code coverage.

Install
=======

[](#install)

With Composer :

```
composer require trismegiste/rpg-name-generator
```

Usage
=====

[](#usage)

See phpunit tests for how to use this library :

```
    $repo = new FileRepository();
    print_r($repo->getSurnameListFor('japanese'));
    print_r($repo->getGivenNameListFor('female', 'japanese'));
```

RandomizerDecorator class is a decorator for adding randomizing capabilities :

```
    $repo = new RandomizerDecorator(new FileRepository());
    print_r($repo->getSurnameListFor('random'));  // gets the list of surnames from a random language
    echo $repo->getRandomGivenNameFor('female', 'chinese');  // picks one random chinese female given name
    echo $repo->getRandomSurnameFor('french');  // picks one random french surname
    echo $repo->getRandomSurnameFor('random');  // picks one random surname from a random language (full random)
```

Test
====

[](#test)

With PhpUnit :

```
vendor/bin/phpunit
```

Code coverage
=============

[](#code-coverage)

With phpdbg :

```
phpdbg -qrr vendor/bin/phpunit
firefox doc/coverage/index.html
```

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~243 days

Total

4

Last Release

954d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/64cc99ca21a090b2454784670e4ac49db17794d6861078eeceebdbe302365c3f?d=identicon)[trismegiste](/maintainers/trismegiste)

---

Top Contributors

[![Trismegiste](https://avatars.githubusercontent.com/u/1260026?v=4)](https://github.com/Trismegiste "Trismegiste (14 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/trismegiste-rpg-name-generator/health.svg)

```
[![Health](https://phpackages.com/badges/trismegiste-rpg-name-generator/health.svg)](https://phpackages.com/packages/trismegiste-rpg-name-generator)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

21866.0M1.7k](/packages/drupal-core)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6942.5M420](/packages/drupal-core-recommended)[blackfire/player

A powerful web crawler and web scraper with Blackfire support

49617.1k](/packages/blackfire-player)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M572](/packages/shopware-core)[jolicode/castor

A lightweight and modern task runner. Automate everything. In PHP.

54743.1k4](/packages/jolicode-castor)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)