TownTopia: Additions

TownTopia Additions is an add-on for TownTopia (see also the TownTopia Wiki). It adds tools that make running a TownTopia village easier. It's server-side: install it on the server (or in single player), and players don't need it.

Village menu: /village

A menu with buttons for everything below and for TownTopia's own commands, sorted into categories (Locator, Village information, Help, Admin, Debug). There's no need to remember commands. It shows only what you're allowed to use, and it finds new TownTopia commands automatically.

Find anything in your village

• By job: /village find farmer (or any job, or jobless). Those villagers glow for you only, with a trail to the nearest one.
• By name: /village find villager <name>. If they're in an unloaded area, it shows where they were last seen.
• Buildings: /village find building <type> outlines every building of that type.
• Free beds: /village find bed outlines empty beds and counts the villagers who have none.
• Homeless villagers: /village find homeless makes villagers without a bed glow and tells you why each one has no bed in plain words, with a fix to try. For example: the house can't be reached, every house is full, there's no free floor beside the bed, or they're stuck off the village paths.
• Hungry and starving villagers: /village find hungry and /village find starving make them glow, hungriest first, with their hunger, the food they carry and why they aren't eating.
• /village find stop turns the highlights off.

Village census: /village census

A written book about your village: people by job, children, free beds and homeless villagers, new villagers and deaths this week and last week, and what was made and used.

"While you were away", in full

TownTopia's welcome-back report shows what the village made. This add-on also shows what the villagers used, so you can see what's running short.

Alerts for the village's people

The owner, officers and friends of a village get these:

• Hunger alerts: when villagers go hungry or starve. Each starving villager is named with the likely reason: not loaded, stuck, can't reach the Kitchen, no Kitchen, no Cook, or no food in storage. Starving villagers also glow for the players warned.
• Tool alerts: when a villager can't work because it has no tool: a pickaxe for miners, an axe for lumberjacks, a sword for guards and butchers, a bow and arrows for archers.
• Raid warnings: when raiders arrive, with the direction they're coming from. One of your guards can call it out ("Raiders to the north-east! To arms!"), with a raid horn.

A busier Builder

With no build order, TownTopia's Builder only re-checks buildings. Now, between checks, it takes turns at:

• Repairs: puts back blocks monsters destroyed in the village (creepers, door-breaking zombies, endermen), using blocks from Storage.
• Tidying up: carries items lying around the village to Storage (not items players dropped).
• Lighting: puts torches from Storage on dark ground so monsters stop spawning.
• Paths: turns the grass villagers walk on most into paths, and fills holes in them.
• Grass: turns dirt from Storage into grass blocks, for builds that need lots of grass.

Your blocks, the village's blocks

Blocks you put into chests and barrels in a working Storage room become the village's, so villagers can use them. For example, the Builder's "Make Missing Blocks" can turn your oak logs into the oak stairs an order needs. Chests you lock in TownTopia's chest settings are left alone.

Livelier villages

• Cured zombie villagers inside a TownTopia village join it as TownTopia villagers (jobless, or a child). Outside a village they stay vanilla.
• Iron golems: groups of TownTopia villagers summon iron golems the way vanilla villagers do, so iron farms work again (up to 4 per village).
• Village cats: stray cats appear in TownTopia villages, as in vanilla villages.
• Stuck-villager rescue: a villager stuck for 2 minutes (inside a block, off the walkable map, or not moving while trying to walk) is sent back to the village bell. This includes the Mayor, but not during raids.
• No raids where monsters can't spawn: besides Peaceful, raids are skipped when doMobSpawning is off or in dimensions you list. A raid already under way there is called off.

Regenerating mines

• Automatic: once a village miner has dug out most of their mine, everyone inside is moved out safely and the tunnels refill with stone and ore that fits the depth, so the miner can keep working. Tunnels that run out into open air are closed in, so the miner always has a floor and walls.
• Druids: a village whose Druid has Mine Refilling on is left to the druid. If the druid is busy and the mine stays dug out for 40 minutes, it's refilled anyway.
• Admin mines: /village mine define | status | regen | remove sets up a mine area that refills once it's mostly mined out.
• More admin commands: /village mine fill <name> fills a mine completely, /village mine refill refills the village miner's tunnels now, and /village mine ores by_height | everywhere sets which ores refills use (everywhere suits sky islands).

Also

• /village guide: a fresh copy of the TownTopia Guide.
• Village tips: an occasional short tip for players standing in a village. You can edit the tips list.

Configuration

Every feature can be switched off or tuned in serverconfig/towntopia_additions-server.toml. That includes how long highlights last, the mine refill percentage, how long mines wait for a druid, how often alerts are checked, which Builder jobs run, the golem limit, which dimensions have no raids, whether raid warnings are in roleplay style, whether the horn plays, and how often tips appear.

Commands and TownTopia

This add-on uses /village and doesn't replace any TownTopia command. Every subcommand was checked against TownTopia's own so they don't clash.

Also by me

TownTopia Integrations connects TownTopia villages with maps (Diorama, Xaero's, JourneyMap), FTB Teams and Quests, Waystones, Jade, JEI, modded trees and work stations, and more.

Links

• TownTopia (the original mod, required): curseforge.com/minecraft/mc-mods/towntopia
• TownTopia Wiki: town-topia.com/wiki
• Source code: github.com/SkipperHQ/towntopia-additions
• Questions or bugs with this add-on: Discord anthony_au (profile)

Credits and disclaimer

TownTopia is made by UrEasyKill76 and Heragoga. TownTopia Additions is a fan creation. It has no affiliation with TownTopia's creators and isn't made or endorsed by them. Please report problems with this add-on here, not to the TownTopia team. It doesn't include any of TownTopia's code or assets, so you need TownTopia installed.