{"id":15143576,"url":"https://github.com/cosmoverse/worldbuilder","last_synced_at":"2025-10-23T20:30:41.220Z","repository":{"id":50640123,"uuid":"231049571","full_name":"Cosmoverse/WorldBuilder","owner":"Cosmoverse","description":"A PocketMine-MP world editor plugin designed to be used on production servers","archived":false,"fork":false,"pushed_at":"2024-07-31T13:51:14.000Z","size":199,"stargazers_count":18,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-30T20:51:56.480Z","etag":null,"topics":["builder","cosmicpe","creative","editor","efficient","pmmp","pmmp-plugin","pocketmine","world"],"latest_commit_sha":null,"homepage":"https://poggit.pmmp.io/ci/Cosmoverse/WorldBuilder/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cosmoverse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2019-12-31T07:46:04.000Z","updated_at":"2024-12-18T22:08:44.000Z","dependencies_parsed_at":"2024-04-06T02:34:14.691Z","dependency_job_id":null,"html_url":"https://github.com/Cosmoverse/WorldBuilder","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmoverse%2FWorldBuilder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmoverse%2FWorldBuilder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmoverse%2FWorldBuilder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmoverse%2FWorldBuilder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cosmoverse","download_url":"https://codeload.github.com/Cosmoverse/WorldBuilder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237882172,"owners_count":19381176,"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":["builder","cosmicpe","creative","editor","efficient","pmmp","pmmp-plugin","pocketmine","world"],"created_at":"2024-09-26T10:02:02.596Z","updated_at":"2025-10-23T20:30:35.879Z","avatar_url":"https://github.com/Cosmoverse.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WorldBuilder\nA world editor plugin designed for production use.\n\nWorldBuilder (WB) is specifically designed to handle multiple world-edit operations efficiently.\nIt is an excellent editor plugin creative-mode like servers (such as MyPlot plugin users).\nWB is _not_ a fast editor—instead, it is deliberately slows down editor tasks to let the server handle multiple operations concurrently.\n\nWB provides an API for limiting and monitoring world edit operations.\n\n## Developer Docs\n### Handling and filtering editor tasks\nAs a creative-mode server maintainer, disallowing players from editing other's regions and avoiding specific blocks from being spawned can be done using WB's API in the following way:\n\n```php\nuse cosmicpe\\worldbuilder\\editor\\executor\\SetEditorTaskInfo;\nuse cosmicpe\\worldbuilder\\event\\player\\PlayerTriggerEditorTaskEvent;\nuse pocketmine\\block\\BlockTypeIds;use pocketmine\\math\\Vector3;\n\npublic function onPlayerTriggerEditorTask(PlayerTriggerEditorTaskEvent $event) : void{\n\t$player = $event-\u003eplayer;\n\t$task = $event-\u003einstance-\u003einfo;\n\tif($task instanceof SetEditorTaskInfo){\n\t\tif($task-\u003eblock-\u003egetTypeId() === BlockTypeIds::TNT){\n\t\t\t$event-\u003ecancel();\n\t\t\t$player-\u003esendMessage(\"Setting \" . $task-\u003eblock-\u003egetName() . \" is not allowed!\");\n\t\t}\n\t\t\n\t\t// allow modifying sections between these 2 points\n\t\t$p1 = new Vector3(0, 0, 0);\n\t\t$p2 = new Vector3(100, 255, 100);\n\t\tif($task-\u003ex1 \u003c $p1-\u003ex || $task-\u003ex2 \u003e $p2-\u003ex || $task-\u003ey1 \u003c $p1-\u003ey || $task-\u003ey2 \u003e $p2-\u003ey || $task-\u003ez1 \u003c $p1-\u003ez || $task-\u003ez2 \u003e $p2-\u003ez){\n\t\t\t$event-\u003ecancel();\n\t\t\t$player-\u003esendMessage(\"You cannot build outside your allocated region!\");\n\t\t}\n\t}else{\n\t\t// disallow players from using anything else besides //set\n\t\t$event-\u003ecancel();\n\t\t$player-\u003esendMessage(\"This operation is not allowed on the server.\");\n\t}\n}\n```\n\n### Monitoring editor tasks\n```php\nuse cosmicpe\\worldbuilder\\editor\\executor\\EditorTaskInfo;\nuse cosmicpe\\worldbuilder\\editor\\task\\listener\\EditorTaskListener;\n\nclass MyEditorTaskListener implements EditorTaskListener{\n\n\tpublic function onRegister(EditorTaskInfo $info) : void{\n\t\t// Called after PlayerTriggerEditorTaskEvent has been triggered and the\n\t\t// event hasn't been cancelled.\n\t}\n\n\tpublic function onCompleteFraction(EditorTaskInfo $info, int $completed, int $total) : void{\n\t\t// $player-\u003esendPopup($task-\u003egetName() . \" completed: \" . sprintf(\"%0.2f\", ($completed / $total) * 100) . \"%\");\n\t}\n\n\tpublic function onCompletion(EditorTaskInfo $info) : void{\n\t\t// $player-\u003esendPopup($task-\u003egetName() . \" completed!\");\n\t}\n}\n```\n...and then register it to an editor task!\n\n```php\nuse cosmicpe\\worldbuilder\\event\\player\\PlayerTriggerEditorTaskEvent;\n\n/**\n * @param PlayerTriggerEditorTaskEvent $event\n * @priority MONITOR\n */\npublic function onPlayerTriggerEditorTask(PlayerTriggerEditorTaskEvent $event) : void{\n\t$event-\u003einstance-\u003eregisterListener(new MyEditorTaskListener());\n}\n```\n\n### Executing edit operations\nAn edit operation (e.g., `//copy`, `//paste`, etc.) may be programmatically executed by building an `EditorTaskInfo` object and executing it.\nAn `EditorTaskInfo` implementation exists for every editor operation.\n\n```php\nuse cosmicpe\\worldbuilder\\editor\\executor\\SetEditorTaskInfo;\nuse cosmicpe\\worldbuilder\\editor\\task\\listener\\EditorTaskOnCompletionListener;\nuse cosmicpe\\worldbuilder\\Loader;\nuse pocketmine\\block\\VanillaBlocks;\nuse pocketmine\\Server;\n\n$world = Server::getInstance()-\u003egetWorldManager()-\u003egetDefaultWorld();\n$task = new SetEditorTaskInfo(\n\tworld: $world,\n\tx1: 0,\n\ty1: 0,\n\tz1: 0,\n\tx2: 100,\n\ty2: 255,\n\tz2: 100,\n\tblock: VanillaBlocks::STONE(), // fill this area with stone\n\tgenerate_new_chunks: true\n);\n\n/** @var Loader $plugin */\n$plugin = Server::getInstance()-\u003egetPluginManager()-\u003egetPlugin(\"WorldBuilder\");\n\necho \"Task started\";\n$instance = $plugin-\u003egetEditorManager()-\u003ebuildInstance($task);\n$instance-\u003eregisterListener(new EditorTaskOnCompletionListener(function(SetEditorTaskInfo $info) : void{\n\techo \"Task completed\";\n}));\n$plugin-\u003egetEditorManager()-\u003epush($instance);\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosmoverse%2Fworldbuilder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcosmoverse%2Fworldbuilder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosmoverse%2Fworldbuilder/lists"}