misticos
Upgrade your buildings easily with a hammer

Supported Games
GameServerKingsGameServerKings

Do you want to easily upgrade buildings with your hammer? Probably, with a single hammer hit? Or.. with a click? Or even better - immediately when you build? Welcome to my world!

BEFORE YOU DOWNLOAD

  1. Auto Grade means that when you upgrade first time, you enable this plugin without any commands, and when you upgrade second time, you disable it. If you do not want it to be the same, disable it by default with default preferences, or for whole server (Allow Auto Grade) or just for yourself with /grade ag False.
  2. You should not be using multiple plugins for upgrading building blocks, et cetera. If my plugin lacks any features, just let me know instead of installing three plugins.
  3. If you do not want this plugin to override / use some specific commands, just remove them from configuration.

Permissions

  • enhancedhammer.use - Required permission to use the plugin.
  • enhancedhammer.free - Free upgrading within this plugin.
  • enhancedhammer.downgrade - Allow downgrading.
  • enhancedhammer.grade.hit - Allow grading with a hammer hit.
  • enhancedhammer.grade.click - Allow grading with a click while holding a hammer (The same as hammer hit but you do not have to actually hit - just look at the building block and left click).
  • enhancedhammer.grade.build - Allow grading immediately once you build something.

Commands

Default commands are: eh, hammer, up, grade and upgrade.
You can specify a grade with: 0 for Twigs, Twigs for Twigs. 1 - Wood, 2 - Stone, 3 - Metal, 4 - TopTier (aka HQM).
You can change your preferences with: t (Time in seconds) for Timeout, ag (True/False) to toggle Auto Grade.

Configuration

Default Configuration

{
  "Commands": [
    "eh",
    "hammer",
    "up",
    "grade",
    "upgrade"
  ],
  "Distance From Entity": 5.0,
  "Allow Auto Grade": true,
  "Send Downgrade Disabled Message": true,
  "Cancel Default Hammer Hit Behavior": true,
  "Default Preferences": {
    "DisableIn": 30.0,
    "AutoGrade": true
  }
}

How-To

Commands - Commands you can use to toggle grading and change preferences.
Distance From Entity - Required distance from entity to upgrade it with a click.
Allow Auto Grade - Whether to allow Auto Grade on this server or not.
Send Downgrade Disabled Message - Whether to send a downgrade disabled message.
Cancel Default Hammer Hit Behavior - Whether to cancel default hammer hit behavior when upgrading, for example - repairing.
Default Preferences - Default player preferences (Applies only to new players and will not change anything for old ones).

Localization

English

{
  "Command: No Permission": "You do not have enough permissions for that (enhancedhammer.use)",
  "Command: Player Only": "You must be an in-game player to use this command",
  "Command: Invalid Grade": "You have entered an invalid grade",
  "Command: Timeout": "Current timeout: {timeout}",
  "Command: Auto Grade: Enabled": "You have enabled automatic toggle for grading",
  "Command: Auto Grade: Disabled": "You have disabled automatic toggle for grading",
  "Command: Auto Grade: Force Disabled": "Auto Grade is disabled on this server",
  "Command: Syntax": "Grade command syntax:\n(grade) - Set current grade to a specific value\ntimeout (Time in seconds) - Disable grading in X seconds\nautograde (True/False) - Toggle automatic grading toggle",
  "Grade: Changed": "Current grade: {grade}",
  "Grade: No Downgrade": "Downgrading is not allowed on this server",
  "Grade: Building Blocked": "You cannot build there",
  "Grade: Insufficient Resources": "You cannot afford this upgrade",
  "Grade: Recently Damaged": "This entity was recently damaged"
}

Credits

BekerMelk - Lots of help and testing.

MIT License


Copyright (c) 2020 misticos


Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:


The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.


THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.