games647/minecraft-banner-generator

Customizable banner generator for servers and player

Minecraft Banner Generator

Description

Minecraft banner generator library., _(*1)

Features

• Server banner Displays:
  • Ping (shows different about how good the ping is)
  • Online players
  • Max players
  • Favicon if available
  • Colorized motd (message of the day)
  • Custom background
• Player banners Displays:
  • Player Head image
  • Displays player name
• No branding
• No Magic values
• Free

ToDo

• Text style effects (bold, italic, underlined)
• Automatic line wrapping
• Graph of player activity

Installation

With composer it's just:, _(*2)

composer require games647/minecraft-banner-generator

For non-composer projects, you can drop the files from the /src folder into a libraries folder and use it with a require statement at the top of the PHP-File. You can see a example in the example.php file., _(*3)

Usage

//this is only used if you don't use composer
require __DIR__ . '/PATH_TO_LIB_FOLDER/MinecraftBanner.php';
require __DIR__ . '/PATH_TO_LIB_FOLDER/ServerBanner.php';

use \MinecraftBanner\ServerBanner;
use \MinecraftBanner\MinecraftBanner;

[...]

//tell the browser that we will send the raw image without HTML
header('Content-type: image/png');

$banner = ServerBanner::server("example.minecraft.com", "§aHallo §cWelt");
imagepng($banner);

Backgrounds

You can use 11 build in Backgrounds or Images as files or URLs, _(*4)

$favicon = imagecreatefrompng("server_favicon.png");
$image = ServerBanner::server("example.minecraft.com", "§aHallo §cWelt", -1, -1, $favicon, "MinecraftBanner::[DEFAULT_BACKGROUND, CLOUDS_BACKGROUND, LILLY_PADS_BACKGROUND, HILLS_BACKGROUND, WATERFALL_BACKGROUND, CANYON_BACKGROUND, GRASSLAND_BACKGROUND, GRASSLAND_CANYON_BACKGROUND, SWAMP_BACKGROUND, LAKE_BACKGROUND, SWAMP2_BACKGROUND, LILLY_PADS_SWAMP_BACKGROUND]");

CLOUDS_BACKGROUND

, _(*5)

LILLY_PADS_BACKGROUND

, _(*6)

HILLS_BACKGROUND

, _(*7)

WATERFALL_BACKGROUND

, _(*8)

CANYON_BACKGROUND

, _(*9)

GRASSLAND_BACKGROUND

, _(*10)

GRASSLAND_CANYON_BACKGROUND

, _(*11)

SWAMP_BACKGROUND

, _(*12)

LAKE_BACKGROUND

, _(*13)

SWAMP2_BACKGROUND

, _(*14)

LILLY_PADS_SWAMP_BACKGROUND

, _(*15)

Scaling

, _(*16)

Examples

$favicon = imagecreatefrompng("server_favicon.png");
$image = ServerBanner::server("example.minecraft.com", "§aHallo §cWelt", -1, -1, $favicon);

, _(*17)

$favicon = imagecreatefrompng("notch_head.png");
$image = PlayerBanner::player("Notch", $favicon);

, _(*18)

$favicon = imagecreatefrompng("server_favicon.png");
$image = ServerBanner::server("example.minecraft.com", "§aHallo §cWelt", -1, -1, $favicon, MinecraftBanner::LILLY_PADS_BACKGROUND);

, _(*19)

$favicon = imagecreatefrompng("notch_head.png");
$image = PlayerBanner::player("Notch", $favicon, MinecraftBanner::LILLY_PADS_BACKGROUND);

, _(*20)