How it works

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

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


Overview | Permissions | Internationalization (Language)
How it works (commands and stuff) | Help

 

Note: in the following instructions, shift click means click while sneaking

 

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.

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.

 

Transfer Object

What?
Transfer an object to another player. This does the same as set owner but works only with protections the player owns.

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

Why?
I don't know :C

 

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 in the history of your server.

 

Find Near Objects

What?
Find near protections.

How?
Type /fp near <radius> into the chat.
The permission frameProtect.admin is needed.

Why?
No idea. Maybe you want to see the cool lightning effects? Or just find hidden protections easily.

 

Import / Migrate data

What?
Import protections from an older version or from another database type.
Find more info under import old data and data migration.

How?
Type /fp import <2.5|2.6|migrate> into the chat to see what parameters are required.
The permission frameProtect.admin is needed.

Why?
I'm sure you don't want to loose your protections when updating or changing database type.

 

WorldEdit Things

IMPORTANT: In FrameProtect 2.7 is a spelling mistake. Use /fp worledit or /fp we to use this feature.

What?
Protect several object at once.
Remove protections from several objects at once.
Find protections inside a WorldEdit selection.

How?
Make a WorldEdit selection
Type /fp worldedit takeown <itemframe|painting|armorstand|leashknot> into the chat.
Type /fp worldedit remove <itemframe|painting|armorstand|leashknot> into the chat.
Type /fp worldedit find <itemframe|painting|armorstand|leashknot> into the chat and be happy
The permission frameProtect.admin is needed.

Why?
Perhaps there will be a time in which you will have to protect millions of objects.

 

Save

What?
Update all protections and save them to the database.

How?
Type /fp save into the chat.
The permission frameProtect.admin is needed.

Why?
Use it when you want to make sure your protections are save.

 

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.