developer-relations icon indicating copy to clipboard operation
developer-relations copied to clipboard

[BUG][DOCS] undocumented `match-v5.ParticipantDto` fields

Open MingweiSamuel opened this issue 2 years ago • 22 comments

scroll to bottom for latest

old content

Ping fields all integers (I assume):

  • allInPings
  • assistMePings
  • baitPings
  • basicPings
  • commandPings
  • dangerPings
  • enemyMissingPings
  • enemyVisionPings
  • holdPings
  • needVisionPings
  • onMyWayPings
  • pushPings
  • visionClearedPings

And other field:

  • eligibleForProgression: boolean

More integer fields (new 2023-04-19)

  • totalAllyJungleMinionsKilled
  • totalEnemyJungleMinionsKilled

More integer fields (2023-06-13)

  • subteamPlacement
  • playerAugment1
  • playerAugment2
  • playerAugment3
  • playerAugment4
  • playerSubteamId

~~A new nested object field: (2023-11-09) (comment)~~

FIXED 2024-05-10

"missions": {
    "playerScore0": 0,
    "playerScore1": 0,
    "playerScore10": 0,
    "playerScore11": 0,
    "playerScore2": 0,
    "playerScore3": 0,
    "playerScore4": 0,
    "playerScore5": 0,
    "playerScore6": 0,
    "playerScore7": 0,
    "playerScore8": 0,
    "playerScore9": 0
},

However the fields are also included directly in the participants dto too (???)

  • playerScore0
  • playerScore1
  • playerScore10
  • playerScore11
  • playerScore2
  • playerScore3
  • playerScore4
  • playerScore5
  • playerScore6
  • playerScore7
  • playerScore8
  • playerScore9

New riot game name field (renamed from riotIdName?) (2023-11-22)

  • riotIdGameName: String

2024-06-11

JP1_450685262

  • playerAugment5
  • playerAugment6

MingweiSamuel avatar Mar 21 '23 04:03 MingweiSamuel

Alright thats all of em for across JP1_390614378 JP1_390621320 JP1_390576646 JP1_390626149 JP1_390607492 JP1_390638767 JP1_390609829 JP1_390643123

MingweiSamuel avatar Mar 21 '23 05:03 MingweiSamuel

The ping fields got introduced with the start of preseason so that should be 12.22 or 12.23 iirc

As for the progression field I am not entirely sure when that one got added

geozukunft avatar Mar 21 '23 11:03 geozukunft

More integer fields (new 2023/04/19)

  • totalAllyJungleMinionsKilled
  • totalEnemyJungleMinionsKilled

MingweiSamuel avatar Apr 23 '23 17:04 MingweiSamuel

New (integer) fields:

  • subteamPlacement
  • playerAugment1
  • playerAugment2
  • playerAugment3
  • playerAugment4
  • playerSubteamId

Hand picked, maybe I missed some

DarkIntaqt avatar Jun 28 '23 08:06 DarkIntaqt

Oh yeah, forgot to add those here

https://github.com/MingweiSamuel/riotapi-schema/commit/fe02503a1367c755f92091864626b0627c4b0c3d

MingweiSamuel avatar Jun 28 '23 08:06 MingweiSamuel

Got some new stuff found in a quick play game EUW1_6669686325

"missions": {
                    "playerScore0": 0,
                    "playerScore1": 0,
                    "playerScore10": 0,
                    "playerScore11": 0,
                    "playerScore2": 0,
                    "playerScore3": 0,
                    "playerScore4": 0,
                    "playerScore5": 0,
                    "playerScore6": 0,
                    "playerScore7": 0,
                    "playerScore8": 0,
                    "playerScore9": 0
                },

geozukunft avatar Nov 09 '23 21:11 geozukunft

Any idea what the meaning of the array is? Why 12 entries?

MingweiSamuel avatar Nov 15 '23 19:11 MingweiSamuel

no clue and for some reason those 12 values are also present as part of the participantDTO without being in the missions subcatgeory

geozukunft avatar Nov 15 '23 19:11 geozukunft

match-v5.ParticipantDto.riotIdGameName: String

MingweiSamuel avatar Nov 22 '23 17:11 MingweiSamuel

Any idea what the meaning of the array is? Why 12 entries?

Only thing that springs to mind is the max known amount of players in a game (hexakill, 6v6)

Querijn avatar Nov 22 '23 19:11 Querijn

Missions DTO now exists

MingweiSamuel avatar May 12 '24 15:05 MingweiSamuel

These fields are now documented:

'riotIdName'
'riotIdGameName'
'allInPings'
'assistMePings'
'commandPings'
'dangerPings'
'enemyMissingPings'
'enemyVisionPings'
'getBackPings'
'needVisionPings'
'onMyWayPings'
'pushPings'
'visionClearedPings'
'eligibleForProgression'
'challenges'
'totalAllyJungleMinionsKilled'
'totalEnemyJungleMinionsKilled'
'playerAugment1'
'playerAugment2'
'playerAugment3'
'playerAugment4'
'playerSubteamId'
'subteamPlacement'
'placement'

MingweiSamuel avatar May 12 '24 15:05 MingweiSamuel

The following are still missing: "baitPings","basicPings","holdPings","playerScore0","playerScore1","playerScore10","playerScore11","playerScore2","playerScore3","playerScore4","playerScore5","playerScore6","playerScore7","playerScore8","playerScore9"

MingweiSamuel avatar May 12 '24 16:05 MingweiSamuel

I want to give some updates here Date: May 24th 2024

-- UNKNOWN -- : My query match doesn't list these entries, but for "holdPings" and "playerScore*" are document available baitPings basicPings

For "riotIdName", this field is not listed in my ARAM gameplay yesterday .

IchiruTake avatar May 24 '24 08:05 IchiruTake

2024-06-11

JP1_450685262

  • playerAugment5
  • playerAugment6

MingweiSamuel avatar Jun 12 '24 06:06 MingweiSamuel

Hi @MingweiSamuel could you verify the ParticipantDto, all fields were updated.

f3ar161 avatar Jun 17 '24 16:06 f3ar161

The dangerPings field was removed from the docs even though it is still being returned (always zero: https://github.com/RiotGames/developer-relations/issues/870 )

MingweiSamuel avatar Jul 03 '24 16:07 MingweiSamuel

Sorry for the delay @f3ar161

Hi @MingweiSamuel could you verify the ParticipantDto, all fields were updated.

The following fields are still missing from the docs for match-v5.ParticipantDto

  • baitPings (no longer returned for new matches, but still exists in old, i.e. https://europe.api.riotgames.com/lol/match/v5/matches/EUW1_6569580003 )
  • dangerPings #870
  • basicPings #814
  • playerAugment5
  • playerAugment6

And that is all, currently!

MingweiSamuel avatar Jul 03 '24 16:07 MingweiSamuel

JP1_477847236

retreatPings

MingweiSamuel avatar Nov 04 '24 05:11 MingweiSamuel

PlayerScore0 etc seem to be in PascalCase now? #908

MingweiSamuel avatar Jan 31 '25 07:01 MingweiSamuel

championSkinId

MingweiSamuel avatar Jun 24 '25 21:06 MingweiSamuel

damageDealtToEpicMonsters

MingweiSamuel avatar Nov 19 '25 17:11 MingweiSamuel