A Luau library for generating interesting codenames.
Find a file
2024-06-10 17:37:04 +05:30
.vscode init: initial implementation 2023-08-15 17:33:32 +05:30
assets chore: include assets 2023-08-16 19:42:37 +05:30
examples chore(examples): include example descriptions 2023-08-19 20:53:34 +05:30
scripts chore(scripts): include shebang (x3) 2023-08-19 20:58:10 +05:30
src feat: more dictionaries 2023-08-19 20:43:02 +05:30
.darklua.json init: initial implementation 2023-08-15 17:33:32 +05:30
.gitignore init: initial implementation 2023-08-15 17:33:32 +05:30
aftman.toml init: initial implementation 2023-08-15 17:33:32 +05:30
README.md chore(README): update platform note for install-deps.luau 2023-08-16 22:36:34 +05:30
wally.lock init: initial implementation 2023-08-15 17:33:32 +05:30
wally.toml init: initial implementation 2023-08-15 17:33:32 +05:30

codenamer.luau

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.

Usage

See examples for a variety of examples exploring various functionalities of the library. In order to run a specific example, refer to development.

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.

Running Examples

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.luau

where EXAMPLE is to be replaced with the name of the example in the examples directory.