BDCustomPortal

BDCustomPortal

BDCustomPortal is a PocketMine-MP 5 plugin that adds custom elemental portal items, animated portal entities, an in-game administration interface, and linked teleportation between portal pairs.

Features

• Five portal types: Air, Earth, Fire, Water, and Blood.
• Custom portal items and visual portal entities supplied by the included Bedrock resource pack.
• In-game portal placement with duplicate-nearby protection.
• Admin menu for giving portal items and managing placed portals.
• Portal naming, connection, unlinking, removal, and player-use toggles.
• Linked portals teleport players across worlds and preserve the destination portal pairing.
• Resource pack installation is handled by the plugin when it enables.

Requirements

• PocketMine-MP 5.x (api: 5.0.0)
• Customies installed and enabled before BDCustomPortal
• A Bedrock Edition client able to receive server resource packs

Installation

1. Download or clone this repository.
2. Copy the repository folder into your PocketMine-MP plugins/ directory. The plugin manifest must remain at the plugin root.
3. Start or restart the server.
4. Accept the server resource pack when prompted. The included pack is located at resources/BDCustomPortal_RP_v1.0.0.mcpack and is loaded by the plugin.
5. Use /bdcustomportal in-game as an operator, or grant the bdcustomportal.admin permission.

Commands and permissions

The command is intended for in-game players and requires the admin permission.

Basic usage

1. Open the admin menu with /bdcustomportal and obtain a portal item.
2. Use the portal item on a block to place a portal entity.
3. Hold or long-press a placed portal to open its management interface.
4. Give each portal a name if desired, then use the connection flow to link two portals.
5. Players can use linked portals to teleport. The management interface also allows an administrator to unlink or remove a portal and control whether players may use it.

Repository layout

plugin.yml
resources/BDCustomPortal_RP_v1.0.0.mcpack
src/BDCustomPortal/BobyDev/
├── main.php
├── PortalEntity.php
├── PortalEntities.php
├── PortalItem.php
├── PortalMenu.php
└── AdminPortalMenu.php

Development notes

The plugin entry point is BDCustomPortal\\BobyDev\\main. The implementation uses Customies for custom items and entities and registers its own resource pack during plugin startup. Runtime world data and local PocketMine-MP files should not be committed; common runtime paths are excluded by .gitignore.

License

No license was included with the supplied plugin archive. Add a license file before redistributing the project if you want to define reuse and contribution terms.