lichess.org
Donate

Improve your challenge link

LichessSoftware Development
When we're accepting challenges to play, sometimes we just want to be given some rules.

People who are Streamers or have a BOT (for example), like to provide a link to receive challenges without having to force the person to enter the profile or write the username, but usually can't force the desired control time.

What happens

Streamers usually put this link in the livestream bot to be challenged (for example):

https://lichess.org/?user=SergioGlorias#friend

This means that the challenger doesn't have to type in the streamer's username (which, for example, will be @SergioGlorias).

And BOTs who only play specific positions:

https://lichess.org/?user=LeelaQueenOdds&fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNB1KBNR_w_KQkq#friend

Meaning that the challenge is for the @LeelaQueenOdds bot to play for a specific position (which in this case, White would have one less Queen than Black). Using the `fen` parameter in the URL.

This means that the challenger still has to put in the control time or the appropriate game variant (Example Streamer: “I will only accept 3+2 games that are of the anti-chess variant”). Since it is in the last configured configuration (or will be in unlimited if the person has never configured it).

But now everything has changed

With the recent Lichess updates, it's now possible to set what you want in the challenge.

Returning to the Streamer URL, we can write:

https://lichess.org/?user=SergioGlorias&variant=crazyhouse&time=realTime&minutesPerSide=3&increment=2#friend

The challenge continues for @SergioGlorias, but now we're saying that the challenge is in the crazyhouse variant and will be 3 minutes for each side, plus 2 seconds increment per move in real time.

OK! But how do I make my own link?

Creating your own is easy:

  1. Write first: https://lichess.org/
  2. Now add ? to write the parameters, which are (note: use & to separate parameters):
    • user Meaning you want to challenge a specific player
      • example: user=SergioGlorias
    • variant game variant you want to play
      • options: standard (regular chess), chess960, crazyhouse, antichess, atomic, horde, kingOfTheHill, racingKings, threeCheck and fromPosition (Not necessary, as you can use fen to choose a specific position.)
      • example: variant=standard
    • fen you're saying that you want the game to be in a specific position
      • example: fen=rnb2bnr/pppp1ppp/4k3/4p3/4P3/4K3/PPPP1PPP/RNB2BNR_w_HAha_-_0_1 (space are _)
    • time Tell us which time mode to use
      • options: realTime and correspondence
      • example: time=realTime
    • minutesPerSide How many minutes will each side have
      • example: minutesPerSide=10 (10 minutes)
    • increment How many seconds of increment
      • example: increment=5 (5 seconds)
  3. Now add #friend at the end to say it's a direct challenge to a person

And now you have a personalized link to give people to challenge you.

Conclusion

Sometimes the personalized link may not make sense, but at the same time it is important to others. Streamers in particular often have to turn down the challenge and ask for a new due that wasn't within the established rules.

Let me know what you think in the comments. If you have any questions, I'll try to explain them better and help you.