A library for generating unique an memorable codenames, inspired by the NPM library unique-names-generator.
Includes out-of-the-box dictionaries, but custom dictionaries can also be provided for special use-cases.
Uses a simple mullbery32 implementation for pseudorandom number generation under the hood, which makes it unlikely for duplicate codenames in a row.
See examples for a variety of examples exploring various functionalities of the library. In order to run a specific example, refer to development.
This library is intended to be used with lune, a standalone Luau runtime.
Due to the current state of wally, installing packages on lune is not successful by default. This project includes a dependency installation script, which can be used to set up a development environment. The script is platform independent.
Once the development environment has been set up, build the minified package bundle by running bundle-prod.sh.
Examples can now be run using lune:
lune examples/EXAMPLE.luauwhere EXAMPLE is to be replaced with the name of the example in the examples directory.