Iberia help

MUD help system

NAMEGEN

Usage: namegen add [name] [tags1] [tag2] ... [tagN]

Usage: namegen del [name]

Usage: namegen tags list|[name]

Usage: namegen names list|[tag]

Usage: namegen [tag][& | |]...[& | |][tagN] [tag][& | |]...[& | |][tagM]

Usage: namegen save

Name generator is a system provided by Iberia MUD Engine with the purpose of ease builder's work, specifically when it's needed to set a name for a recently created NPC.

The system itself is very simple: in it's own database, names with one or multiple tags are stored and can be retrieved later. The value of this system lies in how big and structured this data can be defined (see the example below).

To add a name, use "namegen add" followed by a name and its tags, all arguments separated by a white space (no white spaces allowed in individual name or tag).

To delete a name, use "namegen del" followed by the name.

To list all tags in the system, use "namegen tags list"; if you want to see the tags of a given name, use "namegen tags [name]".

Like tags, if you want to list all names in the system use "namegen names list", and if you want to see the names catalogued with a given tag, use "namegen names [tag]".

After finished adding and/or removing names in name generator system, do not forget to save them into the database, using "namegen save".

Finally, to retrieve names you should use "namegen" followed by the tags you want. Arguments details:

- you can generate any quantity of names at once, by properly setting name definitions;

- name definitions are separated by whitespaces;

- each name definition is constituted by one or more tags, connected by the operator(s) "&" (and) or "|" (or);

- those logic operators have the expected behaviour: "&" will search for names that are tagged with the left AND the right tags, and "|" will search for names that are tagged with the left OR the right tags;

- even though you can use multiple tags for a single name, you can't mix operators (first one detected will prevail; eg: "namegen names turdetanian|celtiberian|iberian" will return a "turdetanian", "celtiberian" or "iberian" name, while "namegen names turdetanian&male|female" will search for a "turdetanian" AND "male|female" names).

For instance, with this naming system a builder can easily generate a complete roman male name obeying to the "tria nomina" convention (a full roman name is constituted by a "praenomen", a "nomen" and a "cognomen"), by typing:

"namegen praenomen&male nomen cognomen"

In the previous example, 3 names will be generated: one randomly selected from the names that have "praenomen" and "male" tags, a second one randomly selected from the names with "nomen" tag, and a third one with a randomly selected name with the tag "cognomen". A possible output could be:

"Name generated: Mamercus Rubellius Patercula"

This command can only be used by administrators.

See also: descgen, randomdesc