Features

Developer Documentation

Check if a player is on dimension change screen

usemuqsit\dimensionportals\event\PlayerDimensionScreenChangeEvent;usemuqsit\dimensionportals\Loader;usemuqsit\dimensionportals\WorldManager;usepocketmine\player\Player;usepocketmine\Server;// Method 1: query current state/** @var Loader $plugin */$plugin = Server::getInstance()->getPluginManager()->getPlugin("DimensionPortals");$player = Server::getInstance()->getPlayerExact("BoxierChimera37")$manager =$plugin->getPlayerManager();$changing_dimension =$manager->get($player)->getChangingDimension();if($changing_dimension !==null){echo$player->getName()," is changing dimension to",$changing_dimension,"!",PHP_EOL;}else{echo$player->getName()," is not changing dimensions!",PHP_EOL;}// Method 2: event-driven solutionpublicfunctiononDimensionScreenChange(PlayerDimensionScreenChangeEvent$event) :void{if($event->state === PlayerDimensionScreenChangeEvent::STATE_BEGIN){echo$player->getName()," is now on dimension change screen (dimension=",$event->dimension,")",PHP_EOL;}elseif($event->state === PlayerDimensionScreenChangeEvent::STATE_END){echo$player->getName()," is no longer on dimension change screen (dimension=",$event->dimension,")",PHP_EOL;}}

Configure dimensions of worlds programatically

usemuqsit\dimensionportals\Loader;usemuqsit\dimensionportals\WorldManager;usepocketmine\Server;/** @var Loader $plugin */$plugin = Server::getInstance()->getPluginManager()->getPlugin("DimensionPortals");$manager =$plugin->getWorldManager();$manager->world_dimensions["ruins"] = WorldManager::DIMENSION_END;// set dimension of 'ruins' world to end$manager->world_dimensions["nether2"] = WorldManager::DIMENSION_NETHER;$manager->default_worlds[WorldManager::DIMENSION_OVERWORLD] ="world2";// portals tp players back to this world$manager->default_worlds[WorldManager::DIMENSION_NETHER] ="nether2";// nether portal tps to this world$manager->default_dimension = WorldManager::DIMENSION_NETHER;// default dimension of the server is nether

PlayerPortalCreateEvent: Disable creating nether portal 64 blocks within spawn

usemuqsit\dimensionportals\event\PlayerPortalCreateEvent;usemuqsit\dimensionportals\WorldManager;usepocketmine\math\Vector3;publicfunctiononPortalCreate(PlayerPortalCreateEvent$event) :void{if($event->dimension !== WorldManager::WORLD_NETHER){// did not create nether portalreturn;}$player =$event->getPlayer();$spawn =$player->getWorld()->getSpawnLocation();foreach($event->frame_blocksas$block){// the obsidian block// these blocks already exist in the worldif($block->getPosition()->distance($spawn) <=64){$event->cancel();return;}}foreach($event->transaction->getBlocks()as [$x,$y,$z,$block]){// the pink portal block// these are the blocks that will be created$pos =newVector3($x,$y,$z);if($pos->distance($spawn) <=64){$event->cancel();return;}}}

PlayerPortalEnterEvent: Instant teleportation for ranked players

usemuqsit\dimensionportals\event\PlayerPortalEnterEvent;publicfunctiononPortalEnter(PlayerPortalEnterEvent$event) :void{if($event->getPlayer()->hasPermission("rank.vip")){$event->teleport_duration =0;}}

PlayerPortalTeleportEvent: Make end portals teleport to boring_end world for unranked players

usemuqsit\dimensionportals\event\PlayerPortalTeleportEvent;usemuqsit\dimensionportals\WorldManager;usepocketmine\entity\Location;publicfunctiononPortalTeleport(PlayerPortalTeleportEvent$event) :void{if($event->dimension !== WorldManager::DIMENSION_END){return;}$player =$event->getPlayer();if($player->hasPermission("rank.vip")){return;}$pos =$player->getServer()->getWorldManager()->getWorldByName("boring_end")->getSpawnLocation();$event->target = Location::fromObject($pos,$pos->world);}

Resources