Viper Economy (1.21.x 26.x)

What Is Viper Economy?

Viper Economy is a server-side only Fabric economy mod that adds a complete virtual and physical currency system to Minecraft. Unlike clunky permission-based economy plugins, Viper Economy hooks directly into Minecraft's server internals via Fabric Mixins delivering atomic transactions, server shop GUIs, chest shops, daily rewards, tax mechanics, PvP balance loss, and scoreboard integration with zero client mods required.

Key differentiator: Vanilla clients connect normally. No resource packs, no client-side mods, no version mismatch errors. Drop the JAR in mods/ and go.

Core Economy Engine

Dual Currency Modes

How It Works (Simplified)

Player Joins  Starting Balance Assigned  Daily Reward Check
                                                       
              
                Virtual Mode: storage.json    /pay  /bal       
                Physical Mode: count items    /topup /withdraw 
              
                                                       
              Server Shop (/servershop)  Buy/Sell  Tax Applied
              Chest Shops  Sign + Chest  Auto-Detected
              PvP Death  Balance Loss %  Winner Gets Drop

Features

Enhance your server setup! Check out my other server-side mods over at : Fabric Server Essentials

Commands

Player Commands

Admin Commands (op only)

Configuration

All configs live in config/viper-economy/ and are hot-reloadable.

config.json

{
  "economyMode": "VIRTUAL",
  "physicalCurrencyItem": "minecraft:diamond",
  "startingBalance": 1000.0,
  "dailyAmount": 100.0,
  "dailySellLimit": 10000.0,
  "taxRate": 0.1,
  "pvpBalanceLossPercentage": 0.0,
  "serverShopEnabled": true
}

prices.json

Defines all purchasable/sellable items organized by category:

{
  "items": {
    "minecraft:diamond": {
      "category": "gems",
      "stack": 64,
      "unit_buy": 100.0,
      "unit_sell": 50.0
    }
  },
  "categories": {
    "gems": {
      "name": "6Gems",
      "display_item": "minecraft:diamond"
    }
  }
}

A massive default prices.json (671 KB, 500+ items across 25+ categories) is bundled and auto-deployed on first run.

Usage Walkthrough

1. First Run (Auto-Setup):

• Drop the mod JAR in mods/, start server
• config/viper-economy/config.json and prices.json are generated from bundled defaults
• Edit config.json if you want PHYSICAL mode or different rates
• Changes apply immediately no restart needed

2. Virtual Economy (Default):

• Players join get startingBalance (1000)
• /servershop opens GUI with 25+ categories, 500+ items, pagination
• Buy with left-click, sell with right-click, shift-click for stacks
• Tax (taxRate) applied automatically on purchases

3. Chest Shops (Player-Run):

1. Place a chest
2. Place a sign on it
3. Line 1: [Shop] (auto-detected)
4. Line 2: B 10 (buy price) or S 5 (sell price) or B 10 S 5
5. Line 3: Item name or ? (auto-detect from chest)
6. Line 4: Optional owner name (defaults to placer)
7. Fill chest with stock players interact with sign to buy/sell

4. Physical Economy (Hardcore/Roleplay):

• Set "economyMode": "PHYSICAL" in config.json
• Set "physicalCurrencyItem": "minecraft:gold_ingot" (or custom item)
• Balances stored as items in player inventory/ender chest
• /bal counts currency items; /pay moves items between players

5. PvP Server Economy:

• Set "pvpBalanceLossPercentage": 0.05 (5% loss on death)
• Winner picks up dropped balance as currency items (physical) or gets credited (virtual)

Performance

• Zero external dependencies pure Fabric API + Mixins
• JSON file storage in world/viper-economy/ atomic writes, no DB required
• Server-side only zero client CPU/RAM impact
• Hot-reloadable edit configs at runtime, no restart

Installation

Requirements

• Fabric Loader: 0.14.21+ (1.21.x) / 0.19.3+ (26.x)
• Java: 21 (1.21.x) or 25 (26.x)
• Fabric API: Matching your Minecraft version

Steps

1. Download the correct JAR for your Minecraft version
2. Place in mods/ folder (server only client not required)
3. Start server once configs auto-generate
4. Edit config/viper-economy/config.json to your liking
5. Edit config/viper-economy/prices.json to customize shop prices
6. Changes apply instantly no restart needed

FAQ

Q: Do players need to install anything?
A: No. Viper Economy is 100% server-side. Vanilla clients connect normally.

Q: How do I reset a player's balance?
A: /resetmoney <player> resets to the starting balance from config.

Q: Can I use custom items as currency?
A: Yes. Set physicalCurrencyItem to any valid item ID in config.json.

Q: How do I add new items to the shop?
A: Edit prices.json and add entries under items and categories. Changes apply instantly.

Q: What happens if the server crashes?
A: JSON storage uses atomic writes partial writes are discarded, last save is preserved.

Supported Versions

Built with Fabric Loom 1.17.x Zero external dependencies ARR Licensed