Frequently Asked Questions
Quick answers to common questions.
Setup
Q:Do I need coding experience?
A:No! Everything is configured in one file. If you can edit text, you can customize this template.
Q:What do I need to run this?
A:Just Node.js 18 or higher. Download it free from nodejs.org. Works on Windows, Mac, and Linux.
Q:I changed something but it's not working
A:Make sure you saved the file. Check for red error squiggles in your editor. Common issues: missing quotes, extra commas, or typos in property names.
Q:The development server won't start
A:Run "npm install" first. If it still fails, delete node_modules folder and package-lock.json, then run "npm install" again.
Customization
Q:How do I change the font?
A:Edit src/app/layout.tsx and change the font import. Google Fonts are supported by default.
Q:Can I add more pages?
A:Yes! Create new folders in src/app/. For example, src/app/rules/page.tsx creates a /rules page.
Q:How do I add custom images?
A:Put images in the public/ folder. Reference them as /image-name.png in your code.
Q:Can I use a light theme?
A:The template is designed for dark themes. Light themes would require CSS modifications beyond the config file.
Q:How do I change the favicon?
A:Replace public/favicon.png with your own. Use a .ico file or .png for best compatibility.
Deployment
Q:Where should I host this?
A:Netlify or Vercel are recommended. Both have free tiers that work great for server homepages.
Q:Do I need a paid hosting plan?
A:No. Free tiers from Netlify/Vercel handle thousands of visitors per month easily.
Q:How do I use a custom domain?
A:Buy a domain, then add it in your hosting platform settings. They provide DNS instructions.
Q:My site shows a 404 error after deploying
A:Make sure you're uploading the contents of the "out" folder, not the folder itself. index.html should be at the root.
Server Status
Q:Why does it show my server as offline?
A:Check your IP in config. Some hosts block status queries - test at api.mcsrvstat.us/2/your.ip directly.
Q:Can I use a different status API?
A:Yes. Modify src/hooks/useServerStatus.ts to use any API you prefer.
Q:How do I hide the player count?
A:Set showPlayerCount: false in the serverStatus config section.
License & Support
Q:Can I use this for multiple servers?
A:Yes! One purchase allows unlimited personal and client use.
Q:Can I resell this template?
A:No. You cannot redistribute or resell the template itself. Client projects are fine.
Q:How do I get support?
A:Contact through BuildByBit messaging. Response within 24-48 hours.
Q:Are updates included?
A:Yes. Bug fixes and improvements are provided free through BuildByBit.