User Tools

Site Tools



materialgirl

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
materialgirl [2022/11/03 02:45] – [Profile Tab] mistahmikeymaterialgirl [2024/01/03 01:44] (current) – [Vendors Table] mistahmikey
Line 3: Line 3:
 ===== What it does ===== ===== What it does =====
  
-Provides a wide variety of functions for you to manage items in your various inventories.   +Provides a wide variety of functions for you to manage items in your various inventory bags: Main Inventory, Equipped Items, Armory, Saddlebags, and Retainer bags.   
-  * Allows you to easily apply functions to multiple selected items in your inventories: Extract Materia, Retrieve Materia, Desynthesize, Repair (using dark matter or a mender), Use, Discard, Sell, Expert Delivery+  * Allows you to easily apply functions to multiple selected items in your inventories (if they are supported by the bag type): Extract Materia, Retrieve Materia, Desynthesize, Repair (using dark matter or a mender), Use, Discard, Merge, Sell, Expert Delivery
   * Allows you to automatically handover required items during certain transactions with NPCs.   * Allows you to automatically handover required items during certain transactions with NPCs.
   * Allows you to trade unlimited (as governed by the recipient's inventory space) selected items or gil to another character running Material Girl.   * Allows you to trade unlimited (as governed by the recipient's inventory space) selected items or gil to another character running Material Girl.
-  * Allows you to move multiple selected items between any of your Inventory, Armory, and Saddlebags.+  * Allows you to move multiple selected items between any of your bags.
   * Allows you to synchronize equipment in your armory by setting and saving the recommended gear for every gearset you have.   * Allows you to synchronize equipment in your armory by setting and saving the recommended gear for every gearset you have.
   * Allows you to clean your armory of equipment that is not assigned to any gearset by automatically moving it into your inventory.   * Allows you to clean your armory of equipment that is not assigned to any gearset by automatically moving it into your inventory.
Line 108: Line 108:
  ( <expression> )  ( <expression> )
  
-<primitiveExpression> := #these all evaluate to TRUE or FALSE for a inventory item+<primitiveExpression> := #these all evaluate to TRUE or FALSE for a bag item
  <patternOp> | #item name matches lua pattern  <patternOp> | #item name matches lua pattern
  <nameOp> | #item name exactly matches string  <nameOp> | #item name exactly matches string
Line 121: Line 121:
  sellable | #item is sellable  sellable | #item is sellable
  collectable | #item is collectable  collectable | #item is collectable
 + buyable | #item can be bought at a vendor
  <relationOp> #item satifies a relation  <relationOp> #item satifies a relation
  
Line 194: Line 195:
  not |  not |
  !  !
- 
 </code> </code>
  
Line 218: Line 218:
 Below the Filter Expression controls is the list of items on which you can perform various functions.  You can select item entries for function application by either clicking the check box to the left of it or by mousing over the item name and clicking on it. You can toggle between all item entries being selected or not by toggling the check box under the Selection label. Below the Filter Expression controls is the list of items on which you can perform various functions.  You can select item entries for function application by either clicking the check box to the left of it or by mousing over the item name and clicking on it. You can toggle between all item entries being selected or not by toggling the check box under the Selection label.
  
-The item list table provide a wide range of item attributes for you to view.  The item information displayed in each column is:+The item list table provide a wide range of item attributes for you to view.  Note that the column headers provide buttons that allow you to sort the list according to values in that column: “^” sorts in the ascending direction (lowest to highest values), while “v” sorts in the descending direction (highest to lowest values). The item information displayed in each column is:
  
-| Name           | The item's name                                                +| Name           | The item's name                                                                                                                                                                 
-| Inv Type       | The inventory type of the inventory in which the item resides  +| Inv Type       | The inventory type of the inventory in which the item resides                                                                                                                   
-| Slot           | The slot within the inventory that holds the item              +| Slot           | The slot within the inventory that holds the item                                                                                                                               
-| Level          | The player level of the item                                   +| Level          | The player level of the item                                                                                                                                                    
-| iLevel         | The item level of the item                                     +| iLevel         | The item level of the item                                                                                                                                                      
-| HQ Count       | The number of this item that are high quality                  +| HQ Count       | The number of this item that are high quality                                                                                                                                   
-| NQ Count       | The number of this item that are normal quality                +| NQ Count       | The number of this item that are normal quality                                                                                                                                 
-| Can Desynth    | The item can be desynthesized                                  +| Can Desynth    | The item can be desynthesized                                                                                                                                                   
-| Materia Count  | The number of materias attached to the item                    +| Materia Count  | The number of materias attached to the item                                                                                                                                     
-| % SB           | The item's spiritbond percentage                               +| % SB           | The item's spiritbond percentage                                                                                                                                                
-| % Cond         | The item's damage condition                                    +| % Cond         | The item's damage condition                                                                                                                                                     
-| Col Rtg        | The item's collectability rating                               +| Col Rtg        | The item's collectability rating                                                                                                                                                
-| Can Trade      | The item can be traded                                         +| Can Trade      | The item can be traded                                                                                                                                                          | 
-| Vendor Price   | The gil amount a vendor will pay for the item                  |+| Can Buy        | The item can be bought at a vendor. If you double right click on a cell in this column containing a "true" value, a popup table of the vendors who sell this item is displayed.  
 +| Vendor Price   | The gil amount a vendor will pay for the item                                                                                                                                   |
  
