Coin Handling Proposal - Revision history

James: Change ABBREV to ABB to maitch other files such as class

2011-02-13T09:53:54Z

Change ABBREV to ABB to maitch other files such as class

James: Add TOC

2011-02-13T09:50:08Z

Add TOC

James: Tidy up formatting

2011-02-13T09:48:53Z

Tidy up formatting

James: moved Money Proposal to Coin Handling Proposal

2011-02-13T09:40:25Z

moved Money Proposal to Coin Handling Proposal

James: Proposal for coin and money Handling

2011-02-13T08:59:36Z

Proposal for coin and money Handling

New page

== Gold Handling Proposal ==

PCGen currently handles available funds and coins separately. The user has to manually purchase coins if she wishes to have those reflected on the character sheet. Those coins have to be sold again if the player wants to spend the money.

This proposal outlines a method by which PCGen would automatically create coins to reflect any available funds and manage the coins in a useful manner.

== Use cases ==

1. Add a certain amount of wealth to a character.
a. Enter total amount as a decimal e.g. 23.31
b. Split amount into coins e.g. 4pp 3gp 3sp 1cp
c. Add to coins held in current coin location e.g. Not Carried
2. Purchase item of equipment
a. Purchase item e.g. Lantern (Bullseye) for 12gp
b. Read coins in coin container e.g Not Carried, 4pp 3gp 3sp 1cp
c. Calculate minimum number of coins to remove e.g. 2pp 2gp
d. Remove from coins in coin container e.g. 2pp 1gp 3sp 1cp
e. If the money spent is more than is contained in the coin container, all coins in the coin container will be spent and then remainder will be deducted from next set of coins (return to step b). Location selected Not carried, then carried, then equipped, then in a location. Containers in a location will be utilized in equipped order.
3. Change default location for coins
a. Select item in equipping tab e.g. belt pouch
b. Right click and select “Make default coin container” option.
c. Existing coins will stay in old location, but new coin manipulation will take place in the new location.
4. Redistribute coins in equipment set
a. Purchase or sell coins as required. Purchase items rules would apply
e.g. purchase 10gp would remove 1pp and add 10gp to the default location
5. Move coins to another location
a. Use standard move item rules for moving part of the total coins to a new location e.g. Not Carried to Belt Pouch
6. Have more than one equipment set
a. Each equipment set would have a default location.
b. On purchase all sets would be updated as per UC2
c. On creation of a new equip set all coins would be moved to the default coin container (Not carried)

== Backing Rules ==

• Coins are items of equipment specified by the type of Coin
• A new tag will be required: ABBREV for equipment e.g. ABBREV:pp
• The default coin container is “Not Carried”. This can be changed globally to “Carried” or “Equipped” through preferences.
• The current coin container for an equipset can be changed by a right click on the item and selecting the “Make default coin container” option
• The current coin container for a set will be labeled with [Coin container] in the equipping tree.
• If the current coin container is unequipped, the default coin container will receive any coins held in that container

== Methods Required ==

BigDecimal getTotalFunds()
spendFunds(BigDecimal gold)
addFunds(BigDecimal gold)
setCurrentCoinLoc(EquipSet set, EquipNode node)

@@ Line 36: / Line 36: @@
 * Coins are items of equipment specified by the type of Coin
-* A new tag will be required: ABBREV for equipment e.g. ABBREV:pp
+* A new tag will be required: ABB for equipment e.g. ABB:pp
 * The default coin container is “Not Carried”. This can be changed globally to “Carried” or “Equipped” through preferences.
 * The current coin container for an equipset can be changed by a right click on the item and selecting the “Make default coin container” option

← Older revision		Revision as of 09:50, 13 February 2011
Line 1:		Line 1:
		+	{\| align="right"
		+	\| __TOC__
		+	\|}
		+
	PCGen currently handles available funds and coins separately. The user has to manually purchase coins if she wishes to have those reflected on the character sheet. Those coins have to be sold again if the player wants to spend the money.		PCGen currently handles available funds and coins separately. The user has to manually purchase coins if she wishes to have those reflected on the character sheet. Those coins have to be sold again if the player wants to spend the money.

@@ Line 1: / Line 1: @@
 PCGen currently handles available funds and coins separately. The user has to manually purchase coins if she wishes to have those reflected on the character sheet. Those coins have to be sold again if the player wants to spend the money.
 This proposal outlines a method by which PCGen would automatically create coins to reflect any available funds and manage the coins in a useful manner.
 == Use cases ==
