Quantcast
Download
(412 Kb)
Download
Updated: 11/01/21 09:21 AM
Pictures
File Info
Compatibility:
Deadlands (7.2.5)
Waking Flame (7.1.5)
Blackwood (7.0.5)
Flames of Ambition (6.3.5)
Markarth (6.2.5)
Stonethorn (6.1.5)
Greymoor (6.0.5)
Updated:11/01/21 09:21 AM
Created:04/15/18 10:31 AM
Monthly downloads:2,369
Total downloads:104,879
Favorites:78
MD5:
Categories:Group, Guild & Friends, Homestead
7.2.5
Guild Hall Button  Popular! (More than 5000 hits)
Version: 2.3.7
by: BoarGules [More]
Guild Hall Button
by Boar Gules
[email protected]


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 11 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)
• 5 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 hardly ever 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, which also suggests why you might possibly want to do this.


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


Bypassing the Settings menu


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, where it can happen that other add-ons (including ones that the Guild Hall Button depends on) may not always be up to date.


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


Now suppose that the guild hall of Rangiest Rangers 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. The only use-case for this would be as a convenience when playing on the Public Test Server.


Visiting houses other than guild halls


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 specify a house but not a player the command will take you to your house of that name.


Version checking


The command /gh version will show a dialogue box giving
• The version of the add-on. The version numbers follow the principles of semantic versioning, fully described at semver.org.
• The version of the game API that is currently running. This version is determined by Zenimax and generally changes after a major update. If this number is higher than an add-on supports, then the game will mark that add-on as out of date.
• The versions of the API that the add-on supports. Add-ons can support two successive API versions. This can be helpful when the Public Test Server is running a later version of the API than the live game. This happens for some weeks before each major update.


Translation


Spanish


Warm thanks to Narian of the Cervanteso team.


French


Warm thanks to mouton.


Russian


Warm thanks to GJSmoker.


Other Languages


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 just over 100 translations.

2.3.7 Deadlands. New API version 101032.
2.3.5 Russian language support, with warm thanks to GJSmoker.
2.3.4 Waking Flame. New API version 100131.
2.3.3 Fix issue with invalid house indicator being treated as "house indicator missing" after issuing error message.
2.3.2 New "outside" option on /visit command, as in "/visit outside sleek". Only works for your own houses: this is an API restriction. New API version 100034.
2.3.1 New API version 100033.
2.3.0 French language support, with warm thanks to mouton. Further work on leaks of grammatical tags on place names into the UI.
2.2.2 Stopped grammatical tags on place names in French and German from leaking into the UI. Markarth.
2.2.1 Fixed bug in searching for houses with a hyphen in the name.
2.2.0 Spanish language support, with warm thanks to Narian of the Cervanteso team. Stonethorn. New API version 100032.
2.1.0 Positioned Guild Hall Button controls relative to the View Bids button. The static positioning previously used was causing collisions and no amount of tweaking could fix it. Eliminated a stray debug trace that accidentally got released.
2.0.0 Send the output of /guildhall list and /guildhall version to a dialogue box instead of the chat window. This was imposed by the fact that any other add-on may now require LibDebugLogger and that diverts all messages sent to the chat window to a log that the user may have made invisible, or disabled. Fixed validation failure in slash commands of the form /gh @user house. This was always invalid (guild number is required) but was not trapped for and led to an unhandled exception. New API version 100031. Major version number because the behaviour of two slash commands has changed.
1.10.1 Remove remaining call to LibStub. Update minimum supported versions of LibSlashCommander (36) and LibAddonMenu-2.0 (30). New API version 100030.
1.10.0 Further changes to embedding of library add-ons in line with new library version facilities. Will now use LibSlashCommander if available, but will not fail if it is not. Dependency is satisfied by version 6 of this library in API version 100029 but not in API version 100030 (coming soon with Harrowstorm).
1.9.1 Amend /guildhall and /visit commands to accept a house name substring that contains a space. Changes to embedding of library add-ons in line with new library version facilities introduced by ZOS with Summerset. Now requires LibAddonMenu-2.0 revision 30. Dependency is not satisfied by earlier versions. New API version 100029.
1.9.0 Not released
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 (6)
File Name
Version
Size
Uploader
Date
2.3.6
412kB
BoarGules
08/24/21 01:06 PM
2.3.4
407kB
BoarGules
08/23/21 12:35 PM
2.3.3
407kB
BoarGules
06/17/21 11:00 AM
2.3.2
406kB
BoarGules
03/13/21 06:04 AM
2.3.1
397kB
BoarGules
11/02/20 12:52 PM
2.3.0
397kB
BoarGules
10/31/20 09:15 AM


