Dogecoin Mod

A lightweight Fabric mod that adds Dogecoin to Minecraft — craft it by feeding gold to a wolf, store it in your wallet, and use an ATM-style GUI to manage your crypto.

Features

• Dogecoin item — 2D flat item model, smeltable back to a gold ingot
• Wolf crafting — right-click a wolf with a gold ingot to receive a Dogecoin (the dog "mines" it for you)
• Wallet system — persistent per-player wallet stored in config/dogecoin_wallets.json
• ATM GUI — /wallet open opens a custom ATM screen (no vanilla container textures)
  • Deposit / Withdraw / Deposit All / Withdraw All
  • Quick amount buttons (1, 10, 64, All)
  • Custom amount input field
  • Real-time balance display
• Commands — /wallet, /wallet open, /wallet deposit <amount>, /wallet withdraw <amount>
• Configurable — config/dogecoin.json with walletEnabled and startingBalance

Installation

1. Install Fabric Loader for your Minecraft version
2. Download the Fabric API jar for your MC version
3. Download the Dogecoin Mod jar from Releases
4. Place all jars in your mods/ folder
5. Launch the game

Requirements:

• Minecraft 1.20.1, 1.21.1, or 1.21.4
• Fabric Loader ≥0.16
• Fabric API ≥0.92.0 (1.20.1) / ≥0.100.0 (1.21.x)

Usage

Dogecoin Item

| Action | Result |
| --- | --- |
| Right-click a wolf with a gold ingot | Gold consumed → 1 Dogecoin dropped/added to inventory |
| Smelt Dogecoin in a furnace | 1 Dogecoin → 1 gold ingot (200 ticks) |
| Blast Dogecoin in a blast furnace | 1 Dogecoin → 1 gold ingot (100 ticks) |

Wallet Commands

| Command | Description |
| --- | --- |
| /wallet | Show your wallet balance and inventory count |
| /wallet open | Open the ATM GUI |
| /wallet deposit <amount> | Deposit Dogecoins from inventory to wallet |
| /wallet withdraw <amount> | Withdraw Dogecoins from wallet to inventory |

ATM GUI

Run /wallet open to open the ATM. The screen shows:

• Balance — your wallet balance in DOGE
• Inventory — how many Dogecoins you're carrying
• Amount field — type a custom amount
• Quick-set buttons: 1, 10, 64, All
• DEPOSIT — move Dogecoins from inventory → wallet
• WITHDRAW — move Dogecoins from wallet → inventory
• DEPOSIT ALL — move all carried Dogecoins to wallet
• WITHDRAW ALL — move entire wallet balance to inventory
• CLOSE — close the ATM

All operations update the screen in real time via Fabric CustomPayload networking.

Configuration

Config file: config/dogecoin.json

{
  "walletEnabled": true,
  "startingBalance": 0
}

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| walletEnabled | boolean | true | Enable/disable the wallet system |
| startingBalance | int | 0 | Initial wallet balance for new players |

Wallet data is stored in config/dogecoin_wallets.json (per-player UUID → balance).

Building from Source

Prerequisites: JDK 21+

# Clone the repository
git clone https://github.com/yourname/dogecoin-mod.git
cd dogecoin-mod

# Build for all supported versions
./gradlew buildAll

# Build for a specific version
./gradlew build -PmcVersion=1.21.1

# Output jars in build/libs/

[!NOTE]
Multi-version builds download separate Minecraft jars for each target version.
The first build will take longer.

Supported Versions

| MC Version | Status | Notes |
| --- | --- | --- |
| 1.20.1 | | Old networking API (PacketByteBuf) |
| 1.21.1 | | Current target (CustomPayload API) |
| 1.21.4 | | Latest 1.21.x (CustomPayload API) |

Support for additional versions can be added by creating a version-specific source directory in src/versioned/.

Project Structure

src/
├── main/java/          # Shared code (items, commands, config, GUI)
│   └── com/pikmintea/dogecoin/
└── versioned/          # Version-specific implementations
    ├── 1.20.1/         # Fabric networking with PacketByteBuf
    ├── 1.21.1/         # Fabric CustomPayload networking
    └── 1.21.4/         # Fabric CustomPayload networking

License

MIT — feel free to use, modify, and distribute.