# Villera — Village Economy, Chunk Claims & Stacked Spawners

**Villera is a Minecraft 1.21.11 Fabric village economy mod that adds biome-adaptive banks, physical currency, role-based markets, rentable chunk claims and performance-friendly stacked spawners.**

Built for both single-player worlds and multiplayer servers, Villera turns ordinary villages into useful progression hubs while keeping important economy, inventory, ownership and permission checks server-authoritative.

## Why choose Villera?

- **Living village economy:** discover functional banks, a Mineral Exchanger and specialized market stalls inside normal villages.

- **Secure banking:** use persistent accounts, physical coins, banknotes and owner-bound bank cards.

- **Useful role-based markets:** trade with Farmers, Butchers, Lumberjacks, Masons and Blacksmiths through exact-quantity confirmation screens.

- **Rentable chunk claims:** protect full 16×16 chunks with granular permissions, ownership transfer and active-runtime rental timers.

- **Lag-friendly stacked spawners:** store accumulated mobs virtually instead of producing uncontrolled entity crowds.

- **Safe transactions:** inventory capacity, balance, card ownership and item quantities are validated before a trade completes.

- **Bilingual:** complete English and Turkish interface text.

## Village banks and physical currency

Villera banks use materials that match the surrounding village biome. Banker NPCs provide persistent account access, deposits, inventory-aware withdrawals and owner-bound cards. Physical copper, silver and gold coins plus banknotes allow cash trading without removing the usefulness of account payments.

A card only authorizes its owner. Stolen cards cannot access another player's account.

## Mineral Exchanger

The Mineral Exchanger is separate from the normal banker. Select a mineral and exact quantity, review its unit value and total payout, choose physical cash or an account deposit, then confirm valuable sales twice. If the transaction cannot complete safely, the original items and balance are restored.

## Role-based village markets

Villera adds Farmers, Butchers, Lumberjacks, Masons and Blacksmiths with broad, configurable inventories. Buying and selling screens show exact quantity, unit price, total value, current inventory count and selected payment method. Prices are designed to reduce renewable-resource profit loops while keeping village trading useful.

## Rentable chunk claims and land protection

Rent a full-height 16×16 Minecraft chunk using Villera Currency. Rental time follows actual active server runtime—not Minecraft day length—so sleeping, changing the game time or pausing a single-player world cannot accelerate expiry.

Claim owners can separately allow:

- Block breaking and placement

- Block and container use

- World-changing item use

- Spawner placement, breaking and use

- Entity interaction and attacks

Claims can be extended, managed, transferred and released through an in-game GUI. Ownership and permissions persist across normal restarts.

## Performance-friendly stacked spawners

Rare Villera spawners can generate in suitable Overworld terrain.

- Levels 1–10 with rewarding merging

- Persistent virtual mob accumulation

- One visible, motionless stack body instead of uncontrolled crowds

- Safe release-area validation

- Pickaxe pickup with mob type and level preservation

- Claim and protected-structure integration

This system is intended for economy and survival servers that want spawner progression without large live-mob farms causing unnecessary entity load.

## Biome-adaptive protected structures

Banks and markets use a palette suited to the village biome. Villera economy structures are protected from looting and dismantling and can repair accidental environmental damage. Decorative containers are intentionally inaccessible.

## Server-authoritative safety

Villera validates inventory capacity, account balance, card ownership, exact item quantity, claim access, spawner identity and protected structure boundaries on the server. Failed operations use rollback paths to prevent item or currency loss.

## Requirements

- Minecraft Java Edition **1.21.11**

- Fabric Loader **0.18.1 or newer**

- Fabric API **0.141.2+1.21.11**

- Java **21**

- Environment: **Client and Server**

## Installation

1. Install Fabric Loader for Minecraft 1.21.11.

2. Put the matching Fabric API JAR in the `mods` folder.

3. Put `villera-1.0.0.jar` in the same `mods` folder.

4. Start the game with Java 21.

## Useful commands

```text

/balance

/pay <player> <amount>

/villera info

/claim rent <hours>

/claim extend <hours>

/claim manage

/claim list

/claim trust <player>

/claim untrust <player>

/claim transfer <player>

/claim release

```

Administrators can safely reload the configuration with `/villera reload`.

## Frequently asked questions

### Is Villera a village overhaul mod?

Villera expands normal villages with a compact economy district, banks, market stalls and protected economy NPCs. It focuses on functional economy gameplay rather than replacing every vanilla village building.

### Does Villera work on multiplayer servers?

Yes. Villera is designed for both single-player and multiplayer, with server-side validation for economy, inventory, claims and spawners. Install it on both the server and joining clients.

### Is Villera available for Forge or NeoForge?

Version 1.0.0 is currently built for Fabric. Do not install the Fabric JAR in a Forge or NeoForge instance.

### Can Villera be used in modpacks?

Yes. Villera is MIT licensed and can be included in modpacks as long as the license and author attribution are preserved. Use an official download source when possible.

### Are the motionless spawner mobs a bug?

No. The visible body represents a virtual stack and intentionally has no AI. This prevents large entity crowds while preserving accumulated mob rewards.

### Are bank and market containers supposed to be locked?

Yes. Decorative economy containers are intentionally protected to prevent structure looting and economy bypasses.

**Villera is part of Yufuus Mods — a growing family of compatible Minecraft expansions.**

Villera

Turn ordinary Minecraft villages into living, secure economy hubs.

Villera expands villages with biome-adaptive banks and market districts, secure player accounts, physical currency, owner-bound bank cards, balanced merchants, real-runtime chunk rentals and performance-friendly stacked spawners.

Built for both single-player worlds and multiplayer Fabric servers, Villera adds meaningful village progression without reducing gameplay to admin commands.

🏦 Village banking

• Biome-adaptive banks integrated into normal villages
• Persistent accounts, physical coins and banknotes
• Inventory-aware deposits and withdrawals
• Owner-bound bank cards
• Separate Banker and Mineral Exchanger roles
• Transaction rollback that prevents item or currency loss

💎 Mineral exchange

Select an exact mineral and quantity, see the unit value and total payout, choose cash or account payment, then confirm valuable sales twice. If a transaction cannot finish safely, every item is restored.

🛒 Role-based markets

Trade with Farmers, Butchers, Lumberjacks, Masons and Blacksmiths. Every purchase and sale shows exact quantity, unit price, total value, inventory count and payment method. Prices reduce renewable-resource profit loops while keeping village trading useful.

🗺️ Rentable chunk claims

Rent full 16×16 chunks using Villera Currency. Time follows actual active server runtime—not Minecraft day length—so sleeping, changing game time or pausing cannot accelerate expiry. Configure granular permissions for blocks, containers, items, spawners and entities; extend, manage, transfer or release claims through an in-game GUI.

🔥 Performance-friendly stacked spawners

• Rare natural Overworld generation
• Levels 1–10 with profitable merging
• Persistent virtual mob storage
• One visible, motionless stack body instead of uncontrolled crowds
• Safe release-area validation
• Pickaxe pickup with type and level preservation
• Claim and protected-structure integration

🏘️ Protected biome-adaptive structures

Banks and markets use materials suited to their village biome. Economy structures cannot be looted or dismantled and repair accidental environmental damage.

🔒 Server-authoritative safety

Inventory capacity, balances, card ownership, exact item quantities, claim permissions, spawner identity and structure boundaries are validated by the server.

🌍 Languages

English and Turkish.

📦 Requirements

• Minecraft Java Edition 1.21.11
• Fabric Loader 0.18.1+
• Fabric API 0.141.2+1.21.11
• Java 21

🎮 Commands

/balance
/pay <player> <amount>
/villera info
/claim rent <hours>
/claim extend <hours>
/claim manage
/claim list
/claim trust <player>
/claim untrust <player>
/claim transfer <player>
/claim release

Administrators can use /villera reload.

Villera is part of Yufuus Mods — a growing family of compatible Minecraft expansions.