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

Download the mod JAR file
Place in your Minecraft mods folder
Start Minecraft with Forge profile
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

CivClash: Nation PVP