Help and FAQ

Something not working? Check here first. Most problems are a building that didn't register or villagers missing something they need.

Common questions

My token doesn't glow

Then the building didn't register. Look in chat, there's always a message saying why. Find it in the list further down this page. The most common causes are a frame too far from the door, a hole in the wall or roof, or no way for villagers to walk there from the Town Hall.

My villagers just stand around

Check these in order:

• Do they have a job? Jobless villagers mostly wander.
• Is there food in the Storage chests? Very hungry villagers stop working.
• Does their building have what the job needs? A cook needs a heat source and a crafting table, a blacksmith needs an anvil and a furnace, and so on.
• Do they have the right tool? Look at their screen. Farmers and lumberjacks can make a wooden one if storage has a crafting table and wood.
• Is it evening? Work stops around 6 pm.

The farmer ignores my field

A field needs at least one planted crop or 3 farmland blocks, and it has to be inside the village border. See the Farms page.

My field keeps getting bigger

That's on purpose, farmers expand fields. Put a fence, path or any block around it. Remember the corners.

The Mayor won't take my emeralds

The Mayor only takes emeralds your village earned (they show your village's name in green). Normal emeralds don't work. Sell goods to the travelling merchant through a Tradesman to earn them.

My token says it belongs to another village

Tokens only work in the village they were bought in. Use it back in its own village.

My village paused

The Town Hall token left its frame. Put it back, or talk to the Mayor and buy a new one for 2 emeralds (or 8 logs and a crafting table).

No babies are being born

Two happy, well fed adults need to sleep in the same house, there needs to be enough food in storage, and the village needs more beds than villagers. It also doesn't happen every night. Check that births aren't turned off in the Mayor's settings.

Can I see what everyone is doing?

If you have cheats on, type /villagerstatus on to show names and what each villager is up to above their heads. The Mayor's Village Info tab also lists everyone.

Villagers look blocky

There's a Villager limbs setting (Smooth or Blocky) in the Mayor's settings under Just for you. It only changes how they look for you.

Building error messages

When a building doesn't register, chat tells you why. Here's what each message means and how to fix it.

Any building

• This token belongs to a different Town Hall: it was bought in another village.
• This token is outside its Town Hall's village: move it closer to the Town Hall, inside the border.
• Village paths are unavailable right now: give it a moment and try again.
• This village already has a Town Hall: only one per village.

Rooms

• No door was found beside the token: move the frame right above or next to the door.
• There is no ceiling above the entrance: the block above the inside of the door needs a roof.
• Villagers cannot stand on the floor just inside the door: put a solid floor block there.
• The entrance needs two clear blocks of headroom: clear the space just inside the door.
• The floor just inside the door is an unsafe ledge: there's a drop right inside. Fill it in.
• Villagers cannot reach it from the Town Hall: build a path they can walk on.
• The room is not enclosed: there's a hole somewhere in the walls or roof. Check corners, behind furniture and under the roof edge.
• The room scan exceeded its size limit: the room is too big (or open). Split it into smaller rooms.
• No room belongs to this door: another building's door is closer to that floor. Check nearby tokens.

Ranch and outdoor Archery Range

• No fence gate was found beside the token: hang the token on the fence right next to the gate.
• Villagers cannot stand just inside the gate: clear the spot inside the gate.
• The fenced area is not enclosed: there's a gap in the fence. Check the corners.
• The fenced area exceeds the 512 tile limit: make the pen smaller.
• Villagers cannot reach the outside of its gate, or cannot pass into the fenced area, or no reachable place to stand inside: make sure villagers can walk up to the gate and into the pen.

Mine, Merchant Stall, Guard Post, Watchtower

• Mine: no reachable place to stand at the mine entrance: the miner needs a spot to stand in front of the token.
• Merchant Stall: only X of the 6 reachable tiles needed: clear more walkable space in front of the token.
• Guard Post: cannot reach a patrol position: put it somewhere villagers can walk to.
• Watchtower: no floor within 3 blocks of the token: put the token on the platform itself.
• Watchtower: villagers cannot get up to the platform: add a ladder or stairs.
• Watchtower: the platform is only X blocks above the ground: it needs to be at least 5 blocks up.

Still stuck?

Ask on the mod's page or community and include a screenshot of the chat message and of the building. It makes helping a lot easier.

Written by easykill. Original page on Google Sites.