Recommendations - Tillerino/Tillerinobot GitHub Wiki

!recommend|r [relax|beta|gamma] [nomod|dt|hr]

There are three generations of recommendation engines: alpha, beta and gamma.

• !recommend relax uses the alpha engine.

• !recommend beta uses the beta engine.

• !recommend gamma uses the gamma engine.

• all engines support a nomod flag to get recommendations without mods.

• !r can be used instead of !recommend. Gamma is the default engine. You do not need to invoke it explicitly.

The alpha engine was the very first recommendation engine written in 2014. It does not understand pp or mods - partly owed to the fact that the osu! API in 2014 was not what it is today 😄 Since the model is quite small, it is kept around for nostalgia.

The beta engine was a quick improvement which is still unaware of mods, but understands difficulty a bit. Like the alpha model, it is quite small and does not bother anybody.

Gamma improves the beta model. It handles mods and pp explicitly and even supports hints. Only smaller adjustments have been made to it over time, so the name has stuck. Instead, new generations of the gamma model are trained every now and then to account for new beatmaps and pp changes. You can see the current generations in the source code.

At this moment, the recommendations will include the hinted mods, but may include others, for example !recommend gamma hr will often be a HDHR recommendation.

• the dt flag hints the DoubleTime mod.
• the hr flag hints the HardRock mod.

Patreon-only feature

Recommendations can be filtered w.r.t. several criteria. Append these filters to your !recommend command. The following filters are available:

• Numeric filters. These can be applied with <, <=, =, >=, and >. Unless stated otherwise, these account for the mods of the recommendation.
  • AR filters approach rate
  • OD filters overall difficulty
  • CS filters circle size
  • STAR filters star difficulty. This does not currently consider the mods of the recommendation, but only filters the star difficulty of the nomod map.
  • BPM filters beats per minute
  • LEN filters beatmap length
• Specific mods can be excluded with -MOD: -HD, -HR, ...

Multiple filters can be combined, even filters of the same criterium. For example, consider the following command for the struggling 10k farmer:

!r DT LEN<=60 AR<=9.7 AR>=9.5 OD<=9.5 -HR -HD

• requests double-time maps,
• which are shorter than a minute (typically tv-size),
• where the approach rate was originally 8,
• makes sure that the overall difficulty does not accidentally explode,
• and excludes hard-rock and hidden, since it is for plebs.

• !r dt will be the bread and butter command for most players above rank 25k. You'll get a DoubleTime recommendation, which might include other mods.

• !r relax nomod gets an alpha-style recommendation without mods.

• Patreon-only feature !recommend dt AR<=10 BPM<=220 BPM>=180 requests a double time recommendation with an approach rate of at most 10 and beats per minute between 180 and 220.