Overview#
TekTopia is a massive overhaul of the Minecraft villager system for version 1.12.2, created by TangoTek. Unlike vanilla villagers, TekTopia villagers are highly intelligent, possess unique professions, and operate within a complex social and economic ecosystem. Players act as the mayor, designing the layout of the town, managing resources, and protecting the citizens from unique threats like the Necromancer.
The mod replaces the standard villager AI with a goal-oriented system where villagers have needs such as hunger, sleep, and happiness. They perform tasks autonomously, such as farming, mining, and crafting, and transport their products to a centralized storage system.
Getting Started#
To begin your journey in TekTopia, you must first establish a Town Hall. This is the heart of your village and the point from which all expansion begins.
- Craft a Town Hall Token: This is the first item you need. It requires a book, an emerald, and gold ingots.
- Locate a Structure: Find or build a suitable room. A structure must be an enclosed space with a door.
- Place the Token: Shift-right-click the Town Hall Token onto a door to transform the room into your Town Hall.
- The Architect and Tradesman: Once the Town Hall is placed, an Architect and a Tradesman will arrive. The Architect sells structure tokens, while the Tradesman sells profession tokens and basic supplies.
Initial Requirements
Before your villagers can work effectively, you must provide:
- Storage: A designated room with chests where villagers will drop off and pick up items.
- Homes: Rooms with beds where villagers can sleep to recover energy and happiness.
- Food: A supply of food in the storage chests to prevent starvation.
Villager Professions#
Villagers in TekTopia are defined by their professions. Each villager has a skill level (1-100) in their specific field, which increases as they perform tasks. Higher skill levels result in faster work and better yields.
| Profession | Primary Task | Key Tool |
|---|---|---|
| Architect | Sells structure tokens to expand the village. | None |
| Bard | Plays music to increase the happiness of nearby villagers. | Instrument |
| Blacksmith | Repairs tools and crafts metal equipment. | Hammer |
| Butcher | Slaughters livestock for meat and leather. | Axe |
| Chef | Cooks raw food into high-quality meals. | Pot/Pan |
| Cleric | Heals injured villagers and provides buffs. | Potion |
| Druid | Accelerates the growth of crops and trees. | Staff |
| Enchanter | Enchants tools and books for the village. | Enchanting Table |
| Farmer | Plants and harvests crops. | Hoe |
| Guard | Patrols the village and attacks hostile mobs. | Sword/Shield |
| Lumberjack | Chops down trees and collects wood. | Axe |
| Miner | Digs for ores and stone in the mineshaft. | Pickaxe |
| Nitwit | Has no profession but can be trained into any role. | None |
| Rancher | Breeds and shears animals. | Wheat/Shears |
| Teacher | Increases the Intelligence of children in the school. | Book |
| Tradesman | Sells profession tokens and buys village goods. | None |
Villager Growth
- Children: Children are born when two villagers are happy and have a home. They spend their time playing or attending school.
- Intelligence: This stat determines how quickly a villager gains skill points. It can be increased by a Teacher in a School.
Structures#
Structures are the functional buildings of your village. Each structure is defined by a Structure Token placed on a door.
Essential Structures
- Town Hall: The central hub. Contains the village manifest and allows for the recruitment of new villagers.
- Storage: The most critical structure. Villagers will only interact with chests placed inside a designated Storage room.
- Homes: Categorized by size (2-bed, 4-bed, 6-bed). Villagers require a bed to maintain happiness.
Work Structures
- Mineshaft: A specialized structure that allows Miners to generate ores and stone.
- Smithy: Where the Blacksmith works to repair tools.
- Kitchen: Required for the Chef to prepare advanced meals.
- School: Where the Teacher instructs children to increase their Intelligence.
- Guard Post: Defines patrol routes for Guards.
- Merchant Stall: A location where the traveling Merchant will visit to trade rare items.
Mechanics#
TekTopia villagers are driven by several internal stats that dictate their behavior and efficiency.
Hunger
Villagers must eat daily. They will seek out food in the Storage room. If they cannot find food, they will lose health and eventually die. Higher quality food (cooked by a Chef) provides more saturation.
Happiness
Happiness is affected by sleeping in a bed, eating good food, and listening to a Bard. Low happiness causes villagers to work slowly or even go on strike. High happiness increases movement and work speed.
Intelligence and Skill
- Intelligence: A base stat (0-100) that acts as a multiplier for skill gain.
- Skill: A profession-specific stat (0-100). A level 100 Miner is significantly faster than a level 1 Miner.
Economy
The village operates on Emeralds. You earn emeralds by selling items to the Tradesman or the traveling Merchant. These emeralds are then used to purchase new Profession and Structure tokens.
Visitors and Threats#
Not everyone in your village is a permanent resident. Various entities will visit throughout the lunar cycle.
Friendly Visitors
- Nomad: A wandering villager who wishes to join your town. You can recruit them at the Town Hall if you have a spare bed.
- Merchant: Arrives periodically to sell rare items, such as high-tier tools and unique tokens, in exchange for emeralds.
Hostile Threats
- The Necromancer: A powerful boss-like entity that spawns at night. He summons waves of zombies to attack the village. If he reaches the Town Hall, he can cause significant damage to the village's population.
Items and Crafting#
Most TekTopia items are obtained through the Tradesman or Architect, but the initial items must be crafted.
| Item | Recipe Components | Purpose |
|---|---|---|
| Town Hall Token | 1x Book, 1x Emerald, 4x Gold Ingot | Starts a new village. |
| Structure Frame | 4x Sticks, 4x Planks | Used to define the boundaries of a structure. |
| Villager Toolset | Varies (Iron/Diamond) | Specialized tools for villagers (e.g., Butcher's Cleaver). |
The Village Manifest
Found inside the Town Hall, the Manifest is a book that lists every villager, their current stats, their location, and the status of all structures in the village. It is the primary tool for village management.
Commands#
For administrators and creative testing, TekTopia includes several commands:
/tektopia help: Displays a list of available commands./tektopia village: Provides detailed information about the current village at the player's location./tektopia debug: Toggles debug overlays for villager AI paths and structure boundaries./tektopia spawn <profession>: Spawns a specific villager type (requires cheats enabled).
