FrameProtect

FrameProtect - Logo

FrameProtect
Item frames, paintings and armor stands are, for simplicity, called objects on this page.

Protect your item frames, paintings and armor stands! Very simple to use.

Your server is not running 1.8 or newer? Info page for older versions of FrameProtect


New info - please read←link to a comment of mine


FrameProtect 2.6 is very buggy. If it doesn't work for you, please use version 2.5. It should still work (without armor stand protection)


Features

  • Protect item frames, paintings and armor stands
  • Per player protections
  • Respawn disappeared protected objects
  • Save protected objects from natural destruction (e.g. paintings hanging in air)
  • Save protected objects from destruction by mobs (e.g. creepers, skeletons)
  • Save protected objects from destruction by piston movement
  • MySQL support
  • Permissions support
  • Customizable messages (comes with several predefined languages)
  • Many configuration options


Installation

> Make sure that your server is running at least Minecraft 1.8.
> Put FrameProtect.jar into your plugins folder and restart the server.

Update from 2.5 or lower to 2.6

If you're already using FrameProtect, I recommend to use my FrameProtectDatabaseUpdater to update your protections and settings.
This will convert all your data (except the language) to the new format.

It depends on wheter you have set useMySQL to true or not if the updater will convert the MySQL database or the flatfile. It's also possible to convert both, you just have to edit the option in the already updated config.yml and restart the server again.

The update does not delete or overwrite the original data.
> old config.yml gets renamed to config.old
> MySQL data gets copied to new tables
> flatfile data gets copied to a new SQLite database.

Updating:

  1. Shut down your server.
  2. Remove the old FrameProtect.jar from your plugins folder.
  3. Put FrameProtectDatabaseUpdater.jar into the plugins folder and start the server.
  4. Wait until your server is started. In the console you should find the message [FrameProtectDatabaseUpdater] Update completed!. If you can't find it, something went wrong (the updater will disable itself after finishing, don't be irritated).
  5. Shut down the server.
  6. Remove FrameProtectDatabaseUpdater.jar from your plugins folder.
  7. Put the new FrameProtect.jar into your plugins folder and start the server.
  8. Done!


How It Works

Protect & Unprotect

What?
Protect or unprotect an object.

How?
Simply shift left click it.
The permission frameProtect.protect is needed.
Notice: frameProtect.place is still needed if you want your players to be able to place objects.

Why?
Protected objects will be saved to the database. No other players (except admins) will be able to destroy them or steal your items. If, caused by any issue, some objects disappear unexpected, FrameProtect will, in most cases, be able to respawn them.


Autoprotection

What?
Autoprotection will protect each object that you place.

Notice: Armor stand autoprotection doesn't work at the moment.

How?
Place an object.
The permission frameProtect.autoprotect is needed.
Without giving your players frameProtect.protect, autoprotection will still work and they will never be able to unprotect their objects.

Why?
It may be helpful if you don't want to teach all your new players in protecting objects.
Also, without the frameProtect.protect permission, you will hardly ever have problems with players fighting for an object.


Object Info

What?
Get the coordinates and the owner of an object.

How?
Simply shift right click it.
The permission frameProtect.info is needed.

Why?
I don't know :C


Set Owner

What?
Change the owner of an object.

How?
Type /fp owner <name> into the chat and then shift click an object.
The permission frameProtect.admin is needed.

Why?
Maybe it will be useful for you at an undefined point of the history of your server.


Admin Stuff

What?
Remove protections of other people
Take items from protected objects
Reload the plugin (config.yml, protections and language)

How?
Reload: /fp reload
The permission frameProtect.admin is needed.

Why?
Because admins should be able to administer.


Permissions

PermissionFunction
frameProtect.place.*place & destroy objects
frameProtect.autoprotect.*autoprotection
frameProtect.protect.*protect & unprotect
frameProtect.info.*object info
frameProtect.adminset owner
frameProtect.adminadmin stuff

Notice:
Instead of .*, which means it's for all objects, you can put .itemframe, .painting or .armorstand

For example:
You want to allow your players to protect paintings but not item frames and armor stands.
The permission you have to give to this group would be: frameProtect.protect.painting


Configuration

You can find all configuration options including description and default value in the config.yml file.


Todo

  • Fix some errors in the updater.
  • Add lcoal buffering for MySql to reduce queries.
  • Add debug commands (find near protections, remove broken protections, etc.)
  • Try to fix object respawning.
  • Add autprotection for armor stands.
  • Readd some commands and add the option to disable direct protecting/deprotecting by clicking.
  • Get the new version to work with 1.7.10.
  • Make FrameProtect able to recognize worlds when they were renamed (use UUIDs).
  • Make the set owner function work for normal players to transfer their protections to others.
  • Any requests?


Language

FrameProtect supports custom languages.

The plugin contains several language files:

en_USEnglishEnglishby Dragon252525
de_DEGermanDeutschby Dragon252525
fr_FRFrenchfrançaisby Dragon252525
eu_ESBasqueEuskaraby galaipa
cs_CZCzechčeštinaby Shadowhacker

Translations that you can download additionally (not yet coming with the plugin):

ru_RURussianрусскийby Aqelius

Creating a new language file

Download example: en_US

%s, %1$s, %2$s and %3$s are placeholders. Please do not remove them.

If your language needs seperate messages for the different objects:

  destroyed: "Privater %s zerstört."
  destroyed_painting: "Privates %s zerstört."

This supports _itemframe, _painting and _armorstand.
If there are only two different messages, you can add the suffix to the one that's only needed once and leave the other like it is.

Sometimes you will see some strange symbols ingame, this is caused by a wrong file encoding, which you can change with most text editors.

