Town, Nation, and Plot Management

Category: Plugin

Towny Plugin: Town/Nation/Plot Management Commands

#

This is a large-scale plugin that includes extensive town and nation management, land protection, and economic systems.

/towny (General Information/Settings)

#

  • /towny allowedblocks: View a list of blocks allowed in specific plot types.
  • /towny itemuse: View a list of items allowed in specific plot types.
  • /towny map: Display a map of surrounding chunk types.
    • big: Display a larger map.
  • /towny menu: Display the GUI menu.
  • /towny plotclearblocks: Display a list of blocks that will be removed by /plot clear.
  • /towny prices: Display the cost for town creation and claiming chunks.
  • /towny spy (admin): Receive private chat content from other nations.
  • /towny switches: View a list of interactive blocks allowed in specific plot types.
  • /towny time: Display real-world time until upkeep is collected.
  • /towny universe: Display plugin information, etc.
  • /towny v (version): Display the plugin version.
  • /towny wildsblocks: Display a list of blocks that can be used in unclaimed land.

/town (t): Town-related Commands

#

  • /town add (Not Usable): Add a player to the town.
  • /town allylist: Display a list of allied nations.
  • /town baltop <town name>: Display the top players by balance in a specific town.
  • /town ban (outlaw) {add | remove} {player name}: Manage players banned from joining the town.
  • /town bankhistory: Display bank transaction history.
  • /town buy (Not Usable): Increase land claim limit.
  • /town buytown: Purchase a town that is for sale.
  • /town cede plot {town name}: Transfer the current chunk to another town.
  • /town claim: Claim land.
    • <auto>: Claim all surrounding land possible.
    • <circle> (Not Usable): Unknown.
    • <fill>: Claim all land within the selected plots.
    • <outpost> (Not Usable): Claim as an outpost.
    • <rect> (Not Usable): Unknown.
  • /town create {town name}: Create a town.
  • /town delete: Delete the town.
  • /town deposit {amount}: Deposit money into the bank.
  • /town enemylist: Display a list of enemy nations.
  • /town forsale (fs) {amount}: Put the town up for sale for the specified amount.
  • /town here: Display information about the town you belong to.
  • /town invite: Commands related to town invitations.
    • {player}: Invite a player to the town.
    • -{player}: Cancel an invitation sent to a player.
    • sent: Display a list of sent invitations.
      • removeall: Cancel all sent invitations.
    • received: Display a list of received invitations.
    • accept {town name}: Accept an invitation from a specific town.
    • deny {town name}: Decline an invitation from a specific town.
  • /town jail: Manage jails.
    • list: Display a list of town jails.
    • {player name}: Imprison a specific player in jail.
      • <time>: Imprison for a specific duration.
        • <number>: Imprison in a specific jail.
          • <number>: Imprison in a specific cell.
  • /town join {town name}: Join a town that does not require an invitation.
  • /town kick {player name}: Kick a specific player from the town.
  • /town leave: Leave the town you belong to.
  • /town list: Display a list of towns on the server.
    • by balance <page number>: Display by bank balance.
    • by bankrupt <page number> (Not Usable): Display by resident count, prioritizing bankrupt towns.
    • by founded <page number>: Display by oldest founded date.
    • by name <page number>: Display by name.
    • by online <page number>: Display by current online player count.
    • by open <page number>: Display by resident count, prioritizing towns that anyone can join.
    • by public <page number>: Display by resident count, prioritizing towns set to public.
    • by residents <page number>: Display by resident count.
    • by ruined <page number>: Display by resident count, prioritizing ruined towns.
    • by townblocks <page number>: Display by number of claimed townblocks.
    • by upkeep <page number>: Display by lowest upkeep cost.
  • /town menu: Display the GUI menu.
  • /town merge {town name}: Merge with another town.
  • /town new {town name}: Create a town.
  • /town nfs (notforsale): Withdraw the town from sale.
  • /town online <town name>: Display online players within the town.
  • /town outlawlist <town name>: Display a list of players banned from joining the town.
  • /town outpost (Not Usable): Manage outposts.
  • /town plotgrouplist: Display a list of chunks for sale to town residents.
  • /town plots: Display statistical information about town chunks.
  • /town purge {days}: Kick players who have not logged in for a certain period.
  • /town rank {add | remove} {player name} {rank}: Grant ranks (permissions) to town residents.
  • /town ranklist: Display a list of which ranks are assigned to town residents.
  • /town reclaim: Reclaim chunks that have been abandoned due to town collapse.
  • /town reslist: Display a list of town residents.
  • /town say {message}: Send a message to all online town residents.
  • /town set: Change various town settings.
    • board {message}: Set the message displayed when town residents log in.
    • embassyprice {price}: Set the price of an embassy.
    • embassytax {price}: Set the upkeep cost for an embassy.
    • homeblock: Set the home chunk.
    • mapcolor {color}: Change the color displayed on Dynmap.
    • mayor {player}: Transfer mayorship to another player.
    • name {town name}: Change the town name.
    • outpost (Not Usable): Manage outpost operations.
    • perm: Manage permissions.
      • {on | off}: Toggle all permissions for all players.
      • {destroy | build | itemuse | switch} {on | off}: Toggle specific permissions for all players.
      • {resident | nation | ally | friend | outsider} {on | off}: Toggle all permissions for specific player types.
      • {resident | nation | ally | friend | outsider} {destroy | build | itemuse | switch} {on | off}: Toggle specific permissions for specific player types.
      • reset: Reset permissions.
    • plotprice {amount}: Set the price of chunks for sale to town residents.
    • plottax {amount}: Set the upkeep cost for chunks sold to town residents.
    • primaryjail: Specify the default jail to use.
    • shopprice {amount}: Set the default cost of town shop chunks.
    • shoptax {amount}: Set the tax collected from players owning town shop chunks.
    • spawn: Set the town spawn point.
    • spawncost {amount}: Set the cost to spawn to the town (max 0.0).
    • surname {player} {string}: Add an arbitrary string after a player's name.
    • tag {string | clear}: Set a tag for the town.
    • taxes {tax rate}: Set the daily tax collected from town residents.
    • taxpercentcap {amount}: Set the daily tax collected from town residents.
    • title {player} {string}: Add an arbitrary string before a player's name.
  • /town spawn <town name>: Teleport to a specific town.
  • /town takeoverclaim (Not Usable): Reclaim land from towns that have exceeded their claim limit.
  • /town toggle: Toggle town settings.
    • explosion: Toggle explosion allowance.
    • fire: Toggle fire spread allowance.
    • mobs: Toggle mob spawning allowance.
    • nationzone (Not Usable): Toggle enablement/disablement of protected areas outside the town.
    • neutral: Toggle pacifism.
    • open: Toggle public setting. If public, anyone can join the town without an invitation.
    • peaceful: Toggle pacifism.
    • public: Toggle public setting. If public, anyone can teleport to the town's spawn point.
    • pvp: Toggle PvP allowance.
    • taxpercent: Toggle set tax by amount/rate.
    • trust: Manage trusted players. Trusted players can manipulate blocks within the town regardless of their nation affiliation.
      • {add | remove} {player}: Add/remove trusted players.
      • list: Display a list of trusted players.
    • trusttown: Toggle trusted towns.
      • {add | remove} {town name}: Add/remove trusted towns.
      • list: Display a list of trusted towns.
  • /town unclaim: Unclaim claimed land.
    • <all>: Unclaim all land.
  • /town unjail {player}: Release an imprisoned player from jail.
  • /town withdraw {amount}: Withdraw money from the bank.

