{"id":43630,"date":"2026-06-02T03:33:36","date_gmt":"2026-06-02T00:33:36","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/"},"modified":"2026-06-02T03:33:36","modified_gmt":"2026-06-02T00:33:36","slug":"codeclaim","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/","title":{"rendered":"CodeClaim"},"content":{"rendered":"
\n

# CodeClaim<\/p>\n

A server-side Fabric mod for Minecraft 1.21.1 that allows players to redeem codes for rewards.
\nNo client mod required. No database required.<\/p>\n

![Minecraft](https:\/\/minecraft.net)
\n![Fabric](https:\/\/fabricmc.net)
\n![Java](https:\/\/adoptium.net)
\n![License](LICENSE)
\n![Server Side](https:\/\/fabricmc.net)<\/p>\n<\/div>\n

—<\/p>\n

## Overview<\/p>\n

CodeClaim lets server administrators create redeemable codes that reward players with any server command \u2014 give items, Pokemon, broadcast titles, and more. Each player can only redeem each code once, and each code can have a global usage limit. All data is stored in simple JSON files with no external database setup required.<\/p>\n

![Replace this with a description](https:\/\/cdn.modrinth.com\/data\/cached_images\/4b0c345be38e5cd28b01c5842a4be899cb4ad45e.png)
\n—<\/p>\n

## Features<\/p>\n

– Any player can use `\/claim` without operator permissions
\n– Each player can only redeem each code once, enforced by UUID
\n– Per-code global usage limit via `max_uses`
\n– Set `max_uses: -1` for unlimited redemptions
\n– Execute any server command as a reward using `%player%` as a placeholder
\n– All data auto-saves to a local JSON file
\n– Hot-reload config and data without restarting the server
\n– Server-side only \u2014 players do not need to install anything<\/p>\n

—<\/p>\n

## Requirements<\/p>\n

– Minecraft 1.21.1
\n– Fabric Loader 0.15.0 or later
\n– Fabric API 0.102.0+1.21.1
\n– Java 21<\/p>\n

—<\/p>\n

## Installation<\/p>\n

1. Download `codeclaim-1.0.0.jar` from the [Releases](..\/..\/releases) page
\n2. Download all required dependencies: Fabric Language Kotlin, Fabric API
\n3. Place the file in your server’s `mods\/` folder alongside Fabric API
\n4. Start the server \u2014 the config file will be automatically generated at `config\/codeclaim.json`
\n5. Edit the config to define your codes and rewards
\n6. Use `\/claimadmin reload` to apply any changes without restarting<\/p>\n

—<\/p>\n

## Commands<\/p>\n

| Command | Permission | Description |
\n|———|————|————-|
\n| `\/claim ` | All players | Redeem a code and receive its reward |
\n| `\/claimadmin reload` | OP level 2 | Reload config and player data from disk |
\n| `\/claimadmin info ` | OP level 2 | View usage statistics for a code |<\/p>\n

---<\/p>\n

## Configuration<\/p>\n

Config file location: `config\/codeclaim.json`<\/p>\n

```json
\n{
\n \"messages\": {
\n \"invalid_code\": \"&cCode '&4{code}&c' does not exist!\",
\n \"already_claimed\": \"&cYou have already redeemed '&4{code}&c'!\",
\n \"max_uses\": \"&cCode '&4{code}&c' has reached its usage limit!\",
\n \"success\": \"&aSuccessfully redeemed code '&2{code}&a'!\",
\n \"reloaded\": \"&aCodeClaim config reloaded!\"
\n },
\n \"codes\": {
\n \"WELCOME2024\": {
\n \"max_uses\": -1,
\n \"commands\": [
\n \"give %player% minecraft:bread 16\"
\n ]
\n },
\n \"SHINY_EVENT\": {
\n \"max_uses\": 100,
\n \"commands\": [
\n \"givepokemonother %player% moltres form=galarian\",
\n \"title @a title {\"text\":\"A player claimed SHINY_EVENT!\",\"color\":\"gold\"}\"
\n ]
\n },
\n \"GRAND_PRIZE\": {
\n \"max_uses\": 1,
\n \"commands\": [
\n \"give %player% minecraft:netherite_ingot 3\",
\n \"say %player% claimed the Grand Prize!\"
\n ]
\n }
\n }
\n}
\n```<\/p>\n

### Field Reference<\/p>\n

| Field | Description |
\n|-------|-------------|
\n| `max_uses` | Maximum total redemptions across all players. `-1` means unlimited. |
\n| `commands` | List of server commands to execute when the code is successfully redeemed. |
\n| `%player%` | Placeholder replaced with the redeeming player's username at runtime. |
\n| `{code}` | Placeholder replaced with the entered code in message strings. |
\n| `&a`, `&c` | Standard Minecraft color codes supported in all message fields. |<\/p>\n

---<\/p>\n

## Data Storage<\/p>\n

Player redemption history is automatically saved to:<\/p>\n

```
\ndata\/codeclaim_data.json
\n```<\/p>\n

This file tracks which players have redeemed which codes, and the total usage count per code. Back up this file regularly to preserve redemption history across server migrations.<\/p>\n

---<\/p>\n

## Building from Source<\/p>\n

Requirements: JDK 21, Gradle 8.8 or later<\/p>\n

```bash
\ngit clone https:\/\/github.com\/YOUR_USERNAME\/codeclaim
\ncd codeclaim<\/p>\n

# Linux \/ macOS
\n.\/gradlew build<\/p>\n

# Windows
\ngradlew.bat build
\n```<\/p>\n

The compiled jar will be output to `build\/libs\/codeclaim-1.0.0.jar`.<\/p>\n

---<\/p>\n

## Compatibility<\/p>\n

| Mod | Status |
\n|-----|--------|
\n| Cobblemon | Compatible \u2014 use `givepokemonother %player%` |
\n| LuckPerms | Compatible |
\n| Any server-side command mod | Compatible |<\/p>\n

---<\/p>\n

## License<\/p>\n

This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.<\/p>\n","protected":false},"excerpt":{"rendered":"

A server-side Fabric mod for Minecraft 1.21.1 that allows players to redeem codes for rewards.
\nNo client mod required. No database required<\/p>\n","protected":false},"featured_media":43631,"template":"","meta":{"_minecraft_slug":"codeclaim","_minecraft_project_id":"DER3FUVI","_minecraft_author":"thanhsu263","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":8,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"codeclaim.zip","_minecraft_size_bytes":14991,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T13:47:43.319321Z","_minecraft_date_created":"2026-05-03T22:13:36.429007Z","_minecraft_date_modified":"2026-04-27T14:56:34.712372Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/codeclaim","_minecraft_icon_attachment_id":43631,"_minecraft_imported_at":"2026-06-02T00:33:37+00:00","_minecraft_import_hash":"998d506ca7fe16db8ea0a4832092f706","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,97,867,123],"mod_loader":[99],"minecraft_version":[37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-43630","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-fabric","mod_category-social","mod_category-technology","mod_loader-fabric","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nCodeClaim - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"CodeClaim - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A server-side Fabric mod for Minecraft 1.21.1 that allows players to redeem codes for rewards. No client mod required. No database required\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/codeclaim\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/codeclaim\\\/\",\"name\":\"CodeClaim - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/codeclaim\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/codeclaim\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/codeclaim-icon-2adec90807d3a06447bd6c2956eaa551fef96da1.png\",\"datePublished\":\"2026-06-02T00:33:36+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/codeclaim\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/codeclaim\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/codeclaim\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/codeclaim-icon-2adec90807d3a06447bd6c2956eaa551fef96da1.png\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/codeclaim-icon-2adec90807d3a06447bd6c2956eaa551fef96da1.png\",\"width\":64,\"height\":64},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/codeclaim\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"CodeClaim\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"CodeClaim - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/","og_locale":"en_US","og_type":"article","og_title":"CodeClaim - Minecraft","og_description":"A server-side Fabric mod for Minecraft 1.21.1 that allows players to redeem codes for rewards. No client mod required. No database required","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/","name":"CodeClaim - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/codeclaim-icon-2adec90807d3a06447bd6c2956eaa551fef96da1.png","datePublished":"2026-06-02T00:33:36+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/codeclaim-icon-2adec90807d3a06447bd6c2956eaa551fef96da1.png","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/codeclaim-icon-2adec90807d3a06447bd6c2956eaa551fef96da1.png","width":64,"height":64},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/codeclaim\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"CodeClaim"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/43630","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/43631"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=43630"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=43630"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=43630"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=43630"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}