Post A Reply Comment Options
Unread 11/16/21, 02:37 AM  
krotten1

Forum posts: 0
File comments: 3
Uploads: 0
Invisible button

I used the settings options to assign the officer and their home to the button and it works fine for me. I have a problem though. None of the guild members visiting the guild home page can see the button.
Report comment to moderator  
Reply With Quote
Unread 08/24/21, 01:53 PM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 33
File comments: 25
Uploads: 1
I've been thinking about this for a while, which is why I haven't replied sooner. It's possible to do that. On the other hand, the keybindings available for additional hotkeys are mostly combinations (shift, alt), or hard to reach (like the operators on the numeric keypad), or hard to remember, or all three, and so not much of a saving of keystrokes over /gh<return>.


Some people have already told me that using the configuration screen to set the owner of the guild hall is too much trouble: if it's not automatic, they couldn't be bothered. So a configuration halfway down the Keybindings dialogue on the Controls menu might not get a lot of use. Especially as it would have to be done per character.


I think of hotkeys as being for when time is scarce and quick reactions make a difference. But you can't travel while in combat, and travel is slow. So I'm not convinced that saving 2 keystrokes for a tiny speedup is going to appeal to a wide circle of users.


If you have appropriate hardware, maybe you could look at setting a keyboard or mouse macro to do what you want.


Originally Posted by canadagreen
Hey, is there any possibility to bind hotkey?
I mean use key instead opening guild window and pressing button / typing command.
Report comment to moderator  
Reply With Quote
Unread 08/24/21, 01:07 PM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 33
File comments: 25
Uploads: 1
Re: Update 2.3.4 new API version 101031

Thank you for pointing out a very careless error. Fixed in 2.3.6.


Originally Posted by Bwadrochit
About the last update 2.3.4, I think there's a typo in the new API version in the add-on text file: it should be 101031 instead of 100131.
Thanks for your work
Report comment to moderator  
Reply With Quote
Unread 08/23/21, 06:22 PM  
Bwadrochit

Forum posts: 0
File comments: 9
Uploads: 0
Update 2.3.4 new API version 101031

About the last update 2.3.4, I think there's a typo in the new API version in the add-on text file: it should be 101031 instead of 100131.
Thanks for your work
Report comment to moderator  
Reply With Quote
Unread 06/28/21, 06:10 AM  
canadagreen

Forum posts: 1
File comments: 9
Uploads: 0
Hey, is there any possibility to bind hotkey?
I mean use key instead opening guild window and pressing button / typing command.
Report comment to moderator  
Reply With Quote
Unread 06/17/21, 10:56 AM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 33
File comments: 25
Uploads: 1
Assigning a castellan who is not a senior officer

Originally Posted by AstroCat
Would it be possible to assign a guild member for the button, not just an officer or leader? Our guild has a character which is the "guildhall" character.
Sorry for the late reply. I have a setting to be notified of posts here, but it doesn't seem to work always.


I may have misunderstood your question, but I believe you can do what you want with a slash command, for example:


/guildhall 1 @the-guildhall-player


It has to be a player name, not a character name, because that is the way the API works: characters don't own houses, players do. If this is an answer to the wrong question, or if it doesn't work, then let me know at [email protected].
Report comment to moderator  
Reply With Quote
Unread 04/09/21, 06:28 AM  
AstroCat
 
AstroCat's Avatar

Forum posts: 18
File comments: 117
Uploads: 0
Would it be possible to assign a guild member for the button, not just an officer or leader? Our guild has a character which is the "guildhall" character.
Report comment to moderator  
Reply With Quote
Unread 10/10/20, 04:37 PM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 33
File comments: 25
Uploads: 1
Re: Names wrongly displayed in German

The bug you reported, example below, is fixed in version 2.2.2, for both French and German.

Daggerfall Overlook - Should be in German "Dolchsturz-Ausblick" but in the addon lists it as: "Dolchsturz-Ausblick^m,in"
The stuff after the ^ is grammar tagging that indicates gender (m/f/n), if the name is considered a proper name or a description (d: in which case it gets a definite article in some situations) and the preposition to use in situations where English has at. So in this example, at Daggerfall Overlook would appear as im Dolchsturz-Ausblick.

These tags are important for the correct construction of messages in the game, but of course should not leak out into the user interface. Thank you for pointing this out.
Report comment to moderator  
Reply With Quote
Unread 09/21/20, 02:58 PM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 33
File comments: 25
Uploads: 1
Names wrongly displayed in German

Thank you for the bug report. It is of course difficult for me to test that sort of thing thoroughly.


In order for the names to match expectations, the add-on gets them from the game API. I'm pretty sure the ^m is a gender indication (Blick is masculine, isn't it?) that the code is not responding to properly.


There is a new version upcoming for Markarth, so I will try to include a fix in that.


Regards


Originally Posted by crysis992
It's just a minor thing but the names of the houses have some weird format when using the German client.

Examples:
Daggerfall Overlook - Should be in German "Dolchsturz-Ausblick" but in the addon lists it as: "Dolchsturz-Ausblick^m,in"

Here's a image with full list from the settings with all home names:
https://iili.io/23gtbS.png

All those homes have some strange formatting at the end of the name starting with "^"
Report comment to moderator  
Reply With Quote
Unread 09/09/20, 06:09 PM  
crysis992

Forum posts: 2
File comments: 53
Uploads: 0
It's just a minor thing but the names of the houses have some weird format when using the German client.

Examples:
Daggerfall Overlook - Should be in German "Dolchsturz-Ausblick" but in the addon lists it as: "Dolchsturz-Ausblick^m,in"

Here's a image with full list from the settings with all home names:
https://iili.io/23gtbS.png

All those homes have some strange formatting at the end of the name starting with "^"
Report comment to moderator  
Reply With Quote
Unread 05/11/20, 02:17 AM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 33
File comments: 25
Uploads: 1
Re: Re: When you have time to look - the debug text is still posting to chat for me?

Originally Posted by belboz
Originally Posted by Sp00sty
The output text to chat only started this AM login for me, wasn't there yesterday evening. I don't know if MINION didn't grab the update properly or not.

This is happening with every character load and not from using any slash commands and I have every extra setting inside turned OFF.
This was, as you suspected, a screen trace that escaped notice. It is fixed in version 2.1.0, uploaded just now.
Report comment to moderator  
Reply With Quote
Unread 05/11/20, 02:14 AM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 33
File comments: 25
Uploads: 1
Update: new version 2.1.0 to address collision of controls

I’ve uploaded version 2.1.0 with a fix for the problem you reported, of a collision with the View Bids button on the guild home screen.
Thank you for the XML, but you will notice I haven’t used it. Not because I have NIH syndrome, but because testing revealed that tweaking the static placement of the controls only moves the problem:

The static placement always was an uneasy compromise (with enough shortcomings to attract comment), which the View Bids button finally broke, because it. does not have a fixed position on the guild home screen.
So the only way out, is to position the Guild Hall Button relative to the ZOS controls on the screen.

That was no surprise: it was what I wanted to do originally, but did not know how. This made it necessary for me to find out.

Report comment to moderator  
Reply With Quote
Unread 05/05/20, 11:01 AM  
belboz

