izQuickName

History

Version 1.0
Initial Release May 2006
Download izQuickName.

Introduction

"The dwarf miner approaches you and scowls. 'What are you doing here?'
The bard bows and appologises. 'We are sorry we have trespassed on your domain, please tell me your name so I may saing a lay in your honour at the feats we shall throw for you this evening.'
There is a pregnant pause as you struggle to think of a name for the dwarf, 'Durin, no Stumpy, no Grabthroat Shinkicker'. And the moment is lost.

Now you won't have to stumble over your names, you can create them on the fly using izQuickName!

This application, which runs on Palm PDAs can be used to generate names of people, places and even character stats. You can use the rules that are supplied with the application , modify them or create your own.

Installation

Copy the pdb and prc files inside the zip archive onto your Palm. QuickName will be visible in the D&D Category.

Usage

Loading Screen To run izQuickName click on the Quickname icon. A loading screen will be briefly displayed while the program is initialised, a progress bar will indicate how much longer you will have to wait (initialisation takes a few seconds on a Zire71).
Once the data is initialised a the main screen is displayed.

Main Screen

Main Screen - Unpopulated This screen is where you will spend most of your time, it is used for generating your names. When it is first loaded it is blank like this. Tapping on the menu silk-screen button or on the title bar brings up a menu with the following options:
New Rule
Clears the screen back to this state ready for you to create a new rule or load one from the database.
Load Rule
Pops up a list of available rules (see the next section for more details). The same as tapping on the Load button.
Save Rule
Saves the changes you have made to the current rule (see the next section for more details). The same as tapping on the Save button.
Namefile Editor
Displays an editor for you to create and modify name files (see later section for more details).
Name to Clipboard
Saves the current name or names to the Palm clipboard.
Name to Memo
Saves the current name or names to a memo (you are prompted for a memo name. If the memo already exists the names are appended to the end of the memo.
Exit
Exits the application
About
Contact and version details.
The number radio buttons at the top of the screen detirmine how many names are generated in each run. Useful if you want a group of NPCs or taverns all at once. This defaults to 1.

Generating Names

Main Screen - Loading A Rule

Food and Drink

Generating a Name

Generating names is simple. You tap on the Load Rules button and a list of available rules is displayed. You select the one you want and the rule string is displayed at the top of the screen and the name files the rule uses are displayed in the list box.
You then tap the Generate button and a name is displayed at the bottom of the screen.
If the rule string is too long to fit into the screen space tap on the (+) button beside it and a full screen editable note is displayed.
If the name generated is too long you can again tap on the (+) button beside the name in the same way.

Creating and Editing Name Files

The Editor

The Editor

You will want to add extra name parts to existing name files and create completly new ones. To do this you will need to use the Namefile Editor. When you tap on this option in the menu a blank name file is displayed on the screen. The Set Name is the name you want to give the set, the Dice Roll is the random dice roll you want to roll in the format NdT+B where N is the number of dice, T is the type of dice and B is the bonus to be added to the result. For example 2d4+3 would give a range of numbers between 5 and 11 with those in the middle of this range getting more 'hits' than the extremes. The Entries field is the number of name parts in the current file. This last field is not editable and automatically changes as new rows are added and deleted.

The New option blanks the screen and allows you to create a new name file, the Load option loads in an existing file for you to edit (in this case the first of the Dwarven Insult name files). In this case the Set Name field is not editable. When you have loaded in an existing name set you can Delete parts, Add parts and Edit parts. Clicking OK saves your changes back to the database (there may be a slight delay as it does this depending on how many parts exist in the database) while Cancel discards your changes.

Creating and Editing Rules

New Rules It is best when editing and creating rules to use the expanded note view (press the (+) button by the rule string. This makes it easier to see what you have been typing. To create a new rule remember to tap the New button first.To edit an existing rule just amend the rule structure and thenselect save.

The Rules files are the instructions that the program uses for generating names. There are several constructs that can be used to generate names and each will be discussed in turn. Any part of the rule string not included in these five groups will at best be ignored and at worst can cause unpridictable results.

Literal Text

This is 'boilerplate' text that you want to be printed out as you have entered it. Literal text is enclosed in square brackets [ ].

Dice Rolls

This allows you to generate numbers in your text. You need to use the ndt+b format where n is the number of dice, t is the dice type and b is the bonus to be added to the total. For example 3d6+4 would roll 3 six side dice and add 4 onto the total.

Random Row From Name File

To get a random row from a Name file use #n where n is a number between 1 and 9 and matches one of the rows in the Name Files table. You can also use #{1d9} to give you a random file if you wish. If you pick a file that is not in the list then nothing will be printed out.

Either Or

If you have a short set of items you wish to select from then use the () structure. For example (3/male/female/female) would give you a result of either male or female, with female coming up twice as often as male. The first entry is the number of items in the list, each item is separated from the one before it by the / character.

New Line

To generate a new line in your output use ~.

Acknowledgements

The code was written and designed using PocketC by Alan Jones. Bug reports and suggestions for future versions should be sent to me.


Visitor Number:

Back to the toolbox.