CS2CasesPlugin

🎁 MCCases — CS2-Style Cases for Minecraft

[!IMPORTANT] A matching server resource pack is REQUIRED for the full experience!

Download the resource pack from the Latest Releases. Make sure you use the resource pack that matches your plugin version.

Without the resource pack, custom weapon textures, 3D weapon models, and first-person weapon visuals will not work as intended.

MCCases brings the Counter-Strike 2 case-opening experience to Minecraft. Open cases, collect weapon skins, inspect knives, trade with other players, and build your own skin collection — all on a regular Paper server.

No client-side mods required. Just the plugin and its matching resource pack.

✨ Features

• CS2-Style Case Openings — Open cases with animated reels and rare rewards.
• Weapon Skins — Collect hundreds of skins with individual floats, patterns, exteriors, and StatTrak values.
• Knives & Gloves — Discover custom 3D weapon models inspired by Counter-Strike.
• Natural Inspect Animations — Inspect weapons and knives with detailed animations.
• Personal Skin Collection — Browse, equip, filter, sort, and favorite your skins.
• Player Trading — Trade skins directly with other players using a secure confirmation system.
• Emerald Marketplace — Buy and sell skins using in-game Emeralds.
• Trade-Up Contracts — Exchange skins for higher-rarity rewards with visible odds.
• Custom Resource Pack — Dedicated textures, weapon models, and first-person visuals.
• Multiple Languages — English by default, with additional translations available.
• Persistent Storage — SQLite, MySQL, and MariaDB support.
• Admin Tools — Manage players, cases, skins, patterns, odds, and dealers.
• Paper Optimized — Server-side functionality without requiring client modifications.

📦 Requirements

• Minecraft Java Edition 26.3
• PaperMC 26.3 (the tested target version)
• Java 25
• The matching MCCases resource pack

No additional plugins are required.

Important: Other Minecraft or Paper versions may require additional testing. Use a compatible server version for the intended experience.

🚀 Installation

1. Download the latest plugin .jar from GitHub Releases.
2. Download the matching MCCases-ResourcePack-<version>.zip from the same release.
3. Place the plugin .jar into your server's plugins/ directory.
4. Start the server. MCCases will generate its configuration files.
5. Configure the resource pack and make it available to your players.
6. Restart the server if required and verify that the plugin loads correctly.

Enable the resource pack

The plugin includes built-in resource pack distribution. You can configure it in plugins/MCCases/config.yml.

resource-pack:
  enabled: true
  namespace: mccases
  distribution:
    enabled: true
    bind-address: 0.0.0.0
    port: 8165
    public-url: "http://your-server-address:8165"
    required: false

Replace your-server-address with an address reachable by your players. Make sure the configured port is accessible through your firewall and hosting provider.

Alternatively, distribute the matching ZIP through your own Minecraft resource pack setup.

🎮 Player Commands

Command	Description
/cases	Browse available cases and open them
/cases open <case> <amount>	Open a specified number of cases
/cases cancel	Cancel queued openings
/openings	View active openings and recent rewards
/inventory	Open your skin collection
/inventory vanilla	Open your collection in a chest-style GUI
/skins [player]	View your collection or another player's collection
/knife [player]	Browse knives
/inspect	Inspect your held skin or equipped knife
/inspect hand	Select the body-hand inspect view
/inspect view	Select the first-person inspect view
/trade [player]	Start a trade with another player
/trade accept <player>	Accept a trade request
/trade decline	Decline a trade request
/trade cancel	Cancel an active trade
/market	Browse the marketplace
/market own	Manage your marketplace listings
/market balance	Check your marketplace balance
/market claims	Collect pending marketplace proceeds
/tradein	Open trade-in contracts
/tradeup	Alternative command for trade-in contracts

🛠️ Admin Commands

All administrative commands use /csadmin (alias: /mccases) and require the mccases.admin permission.

Command	Description
/csadmin info	Display plugin information and resource pack status
/csadmin givecase <player> <case> [amount]	Give cases to a player
/csadmin givekey <player> <key> [amount]	Give case keys
/csadmin giveskin <player> <skin> [float] [pattern] [stattrak]	Add a skin to a player's collection
/csadmin list <player>	List a player's skin instances
/csadmin history <player>	View recent case-opening history
/csadmin manage <player>	Manage a player's collection
/csadmin equip <player> <id>	Equip a skin
/csadmin removeskin <player> <id>	Remove a skin
/csadmin testcase <case> [keep]	Test a case opening
/csadmin odds <case>	Display the case's drop chances
/csadmin preview <skin>	Preview a skin
/csadmin pattern <skin> <pattern>	Analyze a skin pattern
/csadmin shop spawn	Spawn a case dealer
/csadmin shop remove	Remove a case dealer
/csadmin exportpack	Export or rebuild the resource pack
/csadmin reload	Reload supported configuration and catalog files

