Towny

Towny is a Minecraft Java plugin that lets players create organized communities called towns and nations, moving beyond solo play. It uses a system of residents, towns, and nations to manage land ownership and permissions, encouraging teamwork and providing land protection.

Players become residents of towns and can buy land plots within them. They control who can interact with their land. Towns can join together to form larger nations. A key benefit of towns is protection from mobs, PvP (depending on settings), fire, explosions, and griefing, creating a safer environment.

Understanding Residents (individual players in Towny), Towns (settlements formed by residents with a Mayor), and Townblocks (16x16 land units towns claim, which also align to Minecraft chunks) is crucial.

Joining or creating a town offers benefits like protection from threats, a sense of community through collaboration and trade, the ability to own land within the town, access to shared resources like farms and shops, and a town spawn point for easy teleportation. This provides security and a more structured gameplay.

However, it's very important to know that starting your own town is a significant undertaking with a substantial upfront in-game cost, typically at least $500. For most players, it's highly recommended to consider joining an existing town first. This allows you to immediately enjoy the benefits of Towny's protection and community without the initial financial burden and management responsibilities of founding a new settlement.

Firstly, you do not need to become a mayor. To do it properly and lead a small group of players requires some level of work, and it is perfectly reasonable to join an existing town. Though, if you don't want to be forced to build near other players, there are benefits ot creating a town consisting of just yourself, most importantly is protection of your builds from strangers. 

To become a Towny mayor and start a town, you first need find an unclaimed wilderness area (towns can't be made in other towns' land). Once you have a location, creating your town is easy. Stand where you want the center, then type /t new [townname] or /t create [townname] (like /t new Eldoria). After paying the in-game money cost, your town is created, and you're the mayor.

As mayor, immediately set your town's homeblock and spawn. At the center, type /t set homeblock. Then, at the exact spot for the spawn, type /t set spawn. Your town starts with this one block. To get more land, stand next to your town's land in unclaimed wilderness and type /t claim. Each new plot has a cost assiciated with claiming. Also, set initial permissions using /t set perm [resident/ally/outsider] [build/destroy/switch/itemuse] [on/off] (e.g., /t set perm outsider build off). Defaults should work fine, though. Finally, set a welcome message with /t set board [your message] (e.g., /t set board Welcome to Eldoria!). These steps are key for your town's basic functions and security.

• /t new [townname] Creates a new town with the specified name.

• /t set homeblock Sets the current location as the town's homeblock and spawn location.

• /t set spawn Sets the specific town spawn point within the homeblock.

• /t claim: Claims the adjacent wilderness chunk for the town.

• /t set perm... Configures basic permissions for the town's unowned plots.

• /t set board [message] Sets a welcome message for town residents.

As a Towny mayor, you have many commands to manage your town's identity, land, residents, finances, and settings.

Town Setup and Information:

• /t set name [newname] Changes the town's name.

• /t set tag [newtag] Changes the town's tag,  a shortened version of the name which appears in players' chats.

• /t set board [message] Sets a message shown to residents.

• /t set board none Removes the town board message.

• /t here Shows info about the current town.

• /t [townname] Shows info about a specific town.

• /t Shows info about your town.

Expanding Your Territory: Claiming and Unclaiming Land:

• /t claim Claims the adjacent wilderness chunk you're standing in.

• /t claim outpost Claims a further outpost.

• /t claim [radius] Claims multiple chunks in a radius.

• /t claim auto Automatically claims adjacent chunks (if you have funds/bonus blocks).

• /t unclaim Unclaims the chunk you're standing in.

• /t unclaim all Unclaims all your town's land (use with caution!).

• /t unclaim [radius] Unclaims chunks in a radius.

• /t buy bonus [number] Buys extra claimable townblocks.

Keeping the Town Running: Taxes and Finances:

• /t set taxes [amount] Sets a daily tax for residents.

• /t toggle taxpercent Switches between fixed tax and percentage-based tax.

• /t set taxpercentcap [amount] Sets a maximum limit for percentage-based taxes.

• /t set plottax [amount] Sets tax for regular resident plots.

• /t set shoptax [amount] Sets tax for shop plots.

• /t set embassytax [amount] Sets tax for embassy plots.

• /t deposit [amount] Deposits money into the town bank.

• /t withdraw [amount] Withdraws money from the town bank.

• /t bankhistory Shows the town's bank transaction history.

Building Your Community: Inviting and Managing Residents:

• /t add [resident] Invites a player to join your town.