If you want to share your work, I would be very happy if you send me a PM and post your translation on pastebin or somewhere else ;)


Known Bugs

  • AutoProtection doesn't work for armor stands.
  • The updater does sometimes not convert all/any protections.
  • Respawning doesn't work always.


Metrics

FrameProtect sends statistics about the usage to mcstats.org. You can disable this by setting the option opt-out in the YourServerFolder/plugins/PluginMetrics/config.yml file to true.
FrameProtect - MCStats

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of seriosbrad seriosbrad Feb 24, 2015 at 20:50 UTC - 0 likes

    @Zimm3r: Go

    Add the frameProtect.admin permission node to the group.

  • Avatar of Zimm3r Zimm3r Feb 24, 2015 at 19:09 UTC - 0 likes

    Hi, For some reason I can't get your plugin to work properly. Every time I try to use commands I just keep on getting the same message. FrameProtect 2.6 by Dragon252525 /fp help I don't know if you have any ideas to why this is happening to me, I got the newest spigot version so it can't be that..

  • Avatar of Dragon252525 Dragon252525 Feb 23, 2015 at 19:06 UTC - 0 likes

    @Bastikeks: Go

    Nein, WorldGuard regionen werden zur zeit nicht unterstützt.

    @externo6: Go

    I'm not sure why this happens :/ I'm trying to fix this issue.

    @151baccardi: Go

    1) I think I will not add banner protection beacause FrameProtect is made for entity protection; It would be very time-consuming to make it able to protect blocks as well.

    2) I might update the updater; I'll have a look at the database interaction.

    @spazmonkey777: Go @externo6: Go

    I'm not sure why this happens :/ I'll try to improve respawning (way too much errors) It might have something to do with world loading.

    @jessefjxm: Go

    1) O_o Very mysterious. There's no easy way to find protections by coordinates at the time. I'll probably add a command to find near protections or something like that.

    2) I'm not sure why this happens :/ I'm trying to fix this issue.

    @Mr_Simba: Go

    Sorry for this. I mentioned it in the description here: AutoProtection for armor stands doesn't work in FrameProtect 2.6 (no useful option to notice the placement of armor stands in-code)

    @palindrome96: Go

    I have tested 2.6 with Spigot 1.8. Could you give me some more information? Are there any errors?

    @Max633: Go

    Cela devrait fonctionner avec GroupManager (Group_Manager#Negative_Nodes). :/

    @seriosbrad: Go

    In 2.6, the flat data is converted to a SQLite database. You should find some converters or other ways to do this with a google search ;) (maybe there will be an integrated function in FrameProtect to move / copy data across those two databases in the future)

    Last edited Feb 23, 2015 by Dragon252525

    BFAK:Dragon252525,90599402,6ad922298e21396e238e5c647e498642e3f8467a6b1180b83fe49ffb0f2b9350

  • Avatar of jessefjxm jessefjxm Feb 22, 2015 at 15:36 UTC - 0 likes

    Updating from 2.5 to 2.6 fail. The updater said it has successfully convert 50000+ files from old    database, but actually there's only 3 records created in the database, and most of my old records disappear. Hope there's a way to fix this :(

    废话少说,放码过来

  • Avatar of seriosbrad seriosbrad Feb 18, 2015 at 23:58 UTC - 0 likes

    Is there any way to export a v2.6 flatfile database to MySQL? I was not using MySQL previously.

    It exported the playernames and UUID's during update from 2.5 to 2.6 to the "fp_player" table, but "fp_protection" is empty.

    Last edited Feb 19, 2015 by seriosbrad
  • Avatar of Max633 Max633 Feb 17, 2015 at 11:34 UTC - 0 likes

    @KsenMih: Go

    Hello

    J'ai mis une autorisation négative au groupe où je me trouve et ça n'a rien changé. Je suis OP et j'aimerais bien enlevé l'auto-protection mais apparemment la permission négative ne suffit pas.

    Est-ce dû au plugin de permission GroupManager?

    Merci à toi,

    Server french
    http://art-of-survival.fr/images/topsite.png

  • Avatar of KsenMih KsenMih Feb 16, 2015 at 09:38 UTC - 0 likes

    @Max633: Go

    You can't disable self-protection for operators, but for a group, or an user. For this, just add the negative permission -frameProtect.autoprotect.* to your group, or user.

    Tu ne peux pas désactiver la protection automatique pour les opérateurs, tu peux seulement la désactiver pour un groupe ou un/plusieurs joueur(s) spéficique(s). Pour cela, donne la permission négative -frameProtect.autoprotect.* à ton groupe où a ton/tes joueur(s) OP.

  • Avatar of Mr_Simba Mr_Simba Feb 15, 2015 at 17:23 UTC - 0 likes

    For some reason even though players have frameProtect.autoprotect.*, armor stands don't autoprotect. It works for paintings and item frames but not armor stands. It doesn't even work if they have explicitly have frameProtect.autoprotect.armorstand.

    No nudity, even really good nudity!

  • Avatar of Max633 Max633 Feb 15, 2015 at 15:19 UTC - 0 likes

    hi

    How to remove self-protection at op ?

    Thanks

  • Avatar of externo6 externo6 Feb 15, 2015 at 14:29 UTC - 0 likes

    @spazmonkey777: Go

    Having the same issue, looks like frameprotect is trying to place an itemframe on air.

Facts

Date created
Nov 04, 2012
Categories
Last update
Feb 05, 2015
Development stage
Release
Language
  • deDE
  • enUS
  • frFR
  • ruRU
License
All Rights Reserved
Curse link
FrameProtect
Downloads
84,847
Recent files

Authors