Git Product home page Git Product logo

dynmap-towny's Introduction

Dynmap-Towny

Dynmap-Towny provides a simple way to add visibility of Towny towns and nations on Dynmap's maps. The plugin depends on the presence of both Dynmap and Towny Advanced, and interacts directly with the Towny API. Updates to zones are automatically processed (on a settable period - default is once per 5 minutes (300 seconds)). By default, the plugin will be active after simply installing it (by unzipping the distribution into the plugins/ directory and restarting the server).

Towns of any shape are supported, and a proper outline border is computed and displayed that will encompass all the contiguous blocks of a given town (limitation - 'holes' in the middle of a town may still be shaded to look like part of the town). Outposts, including outposts on other worlds, are supported. Clicking on the town will display a popup with a configurable set of data on the town.

Dynmap-Towny will also show configurable icons for the home block of each town, including distinctive icons when the town is a capital of its country.

Display style, including the color and opacity of the outlines and fill, as well as icons used for home markers, can be tailored. This can be done at the global default level, the per-nation level, or the per town level. The Y coordinate (altitude) of the town outlines can also be set (default is 64 - standard sea level) - typically this would be done using 'custstyle', to set the value for each town needing to be adjusted individually.

Visibility of towns can be controlled via the 'visibleregions' and 'hiddenregions' settings. Besides listing the names of the towns to be made visible or hidden, entries with the format 'world:' can be used to make all towns on a given world visible or hidden.

Also, the display of the town outlines can be restricted to a minimum zoom-in level, via the 'minzoom' setting. When non-zero, this setting causes the town outlines to only be displayed at or beyond the given zoom-in level.

Note: If you are currently using the region component for Towny in Dynmap, you should disable that support

Supported Versions

As of 0.79, Dynmap-Towny has the following minimum requirements:

  • CraftBukkit / Spigot / Paper 1.14.4 OR 1.15.2
  • Dynmap 2.5 or later
  • TownyAdvanced 0.96.1.2 or later
  • TownyChat 0.65 or later (Optional)

Plugin Configuration

After the first load, there will be a config.yml file in the plugins/Dynmap-Towny directory. Details of the default configuration, and all the provided settings, can be found here

Building from source

Building presently requires manual download of TownyChat, as it does not have a Maven repository (yet).

  1. Create a 'deps' folder in the project's root directory.
  2. Download and place TownyChat-0.65.jar into the 'deps' folder.
  3. Compile using Maven. (Requires a Java JDK for Java 8+)

Acknowledgements

This is a fork of Dynmap-Towny. I forked this from Hank Jordan who forked it from the original repo.

dynmap-towny's People

Contributors

darbyjack avatar goosius1 avatar hankjordan avatar kobata avatar llmdl avatar mikeprimm avatar norbipeti avatar suneettipirneni avatar theflagcourier avatar warriorrrr avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.