Skip to content
This repository was archived by the owner on Oct 28, 2025. It is now read-only.

README.md

Latest commit

 

History

History
147 lines (132 loc) · 6.64 KB

README.md

File metadata and controls

147 lines (132 loc) · 6.64 KB

TownyAddons

A mix of addons for Towny, created for EarthMC
Ideas sourced from the EMC Roadmap

Resident

Commands

  • /res onlinefriends n13vdsnf
    List online friends
  • /res outlawednations 73gti356
    List nations where you're outlawed
  • /res set wiki rco8lvuz
    Set a link for your page on the EMC Wiki!
    Visible on your /res page
  • /res trustlist yfm42d2u & qi4rma6o
    List towns you're trusted in

Features

  • Cancel Invites io6xhtf3
    Upon joining a town, all of a resident's pending invites are cancelled
    This is beneficial for both the resident and all the towns that have used up an invite

Status Screen

  • Wiki
    View a resident's linked wiki page

Town

Commands

  • /t set plotlimit zw696t2p
    Limit how many plots a resident can claim
    NOTE: Code commented out due to a Towny bug
  • /t set discord mwfxfw5n
    Set a discord for your town
    Visible on /t lookup
  • /t resetperms cln1u95x
    Completely reset a town's permissions.
    Clear town trusted, evict all plots, remove all plot trusted & permission overrides.
    Optionally specify a resident to only affect that player.
    Must add "confirm" to the end regardless
    Usage: /t resetperms {resident} confirm
  • /t log 6yy4qe9h & mj5kyw77
    List recent resident join & leave activity
  • /t toggle friendlyfire (on|off) zwipd7cj
    Toggle a town's friendlyfire allowed status.
    This stops /plot toggle pvp (issued by a resident of the town) in all chunks in the town. Only players with the bypass permission node will bypass.
  • /t list by forsale di95sjmh
    List towns from high to low forsale price
  • /ta toggle shield <town> (on|off)
    Allow server mods/admins to toggle a town's overclaimshield
    Requires overclaimshield

Features

  • Overclaim Notify nvpov4w5
    Notify a town's mayor when their town gets overclaimed. Messages are queued until mayor logs on.

Status Screen

  • Outsider spawn s16l4zd1
    Display if the town is paying for outsiders to teleport
  • Discord
    View a town's linked discord
  • Overclaims remaining yhb7jsqi
    Display how many plots the town is allowed to overclaim

Nation

Commands

  • /n set discord
    Set a discord for your nation
    Visible on /n lookup
  • /n shout 5afc1yfa
    Broadcast a global message on behalf of your nation at a set cost

Features

  • Broadcast rename 6hiljxyc
    Send a global message when a nation is renamed

Status Screen

  • Discord
    View a nation's linked discord
  • Resident count 7usd97yj
    Display how many residents the nation has
  • Nation bonus 8a3b3174
    Display a nation's nation bonus

Plot

Vault plot type oxv9whay
Upon a plot being set to Vault using /plot set vault, all members trusted in the town will get all 4 deny-permission overrides in the plot
Upon someone new being trusted in the town, all plots set to vault will also add deny-permission for the newly trusted player

DiscordSRV

Towny integration into DiscordSRV

Features Broadcast the following events on discord

  • Nation created
  • Nation disbanded
  • Town created
  • Town ruined
  • Town deleted

Config

Settings for /n shout

maxShoutChars: 128
ShoutCooldownHours: 6
ShoutPrice: 128

Settings for /res set wiki

wikiURL: "https://wiki.earthmc.net/"

Settings for DiscordSRV Towny updates

discordSRVChannelID: 969978366394511420

Settings for /plot set vault

VaultCost: 0

Permissions

Perms for /n shout

towny.command.nation.shout
Allows using /n shout

Perms for /res set wiki

towny.command.resident.set.wiki
Allow residents to set & remove their /res wiki
default: true

Perms for /t set discord

towny.command.town.set.discord
Allow players to set & remove their /town discord

Perms for /n set discord

towny.command.nation.set.discord
Allow players to set & remove their /nation discord

Perms for /t set plotlimit

towny.command.town.set.plotlimit
Allow players to set & remove their town's limit for how many plots a resident can claim

Perms for /t toggle friendlyfire

towny.command.town.toggle.friendlyfire
Allow players to toggle their town's friendlyfire-allowed status
towny.town.friendlyfirelimitation.bypass
Allow players to bypass friendlyfire-allowed restriction, and to be able to toggle a plot's PvP status

Perms for /t log

towny.town.log.view
Allow players to view recent joins & leaves in their own town

Perms for /ta toggle shield

towny.command.townyadmin.shield Allow moderators to toggle a town's overclaimshield on/off

Override to allow a user to access Vault plots

towny.vault.perm.exempt Intended for server staff to access stuff if they use TownyAdmin town trust

Override to allow a user to change Vault plot types

towny.vault.change Intended for mayor assistants to be able to change plot types from Vault to any other