Use /csadmin help or tab completion to discover available subcommands on your server.

🔐 Permissions

Permission	Default	Description
mccases.use	Everyone	Access the collection and cases
mccases.inspect	Everyone	Inspect skins
mccases.view	Everyone	View other players' collections
mccases.shop	Everyone	Use the dealer
mccases.trade	Everyone	Trade skins
mccases.market	Everyone	Use the marketplace
mccases.tradein	Everyone	Use trade-in contracts
mccases.admin	Operators	Access administrative commands

⚙️ Configuration

Configuration files are stored in:

plugins/MCCases/
├── config.yml
├── shop.yml
├── market.yml
├── inspect.yml
├── inspect-profiles.yml
├── sounds.yml
├── messages_*.yml
├── catalog/
├── textures/
├── resourcepack/
├── data.db
└── secret.key

• config.yml — Main settings, storage, displays, inspections, and resource pack options.
• shop.yml — Dealer prices and shop settings.
• market.yml — Marketplace limits and economy settings.
• inspect.yml — Inspect animations, positions, and visual settings.
• inspect-profiles.yml — Additional inspect animations.
• sounds.yml — Sound effects.
• messages_*.yml — Language files.
• catalog/ — Cases, skins, weapons, rarities, keys, and patterns.
• textures/ — Skin textures and weapon layers.
• resourcepack/ — Resource pack files.
• data.db — SQLite database when SQLite is enabled.
• secret.key — Signing key for cases and keys.

Existing configuration files are preserved when the plugin starts. Back up your configuration and database before making major changes or updating the plugin.

🎨 Custom Content

MCCases supports custom cases, skins, patterns, and other catalog content.

You can extend the catalog, configure rarity tiers, define skin styles, and generate an updated resource pack.

After changing supported catalog content, reload the plugin and rebuild the resource pack when necessary:

/csadmin reload
/csadmin exportpack

Always distribute the newly generated pack to players when your changes affect textures or models.

💾 Storage & Reliability

MCCases supports:

• SQLite for straightforward setups.
• MySQL and MariaDB for external database storage.
• Persistent player collections and opening history.
• Transactional storage and recovery of interrupted openings.
• Signed case and key items.
• Persistent marketplace balances and pending payouts.

Backup recommendation: Back up your database, player data, configuration files, and secret.key together. Keep a copy of your matching resource pack as well.

🔄 Updating

1. Stop your server.
2. Back up plugins/MCCases/ and your world and player data.
3. Download the new plugin .jar and its matching resource pack.
4. Replace the old plugin and resource pack.
5. Start the server and check /csadmin info.
6. Verify that players receive the correct resource pack.

Always use a matching plugin and resource pack version. Mixing versions can cause missing textures, broken models, or incorrect visuals.

🧑‍💻 Development

MCCases is built with Gradle and Kotlin DSL build configuration.

To build from source, install JDK 25 and run:

./gradlew build

On Windows:

gradlew.bat build

The build produces the plugin JAR and resource pack distribution.

📄 Project Information

• Project: MCCases
• Repository: Plattnericus/CS2CasesPlugin
• Author: Plattnericus
• Platform: PaperMC
• Java: 25
• Build System: Gradle
• Resource Pack: Required for the full visual experience

📜 License

MCCases is distributed under its own non-commercial, source-available license.

You may:

• Use the plugin for free on personal and public servers.
• Modify the source code.
• Share free copies or modified versions in accordance with the license.
• Study the code for educational purposes.

You may not:

• Sell the plugin or modified versions.
• Sell access to the plugin or charge real money for cases, keys, skins, or openings.
• Redistribute modified versions without the required attribution.
• Claim MCCases as your own project or present a derivative as the official version.

When publishing a derivative, follow the attribution requirements in the project's license.

Third-party assets and materials may have separate licensing requirements. Refer to the repository's legal information and third-party notices.

⚖️ Disclaimer

MCCases is an independent project inspired by Counter-Strike 2. It is not affiliated with, endorsed by, or associated with Valve, Mojang, or Microsoft.

Counter-Strike is a trademark of Valve Corporation. Minecraft is a trademark of Mojang AB and Microsoft.

❤️ Credits

Made with care by Plattnericus.

Inspired by the case-opening, weapon-skin, and inspection systems of Counter-Strike 2.

Download: Latest MCCases Release