Scans selected residential areas for available plots, and at your discretion, visits them and records how many lottery participants there are. You can use SLH in any world to which you have access. It's features include:

• Has both an auto and manual mode. In auto mode, it will visit all available plots upon completion of a scan cycle. In manual mode, it will allow selection of a desired plot to visit from a list of all available plots at the completion of a scan cycle.
• Allows you to target specific plots by ward and plot number to visit.
• Allows you to specify what kind of plot to visit: Private, Free Company, or both.
• Allows you to specify what size plot you'd like to visit: Small, Medium, and Large.
• Allows you to specify which residential districts to scan: Mist, The Lavender Beds, The Goblet, Shirogane, or Empyreum.
• Automatically uses speed actions (Sprint, Peloton, Fists of Wind) and mounts in residential areas to get you to the placard as quickly as possible.
• Optionally creates CSVs when the Scan Cycle Idle period is entered that 1) record available plot information, including lottery participation status and counts, after those plots have been visited or 2) record plot information for every scanned plot.

It currently does not have any features to automatically enter you into the lottery for a desired plot or to automatically claim a won plot. Depending on customer feedback, it might be possible to add such features in a future version.

It does not check your eligibility to actually acquire an available plot - it is strictly a data gathering tool at this point.

When using SLH in a world other than your home world, information normally displayed about the current lottery phase, your free company association, and your current plot ownership, is unavailable.

You must also download MistahMikeysLib from the store. It's free, of course.

Currently, SLH supports English, French, Japanese, Chinese. and Korean.

You must ensure FFXIV, Minion, and SLH are always updated to their latest versions.

You must be attuned to all the major city aetherytes (Limsa Lominsa Lower Decks, New Gridania, Ul'dah - Steps of Nald, Kugane, and Foundation).

To enable SLH to scan for available plots, you must have completed all the following unlock quests, which adds the “Residential District Aethernet” option to each major city's Aetheryte:

1. Where the Heart Is (Mist)- Lower La Noscea, Ahctkoen – X32,Y20
2. Where the Heart Is (Lavender Beds) – Central Shroud, Margeria – X21,Y22
3. Where the Heart Is (The Goblet) – Western Thanalan, Imme – X25,Y24
4. I Dream of Shirogane (Shirogane) - Kugane, Tsurubami – X12,Y10
5. Ascending to Empyreum (Empyreum) - Foundation, Gondelimbaud – X10,Y12

They are trivial to complete.

Other addons you allow to run at the same time SLH is running might cause it to fail. Please ensure that no FFXIVMinon tasks are running, Assist in particular, or things will not go well.

IMPORTANT

SLH will teleport to each major city's aetheryte to scan its associated residential district for available plots. THIS COSTS GIL. SLH does attempt to minimize the need to use aetheryte teleports when you can visit multiple plots within an individual housing area ward, keeping you withing the ward until all available plots are visited. If you use the targets feature (see the Target Tab section), SLH will preprocess the list you create to consolidate targeted plots within individual wards. You can also keep the amount of gil spent scanning reasonable by specifying a large delay between successive scans of the 5 residential districts, so the gil burn is minimal. Given that the lottery entry period is several days long, you only need to scan as often as you desire to have up to date lottery participant totals.

Existing users of the original Squatter addon can purchase SLH for a reduced price. Select the Squatter Lottery Helper Update addon from the Minion store to take advantage of this special offer.

You start SLH via the FFXIVMinion menu drop down. It's under the “Mistah Mikey's Addons” menu item. Clicking “Squatter Lottery Helper” should pop up its UI window. The UI consists of different input areas called tabs. The first line of the SLH main window is a list of all the available tabs. To select a desired tab, click on it. Each tab is described below.

GENERAL UI USAGE NOTE

When entering a value into a field control, when you begin to enter the text, the text will appear dimmed as a visual cue you are in the process of modifying the current value of the field. The field value is not entered until you hit either the RETURN key or the TAB key, at which time the value might be checked, resulting in a popup if an error is detected. After dismissing an error popup, you should be returned to the field control to correct the error. If you navigate away from a field control by focusing other controls (say, by clicking in a different field control) before entering the value, the current value will be redisplayed and the value you were in the process of entering will be lost.

In the SLH control descriptions, if the control label has a asterisk appended, it means that value is saved in your profile (see the Profile Tab.)

Finally, for the Discovered Plots list, some of the columns are sortable. For sortable columns, 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).