/nation (n): Nation-related Commands

#

  • /nation add (Not Usable): Invite a town to the nation.
  • /nation ally: Set alliance relations.
    • {nation name}: Invite a nation to an alliance.
    • -{nation name}: Cancel an invitation sent to a nation.
    • sent: Display a list of sent invitations.
      • removeall: Cancel all sent invitations.
    • received: Display a list of received invitations.
    • accept {nation name}: Accept an invitation from a specific nation.
    • deny {nation name}: Decline an invitation from a specific nation.
  • /nation allylist: Display a list of allied nations.
  • /nation baltop <nation name>: Display the top players by balance in a specific nation.
  • /nation bankhistory: Display bank transaction history.
  • /nation create (new) {nation name}: Create a nation.
  • /nation delete: Delete the nation.
  • /nation deposit {amount}: Deposit money into the bank.
  • /nation enemy {nation name}: Designate an enemy nation.
  • /nation enemylist: Display a list of enemy nations.
  • /nation invite: Invite a town to the nation.
    • {town name}: Send an invitation to a town to join the nation.
    • -{town name}: Cancel an invitation sent to a town.
    • sent: Display a list of invitations sent to towns.
  • /nation join {nation name}: Have a town join a nation.
  • /nation kick {town name}: Expel a town from the nation.
  • /nation king (leader): Display help for the nation leader.
  • /nation leave: Have a town leave the nation.
  • /nation list: Display a list of nations on the server.
    • by balance <page number>: Display by bank balance.
    • by bankrupt <page number> (Not Usable): Display by resident count, prioritizing bankrupt nations.
    • by name <page number>: Display by name.
    • by online <page number>: Display by current online player count.
    • by open <page number>: Display by resident count, prioritizing nations that any town can join.
    • by public <page number>: Display by resident count, prioritizing nations set to public.
    • by residents <page number>: Display by resident count.
    • by ruined <page number>: Display by resident count, prioritizing ruined nations.
    • by townblocks <page number>: Display by number of claimed townblocks.
    • by town <page number>: Display by number of affiliated towns.
    • by upkeep <page number>: Display by lowest upkeep cost.
  • /nation menu: Display the GUI menu.
  • /nation merge {nation name}: Merge with another nation.
  • /nation online <nation name>: Display online players within the nation.
  • /nation rank {add | remove} {player name} {rank}: Grant ranks (permissions) to citizens.
  • /nation ranklist: Display a list of which ranks are assigned to citizens.
  • /nation sanctiontown: Manage sanctioned towns.
    • add {town name}: Add a town to the sanction list.
    • remove {town name}: Remove a town from the sanction list.
    • list <nation name>: Display a list of sanctioned towns.
  • /nation say {message}: Send a message to all online citizens.
  • /nation set: Change various nation settings.
    • board {message}: Set the message displayed when citizens log in.
    • capital {town name}: Change the nation's capital.
    • conqueredtax {amount}: Set the daily tax imposed on enemy nations if your nation wins a war.
    • king (leader): Transfer nation leadership to another player.
    • mapcolor {color}: Change the color displayed on Dynmap.
    • name {nation name}: Change the nation name.
    • spawn: Set the town spawn point.
    • spawncost {amount}: Set the cost to spawn to the nation (max 0.0).
    • surname {player} {string}: Add an arbitrary string after a player's name.
    • tag {string | clear}: Set a tag for the nation.
    • taxes {tax rate}: Set the daily tax collected from citizens.
    • taxpercentcap {amount}: Set the daily tax collected from citizens.
    • title {player} {string}: Add an arbitrary string before a player's name.
  • /nation spawn <nation name>: Teleport to a specific nation.
  • /nation toggle: Toggle nation settings.
    • neutral (peaceful): Toggle pacifism.
    • open: Allow towns to freely join the nation.
    • public: Allow everyone to teleport to the town's spawn point.
    • taxpercent: Toggle set tax by amount/rate.
  • /nation townlist: Display a list of towns belonging to the nation.

