{"id":14969575,"url":"https://github.com/shantek/postoffice","last_synced_at":"2026-01-26T03:17:08.858Z","repository":{"id":240168515,"uuid":"769399780","full_name":"shantek/PostOffice","owner":"shantek","description":"A fully functional Post Office plugin for your Minecraft server. With a built in protection system, your post boxes are always safe from other players. A built in notification system informs players when they have items in their post box.","archived":false,"fork":false,"pushed_at":"2024-09-29T06:25:54.000Z","size":178,"stargazers_count":1,"open_issues_count":3,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-11T03:40:55.965Z","etag":null,"topics":["bukkit-plugin","java","minecraft","minecraft-plugin","minecraftjava","paper-plugin","papermc","purpur-plugin","spigot","spigot-plugin"],"latest_commit_sha":null,"homepage":"https://www.shantek.io","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shantek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"shantek","github":"shantek","custom":"https://www.paypal.com/donate/?hosted_button_id=9N3RCSJF6PYPU"}},"created_at":"2024-03-09T01:14:51.000Z","updated_at":"2024-09-29T06:25:22.000Z","dependencies_parsed_at":"2024-09-07T05:21:10.776Z","dependency_job_id":"60f7f62c-7ac8-484d-a574-69225e101a0a","html_url":"https://github.com/shantek/PostOffice","commit_stats":{"total_commits":124,"total_committers":3,"mean_commits":"41.333333333333336","dds":0.3951612903225806,"last_synced_commit":"7bbbe05c57e83a7c3729e804d560eadb32317aae"},"previous_names":["shantek/postoffice"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shantek%2FPostOffice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shantek%2FPostOffice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shantek%2FPostOffice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shantek%2FPostOffice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shantek","download_url":"https://codeload.github.com/shantek/PostOffice/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219863300,"owners_count":16555950,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit-plugin","java","minecraft","minecraft-plugin","minecraftjava","paper-plugin","papermc","purpur-plugin","spigot","spigot-plugin"],"created_at":"2024-09-24T13:42:04.130Z","updated_at":"2025-10-26T09:30:50.737Z","avatar_url":"https://github.com/shantek.png","language":"Java","funding_links":["https://patreon.com/shantek","https://github.com/sponsors/shantek","https://www.paypal.com/donate/?hosted_button_id=9N3RCSJF6PYPU"],"categories":[],"sub_categories":[],"readme":"# ![Shantek Banner](/.github/assets/Banner.png)\n\n---\n[![Modrinth](https://img.shields.io/badge/Modrinth-Download-green?logo=modrinth)](https://modrinth.com/plugin/postoffice)\n[![Discord](https://img.shields.io/discord/628396916639793152.svg?color=%237289da\u0026label=discord)](https://shantek.co/discord)\n[![CodeFactor](https://www.codefactor.io/repository/github/shantek/postoffice/badge)](https://www.codefactor.io/repository/github/shantek/postoffice)\n![GitHub commit activity](https://img.shields.io/github/commit-activity/m/shantek/PostOffice)\n![GitHub Created At](https://img.shields.io/github/created-at/shantek/PostOffice)\n\n\n\u003cimg src=\"https://www.shantek.io/wp-content/uploads/2024/09/Banner.png\" alt=\"Post Office Plugin Banner\" /\u003e\n\n# 📮 Post Office Plugin\n\n**A fully functional post box system for Bukkit-based Minecraft servers!**  \nTurn barrels into secure player mailboxes with claims, protection, and notifications.\n\n\u003e 🔄 **Version 2 is a full rewrite.** You’ll need to re-register existing post boxes.  \n\u003e Just remove the player’s name from the sign and follow the steps below.\n\n### 🔧 [Get the latest development builds here](https://github.com/shantek/PostOffice/releases/)\n\n---\n\n## ✉️ How It Works\n\n1. Upload the JAR to your server and restart.\n2. Edit the `config.yml` if needed (optional).\n3. Place barrels in your post office build.\n4. Attach a blank sign to the front of each barrel.\n5. While looking at the sign, type `/postoffice register`.\n6. Players can use `/postoffice claim` to claim a registered box.\n7. Admins can claim on behalf of others with `/postoffice claim \u003cplayername\u003e`.\n\n\u003e 📦 Anyone can deliver items into a post box, but only the **owner** can retrieve them.  \n\u003e 🔐 Post boxes are protected from tampering unless permissions override this.  \n\u003e You can disable built-in protection and use WorldGuard or other systems instead.\n\n---\n\n## 🎥 YouTube Tutorial\n\n[![YouTube](http://i.ytimg.com/vi/WJtsFSBOviI/hqdefault.jpg)](https://www.youtube.com/watch?v=WJtsFSBOviI)\n\n---\n\n## 🛠️ Commands\n\n| Command | Description |\n|--------|-------------|\n| `/postoffice register` | Register a barrel + sign as a post box. |\n| `/postoffice claim` | Claim a registered post box. |\n| `/postoffice claim \u003cplayer\u003e` | Admin command to claim on behalf of a player. |\n| `/postoffice remove` | Remove a post box (while looking at it). |\n| `/postoffice info` | Show info about the post box you’re looking at. |\n\n---\n\n## 🔐 Permissions\n\n| Node | Description |\n|------|-------------|\n| `shantek.postoffice.use` | Default true. Deny this to ban a player from using post boxes. |\n| `shantek.postoffice.removeitems` | Allow access to remove items from any post box. |\n| `shantek.postoffice.register` | Register or remove post boxes. |\n| `shantek.postoffice.claim` | Claim a post box. |\n| `shantek.postoffice.claim.others` | Claim for another player (admin/mod use). |\n| `shantek.postoffice.updatenotification` | Receive plugin update notifications. |\n\n---\n\n## 📦 Downloads\n\nAvailable on:\n- [Spigot](https://www.spigotmc.org/resources/post-office.108343/)\n- [Modrinth](https://modrinth.com/plugin/postoffice)\n- [CurseForge](https://www.curseforge.com/minecraft/bukkit-plugins/post-office)\n\n---\n\n## 💬 Community \u0026 Support\n\n- 🛠 [Report Bugs or Make Suggestions](https://github.com/shantek/PostOffice/issues)\n- 💬 [Join the Discord](https://shantek.co/discord)\n- ❤️ [Support via Patreon](https://shantek.co/patreon)\n- ☕ [Or via PayPal](https://www.paypal.com/donate/?hosted_button_id=9N3RCSJF6PYPU)\n\n---\n\n## 📄 License\n\n[![License: GPL](https://img.shields.io/badge/license-GPL-blue.svg)](LICENSE)\n\nDistributed under the **GNU General Public License v3.0**.  \nSee the [`LICENSE`](LICENSE) file for details.\n\n---\n\n![Plugin Usage Stats](https://bstats.org/signatures/bukkit/Post%20Office.svg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshantek%2Fpostoffice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshantek%2Fpostoffice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshantek%2Fpostoffice/lists"}