Gacha Setup¶

Configuration¶

All configuration commands for the gacha can be found under the /gacha-config command. To take a look at your current gacha configuration, you can use /gacha-config info:

Some basic options include:

• /gacha-config names allows you to change how the gacha system publicly displays the names of things like the currency and gacha rarities.
• /gacha-config cost sets the cost of each roll. By default, it costs 1 currency to roll, and users will need at least that amount to do so - you can adjust it how you like, though.
• /gacha-config draw-duplicates allows you to toggle whether or not users can draw items they already own from the gacha. By default, they can.
• Finally /gacha-config toggle turns on or off the gacha system. Players cannot use any of the gacha commands (as discussed on the gacha usage page) if the gacha system is turned off. It's suggested that you add your items before turning the gacha system on.

Rarities¶

Rarities are a way to indicate how likely an item is to be drawn from the gacha. The rarer the item, the less likely it is to be drawn. The defaults for rarities are shown in the above configuration image, but you can change the fields you want to with /gacha-config rarities.

Rarity Colors¶

Editing rarity colors will determine the color of the embed (the color to the side of them) for items with a particular rarity.

Rarity Odds¶

Editing rarity odds will determine how likely an item of that rarity is to be drawn from the gacha.

The odds are represented as a percentage, and the sum of all odds must equal 100%.

Rarity Names¶

Rarity names can be changed through /gacha-config names. Do note that even if you change the names, when adding/editing items, you will still need to use the default rarity names (common, uncommon, rare, epic, legendary) in order to assign rarities to items.

Items¶

Adding Items¶

A gacha system isn't a gacha system without items! To add items, you can use the /gacha-manage add-item command. This will pop out a little button that can be used at any time to add gacha items.

Once you click that button, a little prompt will appear to fill out the details of the item you want to add:

You get a number of customization options here:

• The name and description are exactly what you expect. Names must be unique across different items. Both of these fields are required.
• The rarity is the rarity of the item, which will determine how likely it is to be drawn from the gacha. By default, items get created with a common rarity, but you can choose one of: common, uncommon, rare, epic, or legendary.
  • If you have changed the rarity names in the gacha configuration, those will not be reflected here.
  • Rarities are discussed more in the rarities section above.
• The quantity is how many of this item you want to add to the gacha system. By default, there will be infinite amounts of this item - otherwise, for each time someone draws the item, its quantity decreases until it reaches 0 and can no longer be drawn for.
• The image is optional, but if you provide a URL to an image, it'll be displayed when a player draws the item (as a thumbnail in an embed). This can be useful for showing off what the item looks like.

Once you fill out the prompt, you should get a message about how the item was added successfully!

Listing Current Items¶

To see what items are currently in the gacha system, you can use /gacha-manage list-items. This will give you a list of all items in the gacha system, a shortened view of their description, and their quantity (if they have one that isn't infinite).

Viewing Item¶

If you want to see more information about a single item, you can use /gacha-manage view-item and specify the name of the item you want to see. This will give you a more detailed view of the item, including its description, quantity, and image (if it has one).

Editing and Deleting Items¶

Editing an item is as simple as using /gacha-manage edit-item and specifying the item's name. A little pop-up will appear:

As you can see, it already has the old fields populated in it - you'll be able to edit any property you want (including the name!). When you press submit, the item will be edited with the new properties.

To delete an item, it's as simple as using /gacha-manage delete-item with the name of the item you want to delete. Notably, this removes it from all player's item lists, so be careful!

Adding Items To/Removing Items From Players¶

If needed, you can manually add or remove items from a player's inventory.

To add an item to a player, you can use /gacha-manage add-item-to and specify the user, the item, and optionally, the quantity you want to add (if not specified, it defaults to 1):

To remove an item from a player, you can use /gacha-manage remove-item-from and specify similar properties. For quantity, if not specified, it defaults to however many of the item the player has.

Exporting/Importing Items¶

If you wish to transfer items to another server, or just wish to create a shareable list of items in general, the process is simple.

To export items, you can use /gacha-manage export-items. This should give you a file ending in .json; this is a JSON file, and it can be shared around freely. No private information is stored on these other than basic information about the items themselves.

You can also edit it directly if you wish; this should not be necessary, but can be done for advanced usecases. If you choose to do so, please expand the below note.

Regardless, you may import exported items through /gacha-manage import-items and giving your JSON file. This may be done from other servers other than the server where the file was exported from.

The bot, by default, will error out if there are any items in the export that overlap with items already in the server. To get around this, you can use the override option in /gacha-manage import-items to replace those items.

Currency¶

Everything about currency is managed by you through bot commands. To clarify: there are no ways for players to earn currency on their own, so you must give it to them manually.

Adding Currency¶

Adding currency to a single player is easy. Simply use /gacha-manage add-currency with the user and the amount you wish to give:

However, this may take a while when you want to add currency to every player. PYTHIA includes a shortcut in the form of /gacha-manage add-currency-players, which will add the currency given to all members with the players role. This may take a while!

Removing Currency¶

Removing currency is as simple as using /gacha-manage remove-currency with the user and the amount you wish to take away:

There is no way of directly transferring currency from one member to another as a staff member, but you can simulate the process with the available commands

List Currency Amounts¶

To see how much currency every player has, you can use /gacha-manage list-currency-amounts. This will give you a list of all players with the players role and how much currency they have.

View Profile¶

To view the items and currency a user has, you can use the /gacha-manage user-profile commands:

Resetting and Clearing¶

• /gacha-manage reset-currency resets the currency amount for a particular user.
• /gacha-manage reset-items, in a similar manner, resets all items for a particular user.
• /gacha-manage clear-user clears all data about a user, including both currency and items.
• Finally, /gacha-manage clear-everything clears all data about every user, including both currency and items. This action is irreversible!

Finally...¶

Once you're settled, feel free to enable the gacha system with /gacha-config toggle, as mentioned earlier! Players will then be able to use the gacha system as described in the gacha usage guide.