/resident (res): Individual Settings/Information

#

  • /resident friend: Manage friends.
    • add {player}: Add a friend.
    • clear: Remove all friends.
    • list: Display a list of friends.
    • remove {player}: Remove a friend.
  • /resident jail paybail: Pay to be released from jail.
  • /resident menu: Display the GUI menu.
  • /resident outlawlist <player name>: Display a list of towns the player has been outlawed from.
  • /resident plotlist <player name>: Display a list of plots you own.
  • /resident set: Select various personal settings.
    • about {message}: Add text to your profile description.
    • mode (/res toggle): Toggle modes.
      • adminbypass (admin): Toggle the ability to disable admin features.
      • bedspawn: Prioritize bed respawn point over town spawn point.
      • bordertitles: Toggle messages displayed when moving between chunks.
      • constantplotborder: Toggle whether plot borders are always displayed.
      • explosion: Toggle explosion settings in owned chunks.
      • fire: Toggle fire spread settings in owned chunks.
      • ignoreotherchannels: Unknown.
      • ignoreplots: Toggle chunk notifications within towns.
      • infotool (admin): Toggle mode to select Bukkit names/classes of blocks and entities using a brick tool.
      • map: Turn on map that updates when moving between chunks.
      • mobs: Toggle mob spawning settings in owned chunks.
      • plotborder: Toggle whether borders are displayed when moving between chunks.
      • plotgroup: Toggle how chunks are added to plot groups.
      • pvp: Toggle PvP settings in owned chunks.
      • spy (admin): Toggle whether private chat content is displayed.
      • townborder: Unknown.
      • townclaim: Automatically claim destination when moving between chunks.
      • townunclaim: Automatically unclaim destination when moving between chunks.
    • perm: Manage permissions for owned chunks.
      • {on | off}: Toggle all permissions for all players.
      • {destroy | build | itemuse | switch} {on | off}: Toggle specific permissions for all players.
      • {resident | nation | ally | friend | outsider | town} {on | off}: Toggle all permissions for specific player types.
      • {resident | nation | ally | friend | outsider | town} {destroy | build | itemuse | switch} {on | off}: Toggle specific permissions for specific player types.
      • reset: Reset permissions.
  • /resident spawn: Teleport to your spawn point.
  • /resident tax: Display a list of taxes you pay.

/plot: Change Specific Chunks

