# TownyExternal<\/p>\n
A simple plugin that exposes information from Towny in a simple, easy to use, HTTP API.<\/p>\n
By default, the server listens to `127.0.0.1:8064`, but that can be configured.<\/p>\n
## Why?<\/p>\n
So you can make cool things like this: https:\/\/orchidmc.org\/#towns<\/p>\n
## Endpoints<\/p>\n
– `\/api\/towns` fetches a list of all towns
\n– `\/api\/town\/{id}` fetches a specific town
\n– `\/api\/nations` fetches a list of all nations
\n– `\/api\/nation\/{id}` fetches a specific nation<\/p>\n
## Caching<\/p>\n
There are three types of caches for TownyExternal: Redis, H2, and Postgres.<\/p>\n
For some servers with a large amount of players, towns, or nations, H2 might use too much memory or be too slow. In
\nthat case, you can use Postgres or Redis.<\/p>\n
### H2 (recommended, default)<\/p>\n
Everything will be stored in memory. This is the easiest option and default, but required more calls to the Towny API than the other two options since the cache will be cleared when your server restarts.<\/p>\n
If you have nothing already set, you don’t have to add this line to your config.yml since it’s default, but you can.<\/p>\n
“`yaml
\ncache: “h2”
\n“`<\/p>\n
### Redis<\/p>\n
Requires installation of Redis or a similar program like Valkey.<\/p>\n
Add the following to your config.yml.<\/p>\n
“`yaml
\ncache: “redis”<\/p>\n
redis-host: “127.0.0.1” # or whatever your host is
\nredis-port: “6379” # or whatever your port is
\nredis-prefix: “” # can be left blank, set if you have other programs using the same database
\n“`<\/p>\n
### Postgres<\/p>\n
Requires installation of PostgreSQL.<\/p>\n
Add the following to your config.yml.<\/p>\n
“`yaml
\ncache: “postgres”<\/p>\n
postgres-host: “127.0.0.1” # or whatever your host is
\npostgres-port: “5432” # or whatever your port is
\npostgres-db: “townyexternal” # or whatever your database name is
\npostgres-user: “youruser” # change this
\npostgres-pass: “yourpass” # change this
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
A simple plugin that exposes information from Towny in a simple, easy to use, HTTP API.<\/p>\n","protected":false},"featured_media":158718,"template":"","meta":{"_minecraft_slug":"townyexternal","_minecraft_project_id":"jvKr9h5t","_minecraft_author":"ihateblueb","_minecraft_license":"AGPL-3.0-only","_minecraft_downloads":78,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"townyexternal.zip","_minecraft_size_bytes":47281992,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T20:14:57.032007Z","_minecraft_date_created":"2025-07-11T04:32:53.962450Z","_minecraft_date_modified":"2026-02-08T18:06:37.214846Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/townyexternal","_minecraft_icon_attachment_id":158718,"_minecraft_imported_at":"2026-06-09T13:51:51+00:00","_minecraft_import_hash":"bf230c600593136fb61cac6d0b20eead","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,92],"mod_loader":[132,133],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-158717","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n