Quantcast
Download
(339 Kb)
Download
Updated: 05/20/19 11:22 AM
Pictures
File Info
Compatibility:
Elsweyr (5.0.5)
Wrathstone (4.3)
Murkmire (4.2)
Wolfhunter (4.1)
Summerset (4.0)
Dragon Bones (3.3)
Clockwork City (3.2)
Horns of the Reach (3.1)
Morrowind (3.0)
Homestead (2.7)
Updated:05/20/19 11:22 AM
Created:04/15/18 10:31 AM
Monthly downloads:805
Total downloads:22,968
Favorites:39
MD5:
Categories:Group, Guild & Friends, Homestead
5.0.5
Guild Hall Button  Popular! (More than 5000 hits)
Version: 1.8.3
by: BoarGules [More]
Guild Hall Button
by Boar Gules


Many players of Elder Scrolls Online® have hankered after guild halls of the sort provided by Guild Wars.


When Zenimax announced Homestead, the ESO housing framework, many guilds immediately co-opted it as a way to set up guild halls. Typically, though not always, the guild hall is the guild leader’s primary residence. Often, such houses are not furnished as residences at all: they have full catering facilities, crafting stations, and other things you would not expect to find in a private home, however wealthy the owner might be.


You can quite easily travel to such a guild hall: simply pick your guild leader’s name out of the guild roster and select Visit Primary Residence from the context menu.


The Guild Hall Button add-on does little more than that. It is a simple way to reduce the number of mouse-clicks required, and also expresses the intention of the guilds that such houses are not residences at all, but guild halls.


To Install


Most people use Minion to install add-ons, but if you want to do a manual install, that is very straightforward. Open the zipfile and you will see a folder called GuildHallButton. Extract this folder to your ESO add-ons folder.


* On a PC that will typically be C:\Users\username\Documents\Elder Scrolls Online\live\AddOns. If you have installed ESO on another drive, or have chosen another location for your Documents folder, you will presumably know what to substitute for C:.
* On a Mac that will typically be ~/Documents/Elder Scrolls Online/live/AddOns.


Once you have done this you should have a new folder in AddOns called GuildHallButton. There should be 9 files and 2 subfolders inside it:


* GuildHallButton.lua and Version.lua
* GuildHallButton.txt and GuildHallButton.xml
* this documentation in two forms (GuildHallButton.pdf and readme.txt)
* 3 screenshots (.jpg)
* subfolders lang (for internationalization) and lib (for library files)


Operation


Following a successful install, if you press G for Guild, you should see Guild Hall shown on the bottom left of your Guild home screen. Press the button Travel to Guild Hall and you will be moved to the “primary residence” of that guild’s leader.


Configuration


This add-on was intended to be zero-configuration software. But some guilds have castellan-officers, and it is their primary residence that is the guild hall, not the guild leader’s, and this situation needs to be manually configured.


Otherwise, pressing the button will either take you to the wrong place, or simply yield the warning The house you attempted to visit is unavailable.


It is not uncommon for a single management team to run a group of related guilds with a shared guild hall. But, according to ESO rules, a player may be leader of only one guild, so the shared guild hall will not always belong to the leader of the guild you are in.


An add-on cannot discover this situation from the game API, because from the game’s point of view, there is no such thing as a guild hall. Even as a player, you can only find this out by reading your guild’s message of the day, website, or Facebook page. In such cases, you need to enter the information manually.


Fortunately, configuration is simple. Start by going to the game menu Settings | Addons | Guild Hall Button.


This will list your guilds, with three fairly self-explanatory option settings for each.


* Override default guild hall. Set this to on if you need to configure the Guild Hall Button. This will enable the remaining 2 settings:
* Castellan officer. This is the name of the guild officer who is the formal owner of the guild hall. The default value is (guild leader) because that is the usual situation. A drop-down list will offer you a list of the senior officers in the guild to choose from. If the name you want is not on the list, see Extras below.
* Name of guild hall. The default value for this is (principal residence) and you will rarely need to change it. A drop-down list will offer the houses likely to be guild halls: not studio apartments or rooms at taverns. If the house you want is not on the list, see Extras below.