#

  • /plot claim: Purchase land that is for sale.
    • <auto>: Purchase all possible.
  • /plot clear (Not Usable): Unknown.
  • /plot district: Manage districts.
    • add <district name>: Add the current chunk to a district.
    • delete: Delete a district.
    • remove: Remove the current chunk from a district.
    • rename: Rename a district.
  • /plot evict: Force a specific player to unclaim ownership from their owned chunks.
  • /plot forsale (fs) <amount>: Sell a chunk to town residents.
  • /plot group:
    • {add | new |create} {group name}: Create a new plot group.
    • remove: Remove the current chunk from a plot group.
    • delete {group name}: Delete a plot group.
    • rename {group name}: Rename a plot group.
    • set {plot type}: Set the group to the specified plot type.
      • maxjoindays {days | clear}: Set the maximum join days.
      • minjoindays {days | clear}: Set the minimum join days.
      • perm:
        • {on | off}: Toggle all permissions for all players.
        • {destroy | build | itemuse | switch} {on | off}: Toggle specific permissions for all players.
        • {resident | nation | ally | friend | outsider | town} {on | off}: Toggle all permissions for specific player types.
        • {resident | nation | ally | friend | outsider | town} {destroy | build | itemuse | switch} {on | off}: Toggle specific permissions for specific player types.
        • reset: Reset permissions.
    • toggle: Toggle group settings.
      • explosion: Toggle explosion settings within the chunk.
      • fire: Toggle fire spread settings within the chunk.
      • mobs: Toggle mob spawning settings within the chunk.
      • pvp: Toggle PvP settings within the chunk.
      • taxed: Toggle whether tax is levied on the current chunk owned by an individual.
    • forsale (fs) <amount>: Sell a plot group.
    • notforsale (nfs) {plot group}: Withdraw a group from sale.
    • trust: Manage trusted players within the group.
      • {add | remove} {player}: Add/remove trusted players.
      • list: Display a list of trusted players.
    • perm: Set permissions within the group.
      • {add | remove} {player}: Add/remove players for special permissions.
      • gui: Display the GUI menu.
  • /plot info: Display information about the current chunk.
  • /plot jailcell {add | remove}: Add a cell to the current jail chunk.
  • /plot menu: Display the GUI menu.
  • /plot nsf (notforsale): Withdraw a chunk from sale.
  • /plot perm: Set chunk permissions.
    • {add | remove} {player}: Add/remove players for special permissions.
    • gui: Display the GUI menu.
    • hud (Not Usable): Display current chunk permission settings.
  • /plot set: Set the group to the specified plot type.
    • arena: Set plot type to arena.
    • bank: Set plot type to bank.
    • default (reset): Set plot type to default.
    • embassy: Set plot type to embassy.
    • farm: Set plot type to farm.
    • inn: Set plot type to inn.
    • jail: Set plot type to jail.
    • maxjoindays {days | clear}: Set the maximum join days.
    • minjoindays {days | clear}: Set the minimum join days.
    • name {name}: Set the chunk name.
    • outpost (Not Usable): Set plot type to outpost.
    • perm: Set permissions within the chunk.
      • {on | off}: Toggle all permissions for all players.
      • {destroy | build | itemuse | switch} {on | off}: Toggle specific permissions for all players.
      • {resident | nation | ally | friend | outsider | town} {on | off}: Toggle all permissions for specific player types.
      • {resident | nation | ally | friend | outsider | town} {destroy | build | itemuse | switch} {on | off}: Toggle specific permissions for specific player types.
      • reset: Reset permissions.
    • shop: Set plot type to shop.
    • wilds: Set plot type to wilds.
  • /plot toggle: Toggle chunk settings.
    • explosion: Toggle explosion settings within the chunk.
    • fire: Toggle fire spread settings within the chunk.
    • mobs: Toggle mob spawning settings within the chunk.
    • pvp: Toggle PvP settings within the chunk.
    • taxed: Toggle whether tax is levied on the current chunk owned by an individual.
    • forsale (fs) <amount>: Sell a plot group.
    • notforsale (nfs) {plot group}: Withdraw a group from sale.
    • trust: Manage trusted players within the group.
      • {add | remove} {player}: Add/remove trusted players.
      • list: Display a list of trusted players.
    • perm: Set permissions within the group.
      • {add | remove} {player}: Add/remove players for special permissions.
      • gui: Display the GUI menu.
  • /plot trust: Manage trusted players within the chunk.
    • {add | remove} {player}: Add/remove trusted players.
    • list: Display a list of trusted players.
  • /plot unclaim: Unclaim purchased land.

Towny GUI Menu Commands

#

  • /townymenu or /townmenu or /tm: Open the Town management menu.
  • /nationmenu or /nm: Open the Nation management menu.