+UC1. Add a certain amount of wealth to a character.
-.	Add a certain amount of wealth to a character.
+# Enter total amount as a decimal e.g. 23.31
-a.	Enter total amount as a decimal e.g. 23.31
+# Split amount into coins e.g. 4pp 3gp 3sp 1cp
-b.	Split amount into coins e.g. 4pp 3gp 3sp 1cp
+# Add to coins held in current coin location e.g. Not Carried
-c.	Add to coins held in current coin location e.g. Not Carried
+UC2. Purchase item of equipment
-.	Purchase item of equipment
+# Purchase item  e.g. Lantern (Bullseye) for 12gp
-a.	Purchase item  e.g. Lantern (Bullseye) for 12gp
+# Read coins in coin container e.g  Not Carried, 4pp 3gp 3sp 1cp
-b.	Read coins in coin container e.g  Not Carried, 4pp 3gp 3sp 1cp
+# Calculate minimum number of coins to remove e.g. 2pp 2gp
-c.	Calculate minimum number of coins to remove e.g. 2pp 2gp
+# Remove from coins in coin container e.g.  2pp 1gp 3sp 1cp
-d.	Remove from coins in coin container e.g.  2pp 1gp 3sp 1cp
+# If the money spent is more than is contained in the coin container, all coins in the coin container will be spent and then remainder will be deducted from next set of coins (return to step b). Location selected Not carried, then carried, then equipped, then in a location. Containers in a location will be utilized in equipped order.
-e.	If the money spent is more than is contained in the coin container, all coins in the coin container will be spent and then remainder will be deducted from next set of coins (return to step b). Location selected Not carried, then carried, then equipped, then in a location. Containers in a location will be utilized in equipped order.
+UC3. Change default location for coins
-.	Change default location for coins
+# Select item in equipping tab e.g. belt pouch
-a.	Select item in equipping tab e.g. belt pouch
+# Right click and select “Make default coin container” option.
-b.	Right click and select “Make default coin container” option.
+# Existing coins will stay in old location, but new coin manipulation will take place in the new location.
-c.	Existing coins will stay in old location, but new coin manipulation will take place in the new location.
+UC4. Redistribute coins in equipment set
-.	Redistribute coins in equipment set
+# Purchase or sell coins as required. Purchase items rules would apply e.g. purchase 10gp would remove 1pp and add 10gp to the default location
-a.	Purchase or sell coins as required. Purchase items rules would apply
+UC5. Move coins to another location
-e.g. purchase 10gp would remove 1pp and add 10gp to the default location
+# Use standard move item rules for moving part of the total coins to a new location e.g. Not Carried to Belt Pouch
-.	Move coins to another location
+UC6. Have more than one equipment set
-a.	Use standard move item rules for moving part of the total coins to a new location e.g. Not Carried to Belt Pouch
+# Each equipment set would have a default location.
-.	Have more than one equipment set
+# On purchase all sets would be updated as per UC2
-a.	Each equipment set would have a default location.
+# On creation of a new equip set all coins would be moved to the default coin container (Not carried)
 == Backing Rules ==
-•	Coins are items of equipment specified by the type of Coin
+* Coins are items of equipment specified by the type of Coin
-•	A new tag will be required: ABBREV for equipment e.g. ABBREV:pp
+* A new tag will be required: ABBREV for equipment e.g. ABBREV:pp
-•	The default coin container is “Not Carried”. This can be changed globally to “Carried” or “Equipped” through preferences.
+* The default coin container is “Not Carried”. This can be changed globally to “Carried” or “Equipped” through preferences.
-•	The current coin container for an equipset can be changed by a right click on the item and selecting the “Make default coin container” option
+* The current coin container for an equipset can be changed by a right click on the item and selecting the “Make default coin container” option
-•	The current coin container for a set will be labeled with [Coin container] in the equipping tree.
+* The current coin container for a set will be labeled with [Coin container] in the equipping tree.
-•	If the current coin container is unequipped, the default coin container will receive any coins held in that container
+* If the current coin container is unequipped, the default coin container will receive any coins held in that container
 == Methods Required ==
-BigDecimal getTotalFunds()
+* BigDecimal getTotalFunds()
-spendFunds(BigDecimal gold)
+* spendFunds(BigDecimal gold)
-addFunds(BigDecimal gold)
+* addFunds(BigDecimal gold)
-setCurrentCoinLoc(EquipSet set, EquipNode node)
+* setCurrentCoinLoc(EquipSet set, EquipNode node)

← Older revision	Revision as of 09:40, 13 February 2011
(No difference)