PLUGIN GUIDE
FragStealers
Player-facing guidance for the plugins used on Pinnacle SMP.
FragStealers protects player storage, powers secure container shops and virtual mailboxes, lets owners share controlled access with trusted players, and provides logged staff recovery tools.
PLAYER FEATURES What FragStealers Does
Players can protect supported containers, run shops, receive mailed items, and grant specific players limited or full management access without giving up ownership of the protection.
What Is New in 26.2-6 Beta 2
- Protection owners can now trust individual players with either access or manage permissions.
- New commands let owners add, update, remove, and list trusted players while looking at a protection within six blocks.
- Trusted access now works with ordinary locks, shops, and mailboxes.
- Access-level shop users can restock only the configured sale item and cannot remove stock or collect payments.
- Manage-level shop users can restock, remove stock, collect payments, and finish setting up an unconfigured shop.
- Access-level mailbox users can collect mail through a restricted pickup view but cannot insert or rearrange items.
- Manage-level mailbox users can fully manage mailbox contents.
- Open shop and mailbox sessions recheck authorization, so revoked trust takes effect without requiring the player to reconnect.
- Protected shop and mailbox menus now block more inventory bypass methods, including hotbar swaps, offhand swaps, shift-clicking, dragging, dropping, cloning, and collect-to-cursor actions.
- Trust entries are automatically removed when the related lock, shop, or mailbox protection is removed.
Supported Containers
- Chests
- Trapped chests
- Double chests
- Barrels
Protected Storage
- Attach a sign directly to the side of an empty supported container, or place a standing sign directly above it.
- Put
[fs]on the first line. - Finish editing the sign. It changes to [protected] and displays the owner's name.
- The owner and authorized trusted players can open and use the container.
- The container cannot be broken until the protection sign is removed.
- Trusted players cannot edit or remove the sign, break the container, or attach another chest half.
- The owner can safely expand a protected single chest into a double chest.
- Hopper behavior for ordinary locks follows server policy. Shops and mailboxes always block hopper access.
Trusted Player Access
Trust commands must be used in game while the owner is looking directly at the FragStealers sign or protected container from no more than six blocks away.
| Command | What it does |
|---|---|
/fs trust <player> | Grants the player the default access level on the targeted protection. |
/fs trust <player> access | Grants or changes the player to limited access. |
/fs trust <player> manage | Grants or changes the player to management access. |
/fs untrust <player> | Removes the player from the targeted protection. |
/fs trusted | Lists every trusted player and their access level for the targeted protection. |
| Protection | Access Level | Manage Level |
|---|---|---|
| Ordinary lock | Open and use the protected container. | Same container access as the access level. |
| Shop | Add only the configured sale material. Cannot remove stock or collect payments. | Add or remove stock, collect payments, and configure an unconfigured shop. |
| Mailbox | Deposit items and collect mail through a restricted pickup view. | Fully manage mailbox contents. |
Player Shops
- Attach a sign to an empty supported container.
- Put
[fs shop]on the first line. - Right-click the completed sign and choose the item being sold and its quantity.
- Select the payment item and quantity, then confirm the setup.
- Place the sale stock in the physical container.
- Customers right-click the shop sign to purchase the configured amount.
- Sale quantities can be selected one item at a time up to that item's maximum stack size.
- Shop payments are stored separately until collected by the owner, a manage-level trusted player, or authorized staff.
- Configured signs show the sale item in green and the payment item in red without glowing text.
- Access-level trusted users can restock only the correct sale material.
Shop Item Search
Virtual Mailboxes
Creating Your Own Mailbox
- Attach a sign to an empty supported container.
- Put
[fs mail]on the first line. - Leave the second line blank and finish editing the sign.
- Other players can deposit items without seeing or taking existing mail.
- Occupied mailbox slots appear as locked red panes during deposit mode.
- A barrel or single chest mailbox has 27 virtual slots; a double chest mailbox has 54.
- Mailbox items are stored virtually rather than in the physical container.
- The owner receives You've Got Mail! after an online deposit and once after joining while mail remains waiting.
- Master Keys and internal menu items cannot be mailed.
Normal Player Commands
| Command | Who can use it | Purpose |
|---|---|---|
/fs trust <player> [access|manage] | Protection owner | Adds or updates a trusted player on the protection being targeted. |
/fs untrust <player> | Protection owner | Removes trusted access from the targeted protection. |
/fs trusted | Protection owner | Displays the targeted protection's trusted-player list. |
No command is required to create or use ordinary locks, shops, and mailboxes; those actions are handled through signs and right-click menus.
ADMIN ONLY Master Key and Recovery Tools
The Master Key is a genuine unbreakable custom wooden axe used by authorized staff for recovery and inspection. A renamed wooden axe does not work.
| Command | What it does |
|---|---|
/fs give masterkey | Gives the command user a Master Key. |
/fs give masterkey <player> | Gives an online player a Master Key. |
/fs reload | Reloads FragStealers server settings without deleting saved protections. |
Creating a Mailbox for Another Player
Authorized staff can hold a genuine Master Key in either hand and create a mailbox for a known player using:
Line 1: [fs mail]Line 2: PlayerNameThe mailbox belongs to the named player exactly as though they created it themselves.
Administrative Access Rules
- Authorized staff can open protected locks and management interfaces and remove protection signs for recovery.
- The Master Key must remain in hand during active administrative inventory access.
- A Master Key cannot directly break a protected container; the protection sign must be removed first.
- Master Keys cannot be used as shop stock or placed inside mailboxes.
- Master Key administrators cannot change another player's trust list.
- Administrative mailbox creation, protection removal, and item or stock withdrawal actions are logged for accountability.