Flags

**Flags** are used to sort and/or filter lists in Mudae. They are generally letters combined with various symbols that can be appended to lists like , , , , , $sl, ,  (in gamemode 2 only),  (in Mudae World only), and most other lists. Flags can be combined with each other to further filter lists.

It's important to understand that *flags are simply modifiers* of the above commands:  is not its own command, but rather just a modification of .

## List of Flags

1. ↑ Tags can filter, order, or display. All flags that order also display information. However, not all flags that filter display information.
2. ↑ 2.0 2.1 2.2 2.3 Note that tags are a beta feature.

The only letters which currently do not have flags are **j** and **z**.

## Usage

Flags are always added directly to the end of the list command, with no space.

Additional notations when creating a list include:

* $: A dollar sign ($) is also used to separate multiple arguments.
	+ Using  <series 1> $ <series 2> will show characters from both series together.
	+ Using  <bundle 1> $ <bundle 2> will show characters that appear in both bundles (not just one).
	+ This is the case even when Mudae's $prefix is not $.
* : Two dashes (--) is used to exclude certain arguments.
	+ Using  <series> will show the top characters while excluding the specified series or bundle.
	+ Using  <bundle 1> $ <bundle 2> will show the characters that are in bundle 1 while excluding characters in bundle 2.
* : The equals sign (=) is used to provide a second argument when multiple arguments are possible. It is most commonly used with the  and  flags when a series is also specified, since the series is the first argument.
	+ Using  <series>  <text to search> will show the characters in the series with the specified text in their name.
	+ Using  <series>  <note> will show your characters with the specified note in the series.
	+ Separators can be used with either or both arguments:  <series 1> $ <series 2>  <text 1> $ <text 2>
	+ Do not mix this up with the equals sign contained within flags like  or  — the usage is completely different.
* : The ampersand (&) is added to the end of  only when searching for two different bundles to show all characters in either bundle rather than overlapping characters. (See the second example under $ to show only overlapping.)
	+ Using  <bundle 1> $ <bundle 2> will show characters in either bundle.

### Examples

* : Characters in your harem which have keys and do not have an embed color.
* : Top characters which have not yet been claimed, that can be rolled using .
* : Characters on your wishlist, displaying which roulette to roll them.
* : Characters in your harem, sorted by kakera value and displaying how many keys they have (including characters without keys).
* <note>: Only female characters in your harem noted with the specified note, in order of ranks, and showing images.
* update: Characters you own from the most recent update, grouped by series.
* marvel  spider: Male characters from the series Marvel whose name contains "spider".
* Joker $ Mario $ Dainsleif: Shows the main images of the characters with the exact main name Joker, Mario, or Dainsleif, in order of rank (because  was used).
* hololive  horns: Characters from hololive that are tagged with "horns", showing their main names.

### Flag compatibility

Nearly all flags are compatible, even most flags of the same "type". They also work in any order.

* The  flag is actually a combination of the  flag and the  flag, and can also be expressed as .
* The flags for keys and soulkeys,  and , can be combined to show both your keys and your soulkeys.
* Even though  already has an "a" in the command, the  flag can still be used. For example, you can use  Disney to show every character in the Disney bundle grouped by its series.

Some flags, when combined, are exclusive of each other. These include pairs like  and , which will display no results. Other pairs, like  and , will have one tag override the other (the  tag is used and  is ignored). Finally,  and  show a different set of results altogether when combined, averaging the claim and like ranks together.

Additionally, some tags which change the appearance of the list may not work with others:

* The  flag, which shows the list as a series of cards instead, will cause flags like  to be useless: the data showing which roulette a character is in is already on a card.
* The  flag does not show characters, but rather summarizes them by series. This will prevent any flags that display character information from showing up on the list. The  flag can be used instead to group by series and show characters.

### Additional notes

Some flags have syntax that is not intuitive.

* and  automatically sort characters, but  does not, and the  flag should be used instead to sort by kakera.
* Usually, to show a list without something, a minus sign is used (eg. , , and ). However, the  flag is used (*not* n-) to show characters without notes.
* Usually, to show a list with and without something, and also showing information about that thing, a plus sign is used (eg.  for keys,  for colors,  for disables). However, when it comes to owned characters, the  flag works for this purpose, and  serves a different purpose.

There is no flag for wished, liked, or soulmated characters.

The flag  can also be used with the command  to show the base value without keys of one character:  <character name>.

## Removed flags

These flags have been removed and no longer work. They are replaced with other flags as detailed above.

* yd (which previously showed keys, soulkeys, *and* embedcolors)
* abc (old alphabetical order "flag")
* c (which previously showed claimed characters - it was replaced by  flag variants, and  is now used for colors)

## Other flags

There are some other flags which are only for use with certain lists. These flags may not serve the same function on lists of characters like , , etc. Like normal flags, they can typically also be combined.

### Pins

*Main article: List of Mudapins*
* : duplicate pins
* : pins shown in an embed
* : sent in DM
* : full (all pins in order, including ones you don't have yet)
* : missing pins only
* <user ID>: other user's pins that you don't own
* <mudapin(s) ID>: show just the named pin(s)

### Pokeslot

*Main article: Pokéslot*
The following are not exactly flags but still ways to sort/filter your Pokémon. They may also be used to sort your Pokémon using $sp.

* $pd : Sort Pokémon by rarity
* $pd :
* $pd : Sort Pokémon by National Pokédex order
* $pd : Sort Pokémon alphabetically
* $pd : Show all Pokémon, including ones you don't have
* $pd : Show only shiny Pokémon
* $pd : Show only legendary Pokémon
* $pd : Show only UB Pokémon ( also works)
* $pd : Show only generation 1 Pokémon (works for all generations)
* $pd : Show only duplicate Pokémon
* $pd : Show Pokémon as emoji so that they show up larger ( also works)

### Soulmate list

*Main article: Soulmates*
* $sl: Don't show duplicate soulmates.

### Alltags list

*Main article: Character Tags*
* : Show all subcategories in $alltags.

## Lists that flags don't work on

* search results (except  flags).  flag shows details, but instead of images and aliases, it shows owner, roulette, claim ranks, and like ranks.
	+ , $imk-, $imo, and $imf are valid commands, and have similar effects to the , , , and  flags respectively.
	+ $ime+ shows the tags only, without the image or embed.
	+ $imo shows user ID, since cards already show the owner.
* $fnall (except , , )
* (except , / - the latter two behave the same)
* in Gamemode 1
* $noteimglist
* $addimglist
* $a2list
* Other lists which are unrelated to characters, such as , $pokelikelist, and lists of users (they may have their own flags, see above)