Project Zomboid B42MP Pterodactyl Egg

A comprehensive Pterodactyl egg for running Project Zomboid Build 42 servers with B42MP multiplayer mod integration.

Overview

This egg provides automated installation and configuration for:

• Project Zomboid Build 42 (unstable branch)
• B42MP multiplayer mod integration
• Steam authentication with 2FA support

Requirements

Steam Account

• Valid Steam account with Project Zomboid ownership
• Steam credentials (username/password)
• Steam Guard code (if 2FA is enabled)

Server Resources

• RAM: Minimum 6GB (8GB+ recommended)
• Storage: 4GB+ free space
• CPU: 2+ cores recommended

Installation

1. Import the egg JSON file into your Pterodactyl panel
2. Create a new server using the "Project Zomboid B42MP" egg
3. Configure the required environment variables (see below)
4. Start the server

Environment Variables

Required Variables

Variable	Description	Default	Required
SERVER_NAME	Internal server name for save/config files	Pterodactyl	Yes
ADMIN_PASSWORD	Admin account password	adminpassword	Yes
ADMIN_USER	Admin account username	admin	Yes
STEAM_USER	Steam username for downloading	-	Yes
STEAM_PASS	Steam password	-	Yes

Optional Variables

Variable	Description	Default	Required
STEAM_PORT	UDP port for Steam communication	16262	No
STEAM_AUTH	Steam Guard authentication code	-	No
B42MP_VERSION	B42MP version to install	1.28	No
AUTO_UPDATE	Enable auto-update on startup (0/1)	0	No

Available B42MP Versions

Check B42MP releases for available versions. Current default is 1.27.

Server Startup

The egg uses different startup methods based on installation success:

Troubleshooting

Common Issues

Steam Authentication Fails

• Verify Steam credentials are correct
• If using Steam Guard, provide the authentication code in STEAM_AUTH
• Ensure the Steam account owns Project Zomboid

B42MP Download Fails

• Check if the specified B42MP version exists
• Verify internet connectivity
• Server will automatically fallback to vanilla Project Zomboid

Server Won't Start

• Check server logs for specific error messages
• Verify Java installation (included with Project Zomboid)
• Ensure sufficient RAM allocation

File Permission Issues

• Installation script handles permissions automatically
• If issues persist, check container permissions

Advanced Configuration

Memory Settings

The egg uses optimized JVM settings:

• -Xmx5072m - Maximum heap size (adjust based on available RAM)
• -XX:+UseZGC - ZGC garbage collector for better performance
• -XX:-CreateCoredumpOnCrash - Prevents core dumps

Steam Settings

• Uses Steam client files for multiplayer functionality
• Supports both 32-bit and 64-bit Steam libraries
• Automatically configures Steam SDK paths

Support

B42MP Specific Issues

• Visit B42MP Discord/Community for mod-specific support
• Check B42MP documentation for multiplayer setup

Pterodactyl Issues

• Consult Pterodactyl documentation
• Check server console logs
• Verify egg configuration

Project Zomboid Issues

• Official Project Zomboid Discord
• Steam Community Forums

License

This egg configuration is provided as-is. Project Zomboid and B42MP are subject to their respective licenses.

Contributing

To contribute improvements:

1. Test changes thoroughly
2. Document any new environment variables
3. Ensure backward compatibility
4. Submit with clear description of changes

---

Note: This egg is designed for Project Zomboid Build 42 with B42MP mod. For vanilla Project Zomboid servers, consider using the standard Project Zomboid egg.