gmitch215 / BattleCards

🎴 Minecraft Battle Royale

BattleCards

Unique, action-packed Minecraft Plugin, featuring upgradable and collectible cards used in Battle.

🎴 Deploy your Mobs!

About

BattleCards is a free Minecraft Plugin developed for Spigot 1.8+ servers. It creates a unique combat system inspired from games like Clash Royale where entities can drop collectible cards that are upgradable and usable in PvP and PvE combat. Created by GamerCoder, it allows for an amazing and unique Minecraft Experience for all ages. Deploy your Cards!

---

❓ Why?

• Efficient: BattleCards is designed in the Kotlin language, providing a unique method of handling API, properties, and elements for a optimized and performative experience.
• Simple: BattleCards is one of the most well-documented plugins on the market, allowing for easy customization and modification. We also offer an easy-to-learn API for directly modifying plugin behavior to your liking.
• Unique: The concept of BattleCards is one of its unique, inspired by popular games known for their quality and strategy.
• Strategic: Similar to how strategy is implemented in other card-based games, it encourages critical thinking through the limiations of how cards are used to win your battles.
• Transparent: All source code and implementation is open source for developers to contribute, test, and modify. Please consider supporting my work :)

---

🗒️ Usage

Download the plugin from any official providers (Spigot, Modrinth, BuiltByBit, Hangar, etc.). Drop the JAR file into your "plugins" folder.

‼️ Important Note

This plugin is built in Kotlin. While the plugin will automatically download the necessary libraries for the plugin to run, it is recommended that you install the Kotlin Spigot Plugin. This is only required if you are running on a server version below 1.16.

---

📓Changelog

🧙‍♂️ v1.1.1 - February 25, 2024

• Card Weaknesses & Strengths
  • Cards now have Classes (Melee, Ranged, Tank, Group, Magic)
  • These are all 2x or 3x stronger/weaker against one another
• Balance Changes
  • Buff Mercenary, Frost Bear Defense
• Messages Revamp
  • New Message Handlers & Implementation for Bukkit, Spigot & Paper/Paper Forks
  • Configurable & Information in config.yml
• 2 New Card Quests
  • TITAN and GOLIATH
• Expose BattleStatistics#rawStatistics
• Optimization & Other Code Cleanup

📖 v1.1.0 - January 2, 2024 | Generation II

• 3 new Generation II Cards
• New Card Equipment
• Turkish Translation
• Card & Equipment Catalogue
  • View useful information & crafting recipes about all cards & card equipment
• Release of the official guide
• Equipment Drops from Normal Entities
• Piglin Bartering for Equipment & Card Shards (1.16+)
• Decrease BASIC and COMMON Max Experience Requirements
• Minor Bug Fixes
  • Added Missing Translations

🛠️ v1.0.2 - December 2, 2023

• Dependency Updates
• 10+ New Card Equipments
• Added missing chainmail Ability Translation

🐛 v1.0.1 - October 27, 2023

• Dependency Updates
• Fix 1.20.2 Support, Packet Errors
• Add New Metrics
• Buff Thunder Revenant's Max Health Modifier
• Fix Card Identification on 1.8-1.11.2
• Other Minor Additions

🃏 v1.0.0 - September 3, 2023

Initial Release of BattleCards

---

🔮 Future Features

Coming Soon...

---

💻 BattleCards API

JavaDocs: https://battlecards.gamercoder215.me

Installation

Maven

<project>

    <repositories>
        <repository>
            <id>codemc-snapshots</id>
            <url>https://repo.codemc.io/repository/maven-snapshots/</url>
        </repository>
    </repositories>
    
    <dependencies>
        <dependency>
            <groupId>me.gamercoder215.battlecards</groupId>
            <artifactId>battlecards-api</artifactId>
            <version>[VERSION]</version>
        </dependency>
    </dependencies>
    
</project>

Gradle (Groovy)

repositories {
    maven { url 'https://repo.codemc.io/repository/maven-snapshots/' }
}

dependencies {
    implementation 'me.gamercoder215.battlecards:battlecards-api:[VERSION]'
}

Gradle (Kotlin DSL)

repositories {
    maven(url = "https://repo.codemc.io/repository/maven-snapshots/")
}

dependencies {
    implementation('me.gamercoder215.battlecards:battlecards-api:[VERSION]')
}

---

📷 Screenshots