-Depending on the inventory types of the individual items you've selected, certain functions may not be applicable. For example, you can't sell items out of your saddle bags, so if you attempt to do so, Material Girl will deny the request.  Material Girl also prohibits you from preforming destructive operations on your equipment inventory types, and requires you to first move them from your equipped items or armory into your inventory bags to do things like desynthesize or discard. When functions are disallowed, Material Girl will provide a popup that identifies the disallowed functions.+Depending on the inventory types of the individual items you've selected, certain functions may not be applicable. For example, you can't sell items out of your saddle bags, so if you attempt to do so, Material Girl will deny the request.  Material Girl also prohibits you from preforming destructive operations on your equipment inventory types, and requires you to first move them from your equipped items or armory into your inventory bags to do things like retrieve materia, desynthesizeor discard. When functions are disallowed, Material Girl will provide a popup that identifies the disallowed functions.
  
 The functions you can perform are: The functions you can perform are:
Line 252: Line 253:
 | :::                 | :::                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | | :::                 | :::                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | Discard             | The enabled item is discarded. If the item is stacked, all items in the stack are discarded. This is considered to be a destructive function, so you will be prompted to authorize it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | | Discard             | The enabled item is discarded. If the item is stacked, all items in the stack are discarded. This is considered to be a destructive function, so you will be prompted to authorize it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 +| Merge               | Merges the selected stackable items into larger stacks. You can select just the items you want stacked, or you can select everything an Material Girl will merge everything that is stackable. |
 | Expert Delivery     | The enabled item will be offered up for expert delivery.  Material Girl will navigate your character to the appropriate Grand Company officer and interact with it to deliver all enabled items.  By default, special items will not be delivered, but this can be enabled using the Settings tab. If delivering an item will put you over your maximum company seal allowance, the function will be terminated. While this could be considered to be a destructive function, you will be not be prompted to authorize it, since you have plenty of time to abort while it is traveling to the NPC required to accomplish it.                                                                                                                                                                                                                                                                                                                                                               | | Expert Delivery     | The enabled item will be offered up for expert delivery.  Material Girl will navigate your character to the appropriate Grand Company officer and interact with it to deliver all enabled items.  By default, special items will not be delivered, but this can be enabled using the Settings tab. If delivering an item will put you over your maximum company seal allowance, the function will be terminated. While this could be considered to be a destructive function, you will be not be prompted to authorize it, since you have plenty of time to abort while it is traveling to the NPC required to accomplish it.                                                                                                                                                                                                                                                                                                                                                               |
 | :::                 | :::                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | | :::                 | :::                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
Line 268: Line 270:
 | Select Destination  | The enabled items will be moved to the inventory you select from the dropdown list. Some of the inventory selections will be groups, like Armory, while others will be specific inventories, like Bag 1. In all cases, the item is moved into the first available slot in the selected inventory. | | Select Destination  | The enabled items will be moved to the inventory you select from the dropdown list. Some of the inventory selections will be groups, like Armory, while others will be specific inventories, like Bag 1. In all cases, the item is moved into the first available slot in the selected inventory. |
  
 +=== Vendors Table ===
 +
 +If you double click on a cell in the "Can Buy" column with a "true" value, a popup window will display a table of the vendors who sell the item.
 +
 +{{:mistahmikey:materialgirl:vendors_table.png?400|}}
 +
 +If you also own Taximan, you can double click on any vendor in the table to add it to your favorites.  It is always added to your current default category. If Taximan is running, the addition is immediately live - that is, you don't have to reload Taximan for it to pick up the change to your favorites.  Please be aware, some of the vendors may be at locations Taximan cannot reach, because they are behind some intermediate obstacle that it is not programmed to get by.  If someone has a burning need to go to such a vendor, please contact me via Discord and I'll see if it is possible to add the required intermediary to MistahMikeysLib.
    
  
