Willump and another ally will both get the attack speed boost, so be sure to wail on the tower a bit before rolling off to your next adventure. Ganking with the Biggest Snowball Ever! Is a cool move, but once you get the hang of handling, it’s also the fastest way through the jungle. This is, hands down, the best take on Nunu & Willump EVER! I am in love with both.

WillumpLatest versionMeanWillump


Willump is a Python3 helper for the League of Legends LCU API

Project description

Nunu: The server that translates Yeti to English

Read the Nunu readme and get started with your League of Legends webapp today!

Willump Font

Willump is a Python3 helper for the League of Legends LCU API. Willump is asynchronous and can communicate on both HTTPS and WSS channels.

Willump would not exist without lcu-driver, another driver for the League of Legends LCU API. Huge thanks to Andre Sousa for creating the starting point for Willump.

Documentation for the LCU can be found on the Hextech Docs, and a schema of the LCU can be found here.

If you have questions about Willump or the Riot API, find me or ask a question at the Riot Games Third Party Developer Community Discord.

Installing Willump

Willump can be installed through pip

Or pip3 if using python3 pip

Starting Willump

There are two ways to start Willump


this is generally fine since Willump contains no class methods

This starts Willump's http and websocket clients. Note: start() blocks until Willump can connect to the League Client Ux process and server

Using HTTP methods

Willump can can make http requests to any LCU endpoint

Subscribing to websocket events

Willump's websocket can subscribe to LCU events. Willump can attach a user defined default_handler to an event subscription which will be fired any time Willump receives a websocket message pertaining to the event and the message is not otherwise handled. default_handler is a function which accepts json formatted data as its sole argument and returns None, or a disposable value.

You can add subscriptions to an event by resubscribing to the same event

If you want to attach an already made subscription to another event, you can pass it to the subscription handler:

You can get the attached subscriptions to an event:

Willump can also unsubscribe from events to stop listening for them entirely, or can remove a subscription from an event:

Attaching endpoint filters to event subscriptions

Willump's subscriptions contain two further kinds of filters on websocket events -- uri filters and path filters. These are collectively known as endpoint filters. An endpoint filter is a function that runs when a certain endpoint is specified by the event response. A subscription can have multiple endpoint handlers attached to it. Path filters end in '/', and run when the specified endpoint is any sub-endpoint of the path. Uri filters run when the endpoint is the same as the filter's uri. You can attach endpoint filters through the subscription itself, or via Willump with the subscription instance. Endpoint handlers take the same signature as default_handler. They must take in json formatted data and return None, or a disposable value. Uri handlers and path handlers will both fire if they overlap. If an endpoint filter is fired, the subscription's default_handler will not fire. Attaching two endpoint handlers to the same endpoint will overwrite the pre-existing endpoint handler.

Closing Willump

Closing Willump attempts to close the http and ws connections, gather outstanding subscription tasks, and gracefully exit.

Willump isn't endorsed by Riot Games and doesn't reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games, and all associated properties are trademarks or registered trademarks of Riot Games, Inc.

Release historyRelease notifications RSS feed


1.2.3 yanked

1.2.1 yanked

1.2.0 yanked


Burp failed to start proxy service for windows 10. 1.1.5


1.1.2 yanked

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for willump, version 1.2.6
Filename, sizeFile typePython versionUpload dateHashes
Filename, size willump-1.2.6-py3-none-any.whl (9.7 kB) File type Wheel Python version py3 Upload dateHashes
Filename, size willump-1.2.6.tar.gz (11.9 kB) File type Source Python version None Upload dateHashes

Wilum Pugmire


Hashes for willump-1.2.6-py3-none-any.whl

Hashes for willump-1.2.6-py3-none-any.whl
AlgorithmHash digest

Hashes for willump-1.2.6.tar.gz

Hashes for willump-1.2.6.tar.gz
AlgorithmHash digest
Damage: 61 (+3/level)
Attack Range: 125
Movement Speed: 340
Armor: 29 (+3/level)
Magic Resistance: 32 (+1.3/level)

Health Points: 540 (+82/level)
Mana Points: 280 (+42/level)
Attack Speed: 0.625 (+2.3%/level)

Counter Information

  • While Nunu's ultimate is channeling, it can (and often, should) be interrupted.
  • As Nunu's Ice Blast is his main attack, spell shields can significantly reduce his damage output.
  • If you find yourself slowed without warning, Nunu may be channeling his ultimate from cover!
  • Push Nunu away from minions and monsters where possible to stop him healing with his Consume ability.
  • Items that grant temporary invulnerability may provide an easy way to deal with Nunu's ultimate.
  • As Nunu is dependent on AP, building magic resistance may prove effective.
  • Call of the Freljord Video


    Nunu increases the attack speed and movement speed of Willump and a nearby ally, and causes Willump's basic attacks to damage enemies around the target.

    Consume Video


    Willump takes a bite out of a minion, monster, or enemy champion, dealing damage and healing himself.

    Biggest Snowball Ever! Video


    Willump creates a snowball that grows in size and speed as he rolls it. The snowball damages and knocks up enemies.

    Snowball Barrage Video


    Nunu throws multiple snowballs that damage enemies. When he's finished, Willump roots any champions or large monsters that were hit by a snowball.

    Absolute Zero Video


    Nunu & Willump create a powerful blizzard in an area that slows enemies and deals massive damage at the end.