• /t invite [name] Invites a player (alternative command).

• /t invite -[name] Cancels a pending invitation.

• /t invite Lists pending invitations.

• /t kick [resident] Removes a resident from your town.

• /t reslist Lists all town residents.

• /t online Lists online town residents.

Establishing Order: Ranks and Permissions:

• /t rank add [resident][rank] Gives a rank to a resident.

• /t rank remove [resident][rank] Removes a rank from a resident.

• /t ranklist Lists residents and their ranks.

• /t set perm [resident/ally/outsider] [build/destroy/switch/itemuse] [on/off] Sets default permissions for unowned town plots.

• /t set perm reset Resets plot permissions to town defaults.

• /t trust add [playername] Gives a player full permissions in your town.

• /t trust remove [playername] Revokes full permissions from a player.

Defining Your Space: Managing Town Plots:

• /plot set [type] Sets the type of the plot you're standing on (e.g., shop, farm).

• /plot forsale [price] Puts the plot you're on up for sale.

• /plot notforsale Takes the plot you're on off the market.

• /plot set perm [resident/ally/outsider] [build/destroy/switch/itemuse] [on/off] Sets specific permissions for the current plot.

• /plot clear Clears custom permissions and LWC locks from the plot.

• /t plotgrouplist Lists existing plot groups.

• /t plotgroup add [name] Adds the current plot to a group (creates it if needed).

• /t plotgroup rename [new name] Renames a plot group.

• /t plotgroup remove Removes the current plot from its group.

• /t plotgroup delete Deletes a plot group and removes associated plots.

• /t plotgroup forsale [price] Sets all plots in a group for sale.

• /t plotgroup notforsale Removes all plots in a group from sale.

• /t plotgroup set [plot type] Sets the plot type for all plots in a group.

• /t plotgroup set reset Resets the plot type for all plots in a group.

• /t plotgroup toggle [toggle type] Configures toggles for a plot group.

• /t plotgroup set perm ..., /t plotgroup perm add ..., /t plotgroup perm gui ..., /t plotgroup perm remove ..., /t plotgroup trust add ..., /t plotgroup trust remove ...:Commands for managing permissions and trust within plot groups.

Essential Town Settings:

• /t set homeblock Sets the current location as the town's homeblock.

• /t set spawn Sets the town's spawn point within the homeblock.

• /t set spawncost [price] Sets a cost for non-residents to teleport to your spawn.

• /t toggle pvp Toggles player-versus-player combat in town.

• /t toggle fire Toggles fire spread in town.

• /t toggle mobs Toggles hostile mob spawning in town.

• /t toggle explosions Toggles explosions in town.

• /t toggle public Toggles whether town info and spawn are public.

• /t toggle open Toggles whether players can join without an invite.

• /t toggle taxpercent Switches between fixed and percentage-based taxes (same as /t toggle taxpercent).

Other Mayor Actions:

• /t set mayor [resident] Transfers mayoral status to another resident.

• /t delete Starts the process of deleting your town (requires /confirm).

Once your town is well-established, you can create a nation.

1. Creating Your Nation

• Requirements: Only the Mayor of a town can create a nation. Your town will become the nation's capital.

• Cost: Creating a nation costs money. Check the price with /towny prices. Ensure your town bank has enough funds (/t deposit <amount>).

• Create: Stand in your town's homeblock and type: /n new <yournationname>

2. Managing Your Nation

• Nation Bank: Similar to towns, nations have a bank.

  • Deposit: /n deposit <amount>

  • Withdraw (King only): /n withdraw <amount>

• Inviting Towns: Invite other towns to join your nation.

  • Invite: /n add <townname>

  • Towns accept with: /t invite accept <yournationname>

  • Nation Range: Invited towns typically need to be within a certain radius of your capital. This range can be extended by other towns joining the nation.

• Kicking Towns: Remove a town from your nation: /n kick <townname>

• Nation Ranks: Grant special permissions to nation members.

  • Add Rank: /n rank add <playername> <rankname>

  • Remove Rank: /n rank remove <playername> <rankname>

  • Some common nation ranks:

    • Chancellor: Almost full power, but cannot delete the nation or change the King/Capital. Exercise caution when giving this rank!

    • Colonist: May invite towns to the nation.

    • Diplomat: Can send, accept, and deny nation ally requests.

• Setting Nation Spawn: Set a spawn point for your nation, usually within your capital town. /n set spawn Nation members can then use /n spawn to teleport there.