Leaving and Joining Guilds


When you leave a guild or join a new one, the configuration screen will not show your changed membership until the next UI reload. This happens when you log out or issue the /reloadui command.


You can choose to have the Guild Hall Button do an automatic UI reload when you leave or join a guild. Then the configuration screen will always reflect all of your guild current memberships.


But switching this on will mean that if you join or leave two guilds in succession, you will get two /reloadui commands. This may not be what you want.
If in doubt, leave these options switched off.


Error Reporting


If something unexpected happens in an ESO add-on, the game will normally display a UI Error window with the traceback of the code leading up to the Lua error.
Tracebacks are vital to the developer. Without them, solving the problem is close to impossible. But they are meaningless to the end-user. For this reason, this add-on traps and stores the traceback, and simply issues a message saying that what you were trying to do did not work, and that you can retrieve the traceback using the command /guildhall traceback.


You can do this at any time, so that you can compose a bug report when it suits you, instead of having to choose between composing a bug report at that very moment, or closing the UI Error window and destroying the evidence. The Guild Hall Button stores your last 9 tracebacks, numbered 1 to 9. Traceback 1 is the most recent.


Extras


You can use slash commands to bypass the Settings menu. You may need to do this if the drop-down lists on the configuration screen don’t show you the player or the house that you want. It may also be helpful in special situations, such as when playing on the Public Test Server.


Start by typing the command /guildhall list and you will see a list of the guilds you are a member of.


1* Rich Mahogany: Earthtear Cavern -> Guild leader's house
[2] Merchants of the Merchants -> Daggerfall Overlook: Guild leader's house
[3] Rangiest Rangers -> Daggerfall Overlook: Guild leader's house


The numbers on the left have the same meaning as the chat window commands /guild1 etc. Now suppose that the guild hall of Merchants of the Merchants is not the guild leader’s primary residence but is instead the primary residence of castellan-officer @Slartibartfast. Type this command:


/guildhall 2 @Slartibartfast


That will take you to the guild hall, so that you can be sure that your configuration is correct. After that, the next time you press the guild hall button, it will take you to the right place without having to be told a second time. If you see the warning Can’t identify @slartibartfast as a guild member, it indicates you have typed the name wrong. Names are case-sensitive, and the leading @ is required.


To reverse this configuration, simply do the same thing, but supply the guild leader’s name.


For people who dislike taking their fingers from the keyboard, you can also use the command /guildhall (alternative spelling /gh), without a player name, to take you to the guild hall, and you can optionally type a number between 1 and 5 (for example /guildhall 2) to specify which guild. If you omit the number then the command takes you to the guild selected on the guild home screen.


A guild leader whose primary residence is a guild hall will generally have other, more modest accommodation elsewhere. If you have permission to visit one of those other houses, you can go there using the following command:


/guildhall number name


where number is the number of the guild as shown above (not optional), and name is the name of the house, or part of it. For example, typing /gh 1 sleek is enough to identify Sleek Creek. The name you type must be long enough to match exactly one house.


You can combine the two forms of the /guildhall command to permanently set the guild hall for a guild to something other than a primary residence, for example:


/guildhall 2 @Slartibartfast sleek


though it is unlikely that you would want to do this in normal circumstances, because that would mean that guild 2's guild hall could only be reached by using the Guild Hall Button, or another add-on with similar facilities, because there would be no way for guild members to go there using the game’s normal UI.


If you want the ability to go to any house of any player, but not set it as a nonstandard guild hall, use the command /visit instead of /guildhall. This was an extra requested by some users and it is disabled by default. After enabling it in the configuration screen, you can use this command:


/visit @Slartibartfast sleek


