This repository contains the curated wordlist assets used by the Universal Name Generator.
It is an assets-only repository. No application code is included here.
- Capabilities
- Usage
- Known Limitations
- Project Structure
- Roadmap
- Contributing
- Related Projects
- Helping out
- License
The wordlists/ directory contains plain text .lst files organised by universe and category. Each file contains one entry per line, either full names or word fragments used for name generation.
Wordlists are provided for both real-world languages and fictional settings, including:
- real-world languages and naming traditions (Arabic, English, French, German, Irish, Romanian, and many more)
- fantasy races and worlds (Age of Wonders, Divinity, Elder Scrolls, Middle-earth)
- science-fiction factions and species (No Man's Sky, StarCraft, Age of Wonders: Planetfall)
- game-inspired naming sets (RuneScape, Yohoho! Puzzle Pirates)
- username-oriented wordlists collected from various online communities
Use these wordlists as source data for name generation tools that read newline-delimited entries.
wordlists/real/romanian/phone-numbers/phone-numbers.lst
Each line in a .lst file represents one candidate value.
- This repository includes only data files and schemas; it does not include the generator application logic.
- Data quality and style vary across universes and language groups because sources are intentionally diverse.
The key directories are:
| Directory | Purpose |
|---|---|
wordlists/ |
All naming datasets, organised by setting and category |
GenerationSchemas.xml |
XML schema definitions for generation structures and validation |
.github/ |
Repository metadata such as funding configuration |
Each wordlist is a plain text file with one entry per line:
al
dor
mar
ther
Files are named and organised to reflect their intended use (e.g. persons/males, locations/cities, units).
See ROADMAP.md for planned work and forthcoming changes.
You are welcome to submit any suggestion, feedback, or modification to this project.
When doing so, please:
- Maintain cross-platform compatibility
- Maintain the pull requests as focused and consistent with the existing code style
- Maintain your branch up-to-date with
master - Revise the documentation when behaviour changes
- Properly test all changes
Contributions are welcome, especially:
- new language datasets
- new fictional naming sets
- improved wordlist quality
- duplicate and collision filtering
See ROADMAP.md for planned work and forthcoming changes.
- Universal Name Generator API: The API that consumes these datasets to generate names
- Universal Name Generator: The main project ecosystem entry point
Discovered a problem or have a suggestion? Open an issue!
If you find this project useful, consider funding it or starring ⭐️ it on GitHub!
This project is being distributed under the GNU General Public License v3.0 or later.
See LICENSE for further information.