> For the complete documentation index, see [llms.txt](https://plugins.sarhatabaot.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://plugins.sarhatabaot.net/trading-cards/readme.md).

# Trading Cards

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=TreasureIslandMC_TradingCards\&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=TreasureIslandMC_TradingCards) [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=TreasureIslandMC_TradingCards\&metric=bugs)](https://sonarcloud.io/summary/new_code?id=TreasureIslandMC_TradingCards) [![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=TreasureIslandMC_TradingCards\&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=TreasureIslandMC_TradingCards) [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=TreasureIslandMC_TradingCards\&metric=coverage)](https://sonarcloud.io/summary/new_code?id=TreasureIslandMC_TradingCards) [![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=TreasureIslandMC_TradingCards\&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=TreasureIslandMC_TradingCards)

[![](https://jitpack.io/v/sarhatabaot/TradingCards.svg)](https://jitpack.io/#sarhatabaot/TradingCards) [![Java CI with Maven](https://github.com/TreasureIslandMC/TradingCards/actions/workflows/maven.yml/badge.svg)](https://github.com/TreasureIslandMC/TradingCards/actions/workflows/maven.yml) [![](https://img.shields.io/discord/881610309637398538?color=%235865F2\&label=support\&logo=Discord\&logoColor=white\&style=for-the-badge)](https://discord.gg/4v9gsBCgg8)

Spigot plugin for Trading Cards. An updated version of TradingCards with improvements and new features.

You can find dev builds on <https://ci.codemc.io/job/sarhatabaot/job/TradingCards/>

## [Coming from version 5.0.x? See how to migrate here.](https://tradingcards.sarhatabaot.net/migration/5.0.4-greater-than-5.7.2+)

## New Features:

* Java 16 - 1.17+
* Custom Drop types
* Custom Materials
* Custom texture support (CustomModelData nbt tag)
* Multiple cards files
* New config system
* New commands:
  * Sell command
  * Worth command
  * Debug commands - Version, Modules, Rarities, exists.

### Improvements:

* Proper use of VaultAPI.
* Improved deck format
* Tab Completions for commands.
* Better pack format. [Old format](https://github.com/sarhatabaot/TradingCards/blob/f24613e8c6238413f89085b9d5030afb7acb3afa/tradingcards-plugin/src/main/resources/settings/packs.yml), [New Format](https://github.com/sarhatabaot/TradingCards/blob/master/tradingcards-plugin/src/main/resources/data/packs.yml)
* Cached cards

### Unimplemented:

* Rewards from completed rarities
* "SCHEDULED" series mode

## Addons:

This version of Trading Cards doesn't support MythicMobs, MobArena & Towny out of the box. For support, you need to install additional addons: [Addons](https://github.com/sarhatabaot/TradingCards/wiki/Tradingcards-Addons)

These are normal plugins, to install just place in your plugins folder.

## Building TradingCards

```
mvn clean package
```

Any class files in the "messages" package are automatically generated from the "internal-messages" folder. To generate them run `messages:generate` & `formatter:format`. You should probably add these as a compound configuration in your ide. See more info about the usage <https://github.com/sarhatabaot/messages-core>