Documentation

Blockhaven

Installation

Requirements: NamelessMC 2.2.x (PHP 8.2+).

1. Upload the Blockhaven folder to custom/templates/ of your NamelessMC installation (final path: custom/templates/Blockhaven/template.php).
2. StaffCP → Customisation → Templates → find Blockhaven → Install, then Activate (make default).
3. StaffCP → Configuration → General Settings → set Default Homepage to Portal. The portal home renders the Blockhaven modules; "News" keeps the classic news list, restyled.
4. StaffCP → Customisation → Templates → Blockhaven → Settings to start customising.
5. Make sure cache/ is writable (NamelessMC requirement) and clear cache/templates_c/ after updating files.

Updating

Replace the Blockhaven folder, keep your settings (they live in the database). Clear cache/templates_c/.

Customisation

Everything is edited in StaffCP → Customisation → Templates → Blockhaven → Settings (gear icon). No code needed.

Tab	What you can change
Design	Biome palette (Overworld, Nether, The End, Ocean, Desert, Tundra) or your own colours, default light/dark mode, heading font (Minecraft / pixel fonts), body font, bevel size, square or rounded corners, content width, navbar style (overlay on hero / solid), navbar button, page background texture
Brand	Logo text or image, server IP, fallback player count, Discord and store URLs
Home modules	Enable, reorder, duplicate and edit every section of the home page
Footer	Brand block, description, copyright text
Advanced	Disable animations, add custom CSS
Import / Export	Back up your configuration as JSON or copy it to another site

Hero banner

The default hero is a generated pixel landscape that is recoloured by the biome palette. Set a Background image URL in the Hero module to use your own screenshot instead; add a logo image in Brand to replace the text logo. Left side: live player count + IP + play button (copies the IP). Right side: Discord widget.

Fonts

• Minecraft is loaded from fonts.cdnfonts.com and is not included in the download. Check that its licence fits your use (especially for commercial sites) or choose Pixelify Sans, Silkscreen or Press Start 2P, which are open-licence fonts.
• Choose Same as body text for a clean, non-pixel look.

Colour tokens for custom CSS

--bh-primary, --bh-primary-600, --bh-primary-300, --bh-accent, --bh-bg, --bh-surface, --bh-surface-2, --bh-edge, --bh-text, --bh-muted, --bh-px (bevel size), --bh-font, --bh-font-head, --bh-container.

.bh-title { font-size: 6rem; }          /* bigger logo text */
.bh-btn { text-transform: none; }       /* sentence-case buttons */