LegacyLand

A civilization simulation plugin for Paper 1.21 + Towny.

License

Unauthorized modification and redistribution prohibited.
Starting from version 1.0-Beta2.0, this project is licensed under MS-RSL.
Source code is viewable only. Modification and redistribution are not permitted.

Starting from version 1.0-pre1. this project is licensed under All Right Reserved.
Code will never be published, Modification, redistribution and De-obfuscation are not permitted.

---

Overview

LegacyLand extends the Towny nation framework with a full-stack civilization simulation system covering politics, economy, diplomacy, warfare, technology, seasons, and more — giving players a deep strategy and survival experience.

---

Feature Modules

Nation & Politics

• Government System: 5 configurable government types (Feudal, Republic, Constitutional Monarchy, Military Dictatorship, Trade Federation), driven by politics.yml, with extensible custom effects (speed boost, particle effects, etc.)
• Roles & Permissions: King, Chancellor, Supply Officer, Parliament Member, and more — fine-grained permission control per role
• Decree System: Enact decrees directly or via member vote; supports tax adjustments, research bonuses, and other policy types
• Tech Tree: Research point accumulation and spending; tech lines locked/unlocked by government type; protectorate tech overflow mechanic

Economy

• Currency & Treasury: Each nation has its own currency circulating as physical items; minting machines consume gold ingots to produce currency
• Banking: Deposit, withdraw, transfer, and exchange currencies (15% fee; exchange rate dynamically pegged to treasury reserves)
• Loans: Apply for nation loans with interest; late repayment affects credit score
• Futures Contracts: Sellers list contracts for future delivery; buyers claim goods on due date
• Stock Market: Each nation may list one stock; price dynamically tied to national power (treasury + territory + population); supports sell-order matching and dividend distribution
• Taxation: Trade tax, land tax, vassal tax, and more; adjustable via decrees
• Economic Warfare: Embargo, sanctions, inflation attack, currency manipulation
• Economic Analytics: Real-time GDP rankings, inflation rate, and credit score tracking

Diplomacy & Warfare

• Diplomacy: Ally, trade agreement, tech agreement, hostile, and neutral relation types
• Guarantee System: Stronger nations protect weaker ones; guarantor's tech effects partially overflow to the protected nation
• Standard War: Declare war, join as Soldier / Logistics / Scout, surrender, or seek peace
• Siege War: Establish outposts and supply stations in the field to capture town cores
• Flag War: Lightweight territory contest using a timer-based flag capture mechanic

Player Status

• Temperature System: Dynamically influenced by season, biome, and equipped gear
• Hydration System: Players dehydrate in arid environments
• Profession System: Main profession + sub-profession, with leveling and experience
• ActionBar HUD: Real-time display of temperature, hydration, and profession status

World Systems

• Season System: 4 seasons × 3 sub-seasons = 12 sub-seasons total; affects temperature, rain, and snow probabilities
• Chunk Resource Pricing: Biome-based resource output differences; resource extraction tracking; dynamic land pricing
• Market System: Towns host physical markets where players sell items via chest shops
• Organization System: Players create cross-nation organizations with member and outpost management

Infrastructure

• Multi-Database: SQLite (default) / MySQL (HikariCP connection pool) / MongoDB
• GUI Framework: Unified graphical interface system
• Achievement System: Player milestone unlocks
• BlueMap Integration: Land price and nation markers rendered in real time on the world map
• PlaceholderAPI: 20+ placeholder variables; compatible with TAB, DeluxeMenus, and similar plugins
• Folia Support: Async scheduler automatically adapts to both Folia and Paper

---

Dependencies

Plugins

Dependency	Required	Version
Paper	✅ Required	1.21+
Towny	✅ Required	0.102.0.0+
ItemsAdder	✅ Required	3.6.3+
Vault	✅ Required	—
PlaceholderAPI	Recommended	—
BlueMap	Optional	—

---

Configuration

Configurations

config.yml (Core)

database:
  type: sqlite          # sqlite / mysql / mongodb

  sqlite:
    filename: legacyland.db

  mysql:
    host: localhost
    port: 3306
    database: legacyland
    username: root
    password: password
    pool:
      maximum-pool-size: 10
      minimum-idle: 2
      connection-timeout: 30000

  mongodb:
    host: localhost
    port: 27017
    database: legacyland

player-status:
  enable-actionbar: true
  actionbar-update-interval: 10   # ticks

season:
  days-per-sub-season: 8

tech:
  points-per-member: 2            # research points generated per online member per tick
  research-tick-interval: 6000    # research point generation interval (ticks)

politics.yml

Defines the 5 government types: effect multipliers, role lists, and custom effects (speed boost, particle effects, etc.).

tech.yml

Defines tech tree nodes: line, tier, prerequisites, research cost, and effect keys.

---

Command Overview

For full player usage details, see in Player Guide (Simplifed Chinese)

Command	Function
/legacy	Nation info, government, role management
/diplomacy	Diplomatic relations, war declarations, alliances, agreements
/guarantee	Guarantee/protectorate management
/war	War list, join, surrender, peace
/siege	Siege war outpost and core management
/flagwar	Flag war management
/economy	Treasury creation, minting, info
/bank	Deposit, withdraw, transfer, currency exchange
/finance	Loans and futures contracts
/stock	Stock issuance, trading, dividends
/ecowar	Sanctions, embargo, GDP rankings
/tax	View and configure tax rates
/law	Enact decrees, propose and vote
/tech	Tech tree overview and research
/market	Market info and management
/price	Chest shop pricing
/resource	Resource system queries
/landprice	Land price queries
/season	Season info and admin controls
/player	Player attributes and profession management
/status	Player status overview

---

Changelog

v1.0-pre2 (Current)

• ✅ Full economy system: banking, loans, futures, stocks, minting, treasury, taxation
• ✅ Economic warfare: embargo, sanctions, inflation attack, currency manipulation, GDP stats
• ✅ War system: standard war, siege war (outpost + supply station), flag war
• ✅ Decree system: direct enactment + proposal voting, multiple decree types
• ✅ Tech tree: research point accumulation, government-locked lines, protectorate overflow
• ✅ Guarantee/protectorate diplomacy system
• ✅ Chunk resource pricing + dynamic land pricing
• ✅ Market system + chest shop pricing
• ✅ Organization system
• ✅ GUI framework
• ✅ BlueMap land price and nation marker integration
• ✅ Build obfuscation & encryption (ProGuard + ASM XOR string encryption)
• ✅ Folia compatibility

Spoiler

v1.0-Beta2

• ✅ Configuration-driven government system (5 types)
• ✅ Custom effects (speed boost, particle effects)
• ✅ Multi-database support (SQLite / MySQL / MongoDB)
• ✅ Season system (12 sub-seasons)
• ✅ Player status system (temperature, hydration, profession)
• ✅ PlaceholderAPI integration

v1.0-Beta1

• ✅ Nation member and role system
• ✅ Nation taxation system
• ✅ Nation diplomacy system
• ✅ SQLite data persistence

---

Contributor

ian171: Github

Serendisand: Github