which will simply take you to @Slartibartfast’s house at Sleek Creek but won’t affect guild hall settings. If you don’t specify a house then the /visit command will take you to that player’s principal residence. If you don’t specify a player then the /visit command will take you to your house of that name.


Translation


If you use and like Guild Hall Button and you would like to have it in your own language, please volunteer by emailing [email protected] You would not be letting yourself in for a lot of work: the add-on, being a very simple one, needs only around two dozen translations.

1.8.3 New API version 100027. Elsweyr.
1.8.2 Fix display of candidate castellan officers in guilds where members don't have ranks
1.8.1 Fix to command /visit without a player name defaults to current player
1.8.0 Command /visit without a player name defaults to current player
1.7.4 New API version 100026. Cosmetic change of positioning of button on guild screen required by changed layout.
1.7.3 New API version 100025. No substantive changes.
1.7.2 Will not overwrite a slash command that is already assigned
1.7.1 Command /visit without a house name defaults to player's principal residence
1.7.0
-- Compatible with Murkmire
-- New optional slash command /visit
-- Hints provided for /guildhall subcommands traceback, list, version
1.6.1 Eliminate spurious failure message on joining a guild
1.6.0
-- Fixes to a pervasive bug between leaving/joining a guild and the next /reloadui that in the worst case led to a corrupted SavedVariables file, which just kept the defect alive past /reloadui. (Warm thanks to RavenMind for a comprehensive bug report.)
-- Measures (inspired by Python) to stop stack traces from leaking out to the player as a UI Error window. Code defects are hard to avoid, but they should be handled more gracefully than popping up a debug window on a player's screen.
-- New /guildhall subcommands: /gh version and /gh traceback.
-- Fix to the configuration of house names.
-- Better validation to prevent the configuration of a house override without castellan name.
-- Better validation to prevent a castellan's name differing in case from the real player name.
-- Option to do an automatic /reloadui after leaving/joining a guild, to refresh the config screen.
-- Internal changes: further preparation for gettext-style internationalization support.
1.5.6 Partial rollback of changeset 259.
1.5.5 Additional misconfiguration trap
1.5.4 Cosmetic change (trace in chat window removed)
1.5.3 Wolfhunter compatibility. Update to API version. Largely internal changes: preparation for gettext-style internationalization support; start of migration to more robust error-handling scheme.
1.5.2 Not released.
Archived Files (8)
File Name
Version
Size
Uploader
Date
1.8.3
339kB
BoarGules
05/11/19 02:57 AM
1.8.1
339kB
BoarGules
04/01/19 02:05 PM
1.8.0
339kB
BoarGules
04/01/19 01:26 PM
1.7.4
337kB
BoarGules
02/25/19 03:06 AM
1.7.3
337kB
BoarGules
11/18/18 02:01 PM
1.7.2
337kB
BoarGules
10/14/18 05:00 AM
1.7.1
337kB
BoarGules
10/11/18 01:18 PM
1.7.0
336kB
BoarGules
10/08/18 04:04 PM


Post A Reply Comment Options
Unread 06/18/19, 03:50 AM  
jc28735250

Forum posts: 2
File comments: 2
Uploads: 0
Great mod! Has the great ability to specify manually which guild member's hall to set as guild hall, which is what I needed.

Small suggestion for a feature: add keybind customization to go to guild hall 1...etc
Report comment to moderator  
Reply With Quote
Unread 05/30/19, 03:11 PM  
Keluna

Forum posts: 0
File comments: 25
Uploads: 0
Thank you very much for this Addon, this is what I was searching for. The important feature for me is that you can manually configure the guild hall. Please keep the Addon up to date, it's a really useful one.
Report comment to moderator  
Reply With Quote
Unread 05/28/19, 03:53 AM  
SteveCampsOut
 
SteveCampsOut's Avatar

Forum posts: 23
File comments: 304
Uploads: 0
Isn't this a trimmed down version of "WheresMyGuildHall"? They've updated that one.
Report comment to moderator  
Reply With Quote
Unread 05/27/19, 10:01 AM  
Rhyono
AddOn Author - Click to view AddOns

