EasyForms

⚠️ Deprecated! If you're looking for good PM4 forms API consider new forms library with PHP 8.0+ support and phpstan integration

Plugin for pmmp that allow you create GUI in a few clicks.

Code samples

ModalForm

$sender->sendForm(new ModalForm("A small question", "Our server is cool?",
    function(Player $player, bool $response) : void{
        $player->sendMessage($response ? "Thank you" : "We will try to become better");
    }
));

MenuForm

$sender->sendForm(new MenuForm(
    "Select server", "Choose server", [new Button("SkyWars #1", new Image("https://gamepedia.cursecdn.com/minecraft_gamepedia/1/19/Melon.png"))],
    function(Player $player, Button $selected) : void{
        $player->sendMessage("You selected: " . $selected->getText());
        $player->sendMessage("Index of button: " . $selected->getValue());
    }
));

CustomForm

$sender->sendForm(new CustomForm("Enter data",
    [
        new Dropdown("Select product", ["beer", "cheese", "cola"]),
        new Input("Enter your name", "Bob"),
        new Label("I am label!"), //Note: get<Element>() does not work with label
        new Slider("Select count", 0.0, 100.0, 1.0, 50.0),
        new StepSlider("Select product", ["beer", "cheese", "cola"]),
        new Toggle("Creative", $sender->isCreative())
    ],
    function(Player $player, CustomFormResponse $response) : void{
        $dropdown = $response->getDropdown();
        $player->sendMessage("You selected: {$dropdown->getSelectedOption()}");

        $input = $response->getInput();
        $player->sendMessage("Your name is {$input->getValue()}");

        $slider = $response->getSlider();
        $player->sendMessage("Count: {$slider->getValue()}");

        $stepSlider = $response->getStepSlider();
        $player->sendMessage("You selected: {$stepSlider->getSelectedOption()}");

        $toggle = $response->getToggle();
        $player->setGamemode($toggle->getValue() ? GameMode::CREATIVE() : GameMode::SURVIVAL());
    }
));

CustomForm with getValues() method

$sender->sendForm(new CustomForm("Enter data",
    [
        new Dropdown("Select product", ["beer", "cheese", "cola"]),
        new Input("Enter your name", "Bob"),
        new Label("I am label!"), //Also ignored by getValues()
        new Slider("Select count", 0.0, 100.0, 1.0, 50.0),
        new StepSlider("Select product", ["beer", "cheese", "cola"]),
        new Toggle("Creative", $sender->isCreative())
    ],
    function(Player $player, CustomFormResponse $response) : void{
        list($product1, $username, $count, $product2, $enableCreative) = $response->getValues();
        $player->sendMessage("You selected: $product1");
        $player->sendMessage("Your name is $username");
        $player->sendMessage("Count: $count");
        $player->sendMessage("You selected: $product2");
        $player->setGamemode($enableCreative ? GameMode::CREATIVE() : GameMode::SURVIVAL());
    }
));

ServerSettingsForm

public function onServerSettingsRequest(ServerSettingsRequestEvent $e) : void{
    $player = $e->getPlayer();
    $e->setForm(new ServerSettingsForm("Server settings",
            [
                new Label("Some text"),
                new Toggle("Enable something", $player->isFlying())
            ],
            new Image("http://icons.iconarchive.com/icons/double-j-design/diagram-free/128/settings-icon.png"),
            function(Player $player, CustomFormResponse $response) : void{
                $player->sendMessage($response->getToggle()->getValue() ? "enabled" : "disabled");
            }
        )
    );
}