This tab generally controls scanning for available plots and the plot visiting process. The two lines below the tab selection line show your Available Gil and the current Housing Lottery Status.

This area of the tab provides information about your Free Company membership and current plot associations. The information is automatically updated whenever SLH is loaded or reset. However, because SLH must interact with FFXIV controls (dialogs) to accumulate this information, it can sometimes fail for a variety of reasons that are beyond SLH's control. If you see that the information does not reflect your reality, or if you change those associations during the game, you can hit the “Refresh” button and SLH will attempt to gather the information again. If SLH is consistently unable to gather this information, it likely means some other addon you have installed is interfering with SLH's ability to operate the required controls. Please report all such issues on the SLH discord channel (see the support section at the end of this wiki.)

If you would like SLH to track the demolition timer for the houses on your associated plots, deselect all aetherytes, make sure SLH is enabled, then click on the plots you own one by one to travel to them. You don't have to use SLH to travel to your plots - you can travel to them however you please. Once at the plot, make sure SLH is still enabled, enter your house, and you will see the current time recorded in the Last Visit Date column. SLH will automatically tell you how many days it's been since that visit date in the Days Since Visit column. The last visit date is saved across logins - BUT - SLH also will delete this information if it determines you no longer own the plot. This might occur accidentally if, for whatever reason, SLH is unable to accurately determine your plot ownership, which can occur from time to time. If that happens, simply repeat this procedure for the plots that have NEVER as their Last Visit Date to start the ball rolling again.

The controls on this tab are described below.

Because teleporting costs gil, you have a couple of ways you can control how often SLH will cycle through your selected aetherytes to scan for available plots. After you have completed scanning all selected aetherytes, these controls allow you to specify how long you will idle before beginning to scan the aetherytes again (the scan idle period.)

These controls affect how changes to the controls in the housing areas comprising the Housing Area Scan List (described next) work. If they are checked, then changes to the corresponding housing area control will be made to ALL housing area entries. If they are not checked, the changes only apply to the corresponding housing area control.

The housing area scan list controls how SLH scans housing areas (surprise!) and, for each housing area, the top level filter criteria for the plots it will attempt to visit within that housing area. There are currently 4 entries in this list, one for each of the housing areas currently in the game. SLH will visit the city aetherytes associated with each housing area in the list to scan for available plots. By default, the visitation order is serpentine. SLH chooses 1) which entry will be the first one scanned, which acts as the anchor for determining when the Scan Idle Period begins, and 2) the direction the entries will be visited (forward or backward). When the scan wraps around to the first entry, SLH enters the Scan Idle Period (delay until SLH will resume scanning), and when it resumes scanning, if serpentine scanning is enabled, it will go in the opposite direction. By default, SLH chooses the leftmost entry to start the scan and the forward direction. If you check “Randomize Scan Start”, SLH will randomly chooses the first entry to scan and direction. So you have some idea of where SLH is in the scanning process, it color codes the current entry being scanned (green) and the next entry to be scanned (cyan); the “enabled” checkbox for the first entry is green.

For each entry in the housing area scan list, you can specify the following housing area-specific criteria by using the following controls:

Drop down that allows you to set the housing area for its list entry. You can set these however you like to create whatever visitation order you desire. Be aware, SLH does not enforce any rules on how you do this - you can set them all to the same housing area if you like, and SLH will visit the same aetheryte 4 times. It's completely up to you.

If checked, the housing area list entry will be included in the scan. The checkbox will be green for housing area SLH chooses to start the scan.

Drop down that allows you to select one of the following:

Note When SLH scans a housing area ward for available plots, the Residential Area Selection control will not change view when it scans subdivision plots 30-60. SLH receives the data for all 60 plots when the ward is selected, so you will never see the control's view switch to plots 30-60. Don't worry, if you selected “Both Divisions” or “Subdivision Only” in the Divisions to Scan control, those subdivision plots are being scanned.

Drop down that allows you to select one of the following:

(S)mall, (M)edium, and (L)arge: Check the ones you wish to have SLH check for availability. Note: only available plots with the size(s) you select will be shown in the Discovered Plots List.

1 through 5: Check the ones you wish to have SLH check for availability. Note: only available plots with the grade(s) you select will be shown in the Discovered Plots List.