Forum posts: 507
File comments: 957
Uploads: 19
Same problem.

Guild 2 became Guild 1. Guild 1's button is now on Guild 2's page.

I'd recommend attaching the button by guild id, not guild index, as those will never change.
Report comment to moderator  
Reply With Quote
Unread 05/21/19, 10:51 PM  
Phuein
 
Phuein's Avatar
AddOn Author - Click to view AddOns

Forum posts: 75
File comments: 116
Uploads: 7
Re: Configuring guild changes

Originally Posted by BoarGules


It is not uncommon for a single management team to run a group of related guilds with a shared guild hall. But, according to ESO rules, a player may be leader of only one guild, so the shared guild hall will not always belong to the leader of the guild you are in.


An add-on cannot discover this situation from the game API, because from the game’s point of view, there is no such thing as a guild hall. Even as a player, you can only find this out by reading your guild’s message of the day, website, or Facebook page. In such cases, you need to enter the information manually.


You enter it by going to the game menu Settings | Addons | Guild Hall Button. This will list your guilds, with three fairly self-explanatory option settings for each.

  • Override default guild hall. Set this to on if you need to configure the Guild Hall Button. This will enable the remaining 2 settings:
  • Castellan officer. This is the name of the guild officer who is the formal owner of the guild hall. The default value is (guild leader) because that is the usual situation. A drop-down list will offer you a list of the senior officers in the guild to choose from.
  • Name of guild hall. The default value for this is (principal residence) and you will rarely need to change it.

Did manual entry not work for you, or did you just have trouble finding it?

I'm not sure I'm following you here. Don't you just listen to: EVENT_GUILD_SELF_LEFT_GUILD and EVENT_GUILD_SELF_JOINED_GUILD ?

That way you can just update the button data accordingly. Redo the data, matching old indexes to new.

I'll say it in different words: I left some guilds, and joined some new guilds, but your addon did not update my guilds and their selection. It just showed the old guilds' data. Even after /reloadui or logout.

EDIT: I will mention that I was using an older version, and not updated again until recently.
__________________

Author of beloved and rejuvenated addons:

ShowMount            • PvP FPS 2018

Notebook 2018        • Junkee 2018

BestFriends 2018      • New Addon
Last edited by Phuein : 05/21/19 at 10:56 PM.
Report comment to moderator  
Reply With Quote
Unread 05/21/19, 10:10 AM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 16
Uploads: 1
Re: Suggestions

Originally Posted by Coolio_Wolfus
  1. ...
  2. Add a way for it to be blank if unset, some small guilds don't have a guild hall yet.
  3. ...
  4. ...
I've been thinking about this one and, though I like the idea, I don't think the API gives me any way to implement it. In the game, if you press G[uild] | Roster, and right-click the guild leader, you can choose Visit Primary Residence. If you do, you have no idea where you are going to be taken until you get there. If the guild leader has no primary residence, or does but you are not allowed to go there, there will just be an alert at the top right of the screen.


The Guild Hall Button is a just a wrapper around this functionality, so it has no reliable way to know if the guild leader has no house, or no house available to you. The API doesn't allow an add-on to discover what houses a player owns (which is probably a good thing) and so there is no way to grey out the icon or disable the button if no such house exists.


Where the house does exist and the jump is successful, the add-on can look around to see where it is, and update the name on the guild home screen for next time. Mostly that is quick enough for users not to notice it wasn't there before. But it is hard to reliably infer the absence of a jump target from a failed jump, because such failures have other, generally commoner, causes.


I do review API upgrades from time to time in the hope of getting better facilities, but the fundamental problem is that, from the game's point of view, there is no such thing as a guild hall, and the things we do to make it appear otherwise are, for the most part, smoke and mirrors.


