{"id":20780869,"url":"https://github.com/x4e/paperbin","last_synced_at":"2025-04-30T20:34:06.287Z","repository":{"id":52265954,"uuid":"255067488","full_name":"x4e/PaperBin","owner":"x4e","description":"An experiment at improving the performance of PaperMC","archived":false,"fork":false,"pushed_at":"2021-05-02T16:37:04.000Z","size":23460,"stargazers_count":96,"open_issues_count":5,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-30T19:41:27.823Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/x4e.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"License.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-12T11:26:12.000Z","updated_at":"2025-02-27T04:41:23.000Z","dependencies_parsed_at":"2022-09-12T02:51:10.701Z","dependency_job_id":null,"html_url":"https://github.com/x4e/PaperBin","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x4e%2FPaperBin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x4e%2FPaperBin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x4e%2FPaperBin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x4e%2FPaperBin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/x4e","download_url":"https://codeload.github.com/x4e/PaperBin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251777841,"owners_count":21642234,"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":[],"created_at":"2024-11-17T13:39:48.244Z","updated_at":"2025-04-30T20:34:06.265Z","avatar_url":"https://github.com/x4e.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PaperBin 🗑️\r\n![Java CI with Gradle](https://github.com/x4e/PaperBin/workflows/Java%20CI%20with%20Gradle/badge.svg)\r\n[![Downloads](https://img.shields.io/github/downloads/bytechef/paperbin/total?logo=github\u0026logoColor=white)](https://github.com/x4e/PaperBin/releases/latest)\r\n[![Discord](https://img.shields.io/discord/658373639137132595?logo=discord\u0026logoColor=white)](https://discord.gg/9wA2G8E)\r\n\r\nAn experiment at improving the performance of PaperMC.\r\n\r\nThis project uses jvmti to modify Minecraft classes at runtime.\r\nBecause of this paperbin can even be run on top of modified versions of paper.\r\n\r\n## Donate\r\nYou can donate by sending bitcoin to `bc1q35vyw5rudnttchglj3rch9p2j9xxannumn3muv`.\r\n\r\n## Usage\r\n\r\nNote: It is highly recommended to run PaperBin on Java 15 using ZGC and large pages for best performance.\r\n\r\nDownload the latest 1.12.2 release from [Paper's website](https://papermc.io/legacy).\r\n\r\nGo to [the releases](https://github.com/x4e/PaperBin/releases) and download PaperBin.jar as well as the relevant native library for your platform (dll for windows, dylib for mac, so for linux).\r\nThe following commands will be for the linux native library, adapt them for your one.\r\n```\r\njava -jar paper-1.12.2-1618.jar\r\njava -agentpath:libJvmClassHook.so -jar PaperBin.jar cache/patched_1.12.2.jar\r\n```\r\nThe first command should exit with an error.\r\nIf it does not then quit it yourself once it has finished starting up the server.\r\n\r\n## Testomonials\r\n\u003e paperbin\r\n\u003e did lots of impovements to my server\r\n\u003e i can f\\*\\*\\*ing handle 15k entities\r\n\u003e in 4 chunks\r\n\u003e without tps drop\r\n\r\n(Kaspian#8508)\r\n\r\n\u003e paperbin runs great for a server with 100+ players and wont affect breaking blocks or eating that much when the tps is low would recommend\r\n\r\n(cubebuilderunderscore#4344)\r\n\r\n\u003e thanks for making such a helpful server tool\r\n\r\n(Gav#7669)\r\n\r\n\r\n## Test Server\r\nThis plugin is currently active on `oldfag.org`, feel free to connect and test it out, there are no rules.\r\n\r\n## Features:\r\n- Multithreaded mob ai goal calculation\r\n- Anti Chunk Ban\r\n- Anti Crasher (book exploit)\r\n- Anti Dupe (portal entity exploit)\r\n- Anti Elytra Fly (infinite durability exploit)\r\n- Anti Grief (various exploits to break end portals)\r\n- Anti Nether Roof (prevent people glitching above/below bedrock or outside the world border)\r\n- Anti Portal God Mode (exploit allowing invincibility after travelling through a portal)\r\n- Anti Unicode Chat\r\n- Block Tick Rate Limiter (limit the rate at which blocks are ticked)\r\n- Chunk Loading Optimisations (remove some unecessary locks)\r\n- Faster Game Rule Lookups (average O(1) vs original O(n))\r\n- Mob AI Rate Limiting\r\n- Optimised everyone sleeping checks\r\n- Tps Compensation for events such as food/potion consumption, furnace/brewing progress etc\r\n- Village rate limiter (rate limit the rate at which villages are updated)\r\n\r\n## Configuration\r\nThe first time you run PaperBin it will output the default config to `paperbin.properties`, just replace the defaults as necessary.\r\n\r\n## Building\r\n\r\nPaperbin needs the patched paper jar as a dependency, so you will need to follow these build steps.\r\n```Bash\r\ngit clone https://github.com/x4e/PaperBin\r\ncd PaperBin\r\nmkdir paperbin\r\nwget https://papermc.io/api/v2/projects/paper/versions/1.12.2/builds/1618/downloads/paper-1.12.2-1618.jar -O paperbin/paper.jar\r\ncd paperbin\r\njava -jar paper.jar\r\ncd ../\r\n./build.sh\r\n```\r\n\r\n\r\n## YourKit\r\n![YourKit](https://www.yourkit.com/images/yklogo.png)\r\n\r\nThank you YourKit for supporting this project with their amazing profiler.\r\n\r\nYourKit supports open source projects with innovative and intelligent tools\r\nfor monitoring and profiling Java and .NET applications.\r\nYourKit is the creator of [YourKit Java Profiler](https://www.yourkit.com/java/profiler/),\r\n[YourKit .NET Profiler](https://www.yourkit.com/.net/profiler/),\r\nand [YourKit YouMonitor](https://www.yourkit.com/youmonitor/).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx4e%2Fpaperbin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fx4e%2Fpaperbin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx4e%2Fpaperbin/lists"}