A scrollable list of plots discovered during scanning. When using auto-visit, plots with the “Available” status are visited in the order they appear in this list. Certain 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). Note that sorting the list will change the order in which available plots are visited. So, for example, if you wanted to visit plots according to their plot size, largest to smallest, you would use the “v” button to sort the list in the descending direction.

Each line contains the following information:

Clicking on an Available or Visited plot will mark that plot to be visited during the next Scan Cycle Idle period.

Clicking on Aborted plots changes their status back to Available.

Clicking on Sold plots will remove them from the list.

Clicking on anything other plot status value does nothing.

The list is sorted by Plot status, in the following order: Visiting, Purchased, Available, Visited, Aborted, Sold, Owned. The secondary sorts fields are Housing Area, Ward Number, and Plot Number.

The Targets Tab allows you to prioritize what plots SLH tries to visit.

You enter a target plot using the Priority, Housing Area, Ward No, and Plot No fields, then add it to the target list using the Add button. The Priority value is a number (can be float) that is used to order the target list. Larger priority values indicate higher priority. If you want to change the priority of an existing target, simply enter its housing area, ward number and plot number along with the new priority value and click Add.

The Ward No and Plot No can be set to zero to act as a wildcard in the plot targeting. So, if you want to target any plot in ward 17, you would enter a plot number of zero. Likewise, if you want to target plot 10 in any ward, you would enter a ward number of zero. If both ward number and plot number are zero, SLH will target all plots in all wards within that Housing Area - you can use this to prioritize the housing areas within which SLH will attempt to visit plots.

You can delete plots from the target list by checking them in the Selection column and clicking the Delete button. You can select/deselect them all by using the checkbox at the bottom of the Selection column.

Also, this feature is intended for use when Auto Visit is checked on the Scan Tab - otherwise, it really doesn't do anything at all. It does not filter the available plot list to only show targeted plots.

When you visit plots, SLH will preprocess your target list to consolidate plots within individual wards to minimize the need to teleport out to an aethertye to change the ward you are in.

All of the settings on this tab can be saved in your profile. So if you want different target lists, you can create different profiles to hold them.

The Movement Tab allows you to control what kind of movement speed SLH will use to run your character to the placard in the housing area. There are two types of movement speed enhancements that are used: running speed actions and mounts. Running speed actions include Sprint, and if you use the right character, Peloton and Fists of Wind. These are invoked as they are available when the distance you must move is fairly short as indicated by the Mount Cutoff Distance. When the distance is longer than the Mount Cutoff Distance, a selected or random mount will be used to travel that distance. The controls on this tab are:

The Notification Tab allows you tell SLH to send an email to a desired recipient email account using a desired sender email account. The events for which SLH sends a email are: Available plots are discovered during scanning, a plot visit is initiated (either via Auto Visit or clicking on a desired available plot), you win the plot, or someone else wins the plot. Note: these notifications do not occur when Test Mode or Demo Mode is selected, but you can send a test notification if you wish. The controls on this tab are:

The Profile Tab allows you to persistently store most of SLH's settings. The profile settings are stored in files unique to the character and game language used to create the profile. You can create as many profiles as you like. The controls on this tab are:

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.

This tab is primarily intended for use in conjunction with consultation with SLH support. It enables various test scenarios and debugging information that are used to help diagnose issues that might occur during SLH's operation. The controls on this tab are:

For support or requests, please contact me on discord: https://discord.gg/J67ybRCRqt. I will respond as soon as I am able, generally within 24 hours at most.

When you need support, please provide me, at a minimum, the following:

1. Enable the debug information category on the Debug Tab and do what you did to create the problem. Then take a screen shot of your Minion Console Log when the problem occurs. Make sure the Log's window as big as possible to show the maximum amount of output. If the output is larger than the window, then scroll the offscreen portions into view and send multiple screen shots.
2. A screen shot of your Material Girl main tab

If you post this information to the specified channel (NOT RECOMMENDED), please ensure it does not contain any information that identifies your account, character, or server. For complete anonymity, just DM it to mistahmikey#4073. Additionally, you should not use an account you use for in-game communications so you can't be doxed as a botter.

If that initial information is insufficient for me to determine the cause, I will ask you to set other debug settings that will provide more information. SLH is a very complex piece of software, and can be negatively affected by a number of factors over which I have no control, not the least of which is what other addons you run. I appreciate your patience in working with me to solve your issue when it is not slam-dunk easy. As long as you are willing to try the debugging measures I request, I will work with you until your problem is solved.