> For the complete documentation index, see [llms.txt](https://info.unitedlands.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://info.unitedlands.net/gameplay-mechanics/towny/upkeep.md).

# Upkeep

Introduction

Upkeep on United Lands is different from every other server! We have a hand crafted algorithm that considers many more factors than just size. This allows for a more dynamic town borders and a deeper gameplay experience.

### Maintaining Upkeep

As is known, towns cost 8,000G to found and it requires an additional amount of money every real-life day (taken at 12:00 UTC). To ensure there is money in the town bank for upkeep to be taken out of, deposit money with `/t deposit [Amount]`, you can later withdraw that money with `/t withdraw [Amount]` - these commands can be done in either a home or bank plot. 

You can see your upkeep in the `/t` screen. The time until the next upkeep can be checked with `/towny time`. 

<figure><img src="/files/X4XfyRvBzIq6kpsVWEa7" alt=""><figcaption><p>Non-discounted upkeep is shown with a strikethrough, your real upkeep is highlighted in yellow.</p></figcaption></figure>

### Failing Upkeep

If a town fails to pay it's upkeep it is put in a **ruined state**. In this state it cannot function like a normal town, but still exists. Any resident can reclaim the town for 8,000G and return it to normal. If a town is not reclaimed after 72 hours it is deleted.&#x20;

{% hint style="warning" %}
Ruined towns are able to be raided, and locks do not work inside them.
{% endhint %}

&#x20;For every chunk of land claimed with `/t claim` **16G** is added to your upkeep per day, it costs 48G to claim 1 chunk. For every **25 chunks** your town owns the total upkeep is *increased* by **20%**. To offset this, the total upkeep is *decreased* by **20%** for every **2 residents** in the town. This means towns with a good land to resident balance will be able to expand a lot quicker and cheaper than towns that don't.&#x20;

### Calculating Upkeep

Below is a **simplified** version of how upkeep is calculated. You can use this as a reference point to understand where we get our numbers from.&#x20;

For every chunk of land claimed with `/t claim`, 6G is added to your upkeep per day, it costs 48G to claim one chunk. For every 25 chunks your town owns the total upkeep is increased by an additional 10%. For every 2 residents in the town overall upkeep is decreased by 40%. Therefore, it is best to keep a good land and resident ratio to be able to expand faster and cheaper than others.&#x20;

<pre class="language-yaml"><code class="lang-yaml"><strong># These variables are the same for both town and nation upkeep calculations. 
</strong><strong>upkeepVariables:
</strong>  # The base upkeep price per plot in which all calculations are based off. 
  baseUpkeepPrice: 6
<strong>  # The amount of claims that the upkeep percentage increases at.
</strong>  riseAt: 25
  # The amount that the upkeep decreases it (residents). If set to 2, then every 2 residents the upkeep will decrease by 0.04 or as configured above
  fallAt: 2
  # The percentage that the upkeep increases by when a town reaches the plot amount in riseAt.
  riseStep: 0.10
  # The percentage that the upkeep decreases by everytime a town reaches the required amount of residents in fallAt.
  fallStep: 0.40

<strong># Multipliers are added at the end of a town calculations and will decrease the final upkeep by the designated amount dependant on power status and/or territorial war toggles.
</strong>Multipliers:
  # Multipliers that effect town upkeep, all in percents. 
  town:
    # Towns with only a power status.
    major: 0.3
    minor: 0.6
    # Towns with a power status and territorial wars enabled.
    majorTerritorialWar: 0.1
    minorTerritorialWar: 0.4
    # Towns with only territorial wars enabled.
    territorialWar: 0.8
  # Multipliers that effect nation upkeep, all in percents. 
  nation:
    major: 0.3
    minor: 0.6

# Extremely simplified version of the upkeep calculations
upkeepCalculations:
  # Town calculation
  town:
  - (((upkeep per claim) * (town claim count - town bonus claims)) * (rise mod / fall mod) - (nation discount)) * (modifiers)
  # Nation calculation
  nation:
  - (1 / number of towns) * ((base nation upkeep) * (rise mod / fall mod)) * (nation claim count) * (modifiers)
</code></pre>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://info.unitedlands.net/gameplay-mechanics/towny/upkeep.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.