• Allies and Enemies: Define your nation's diplomatic relationships.

  • Ally another nation: /n ally add <nationname>

  • Remove an ally: /n ally remove <nationname>

  • Declare an enemy: /n enemy add <nationname>

  • Remove an enemy: /n enemy remove <nationname>

• Nation Taxes: You can set taxes on the towns within your nation. This money goes into the nation bank. /n set taxes <amount>

• Nation Board: Set a message that nation members see upon logging in. /n set board <message>

• Nation Tag: Set a short tag that can appear in chat. /n tag <up_to_4_characters>

• Nation Chat: Communicate with your nation members:

  • Enter nation chat: /nc

  • Speak once in nation chat: /nc <message>

• Toggle Open: Allow towns to join your nation without an invite. /n toggle open

• Transferring Leadership: As King, you can transfer your position to another resident. /n set king <playername>

• Deleting Your Nation: Use with extreme caution, as this dissolves the entire nation. /n delete

Useful General Towny Commands

• /towny map: Shows a map of nearby claimed chunks.

• /res toggle plotborder or F3 + G: Shows chunk borders to help with claiming.

• /towny prices: Shows the costs of various Towny actions.

• /towny time: Shows the time until the next Towny daily upkeep collection.

• /t list: Lists all towns.

• /n list: Lists all nations.

• /res: View your own resident information.

• /t: View your own town's information.

• /n: View your own nation's information.

Joining a town lets you collaborate and belong. If a town is open, use /t join [townname]. If invited, use /invite accept [town name] or /accept [town name]. See pending invites with /t invite received or /invite list.

As a resident, you can claim personal plots with /plot claim (may cost). Unclaim with /plot unclaim (remove everything first!). Some servers have /plot unclaim circle/rect or /plot unclaim [radius] for multiple plots.

Contribute to the town by depositing money with /t deposit [amount]. Stay informed with /t here (your town info) or /t [townname] (other town info). Learn about residents with /res (your info) or /res [name] (other resident info).

Communicate in town chat with /tc [message] or just /tc to enter the channel. Set your town spawn with /res set spawn (useful if beds are limited). Manage trusted friends for plot access with /res friend add [name] (online), /res friend remove [name] (online), /res friend add+ [name] (offline), /res friend remove+ [name] (offline), and clear all with /res friend clearlist. Toggle a live map of town borders with /res toggle map, plot borders with /res toggle plotborder, and turn off toggles with /res toggle reset.

• Joining a Town /t join [townname], /invite accept [town name], /accept [town name]

• Managing Personal Plots /plot claim, /plot unclaim, /plot unclaim circle/rect, /plot unclaim [radius]

• Paying Town Taxes /t deposit [amount]

• Viewing Town Information /t here, /t [townname]

• Viewing Resident Information /res, /res [name]

• Sending Town Messages /tc [message]

• Setting Home Location /res set spawn

• Managing Friends /res friend add [name], /res friend remove [name], /res friend add+ [name], /res friend remove+ [name], /res friend clearlist

• Map Toggles /res toggle map, /res toggle plotborder, /res toggle constantplotborder, /res toggle reset

All players can use these Towny commands:

• /towny Shows basic Towny commands.

• /towny? or /towny help Shows a comprehensive list of commands.

• /towny universe Displays server-wide Towny statistics (residents, towns, nations, claimed land).

• /towny version or /towny v Shows the Towny plugin version.

Keep track of the economy:

• /towny time Shows time until the next Towny "new day" (tax/upkeep collection).

• /towny prices Shows costs for Towny actions and your daily taxes.

• /towny prices [town name] Shows prices for another town.

Navigate with maps:

• /towny map Shows a small area map in chat.

• /towny map big Shows a larger area map.

• /towny map hud (If available) Shows a live map on your scoreboard.

See top players and towns:

• /towny top residents [all/town/nation] Shows top residents.

• /towny top land [all/resident/town] Shows top land owners.

• /towny top balance [all/nation/town] Shows towns/nations with the most money.

To enjoy Towny, communicate and be respectful in town chat. Learn and follow your town's rules. Contribute to your town through projects, taxes, and being helpful.

Mayors should plan their town, set fair taxes/permissions, use ranks to delegate, keep residents informed, and watch the town bank. Towns have daily upkeep; going into debt can lead to disbandment. Inactive towns may be deleted.

To learn more about Towny, check server rules/guides, official documentation/wikis, community forums/Discord, and YouTube tutorials. Engage with the system to become a skilled player.