{"id":15142865,"url":"https://github.com/cosmoverse/npcdialogue","last_synced_at":"2026-02-22T11:27:07.234Z","repository":{"id":186706948,"uuid":"675621300","full_name":"Cosmoverse/NpcDialogue","owner":"Cosmoverse","description":"A PocketMine-MP library for making NPC dialogues","archived":false,"fork":false,"pushed_at":"2024-04-08T11:32:17.000Z","size":4046,"stargazers_count":25,"open_issues_count":2,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-22T20:41:22.265Z","etag":null,"topics":["library","pmmp","pocketmine-mp","virion"],"latest_commit_sha":null,"homepage":"https://poggit.pmmp.io/ci/Cosmoverse/NpcDialogue","language":"PHP","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/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":"2023-08-07T10:45:52.000Z","updated_at":"2025-03-05T01:43:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"c13f4fe6-59d5-478a-870e-0a7fde7e3ace","html_url":"https://github.com/Cosmoverse/NpcDialogue","commit_stats":null,"previous_names":["cosmoverse/npcdialogue"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/Cosmoverse/NpcDialogue","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmoverse%2FNpcDialogue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmoverse%2FNpcDialogue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmoverse%2FNpcDialogue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmoverse%2FNpcDialogue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cosmoverse","download_url":"https://codeload.github.com/Cosmoverse/NpcDialogue/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmoverse%2FNpcDialogue/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264330499,"owners_count":23591953,"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":["library","pmmp","pocketmine-mp","virion"],"created_at":"2024-09-26T10:00:45.082Z","updated_at":"2026-02-22T11:27:07.155Z","avatar_url":"https://github.com/Cosmoverse.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NpcDialogue\nNpcDialogue is a PocketMine-MP library for creating NPC dialogues. The library is built for portability, letting developers build dialgoues without spawning (and handling despawning of) any entities whatsoever.\n\nThe library requires event handling and therefore a plugin must  call `NpcDialogueManager::register()` on enable.\n\n```diff\n+use cosmicpe\\npcdialogue\\NpcDialogueManager;\n\nprotected function onEnable() : void{\n+\tif(!NpcDialogueManager::isRegistered()){\n+\t\tNpcDialogueManager::register($this);\n+\t}\n}\n```\n\n## Examples\n### Building a simple dialogue\nThe library  provides a builder class (`NpcDialogueBuilder`) to conveniently build NPC dialogue.  NPC dialogues can be sent to players using `NPCDialogueManager::send()` once built.\n```php\nuse cosmicpe\\npcdialogue\\dialogue\\texture\\DefaultNpcDialogueTexture;\nuse cosmicpe\\npcdialogue\\NpcDialogueBuilder;\nuse cosmicpe\\npcdialogue\\NpcDialogueManager;\nuse pocketmine\\player\\Player;\n\n$dialogue = NpcDialogueBuilder::create()\n\t-\u003esetName(\"Dialogue Name\")\n\t-\u003esetText(\"This is an example dialogue.\")\n\t-\u003esetDefaultNpcTexture(DefaultNpcDialogueTexture::TEXTURE_NPC_10)\n\t-\u003eaddSimpleButton(\"Okay\")\n\t-\u003eaddSimpleButton(\"Whatever\", function(Player $player) : void{\n\t\t$player-\u003esendMessage(\"You clicked 'Whatever' button\");\n\t})\n\t-\u003esetCloseListener(function(Player $player) : void{\n\t\t$player-\u003esendMessage(\"You closed the dialogue\");\n\t})\n-\u003ebuild();\nNpcDialogueManager::send($player, $dialogue);\n```\n![img.png](resources-readme/example-1.png)\n\n### Building a dialogue with a pre-registered entity's texture\nA pre-registered entity's entity identifier can be supplied to `NpcDialogueBuilder::setEntityNpcTexture()`.\n```php\nuse cosmicpe\\npcdialogue\\NpcDialogueBuilder;\nuse cosmicpe\\npcdialogue\\NpcDialogueManager;\nuse pocketmine\\network\\mcpe\\protocol\\types\\entity\\EntityIds;\n\nNpcDialogueManager::send($player, NpcDialogueBuilder::create()\n\t-\u003esetName(\"Honey Bee\")\n\t-\u003esetText(file_get_contents(\"bee_movie_script.txt\"))\n\t-\u003esetEntityNpcTexture(EntityIds::BEE)\n-\u003ebuild());\n```\n![img.png](resources-readme/example-2.png)\n\n### Building a dialogue with a player's skin as texture\nA player skin (a `Skin` object) can be supplied to `NpcDialogueBuilder::setSkinNpcTexture()`.\n```php\nuse cosmicpe\\npcdialogue\\NpcDialogueBuilder;\nuse cosmicpe\\npcdialogue\\NpcDialogueManager;\n\nNpcDialogueManager::send($player, NpcDialogueBuilder::create()\n\t-\u003esetName(\"This is YOU!\")\n\t-\u003esetText(\"You have the power within you to overcome any obstacle that comes your way. You are resilient, capable, and determined to achieve greatness. Embrace the challenges, believe in yourself, and remember that every step you take brings you closer to your dreams. Keep pushing forward with unwavering determination, for the world awaits the extraordinary impact you're destined to make.\")\n\t-\u003esetSkinNpcTexture($player-\u003egetSkin())\n-\u003ebuild());\n```\n![img.png](resources-readme/example-3.png)\n\nYou can set 'portrait offset' of player skins to adjust scale of the texture.\n```php\nuse cosmicpe\\npcdialogue\\NpcDialogueBuilder;\nuse cosmicpe\\npcdialogue\\NpcDialogueManager;\n\n$parent = NpcDialogueTextureOffset::defaultPlayerPortrait();\n$portrait_offset = new NpcDialogueTextureOffset(2.0, 2.0, 2.0, $parent-\u003etranslate_x, $parent-\u003etranslate_y, $parent-\u003etranslate_z);\nNpcDialogueManager::send($player, NpcDialogueBuilder::create()\n\t-\u003esetName(\"This is YOU!\")\n\t-\u003esetText(\"You have the power within you to overcome any obstacle that comes your way. You are resilient, capable, and determined to achieve greatness. Embrace the challenges, believe in yourself, and remember that every step you take brings you closer to your dreams. Keep pushing forward with unwavering determination, for the world awaits the extraordinary impact you're destined to make.\")\n\t-\u003esetSkinNpcTexture($player-\u003egetSkin(), null, $portrait_offset)\n-\u003ebuild());\n```\n![img.png](resources-readme/example-4.png)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosmoverse%2Fnpcdialogue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcosmoverse%2Fnpcdialogue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosmoverse%2Fnpcdialogue/lists"}