Line 282: Line 291:
  
 You can select individual inventory type entries by either clicking the check box to the left of it or by mousing over the inventory type name and clicking on it.  You can toggle between all inventory type entries being selected or not by toggling the check box under the Selection label. You can select individual inventory type entries by either clicking the check box to the left of it or by mousing over the inventory type name and clicking on it.  You can toggle between all inventory type entries being selected or not by toggling the check box under the Selection label.
 +
 +For the saddlebag inventory types to appear, Material Girl must be able to operate the saddlebag main command.  This requires a cast, so if your action bar is disabled (doesn't appear on your screen) then the saddlebag types will not appear.  This typically occurs because you have FFXIV windows open that causes the action bar to be disabled.  If this happens, just close all your open FFXIV windows, then hit the Reset button on the Material Girl UI.
 +
 +The retainer bag inventory types are only available while you have the retainer inventory window open. So you must manually open the retainer inventory window to enable using Material Girl on retainer bags.
  
 The selected inventory types will be displayed on the Main Tab next to the Selected Inventory Types label. The selected inventory types will be displayed on the Main Tab next to the Selected Inventory Types label.
Line 315: Line 328:
 | Accept Delivery of Special Item | When checked, Material Girl will automatically allow expert delivery of special items. | | Accept Delivery of Special Item | When checked, Material Girl will automatically allow expert delivery of special items. |
 | Set Recommended Gear During Armory Clean | When checked, Material Girl will first set recommended gear for each selected gearset before cataloging the equipment being used from that gearset. | | Set Recommended Gear During Armory Clean | When checked, Material Girl will first set recommended gear for each selected gearset before cataloging the equipment being used from that gearset. |
-| Automatic Desynthesize Mode Disable Override | When checked, Material Girl will allow you to automatically desynthesize items as you craft. This is useful for leveling desynthesis skill. If you use Lisbeth for crafting, be sure to disable its auto material extraction and repair features if you enable them in Material Girl. This setting is NOT saved to your profile. |+Override Automatic Desynthesize Mode Disable | When checked, Material Girl will allow you to automatically desynthesize items as you craft. This is useful for leveling desynthesis skill. If you use Lisbeth for crafting, be sure to disable its auto material extraction and repair features if you enable them in Material Girl. This setting is NOT saved to your profile. | 
 +| Override Equipped Gearset Materia Retrieval Block | When checked, Material Girl will allow you to retrieve materia from your equipped gear. This setting is NOT saved to your profile. |
 | Min Repair Condition | The equipment condition threshold for repairing equipment that falls below the set threshold. | | Min Repair Condition | The equipment condition threshold for repairing equipment that falls below the set threshold. |
 ===== Profile Tab ===== ===== Profile Tab =====
Line 330: Line 344:
 | Add | Create the new profile and save all current settings to it. | | Add | Create the new profile and save all current settings to it. |
  
-The table is a list of all the profiles you have created for the current character and game language.  Using the "Selection" column, you can select specific profiles for the operations Delete or Make Current.  Obviously, only one profile at a time can be made current, so you can only select one for that operation, but you can select as many as you like for the Delete operation.  You can select/deselect all profiles by using the checkbox in the operation row.+The table is a list of all the profiles you have created for the current character and game language.  Using the "Selection" column, you can select specific profiles for the operations Delete or Make Current.  Obviously, only one profile at a time can be made current, so you can only select one for that operation, but you can select as many as you like for the Delete operation.  You can select/deselect all profiles by using the checkbox in the operation row. ** Be aware that profile values are only saved when you explicitly request them to be saved via the Save button. **
  
  
Line 339: Line 353:
 This tab is primarily intended for use in conjunction with consultation with Material Girl support.  It enables various test scenarios and debugging information that are used to help diagnose issues that might occur during Squatter's operation.  The controls on this tab are: This tab is primarily intended for use in conjunction with consultation with Material Girl support.  It enables various test scenarios and debugging information that are used to help diagnose issues that might occur during Squatter's operation.  The controls on this tab are:
  
-Enable Log file:  When checked, Material Girl will create a unique log file for your session. This only needs to be checked if you are told to do so by Squatter support. +Enable Log file When checked, Material Girl will create a unique log file for your session. This only needs to be checked if you are told to do so by Squatter support. | 
- +Enable Timestamp When checked, Material Girl will include the current tick count in the debug messages. This provides information that facilitates debugging timing issues. | 
-Enable Timestamp:  When checked, Material Girl will include the current tick count in the debug messages. This provides information that facilitates debugging timing issues. +Debug Message Level Settings Material Girl's debug message system implements a simple filtering mechanism that can be used to allow or inhibit certain message classes, generally in increasing order of verbosity.  The default settings are fairly "quiet", but to debug issues you encounter you will be asked to enable more verbose settings to gather diagnostic information. |
- +
-Debug Message Level Settings:  Material Girl's debug message system implements a simple filtering mechanism that can be used to allow or inhibit certain message classes, generally in increasing order of verbosity.  The default settings are fairly "quiet", but to debug issues you encounter you will be asked to enable more verbose settings to gather diagnostic information. +
 ====== Support ====== ====== Support ======
  
materialgirl.1667443542.txt.gz · Last modified: 2022/11/03 02:45 by mistahmikey