Thank you for your interest. I would definitely implement this suggestion, if there seemed to be a way to do it.
Report comment to moderator  
Reply With Quote
Unread 05/20/19, 07:53 PM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 16
Uploads: 1
Button not showing guild change

If the add-on is showing the name of an old guild hall on the button, this is expected, temporarily. That is because the add-on has only one way of finding out the name of the new guild hall. You have to press the button and go there.

In the game, if you press G[uild] | Roster, and right-click the guild leader, you can choose Visit Primary Residence. If you do, you have no idea where you are going to be taken until you get there. You might think you know, from past experience, but it could change at that player's whim at any moment. The Guild Hall Button is just a wrapper around this functionality and so it has no idea either. What it can do is look around when it arrives, just as a player would, and remember the name of the house for next time.


The API doesn't allow an add-on to discover what houses a player owns (which is probably a good thing) and so the add-on has to make do with incomplete information. The Guild Hall Button tries to skate over these information gaps as gracefully as it can but the results aren't perfect. In the configuration screen you can choose to do an automatic Reload UI whenever you join or leave a guild. That speeds up the process of rediscovery a little (not a lot).
Report comment to moderator  
Reply With Quote
Unread 05/20/19, 12:06 PM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 16
Uploads: 1
Configuring guild changes

Originally Posted by Phuein
Love your addon. Getting a bug here. My guilds have changed in recent months, but the buttons are still displayed for the old guilds with their guild names.
Originally Posted by Phuein

Screenshot for reference: https://i.imgur.com/EK2zgGS.png

EDIT: Temporary fix: Deleted the savedvars file to make it refresh.


It is not uncommon for a single management team to run a group of related guilds with a shared guild hall. But, according to ESO rules, a player may be leader of only one guild, so the shared guild hall will not always belong to the leader of the guild you are in.


An add-on cannot discover this situation from the game API, because from the game’s point of view, there is no such thing as a guild hall. Even as a player, you can only find this out by reading your guild’s message of the day, website, or Facebook page. In such cases, you need to enter the information manually.


You enter it by going to the game menu Settings | Addons | Guild Hall Button. This will list your guilds, with three fairly self-explanatory option settings for each.

  • Override default guild hall. Set this to on if you need to configure the Guild Hall Button. This will enable the remaining 2 settings:
  • Castellan officer. This is the name of the guild officer who is the formal owner of the guild hall. The default value is (guild leader) because that is the usual situation. A drop-down list will offer you a list of the senior officers in the guild to choose from.
  • Name of guild hall. The default value for this is (principal residence) and you will rarely need to change it.

Did manual entry not work for you, or did you just have trouble finding it?
Report comment to moderator  
Reply With Quote
Unread 05/20/19, 11:57 AM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 16
Uploads: 1
Re: Suggestions

Originally Posted by Coolio_Wolfus
  1. Raise the info position it has a wide gap to the trader item above it.
  2. Add a way for it to be blank if unset, some small guilds don't have a guild hall yet.
  3. The default name (guild name + "guild hall") is a little long in some cases, maybe have option to leave text blank unless home set.
  4. Add a way for guild hall to be set for each guild via the guild leaders message, MotD or even the new guild info/recruitment page.
Thanks for your suggestions.


1. The position is an uneasy compromise and has been chosen to accommodate very long trader names. The wide space is sometimes awkward but it is better than a collision with the label above, which can extend over 3 lines.


2. It hadn't occurred to me that someone in a guild without a guild hall would want the add-on. I see your point. I will look at that in the next revision.


3. The default name is a placeholder, and disappears very soon and is replaced by a usable name. I experimented with Guild Hall 1 etc but feedback was negative.


