# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://plugins.sarhatabaot.net/trading-cards/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.