EP Lobbies JSON documentation
EP Lobbies JSON documentation
This documentation is intended for developers who wish to consume EP Lobbies data, now available from http://eso-community.net/assets/patch/api/lobbies.json
Here is an example JSON output:
What you get is an array of objects, each of those objects representing one lobby/game room.
Properties of this object are:
bool allow_cheats - Indicates that the Allow Cheats option has been selected.
bool deleted - Internal. Indicates that our server marked this room as to likely be no longer available. These rooms should not be displayed as active rooms on a UI.
int game_mode - Indicates selected game mode. 0 = Supremacy, 1 = Deathmatch.
int game_speed - Indicates selected game speed. 0 = Slow, 1 = Medium, 2 = Fast.
string id - ESO room ID.
bool koth - Indicates King of the Hill game mode.
timestamp last_pong - Internal. Time of the last received keepalive request from host.
timestamp last_change - Internal. Time of the last received room update request from host.
string map - DisplayName of the currently selected map. This name is mostly readable to the end-user, but is not the actual translated name as seen on ESO.
int max_hc - Maximum allowed HC level for this room.
int max_players - Maximum allowed number of players for this room.
int min_hc - Minimum allowed HC level for this room.
bool monopoly - Indicates whether the room has Trade Monopoly victory condition enabled.
string name - Custom player-defined name of this game room. Always returns "QuickSearch Match" if quicksearch is true.
bool no_blockade - Indicates whether the room has activated No Blockade rule.
bool password - Indicates whether the room is password-protected.
int patch - Internal. Indicates currently active game patch. 1 = ESOC Supremacy Standard Patch, 2 = ESOC Treaty Patch, 3 = EP XPMOD, 4 = EP Smackdown.
string[8] players - Array of player names participating in this game room. The array is sorted according to the actual order of players in this game room, remaining empty/closed spots are filled with null values. If quicksearch is true, the array will only contain "Power Rating X" as the host player name, where X is that player's PR, rounded up to an integer.
bool quicksearch - Indicates that this room is a Quick Match room and wasn't hosted through the game browser. If true, the room name and host player name will be returned anonymized.
bool restorable - Internal. Indicates that this room was marked as deleted due to an abrupt stop in communication, and may still be restored.
bool scenario - Indicates the room is a Scenario type room.
int starting_age - Indicates the selected starting age for this room. 0 = Discovery, 1 = Colonial, 2 = Fortress, 3 = Industrial, 4 = Post-Industrial, 5 = Imperial, 6 = Post-Imperial.
int treaty_time - Treaty time, in minutes.
Here is an example JSON output:
What you get is an array of objects, each of those objects representing one lobby/game room.
Properties of this object are:
bool allow_cheats - Indicates that the Allow Cheats option has been selected.
bool deleted - Internal. Indicates that our server marked this room as to likely be no longer available. These rooms should not be displayed as active rooms on a UI.
int game_mode - Indicates selected game mode. 0 = Supremacy, 1 = Deathmatch.
int game_speed - Indicates selected game speed. 0 = Slow, 1 = Medium, 2 = Fast.
string id - ESO room ID.
bool koth - Indicates King of the Hill game mode.
timestamp last_pong - Internal. Time of the last received keepalive request from host.
timestamp last_change - Internal. Time of the last received room update request from host.
string map - DisplayName of the currently selected map. This name is mostly readable to the end-user, but is not the actual translated name as seen on ESO.
int max_hc - Maximum allowed HC level for this room.
int max_players - Maximum allowed number of players for this room.
int min_hc - Minimum allowed HC level for this room.
bool monopoly - Indicates whether the room has Trade Monopoly victory condition enabled.
string name - Custom player-defined name of this game room. Always returns "QuickSearch Match" if quicksearch is true.
bool no_blockade - Indicates whether the room has activated No Blockade rule.
bool password - Indicates whether the room is password-protected.
int patch - Internal. Indicates currently active game patch. 1 = ESOC Supremacy Standard Patch, 2 = ESOC Treaty Patch, 3 = EP XPMOD, 4 = EP Smackdown.
string[8] players - Array of player names participating in this game room. The array is sorted according to the actual order of players in this game room, remaining empty/closed spots are filled with null values. If quicksearch is true, the array will only contain "Power Rating X" as the host player name, where X is that player's PR, rounded up to an integer.
bool quicksearch - Indicates that this room is a Quick Match room and wasn't hosted through the game browser. If true, the room name and host player name will be returned anonymized.
bool restorable - Internal. Indicates that this room was marked as deleted due to an abrupt stop in communication, and may still be restored.
bool scenario - Indicates the room is a Scenario type room.
int starting_age - Indicates the selected starting age for this room. 0 = Discovery, 1 = Colonial, 2 = Fortress, 3 = Industrial, 4 = Post-Industrial, 5 = Imperial, 6 = Post-Imperial.
int treaty_time - Treaty time, in minutes.
- musketeer925
- Retired Contributor
- Posts: 2483
- Joined: Mar 28, 2015
- ESO: musketeer925
Re: EP Lobbies JSON documentation
It would probably be better to change password to a bool, and let GUIs represent as they please (e.g., "Yes").
Re: EP Lobbies JSON documentation
musketeer925 wrote:It would probably be better to change password to a bool, and let GUIs represent as they please (e.g., "Yes").
Yes, done.
The password attribute is now a bool and the patch attribute is functional. Doc updated.
Re: EP Lobbies JSON documentation
This is cool and it seems to be working right now
-
- Ninja
- Posts: 14364
- Joined: Mar 26, 2015
Re: EP Lobbies JSON documentation
I can't wait to fix my computer
- aligator92
- Howdah
- Posts: 1518
- Joined: Feb 27, 2015
- ESO: aligator92
Re: EP Lobbies JSON documentation
So thats why you kept hosting your afk lobby these last couple of days
Re: EP Lobbies JSON documentation
aligator92 wrote:So thats why you kept hosting your afk lobby these last couple of days
Exactly, haha. Sorry to everyone for being unresponsive.
Re: EP Lobbies JSON documentation
timestamp last_change - Internal. Time of the last received room update request from host.
This is in seconds, not ms.
Re: EP Lobbies JSON documentation
Ashvin wrote:timestamp last_change - Internal. Time of the last received room update request from host.
This is in seconds, not ms.
It's in timestamp, like last_pong
Re: EP Lobbies JSON documentation
Sometimes I get null map
and sometimes empty room
Empty room is maybe because of "restorable": true and "id": null (but why does it say "deleted": false?), but why is map null sometimes?
Code: Select all
{
"allow_cheats": false,
"deleted": false,
"game_mode": 0,
"game_speed": 1,
"id": "d9a0e3495d4d46ef8965610f4f1e2b94",
"koth": false,
"last_change": 1575219071.7764876,
"last_pong": 1575219071.7764876,
"map": null,
"max_hc": -1,
"max_players": 2,
"min_hc": -1,
"monopoly": true,
"name": "EAGLEMUT's Game",
"no_blockade": false,
"password": false,
"patch": 1,
"players": [
"EAGLEMUT",
"Henry the Navigator",
null,
null,
null,
null,
null,
null
],
"quicksearch": false,
"restorable": false,
"scenario": false,
"starting_age": 0,
"treaty_time": 0
}
Code: Select all
{
"allow_cheats": false,
"deleted": false,
"game_mode": 0,
"game_speed": 1,
"id": null,
"koth": false,
"last_change": 1575211510.4361851,
"last_pong": 1575211510.4361851,
"map": "randommaps",
"max_hc": -1,
"max_players": 4,
"min_hc": -1,
"monopoly": true,
"name": "ep 1v1 unr",
"no_blockade": false,
"password": false,
"patch": 1,
"players": [
null,
null,
null,
null,
null,
null,
null,
null
],
"quicksearch": false,
"restorable": true,
"scenario": false,
"starting_age": 0,
"treaty_time": 0
}
Re: EP Lobbies JSON documentation
Simply means there is currently no map selected.UrvyZnapy wrote:why is map null sometimes?
That's a weird room state, looks like a bug I'd say.UrvyZnapy wrote:Empty room is maybe because of "restorable": true and "id": null (but why does it say "deleted": false?)
Since I'm here, I might as well make a note about some peculiarities of "restored" game rooms, in the sense of rooms hosted from a savegame file. Note that those rooms will return the savegame file name as "map" value, and they always act as if they are filled with the original players, even when those players are not actually in the room yet.
- Mr_Bramboy
- Retired Contributor
- Posts: 8219
- Joined: Feb 26, 2015
- ESO: [VOC] Bram
- Location: Amsterdam
Re: EP Lobbies JSON documentation
Perhaps this has to do with people switching from WoL to EP. If you switch from EP to RE while having a EP map selected the RE map becomes bugged until you change it. The same could possibly happen if you switch from WoL to EP while having a WoL map selected.
Re: EP Lobbies JSON documentation
It's a valid state to have no map selected, it's not any kind of bug. When you check the custom maps checkbox you initially have no map ("Unselected") and have to choose something.Mr_Bramboy wrote:Perhaps this has to do with people switching from WoL to EP. If you switch from EP to RE while having a EP map selected the RE map becomes bugged until you change it. The same could possibly happen if you switch from WoL to EP while having a WoL map selected.
Who is online
Users browsing this forum: No registered users and 1 guest