4. This comes in the will not fix category. I know other similar add-ons do it, and I disagree with it. Doing as you suggest makes the correct operation of the add-on dependent on the MotD. In cases where the developer is also the guild leader this works, but in all other cases it leaves the add-on vulnerable to changes over which neither the developer nor the user has any control. An officer standing in for the guild leader and who posts the MotD, may not understand, or may even disagree with, the use of cryptic syntax in what is supposed to be a human-readable message, and delete it, or helpfully modify it in such a way that it no longer works. The guild leader may forget to change the indication when the guild hall changes. And so on. So there would in any case have to be a configuration checkbox for ignore MotD. That is why much effort has been put into making a nonstandard guild hall quick and easy for the user to configure. I have had feedback to the effect that some users couldn't be bothered to do that, but as it takes fewer mouse-clicks/keystrokes than navigating to the correct principal residence even once, I have trouble seeing the force of the argument.
Report comment to moderator  
Reply With Quote
Unread 05/18/19, 12:11 PM  
Coolio_Wolfus

Forum posts: 0
File comments: 25
Uploads: 0
Lightbulb Suggestions

  1. Raise the info position it has a wide gap to the trader item above it.
  2. Add a way for it to be blank if unset, some small guilds don't have a guild hall yet.
  3. The default name (guild name + "guild hall") is a little long in some cases, maybe have option to leave text blank unless home set.
  4. Add a way for guild hall to be set for each guild via the guild leaders message, MotD or even the new guild info/recruitment page.
Report comment to moderator  
Reply With Quote
Unread 05/12/19, 10:27 AM  
Phuein
 
Phuein's Avatar
AddOn Author - Click to view AddOns

Forum posts: 75
File comments: 116
Uploads: 7
Love your addon. Getting a bug here. My guilds have changed in recent months, but the buttons are still displayed for the old guilds with their guild names.

Screenshot for reference: https://i.imgur.com/EK2zgGS.png

EDIT: Temporary fix: Deleted the savedvars file to make it refresh.
__________________

Author of beloved and rejuvenated addons:

ShowMount            • PvP FPS 2018

Notebook 2018        • Junkee 2018

BestFriends 2018      • New Addon
Last edited by Phuein : 05/14/19 at 09:47 AM.
Report comment to moderator  
Reply With Quote
Unread 04/01/19, 02:28 PM  
tomtomhotep
 
tomtomhotep's Avatar
AddOn Author - Click to view AddOns

Forum posts: 21
File comments: 200
Uploads: 6
Thumbs up Re: Your request to extend /visit command

Originally Posted by BoarGules
Hi,
Version 1.8.1, uploaded today, extends the /visit command of the Guild Hall Button in line with your suggestion.

Thank you for your support and for taking the trouble to suggest improvements.
Regards
You're Welcome!

Thank You for the great addon!
Report comment to moderator  
Reply With Quote
Unread 04/01/19, 01:33 PM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 16
Uploads: 1
Your request to extend /visit command

Hi,


Version 1.8.1, uploaded today, extends the /visit command of the Guild Hall Button in line with your suggestion.


Thank you for your support and for taking the trouble to suggest improvements.


Regards
Last edited by BoarGules : 04/01/19 at 02:08 PM.
Report comment to moderator  
Reply With Quote
Unread 04/01/19, 05:06 AM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 16
Uploads: 1
Re: /visit

Hi,


I will certainly look at that. It seems a reasonable thing to want.


Regards


Originally Posted by tomtomhotep
Hi.

I love the /visit command. I was wondering if you could expand it a bit, to allow the user to travel to one of their own houses, by omitting the first parameter, @playername.

So if I own the "Sleek Creek" house, and I type /visit sleek, it would transport me to my own Sleek Creek house.
Report comment to moderator  
Reply With Quote
Unread 03/17/19, 08:46 AM  
tomtomhotep
 
tomtomhotep's Avatar
AddOn Author - Click to view AddOns

Forum posts: 21
File comments: 200
Uploads: 6
Question /visit

Hi.

I love the /visit command. I was wondering if you could expand it a bit, to allow the user to travel to one of their own houses, by omitting the first parameter, @playername.

So if I own the "Sleek Creek" house, and I type /visit sleek, it would transport me to my own Sleek Creek house.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: