CivClash: Nation PVP

CivClash is a Minecraft Forge mod that implements a civilization/nation management system for multiplayer servers. The mod creates a layered architecture where it leverages Minecraft's existing faction system while implementing its own nation logic layer.

A note from the dev:

This initial prototype is considered a pre-alpha demonstration of the framework and viability of factions in 1.20.1. It in no way represents the intended vision and is not a good representation of how CivClash will actually play.  

So, please, feel free to share feedback and ideas but more importantly manage your expectations when playing and interacting. Also make backups of your worls before using.

Quick Start

For Players

• Use /civclash create <name> to start your civilization
• Press G to open the Team Management GUI
• Press H to open the Diplomacy GUI
• Press M to open the Local Map for visual territory overview
• Press N for quick territory overlay around your position
• Press C to quickly claim the chunk you're standing in
• Use /civclash claim to claim territory for your team

For Server Admins

• Use /civclash admin delete <team> to remove teams
• Use /civclash admin progression <team> to force progression checks

Documentation Structure

• Backend Systems - Technical architecture and data management
• User Interface - GUI screens and keybind reference
• Commands Reference - Complete command list and usage
• Game Mechanics - Progression system and gameplay features

Core Features

Nation Progression System

Teams progress through five tiers based on population, territory, and influence:

• Team (2+ members) - Basic group with limited territory
• Band (4+ members) - Small community with expanded claims
• Tribe (8+ members) - Organized society with diplomacy
• Chiefdom (12+ members) - Complex hierarchy with specialization
• State (20+ members) - Advanced civilization with maximum power

Territory Management

• Chunk-based claiming system with influence costs
• Quick claim via commands or keybinds
• Territory limits based on civilization tier
• Visual Local Map System with multiple overlay layers
• Real-time territory ownership and influence visualization

Diplomacy System

• Alliance formation between compatible civilizations
• War declaration and peace negotiation
• Trade benefits and territorial access based on relations
• Influence modifiers from diplomatic status

Dual Influence Mechanics

• Soft Influence: Generated through player activities and building
• Hard Influence: Formal territorial claims and political actions
• Combined system drives progression and territorial expansion
• Visual Influence Zones: Heat map visualization of dominance areas

Local Map System

• Player-centered view showing territories and influence around you
• Multiple visualization layers: Claims, influence zones, upkeep costs, war status
• Interactive controls: Zoom, pan, layer toggles, and real-time updates
• Quick overlay for tactical situational awareness
• Event-driven updates for optimal performance

Technical Requirements

• Minecraft: 1.20.1
• Forge: 1.20.1-47.4.0
• Java: 17+

Installation

1. Download the mod JAR file
2. Place in your Minecraft mods folder
3. Start Minecraft with Forge profile
4. Join a server or create a world

Configuration

The mod uses Forge's configuration system. Key settings can be found in:

• config/civclash-common.toml - Server-side game balance
• Keybinds configured through Minecraft's Controls menu