Forum posts: 0
File comments: 7
Uploads: 0
Re: When you have time to look - the debug text is still posting to chat for me?

Originally Posted by Sp00sty
The output text to chat only started this AM login for me, wasn't there yesterday evening. I don't know if MINION didn't grab the update properly or not.

This is happening with every character load and not from using any slash commands and I have every extra setting inside turned OFF.



Code:
Blackbriar Barter Co retaining @bbcguild: rank 3
After I found that it was Guild Hall Button I decided to go ahead and uninstall from MINION and let it re-install, no change. I then uninstalled again and did a manual install, still no change. I deleted saved variables each time. I disabled LibDebugLogger and still no change.

It is an annoyance but it doesn't seem to affect gameplay, but if there is a quick manual code comment-out I can perform until you have time to look at it would be appreciated.

It is going to fire at every character login and is several pages (chat windows) long and during crafting writs I may be changing characters several times in a row.

It is annoying if you relog a lot (I do) - a quickfix is changeing line 1067 in
GuildHallBotton.lua

from:
d(guild_name.." retaining "..member.name..": rank "..member.rank)
to:
-- d(guild_name.." retaining "..member.name..": rank "..member.rank)

as you pointed out is was some debug message that had not been disabled.
Report comment to moderator  
Reply With Quote
Unread 05/02/20, 02:13 PM  
Sp00sty

Forum posts: 64
File comments: 165
Uploads: 0
When you have time to look - the debug text is still posting to chat for me?

The output text to chat only started this AM login for me, wasn't there yesterday evening. I don't know if MINION didn't grab the update properly or not.

This is happening with every character load and not from using any slash commands and I have every extra setting inside turned OFF.

Send the output of /guildhall list and /guildhall version to a dialogue box instead of the chat window.
Code:
Blackbriar Barter Co retaining @bbcguild: rank 3
After I found that it was Guild Hall Button I decided to go ahead and uninstall from MINION and let it re-install, no change. I then uninstalled again and did a manual install, still no change. I deleted saved variables each time. I disabled LibDebugLogger and still no change.

It is an annoyance but it doesn't seem to affect gameplay, but if there is a quick manual code comment-out I can perform until you have time to look at it would be appreciated.

It is going to fire at every character login and is several pages (chat windows) long and during crafting writs I may be changing characters several times in a row.
Last edited by Sp00sty : 05/02/20 at 02:16 PM.
Report comment to moderator  
Reply With Quote
Unread 05/01/20, 03:51 PM  
BoarGules
 
BoarGules's Avatar
AddOn Author - Click to view AddOns

Forum posts: 33
File comments: 25
Uploads: 1
Originally Posted by Kenza
I have a suggestion/request~ Could we get this?

And another request, could it default to the name of the house instead of 'Guild Name Guild Hall'? Or is it not(easily) possible to detect that information?

Thank you for this wonderful little addon!

Sorry about the very late reply. I've just moved to France and migration tends to upend priorities. Lockdown too.


I only noticed the other day that the Bids button interfered with the layout, when I was looking over my wife's shoulder. Only guild leaders see that button, so it never came up in my testing because I'm not one. It bothered me the moment I saw it, and it clearly needs attention. It's not in the latest upgrade because (I'm told) it's not always present and so is hard for me to test.


The name of the guild hall does appear as you suggest, but only after you have gone there once. That is because the API offers no way to query for the name of the guild hall. Recall that, as far as ESO is concerned, there is no such thing as a guild hall, only players' houses, and there is no way to get a list of a player's houses (for reasons that I can understand, inconvenient though it is). So the only way to find out the name of the guild hall is to wait until the user goes there (using the button, of course) and update it then. Code along the lines of "Oh, user pressed the button and here I am. Where am I, exactly?" Mostly people don't notice, or do, but forget, because the defect is transient. Full marks for the proofreader's eye. Alas, that bit of the code is mostly smoke and mirrors, and I haven't discovered a way to do better.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: